| H05 |
Own-server route groups reject an identity before its MCP/admin body is buffered or dispatched. |
OwnServerSecuritySettings (host.routes), OwnServerPerimeter, AegisServer.serve; OwnServerPerimeterTest.routeAdmissionUsesIdentityAndRouteGroupBeforeAnyBodyIsNeeded, GatewayHostTest.ownHostRouteGroupsAndCorsRunBeforeMcpDispatch |
local JDK HTTP server |
recorded |
perimeter or host binding change |
| H06 |
Browser preflight uses exact origins and cannot advertise an origin the common MCP handler rejects. |
OwnServerSecuritySettings (host.cors), OwnServerPerimeter.preflight, AegisServer.preflight; OwnServerPerimeterTest.corsPolicyUsesExactOriginsAndHeaderNormalization, GatewayHostTest.corsPreflightCannotAdvertiseAnOriginTheMcpHandlerRejects |
local JDK HTTP server |
recorded |
CORS or origin-check change |
| H07 |
Own-server OAuth protected-resource metadata follows RFC 9728 and is bound to the JWT audience unless explicitly escaped. |
ProtectedResourceMetadata, OwnServerSecuritySettings (host.oauth); ProtectedResourceMetadataTest (both modules), OwnServerSecuritySettingsTest.oauthMetadataRequiresAudienceBindingUnlessExplicitlyEscaped |
local JDK HTTP server |
recorded |
OAuth metadata or identity change |
| H10 |
In the retained 2026-10-05 run, the dated knox-bundle jar loaded in a stock Apache Knox 3.0.0 gateway process and governed MCP calls end to end: Knox demo-LDAP authentication and AclsAuthz admitted the route, Aegis denied a reader’s destructive call, required an independent approval and a dry-run receipt, executed the approved delete on a real ZooKeeper 3.9.3 server, and refused the replay; both audit journals verified. |
ZooKeeperFrontDoorsTest (OWN_HOST and KNOX); retained run, knox-bundle SHA-256 0726C4CE71D23856F8FE9A58BE2C80E7FC7E4AE740ED70E8ECC8CBFB2617B780 |
stock Knox 3.0.0 (bin/gateway.jar) with the bundle in ext/, real ZooKeeper 3.9.3, 2026-10-05 |
verified-historical |
any extension, bundle, Knox version or candidate change |
| H08 |
The Knox bundle contains the Aegis engine, MCP, OTLP, configuration and PostgreSQL state modules, the PostgreSQL driver and the extension, and no Knox, servlet, JAX-RS, Jersey, Jackson or SnakeYAML class. |
aegis-knox3-extension/pom.xml shade include list; KnoxPackagingBoundaryTest.builtHostsShareAegisGovernanceButNotHostImplementations reads the built knox-bundle jar |
built jar in the default reactor |
recorded |
shade list or dependency change |
| S12 |
derby-local persists durable local governance state for one process, with exact nonce and rate semantics. |
aegis-state-derby, StateStoreFactory; DerbyStateStoreTest, GatewayHostTest.derbyLocalStateProviderIsDiscoveredByTheOwnServer |
Apache Derby 10.16.1.1 embedded |
recorded |
state store or Derby version change |
| S13 |
A quarantined MCP/HTTP/plugin source contributes no callable tool and must identify its evidence reference. |
sources[].trust, GatewayFactory.SourceBuild.bind; GatewayFactoryTest.sourceTrustQuarantineHidesEveryToolUntilOperatorConfigActivatesTheSource |
deterministic configuration test |
recorded |
source binding change |
| S14 |
In the historical 2026-10-08 managed PostgreSQL run, two PostgreSQL providers reportedly shared nonce/rate state, and persistence, expiration, escaped scans, invalid rate requests, environment-named credentials, and signed serial high-water rollback protection behaved as described. The engine version was not retained, and the run is not candidate or active-active certification. |
PostgresStateStoreIT; PostgreSQL validation evidence |
temporary managed PostgreSQL instance, deleted after the run; no immutable raw artifact retained |
recorded |
state provider, PostgreSQL version, candidate release, or deployment topology change |
| S15 |
In the historical 2026-10-03 run, two gateway processes using one postgres namespace reportedly shared approvals, single-use approval and receipt nonces, signed serial high-water state, and rate windows. The run did not cover replication, failover, or a release candidate. |
TwoGatewayProcessesPostgresIT; two-gateway evidence |
two Main JVMs, real PostgreSQL 17.6 on loopback; no immutable raw artifact retained |
recorded |
state provider, approval or rate code, PostgreSQL version, or candidate release change |
| S16 |
With audit.checkpoint the journal exports its head on a record count, a timer, open and close; it refuses to reopen a journal that is shorter than or different at the last exported head without exporting anything, and --verify-audit --checkpoints reports truncation and regeneration that the chain alone accepts. |
HashChainFileAuditSink, AuditCheckpointVerifier, Main; AuditCheckpointTest, MainAndSettingsTest.auditCheckpointsAreWrittenFromConfigAndCheckedFromTheCommandLine, AuditCheckpointAndManifestConfigTest |
deterministic file tests |
recorded |
audit sink, checkpoint format or CLI change |
| S17 |
A signed catalog.manifest (Ed25519, verified before parsing) activates exactly its pinned tools in REQUIRE_PINS; a changed definition is quarantined, an edited manifest, another key or another gateway name stops start-up, and a conflicting inline pin is refused. The gateway jar generates keys, creates a manifest from a reviewed GET /aegis/v1/catalog reply, signs and verifies. |
SignedCatalogManifest, GatewayFactory, CatalogManifestCommands; SignedCatalogManifestTest, SignedCatalogManifestFlowTest (real own host), AuditCheckpointAndManifestConfigTest |
JDK Ed25519; real own host on loopback |
recorded |
manifest format, signature algorithm or pin semantics change |
| S18 |
Historical 2026-10-03 OpenBao and 2026-10-05 Vault runs reportedly showed strict secret replacement and fail-closed KV v2 behavior. Neither run retained immutable raw output; Vault namespaces and server TLS were not exercised. |
FileSecretProvider, VaultKvSecretProvider, SecretProviderFactory; SecretProvidersTest, VaultKvSecretProviderIT; OpenBao evidence |
real OpenBao 2.7.1 and Vault 1.17.6 dev servers on loopback |
recorded |
provider code, KV API or OpenBao/Vault version change |
| H12 |
File-based SPIFFE identity tests exercise real JDK TLS with keytool-issued certificates: mapped URI SANs authenticate, while missing, untrusted, ambiguous, wrong-domain, and unmapped certificates fail. They do not exercise SPIRE Workload API issuance. |
SpiffeIdentity, OwnServerSecuritySettings, AegisServer; SpiffeMutualTlsTest (real TLS), SpiffeIdentityTest |
JDK TLS with keytool-issued certificates, not SPIRE-issued certificates |
recorded |
identity, TLS host or SVID rule change |
| S20 |
The kafka-admin source creates, describes, lists and deletes topics on a real Kafka 3.9.1 KRaft broker in the default build; a dry run is the broker’s own validateOnly check, creates nothing, and an impossible replication factor is refused by the broker. |
KafkaAdminToolSource; ExampleConfigsTest.kafkaConnectAndAdminClient with RealKafkaBroker |
real broker in its own JVM from aegis-validation-kafka-server |
recorded |
Kafka version or kafka-admin source change |
| G01 |
hooks[].type: project-governance enforces evidence references for configured high-impact actions and denies protected resources. |
ProjectGovernanceGuardrail; ProjectGovernanceGuardrailTest, and ApacheProjectGovernanceProfileTest for the profile build and tool visibility |
deterministic hook tests; profile built in a temporary directory |
recorded |
guardrail setting, hook or profile change |
| S21 |
The historical own-host Keycloak run reportedly gave each caller a per-user RFC 8693 backend token with no inbound-token forwarding, fallback, or token journaling. Current stricter token parsing postdates that run. Knox does not bind the required verified subject token and fails closed. |
TokenExchangeCredentialsTest; examples/adopters/token-exchange/keycloak_e2e.py (evidence) |
Keycloak 26.8.0 standard token exchange, own host; no immutable raw run artifact retained |
recorded |
credential provider, host binding or Keycloak version change |
| S22 |
The a2a source offers an A2A 1.0 agent as one governed tool, applies the source credential, and enforces the card endpoint origin rule. |
A2aToolSourceTest; A2aAgentFrontDoorsTest |
agent on the official a2a-sdk 1.2.1, own host and Knox 3.0.0 |
recorded |
a2a source, A2A protocol or SDK version change |
| S23 |
--openapi-draft produces a configuration that loads, with every tool DESTRUCTIVE and a deny-all policy, from the published Iceberg 1.10.1 REST document; a reviewed tool reaches the real catalog with the document’s schema enforced. |
OpenApiDraftTest, OpenApiDraftCommandTest, OpenApiDraftIcebergTest |
Iceberg 1.10.1 RESTCatalogServer |
recorded |
generator or schema validator change |
| S24 |
A remote schema $ref is never fetched and denies the call; local $refs are enforced and cycles are bounded. |
SchemaRefTest |
deterministic |
recorded |
schema validator change |
| S25 |
Optional serverCatalog: an offline Ed25519-signed register, verified before parsing, decides at startup which configured sources start. Unlisted or changed (source-digest mismatch) sources stop start-up; QUARANTINED or REVOKED sources are never constructed or discovered; only pinned tools are bound; pinning becomes signed-only (an inline or manifest pin the catalog does not carry stops start-up). A break-glass order under a separate key can only reduce capability by quarantining or revoking named sources for at most 24 hours, and an expired order refuses start-up. The gateway jar generates, signs and verifies both files offline. No admin route exists for either. Deterministic tests and the reported four-engine two-door runs are recorded; their target output exists only under ignored target/ paths, and Spark Connect was not run with a catalog. Key custody remains the operator’s. Signed serial rollback protection depends on the configured atomic state-store high-water mark; unnumbered same-key files remain signature-only. |
SignedServerCatalog, BreakGlassContainment, CatalogIntegrity, GatewayFactory, ServerCatalogCommands; SignedServerCatalogTest, ServerCatalogConfigTest, ServerCatalogFlowTest (real own host), AdminApiTest.noRouteRegistersABackendAtRunTime |
JDK Ed25519; real own host on loopback; real Flink 1.20.1, Iceberg 1.10.1, Spark 4.0.1 and Kafka 3.9.1 through the own host and stock Knox 3.0.0 (FlinkFrontDoorsTest, IcebergFrontDoorsTest, SparkFrontDoorsTest, KafkaFrontDoorsTest, run) |
recorded |
catalog or order format, source digest, pin or acceptance semantics change |
| G02 |
The reference PII, secrets and change-window hooks refuse before the backend sees the call, withhold a result carrying a card number, and a stopped hook makes the gateway deny. |
adopters/hooks/test_hooks.py; adopters/hooks/e2e_gateway.py |
gateway jar as a process, CPython http.server backend |
recorded |
hook contract or hook service change |
| G03 |
Security properties S1-S31 that have deterministic tests have a documented focused-suite plan; the product threat model documents assets, DFD, STRIDE by zone, TM01-TM10, and residual risk. The reported 2026-10-05 result is not bound to this review candidate by immutable raw evidence, so it is not current verification. |
SECURITY.md, THREAT-MODEL.md; focused suite and per-class catalogue in SECURITY-VALIDATION.md |
reported JDK 17.0.7 Maven surefire run, 227 selected tests, 0 reported failures (2026-10-05) |
recorded |
any S1-S31 control, host perimeter, approval, egress, audit or identity change; promote only with candidate-bound raw evidence |
| H11 |
The Helm chart renders valid Kubernetes 1.33 manifests, refuses unsafe values, and its rendered configuration starts the gateway with the StatefulSet’s own arguments. |
charts/aegis/ci/start_rendered.py; helm lint, kubeconform |
Helm 4.3.0, kubeconform 0.8.0; no cluster |
recorded |
chart or Dockerfile change |