This record is the focused S1 to S31 selection from 2026-10-05: 227 tests, 0 failures. The properties are in SECURITY.md and the abuse scenarios are in THREAT-MODEL.md. The release-candidate repeat is on the roadmap.
Companion claim row: CLAIMS-MATRIX.md G03.
| Part | Value |
|---|---|
| Date | 2026-10-05 |
| OS | Windows 11 x64 |
| JDK used by Maven surefire | Oracle JDK 17.0.7 (mvn -version java.home) |
| JDK on PATH | Temurin 21.0.11 LTS (not used by this Maven invocation) |
| Maven | 3.9.0 |
| External services in this suite | None (no Docker, Keycloak, Vault, or Postgres) |
| Network | Default build; tests use loopback servers started by JUnit where needed |
We selected JUnit 5 classes named in the “Tested in” column of SECURITY.md, plus host/Knox/SPIFFE classes required to exercise perimeter and confused-deputy proofs:
The exact reported 2026-10-05 selection was the following one-line command. It does not include
ScopeEnforcementTest, which was added to this evidence catalogue after that run.
mvn -B -pl aegis-engine,aegis-mcp-security,aegis-gateway,aegis-knox3-extension,aegis-mcp,aegis-config -am test -Dsurefire.failIfNoSpecifiedTests=false -Dtest=GovernanceEngineTest,SeparationOfDutiesTest,ControlsTest,OutputGuardTest,HashChainFileAuditSinkTest,JwtVerifierTest,OwnServerPerimeterTest,GatewayHostTest,AdminApiTest,HooksTest,ContentGovernanceTest,ContentGovernorTest,RemoteHookTest,SchemaRefTest,JsonPointerExpressionTest,OwnServerSecuritySettingsTest,ProtectedResourceMetadataTest,SpiffeIdentityTest,SpiffeMutualTlsTest,TokenExchangeCredentialsTest,SignedCatalogManifestTest,SignedCatalogManifestFlowTest,AuditCheckpointTest,KnoxAclRouteScopeTest,KnoxExtensionTest,ProjectGovernanceGuardrailTest,ExistingMcpServerProxyTest,McpServerHandlerTest,JsonTest,ObservabilityTest,ContentHooksTest,GatewayFactoryTest,SecretProvidersTest
-Dsurefire.failIfNoSpecifiedTests=false was required because -am pulled intermediate modules that
did not contain any of the named classes.
BUILD SUCCESS.Recorded result, not candidate attestation.
| Module | Selected tests | Failures | Errors | Skipped |
|---|---|---|---|---|
aegis-engine |
115 | 0 | 0 | 0 |
aegis-mcp |
38 | 0 | 0 | 0 |
aegis-config |
27 | 0 | 0 | 0 |
aegis-mcp-guardrails |
2 | 0 | 0 | 0 |
aegis-mcp-security |
23 | 0 | 0 | 0 |
aegis-gateway |
17 | 0 | 0 | 0 |
aegis-knox3-extension |
5 | 0 | 0 | 0 |
| Total | 227 | 0 | 0 | 0 |
Wall clock: about 4 minutes 28 seconds. Reported outcome: BUILD SUCCESS. Repeating this selection on the release candidate is on the roadmap.
This section is the detailed “how we proved it” catalogue. Assertions are summarized from the test names and the S-property contracts they anchor; see the Java sources under each module for exact expects.
| Test class | Module | How it is performed | What it proves | S / TM / OWASP |
|---|---|---|---|---|
JwtVerifierTest |
mcp-security | Builds tokens with wrong iss, aud, expiry, skew, alg: none, algorithm confusion |
Forged or malformed JWTs are refused fail-closed | S2; Spoofing; MCP07 |
OwnServerPerimeterTest |
mcp-security | Route admission and CORS settings unit checks | Perimeter config is strict before dispatch | S21 |
OwnServerSecuritySettingsTest |
mcp-security | OAuth metadata vs audience binding | Metadata cannot drift from aud without explicit escape |
S24 |
ProtectedResourceMetadataTest |
mcp-security + gateway | Serves metadata; 401 points at it; scope challenge | Wire-level OAuth resource metadata behaviour | S24, S26 |
SpiffeIdentityTest |
mcp-security | Maps X.509-SVID rules (domains, SANs) | Unmapped or wrong trust domain denied | Spoofing residual path |
SpiffeMutualTlsTest |
gateway | Real TLS listener with clientAuth: require |
Handshake fails without trusted cert; mapped file-based SVID becomes caller | H12, not SPIRE Workload API evidence |
GatewayHostTest |
gateway | Starts real AegisServer on loopback; HS256 caller |
Auth required; forged/alg:none rejected; backend auth=null; metrics group gate; CORS cannot widen; oversized body rejected; self-approval 403; derby-local discovery |
S1, S2, S3, S17, S21, S23; TM03 |
KnoxExtensionTest |
knox3 | Knox extension wiring with Aegis engine | Knox Subject path still requires Aegis governance | S1, S27 story |
KnoxAclRouteScopeTest |
knox3 | Real Knox 3.0.0 AclsAuthz filter |
Knox admits by user/group/IP and is body-blind; Aegis still denies destructive body | TM03 confused deputy |
| Test class | Module | How it is performed | What it proves | S / TM / OWASP |
|---|---|---|---|---|
GovernanceEngineTest |
engine | In-memory engine with fixture tools | Control order; default deny; approval/receipt binding; intent before execute; credential after allow; pin change; rates/breakers | S3-S7, S9; TM01-TM03; MCP01/02/03/08 |
SeparationOfDutiesTest |
engine | Requester vs approver under NFKC/case; delegation | Self-approval refused; delegated cannot approve; journal-first decisions | S5, S6; TM06; MCP02 |
ControlsTest |
engine | Egress CIDRs, nested URLs, screening phrases, sql-readonly shapes, output bounds | SSRF deny; injection screen; READ mutate denied; redaction | S4, S8, S11, S12; TM01, TM04, TM05; MCP05/06 |
OutputGuardTest |
engine | Secret-shaped strings and size limits | Redaction and bounds before model delivery | S11; MCP01/MCP10 |
HooksTest / ContentHooksTest |
engine | Hook throws, empty, timeout, AUDIT mode | Fail-closed; cannot invent deny codes; AUDIT cannot alter | S19; MCP07 containment |
ObservabilityTest |
engine | Failing listener / metrics shape | Observability cannot change decisions or leak args | S18; MCP08 |
SchemaRefTest |
engine | Remote $ref, cycles, local refs |
Remote ref never fetched; deny | S30; Tampering |
JsonPointerExpressionTest |
engine | Pointer filters without functions | No expression-language filters | S30 |
JsonTest |
engine | Duplicate keys, depth/size | Parse bounds | S10 |
ProjectGovernanceGuardrailTest |
guardrails | Protected resources + evidence refs | High-impact evidence requirements | S25 |
| Test class | Module | How it is performed | What it proves | S / TM / OWASP |
|---|---|---|---|---|
SignedCatalogManifestTest |
engine | Ed25519 manifest create/verify | Bad signature / wrong gateway refused | S9; TM02; MCP03 |
SignedCatalogManifestFlowTest |
gateway | Own-host flow with signed pins | REQUIRE_PINS activates only signed tools | S9; TM02 |
GatewayFactoryTest |
config | sources[].trust: QUARANTINED |
No callable tools until activated | S22; TM02/TM09; MCP04/09 contain |
ExistingMcpServerProxyTest |
mcp | Local upstream MCP; redirect to metadata; sampling | Egress on redirect; no sampling/elicitation to client; pin behaviour | S8, S9, S15; TM02, TM04, TM08 |
ContentGovernanceTest / ContentGovernorTest |
mcp / engine | resources/prompts/complete paths | Governed like tools; URI routing; bounds | S7, S11, S12, S13 |
McpServerHandlerTest |
mcp | Era headers, sessions, capacity | Caller-bound sessions; header/body agreement | S10, S14; MCP07/10 |
AdminApiTest |
mcp | Origin, non-approver, delegated accept, journal fail, verify | CSRF Origin; SoD on catalog accept; verify API shape | S17, S28; TM10 |
| Test class | Module | How it is performed | What it proves | S / TM / OWASP |
|---|---|---|---|---|
HashChainFileAuditSinkTest |
engine | Append, verify, second writer | Chain verifies; second writer refused | S7, S28; TM10; MCP08 |
AuditCheckpointTest |
engine | Export head; truncated reopen | Checkpoint detects truncation/regeneration | S7; TM10 |
| Test class | Module | How it is performed | What it proves | S / TM / OWASP |
|---|---|---|---|---|
TokenExchangeCredentialsTest |
config | Mock token endpoint; subject mismatch; failure | Inbound JWT only to exchange URL; no fallback; subject check | S29; MCP01 |
SecretProvidersTest |
config | File secret source; failure shapes | Strict replacement; no secret echo on failure | claims S18 (file half) |
RemoteHookTest |
config | Hook URL off egress list; payload flags | Start-up refuse; args not included by default | S20 |
These classes and methods were added after the 2026-10-05 selection. They are not part of its 227
reported tests or its result. Add them to the -Dtest list for the next candidate-bound run.
| Test class or method | Module | How it is performed | What it proves | S / TM / OWASP |
|---|---|---|---|---|
GovernanceEngineTest.missingActionScopeDeniesBeforeCredentialsOrBackendAndFullGrantProceeds |
engine | Caller with no, partial (case-changed) and full scopes on a tool with two actionScopes |
SCOPE_DENIED names the missing scopes; no credential lookup or backend call until every exact scope is present |
S26; MCP02 |
SeparationOfDutiesTest.tokensFromAnotherGatewaySharingTheKeyAreRejected (extended) |
engine | Same action with and without an action-scope requirement | A changed scope requirement is a different binding; scope order is canonical; unscoped bindings keep their earlier digest | S5 |
JwtVerifierTest.validTokenMapsSubjectGroupsIssuerAndVerifiedScopes, ScopeEnforcementTest |
mcp-security | Verified scope and scp claims |
The admitted caller carries verified scope names, never token material | S26 |
TokenExchangeCredentialsTest subject-token cases |
config | Readable issued JWTs with missing, blank, non-string, or mismatched sub; compact five-part JWE; opaque tokens; checkSubject: false |
Current readable JWT subject checks fail closed, compact JWE is refused, opaque tokens remain accepted, and the explicit compatibility escape is tested | S29; MCP01 |
GatewayFactoryTest.actionScopesAreTrustedToolRequirementsAndDenyBeforeBackendAccess |
config | tools[].actionScopes in configuration |
Wiring, denial, and refusal of malformed scope tokens | S26 |
SignedServerCatalogTest |
engine | Ed25519 server catalog and break-glass order: tamper, wrong key, replay as another document kind, malformed records, window checks; signed-only CatalogIntegrity |
Verify-before-parse; ACTIVE needs digest and pins; non-ACTIVE vouches for nothing; orders only contain; no learning or acceptance under a catalog | S22; TM02/TM09; MCP03/MCP04/MCP09 |
ServerCatalogConfigTest |
config | Two sources, signed catalog, break-glass orders | Unlisted, changed or duplicated sources refuse start; non-ACTIVE sources are never started; unpinned tools are never bound; catalog cannot weaken pinning; separate incident key; expired order refuses start |
S22 |
ServerCatalogFlowTest |
gateway | Real own host: reviewed catalog reply, --server-catalog-create, --manifest-sign, --server-catalog-verify, restart, --break-glass-* |
The jar’s offline generator and verifier produce files the gateway enforces | S22 |
AdminApiTest.noRouteRegistersABackendAtRunTime (extended) |
mcp | Every method on /server-catalog and /break-glass paths |
No run-time route reads, replaces or bypasses either file | S30 |
| Threat ID | Scenario | Primary proof in this suite |
|---|---|---|
| TM01 | Prompt-injected destructive call | ControlsTest + GovernanceEngineTest + SoD |
| TM02 | Tool poisoning | Catalog pin/quarantine + signed manifest tests |
| TM03 | Confused deputy | KnoxAclRouteScopeTest + credential-after-allow tests |
| TM04 | SSRF | ControlsTest + ExistingMcpServerProxyTest |
| TM05 | READ mutates | sql-readonly / controls paths |
| TM06 | Self-approval | SeparationOfDutiesTest |
| TM07 | Shadow MCP outside Aegis | Not positively testable here (external) |
| TM08 | Over-sharing after allow | OutputGuardTest, content + proxy tests |
| TM09 | Dependency provenance | Partial (quarantine/SBOM); scanner not run |
| TM10 | Audit truncation | Hash-chain + checkpoint + verify API tests |
| OWASP item | Proof in this suite | Not claimed |
|---|---|---|
| MCP01 | Token non-passthrough, redaction, exchange unit tests | IdP storage/rotation |
| MCP02 | Default deny, SoD, scopes | IdP group lifecycle |
| MCP03 | Pin/quarantine/manifest | TOFU first-definition truth |
| MCP04 | Quarantine + egress unit tests | Vuln gate, signing, SCANOSS |
| MCP05 | Typed/safe converters + sql-readonly | OS sandbox of stdio/jobs |
| MCP06 | Screening + approval gates | Prevention of novel injection |
| MCP07 | JWT, perimeter, admin, Knox | Production IdP policy |
| MCP08 | Journal + metrics non-interference | Off-host SIEM |
| MCP09 | Containment for configured sources only | Discovery of bypass servers |
| MCP10 | Output bounds, no sampling | Client memory after allow |
The full 227-test selection passed.
| Item | Where it lives instead |
|---|---|
| Keycloak live token exchange | TOKEN-EXCHANGE-KEYCLOAK.md |
| OpenBao / Vault KV live | SECRETS-OPENBAO.md |
| PostgreSQL shared state | POSTGRES-RDS-VALIDATION.md, POSTGRES-TWO-GATEWAYS.md |
KnoxPackagingBoundaryTest jar contents |
examples/aegis-examples (not in this -pl set) |
A2aToolSourceTest |
aegis-source-a2a module suite / FrontDoors |
| AI provenance scanner | Roadmap |
| Companion records | Token exchange, secrets, and PostgreSQL have their own evidence pages above |
From the repository root, on JDK 17+ with Maven 3.9+, run the current selection. This command adds the post-2026-10-05 classes to the historical selection:
mvn -B -pl aegis-engine,aegis-mcp-security,aegis-gateway,aegis-knox3-extension,aegis-mcp,aegis-config -am test -Dsurefire.failIfNoSpecifiedTests=false -Dtest=GovernanceEngineTest,SeparationOfDutiesTest,ControlsTest,OutputGuardTest,HashChainFileAuditSinkTest,JwtVerifierTest,ScopeEnforcementTest,OwnServerPerimeterTest,GatewayHostTest,AdminApiTest,HooksTest,ContentGovernanceTest,ContentGovernorTest,RemoteHookTest,SchemaRefTest,JsonPointerExpressionTest,OwnServerSecuritySettingsTest,ProtectedResourceMetadataTest,SpiffeIdentityTest,SpiffeMutualTlsTest,TokenExchangeCredentialsTest,SignedCatalogManifestTest,SignedCatalogManifestFlowTest,AuditCheckpointTest,KnoxAclRouteScopeTest,KnoxExtensionTest,ProjectGovernanceGuardrailTest,ExistingMcpServerProxyTest,McpServerHandlerTest,JsonTest,ObservabilityTest,ContentHooksTest,GatewayFactoryTest,SecretProvidersTest,SignedServerCatalogTest,ServerCatalogConfigTest,ServerCatalogFlowTest
Confirm the current reactor succeeds and review the totals produced by that run. The 2026-10-05 selection reported 227 tests and 0 failures. Repeating it on the release candidate is on the roadmap.