Espai de noms de Decision Gate + Arquitectura de registre RBAC/ACL

Audience: Engineers implementing or reviewing namespace policy, Asset Core namespace authority integration, and schema registry access control. This document is the canonical, implementation-aligned description of how Audiència: Enginyers que implementen o revisen la política d’espai de noms, integració de l’autoritat d’espai de noms d’Asset Core i control d’accés al registre d’esquemes. Aquest document és la descripció canònica, alineada amb la implementació, de com Decision Gate (DG) fa complir els límits d’espai de noms i el RBAC/ACL del registre.

Executive Overview

Decision Gate aplica aïllament de l’espai de noms i autorització del registre d’esquema com a fronteres de seguretat de primera classe. Totes les comprovacions d’espai de noms i registre són fail-closed i s’executen abans de qualsevol mutació de l’estat del registre o del escenari. El sistema és intencionadament conservador:

El routatge de namespaces requereix una validació explícita; els namespaces desconeguts són denegats.
The reserved default namespace id (1) is blocked by default and allowed only when both namespace.allow_default = true and the caller’s tenant appears in L’identificador de l’espai de noms per defecte reservat (1) està bloquejat per defecte i només es permet quan tant namespace.allow_default = true com el llogater de la persona que crida apareix en namespace.default_tenants.F:crates/decision-gate-config/src/config.rs L1025-L1052 F:crates/decision-gate-mcp/src/tools.rs L2821-L2841
Asset Core integration is explicit and bounded to configured endpoints and La integració d’Asset Core és explícita i limitada a punts finals configurats i temps d’espera; no s’accepta cap mapeig d’espai de noms implícit.F:crates/decision-gate-config/src/config.rs L1118-L1165 F:crates/decision-gate-mcp/src/namespace_authority.rs L103-L159
Schema registry access is guarded by a dedicated Registry ACL layer that is L’accés al registre d’esquema està protegit per una capa dedicada d’ACL del registre que és independent de les llistes d’aprovació d’eines; ambdues han de permetre l’acció.F:crates/decision-gate-mcp/src/registry_acl.rs L146-L215 F:crates/decision-gate-mcp/src/tools.rs L2881-L2910

Registry RBAC/ACL està delimitat per tenant + namespace + subject i es pot configurar com a builtin o personalitzat. La política builtin està definida explícitament pels noms de rol amb control de classe de política per a l’accés d’escriptura.F:crates/decision-gate-mcp/src/registry_acl.rs L218-L255

Abast i No Objectius

En abast:

Validació de l’espai de noms en eines MCP.
Restriccions del namespace per defecte.
Integració de l’autoritat del namespace Asset Core.
Política RBAC/ACL del registre d’esquema i requisits de signatura.
Auditar i executar el context de seguretat per a aquestes decisions.

Fora de l’abast (tractat en altres llocs o exclòs intencionadament):

