MESA Core · v0.9.3
Güvenlik ve kapsam
Bu rehberin Türkçe ve İngilizce sürümleri aynı konuyu açıklar. Bu sayfayla ilgili kaynak bölümleri en altta yer alır.
Erişim sınırını üst alan belirler#
Kimliği doğrulanan anahtar, bir erişim kimliğine bağlanır. Üst erişim alanı (tenant), çalışma alanı ve veri kümesi için OWNER, WRITER ve READER rolleri tanımlanır; bu roller alt alanlara geçer. Ajan kimliği bir erişim anahtarı değildir, isteğin bağlamını belirtir. Oturumun veri kümesi listesi sabittir. Kalıcı silme ve geri alma için role ek olarak açık veri kümesi izni gerekir. Erişim kapsamı arama sıralamasından önce denetlenir.
Kurulumun güvenliği de sizin sorumluluğunuzdadır#
Core; SQLite, LanceDB ve Kùzu verilerini diskte kendisi şifrelemez. Diskleri, işletim sistemi izinlerini, yedekleri ve ağı ayrıca koruyun. Sürümlü hafıza, sağlık ve ölçüm çağrıları API anahtarı ister. Hazır olma, OpenAPI, Swagger ve ReDoc arayüzleri dışarıya açık olabilir; kurulum sınırında TLS ve erişim kuralları uygulayın.
Kanıt metnini güvenilir talimat saymayın#
Kaynağı belli bir kayıt, bağımsız olarak doğrulanmış gerçek anlamına gelmez. UNTRUSTED_MEMORY_EVIDENCE, modele ve araçlara aktarılırken veri olarak kalmalı; talimat yetkisi kazanmamalıdır. İçeriği, erişim bilgilerini, model çıktısını veya iş sahipliği anahtarlarını günlüklere yazmayın. İki modelin aynı fikirde olması hukuki doğruluğu garanti etmez veya hatalı yanıtları tamamen önlemez.
v0.9.3 ile çalışma#
Silme, denetim kimlikleri ve özetler korunurken belgenin sahip olduğu kaynak ve çıkarım metnini temizler. Başka bir belgenin sahip olduğu ortak bilgi/varlık metni kalır. Yerel kimlik bilgilerini ve üretilen MCP yapılandırmasını koruyun.
v0.9.3’de sınırlı istek işi#
Hukuki kural çıkarımı, atıf çözümleme, kapsam hazırlama ve yoğun token puanlama; kullanıcı metni üzerinde yapılan işi sınırlar ve thread yürütmesini paylaşır. Böylece ölçülen yoğun örnekler sürerken sağlık istekleri çalışabilir. v0.9.3’te /v4/* ve /control/* için dakikalık ve günlük hız sınırları uygulanmaz. Kùzu 0.11.3 ham çizge dosyaları süreç belleğinden parçalar içerebilir; çizge dizinini SQLite gibi koruyun. Güncel sınırlara bakın. Kanun adları, kimlikler ve tam eşleşme önceliği izinli kurum/veri kümesi/ajan/zaman kapsamında çözülür.
Şemalar
Dolu elmas sahipliği (bileşim) gösterir: veri kümesi silinince belgeleri de gider. Role, Principal–Tenant bağındaki ilişki sınıfıdır ve çalışma alanlarına, veri kümelerine miras kalır. Oturumu sunucu oluşturur ve veri kümesi setini sabitler. LegalItem anlık görüntüleri kaynak parçalarına aittir; SPO kayıtlarından ayrıdır ve hukuk kuralları kapalıyken sonuç kopyalarında gizlenir.
Tüm şemalar ve gerekçeleri: Mimari →
Kaynak belgedeki ilgili bölümler
Bu bölüm, kaynak belgenin bu sayfayla ilgili kısımlarını değiştirmeden gösterir. Kaynak içindeki bir bölüme giden bağlantıyı açtığınızda metin otomatik olarak görünür.
Threat model and deployment boundary#
Core enforces authenticated principals, scoped catalog/session access and
ownership-aware storage operations. An operator with filesystem access or
control over the process/credentials is outside that application boundary.
Embedded SQLite/LanceDB/Kùzu data is not encrypted at rest by Core; use reviewed
volume encryption and restrict OS permissions, backups and network access.
V4 keys are key_id.secret; the registry stores salted scrypt hashes, supports
rotation/revocation and binds principal identity server-side. Provision tenant
roles, agent permission and dataset purge/rollback permission explicitly.
Revalidate roles for each request; user metadata grants no authority.
Tenant → workspace → dataset roles inherit downwards. Sessions bind immutable
dataset membership and agent context. Negative isolation contracts cover SQL,
vectors, graph and historical mutation management; passing tests is not an
absolute guarantee against every possible leak. V3 agent/session checks are a
separate compatibility contract.
Network and authentication#
Versioned memory routes, /health and /metrics require an API
key. /health/init is a public readiness probe. OpenAPI, Swagger and Redoc are
not protected by the memory-router authentication dependency. Configure an
authenticated reverse proxy, TLS and access policy for nonlocal deployments.
Compose publishes loopback only; the normal runtime launcher binds 0.0.0.0
inside the process/container. Do not expose its port without a network boundary.
Control-plane routes require an active principal with ADMIN; MCP gateway
credentials additionally bind a client/workspace. Gateway encrypted approvals
and bridge spools are separate from canonical memory storage. Protect the
Fernet key and local XDG environment files; do not reuse a shared gateway token.
Approvals and the control-plane audit belong to the HTTP MCP gateway. Direct
mesa-mcp stdio creates no local database and relies on the MCP client's tool
approval and the MESA API key's grants for access to Core.
Untrusted data and logs#
Exact source content remains data. Context uses UNTRUSTED_MEMORY_EVIDENCE
JSON records; prompt injection detection/rendering is not proof that a downstream
model will ignore malicious instructions. Review consumers, tool authority and
output handling. API bounds and source-file containment checks reduce abuse;
they do not establish document truth or a legal opinion.
Document purge erases its source and extracted text while retaining identifiers and hashes; shared assertion/entity text remains while another document still owns it.
Kùzu keeps graph structure and entity names; assertion evidence, literal values
and source references stay in SQLite. Graph ranking reads evidence from the
authorized SQLite assertion map. Existing stores need one offline projection
rebuild to create a fresh active graph with those text fields empty (see the
rebuild runbook). Retained generations and rebuild backups still
contain historical bytes; retire those copies under your retention policy
after verifying the new generation. Purge cannot erase independent backups.
Known v0.9 limitation: Kùzu may write leftover process memory into unused
parts of its file. The offline rebuild reads every assertion from SQLite, so a
new graph file can contain fragments of live documents' text in such unused
bytes (seen in 2 of 6 test rebuilds; not seen in normal projection). Kùzu never
overwrites them, so text of a document purged after that rebuild can stay
recoverable from the graph file. If a purge must leave no copy at all, run
another offline rebuild after the purge and retire the older generation.
Strict erasure setups can set MESA_GRAPH_ENABLED=false to keep Kùzu closed and prevent new graph files; retire any existing graph files and retained copies under the retention policy.
Avoid query/source content, credentials, raw model output and claim tokens in
logs. IDs and aggregate diagnostics still reveal operational metadata and need
access/retention policy. Historical reports may contain deployment details;
they are not public defaults or evidence that those endpoints are safe to use.
MESA_EXTERNAL_PROVIDER_ENABLED=false fences canonical external model/provider
calls; local model provisioning/download and browser fonts are separate network
concerns. MESA_ZERO_COST_MODE is provider selection, not a complete air-gap or
exfiltration guarantee. Preserve validation assurance when selecting local models.
With the external switch off, ollama and openai_compatible (LLM and
embedding) can use only HTTP(S) URLs whose host is localhost, 127.0.0.1,
::1 or host.docker.internal. The last name means the Docker host, allowing
a container to reach its host's model server. Other hosts, including private
LAN addresses, are blocked. The same rule checks the effective embedding URL,
including MESA_EMBEDDING_BASE_URL overrides and MESA_LLM_BASE_URL fallback.
Local openai_compatible endpoints need no API key; clients send local when
none is configured. openai, claude, anthropic and hosted remain blocked
regardless of URL. Enabling external providers permits remote model endpoints;
remote OpenAI-compatible endpoints still require a configured provider key.
Responsible reporting and supply chain#
Follow SECURITY.md for private reporting. CI checks secrets,
dependency/image vulnerabilities and SBOMs; release requires same-commit evidence
and artifact attestation verification. A local string scan does not replace those
checks. Store real keys in a secret manager and keep .env out of Git.