Asset Core write-path gating (explicitly out of scope in the integration Control d’escriptura d’Asset Core (explícitament fora de l’abast en el contracte d’integració).
Control d’accés basat en rols (RBAC) a nivell d’escenari o llistes blanques d’eines (tractat en la documentació d’autenticació del servidor).
Aplicació de la confiança dels proveïdors d’evidència (documentat a la guia de seguretat).

Conceptes i Tipus Fonamentals

Identificadors de Namespace i Llogater

Els espais de noms i els llogaters es tracten com a identificadors explícits que es porten a terme per les sol·licituds d’eines. L’identificador d’espai de noms per defecte reservat és 1 i ha de passar controls addicionals abans que qualsevol operació pugui continuar.F:crates/decision-gate-mcp/src/tools.rs L162-L168 F:crates/decision-gate-mcp/src/tools.rs L2821-L2841

Registre d’Esquemes

Les entrades del registre d’esquema són valors DataShapeRecord immutables. Cada registre està delimitat per inquilí + espai de noms + id d’esquema + versió, i pot incloure metadades de signatura opcionals (id de clau, signatura, algorisme opcional). F:crates/decision-gate-core/src/core/data_shape.rs L49-L72

Namespace Política

Guàrdia de l’espai de noms per defecte

L’espai de noms per defecte és un identificador reservat codificat (1). El seu comportament és intencionadament limitat:

If namespace.allow_default is false, all requests targeting the default Si namespace.allow_default és fals, totes les sol·licituds que apunten al namespace per defecte són rebutjades.
If namespace.allow_default is true, namespace.default_tenants must be Si namespace.allow_default és cert, namespace.default_tenants ha de ser no buit i el sol·licitant ha de proporcionar un tenant_id a la llista d’autoritzacions.
El guardià de l’espai de noms per defecte s’aplica abans de les comprovacions d’autoritat externa.

Implementació:

La validació de la configuració imposa el requisit de la llista d’acceptació.F:crates/decision-gate-config/src/config.rs L1025-L1052
El router d’eines aplica la guàrdia per sol·licitud.F:crates/decision-gate-mcp/src/tools.rs L2821-L2841

Modes d’Autoritat de Namespace

L’autoritat del namespace determina com DG valida l’existència del namespace:

Mode	Behavior	Source
`none`	No es realitzen comprovacions d’autoritat externa (només política de l’espai de noms local)	`NamespaceAuthorityMode::None`F:crates/decision-gate-config/src/config.rs L1056-L1115
`assetcore_http`	Valida l’espai de noms mitjançant l’API HTTP del daemon d’escriptura d’Asset Core	`NamespaceAuthorityMode::AssetcoreHttp`F:crates/decision-gate-config/src/config.rs L1056-L1115 F:crates/decision-gate-mcp/src/namespace_authority.rs L67-L159

Quan assetcore_http està habilitat, DG valida els espais de noms emetent una sol·licitud GET a /{base_url}/v1/write/namespaces/{resolved_id}. HTTP 200 = permès; 404 o 401/403 = denegat; altres estats i errors de transport es tracten com a no disponibles (fallada tancada).F:crates/decision-gate-mcp/src/namespace_authority.rs L130-L158

Les sol·licituds d’autoritat d’Asset Core poden incloure un token de portador opcional i un x-correlation-id header derivat de l’encapçalament de correlació proporcionat pel client insegur quan estigui disponible (recaient en l’id de sol·licitud JSON-RPC o en l’id de correlació emès pel servidor). Els IDs de correlació del client són estrictament validats i rebutjats quan són invàlids; només es reenvien valors netejats a l’autoritat de l’espai de noms per prevenir la injecció d’encapçalaments i l’engany de registres.F:crates/decision-gate-mcp/src/tools.rs L2821-L2852 F:crates/decision-gate-mcp/src/namespace_authority.rs L103-L126 F:crates/decision-gate-mcp/src/server.rs L1648-L1657

Restricció d’integració: el mode dev-permissive és prohibit quan namespace.authority.mode = assetcore_http per evitar debilitar la seguretat del namespace en desplegaments integrats.F:crates/decision-gate-config/src/config.rs L580-L603

Regles del Namespace Asset Core

Els identificadors de l’espai de noms són numèrics a tot arreu (>= 1). La validació de l’autoritat d’Asset Core és directa i no aplica cap mapeig ni traducció. Qualsevol fallada de parseig genera un error de validació de l’espai de noms (fail closed).F:crates/decision-gate-config/src/config.rs L1118-L1165 F:crates/decision-gate-mcp/src/namespace_authority.rs L130-L158

La validació de configuració imposa els ajustos requerits d’Asset Core (URL base, rangs de temps d’espera) quan s’habilita l’autoritat d’Asset Core.F:crates/decision-gate-config/src/config.rs L1118-L1165

Postura de fallida

Les fallades de l’autoritat de l’espai de noms es mapegen de la següent manera:

Entrada de namespace no vàlida -> InvalidParams (error de l’agent)
Autoritat denegada o no disponible -> Unauthorized (fallada tancada)

Això assegura que els espais de noms que falten i les interrupcions a la font es tractin com a fallades d’accés en lloc de camins permesos.F:crates/decision-gate-mcp/src/tools.rs L3217-L3222

Registre RBAC/ACL

Resolució Principal

El registre ACL es basa en un principal derivat del context d’autenticació MCP:

AuthContext.principal_id() resolves to subject, token fingerprint, or a AuthContext.principal_id() es resol a subjecte, empremta del token o una etiqueta de reserva estable (local/token/mtls).
Principal profiles are configured in server.auth.principals, each with Els perfils principals es configuren a server.auth.principals, cadascun amb una classe de política opcional i vinculacions de rol.
Role bindings can be globally scoped or restricted to a tenant and/or Les vinculacions de rol poden tenir un abast global o estar restringides a un inquilí i/o un espai de noms.

Referències d’implementació:

Derivació de l’id principal.F:crates/decision-gate-mcp/src/auth.rs L181-L216
Configuració i validació principals.F:crates/decision-gate-config/src/config.rs L802-L977
Resolutor de mapeig principal i lògica d’abastament de rols.F:crates/decision-gate-mcp/src/registry_acl.rs L54-L143

Política ACL integrada

La política integrada és la predeterminada (schema_registry.acl.mode = builtin). El comportament és intencionadament conservador i ancorat en noms de rol canònics:

Llegir (Llista/Obtenir) permès quan el principal té qualsevol de:

TenantAdmin, NamespaceOwner, NamespaceAdmin, NamespaceWriter, TenantAdmin, NamespaceOwner, NamespaceAdmin, NamespaceWriter, NamespaceReader, SchemaManager

Escriure (Registrar) permès quan:

TenantAdmin, NamespaceOwner o NamespaceAdmin; O bé
La classe SchemaManager i la classe de política no és prod

Si no s’especifica cap classe de política, es tracta com a prod (fallar tancat per a les escriptures de SchemaManager).F:crates/decision-gate-mcp/src/registry_acl.rs L218-L283

Política ACL Personalitzada

La política personalitzada (schema_registry.acl.mode = custom) avalua les regles en ordre i retorna la primera coincidència. Una regla coincideix quan totes les dimensions no buides coincideixen:

acció
llogater
espai de noms
subjecte (id principal)
rols (coincidència de rol delimitat)
classe de política

Si no coincideixen regles, s’aplica l’efecte per defecte (allow o deny). F:crates/decision-gate-mcp/src/registry_acl.rs L287-L339 F:crates/decision-gate-config/src/config.rs L1723-L1812

Requisit de Signatura

El registre ACL pot requerir metadades de signatura de l’esquema:

schema_registry.acl.require_signing = true enforces presence of signing schema_registry.acl.require_signing = true imposa la presència de metadades de signing en els registres d’esquema.
Missing or empty signing metadata is rejected as unauthorized before registry La manca o l’absència de metadades de signatura es rebutja com a no autoritzada abans de la mutació del registre. F:crates/decision-gate-config/src/config.rs L1768-L1785 F:crates/decision-gate-mcp/src/tools.rs L3032-L3041

Fluixos de Decisió d’Autorització

Flux d’Aplicació de l’Espai de Noms (Tots els Eines Amb Àmbit d’Espai de Noms)

Request
  -> Tool auth (DefaultToolAuthz)
  -> ensure_namespace_allowed
     -> default namespace guard
     -> namespace authority check (optional)
  -> tool execution

El guardià de l’espai de noms per defecte s’executa abans de les comprovacions d’autoritat per evitar qualsevol retrocés o desviament implícit.F:crates/decision-gate-mcp/src/tools.rs L2821-L2841

Flux d’ACL del Registre (schemas_register/list/get)

Request
  -> Tool auth (DefaultToolAuthz)
  -> ensure_namespace_allowed
  -> ensure_registry_access
     -> resolve principal (auth context -> profile)
     -> evaluate registry ACL (builtin or custom)
     -> emit registry audit event
  -> validate signing metadata (optional)
  -> registry mutation or read