Ein Beweismittel-Paket-Manifest benennt den versiegelten Export, den Mandantenbereich, aufbewahrte Artefakte, den Merkle-Root, Aufzeichnungslinks und Integritätsanker. Verwenden Sie es, wenn ein Evidence-Room-Export zwischen KLA und einem Offline-Prüfer verschoben wird.
Paket-Spezifikation · evidence-room-bundle-v1 · Manifest-Format 1.0
01
Die JSON Schema- und synthetischen Dateien werden von unveränderlichen v1-Artefakt-URLs bereitgestellt. Das Produktionsbundle behält bundle.json und manifest.json als separate Dateien.
/ai-agent-evidence-bundle-manifest/v1/schema.jsonDownload Bundle summary exampleThe bundle.json top-level seal summary for the valid synthetic export./ai-agent-evidence-bundle-manifest/v1/examples/bundle-json-synthetic.jsonDownload Valid manifest exampleA populated manifest linked to the audit execution record example./ai-agent-evidence-bundle-manifest/v1/examples/bundle-manifest-synthetic.jsonDownload Tampered manifest exampleOne artifact digest changed while the sealed digest and Merkle root remain stale./ai-agent-evidence-bundle-manifest/v1/examples/bundle-manifest-synthetic-tampered.jsonDownload 02
Der Exporteur schreibt ein Verzeichnis mit einer Zusammenfassung, Manifest, separatem JWS, eingebetteten öffentlichen Schlüsseln, Zeitstempelnachweis, Ledger-Anker und exportierten Artefakten.
<bundle-dir>/ bundle.json manifest.json manifest.jws.json keys/jwks.json timestamp.ots ledger_anchor.json artifacts/exports/... artifacts/index/artifact_index.json
03
Erforderliche Felder stammen aus dem aktuellen versiegelten Bündelvertrag. Bedingte Felder erscheinen, wenn der Produzent den entsprechenden Umfang oder Details der Nachweisfabrik aufzeichnet. Optionale Felder enthalten zusätzliche Exportkontexte.
| Feld | Status | Zweck |
|---|---|---|
| formatVersion | Erforderlich | Wählt das versiegelte Manifestformat aus; der aktuelle Produzent gibt 1.0 aus. |
| bundleSpec | Erforderlich | Identifiziert evidence-room-bundle-v1. |
| exportId | Erforderlich | Bindet das Manifest an einen Export. |
| tenantId | Erforderlich | Gibt den vom Export getragenen Mandantenbereich an. |
| createdAt | Erforderlich | Erfasst, wann der Exportdatensatz erstellt wurde. |
| exporter.name | Erforderlich | Identifiziert den Exporteur, der das Bündel erstellt hat. |
| exporter.version | Erforderlich | Identifiziert die Version des Exporteurs. |
| export.exportId | Erforderlich | Muss mit der Export-ID auf oberster Ebene übereinstimmen. |
| export.tenantId | Erforderlich | Muss mit der Mandanten-ID auf oberster Ebene übereinstimmen. |
| export.environment | Erforderlich | Erfasst das Label der Quellumgebung. |
| export.platformVersion | Erforderlich | Erfasst die vom Produzenten bereitgestellte Plattformversion. |
| export.requestedBy | Erforderlich | Erfasst die Referenz des Exportanforderers. |
| export.requestedAt | Erforderlich | Erfasst die Zeit der Exportanforderung. |
| export.sealedAt | Erforderlich | Erfasst, wann das Siegel erstellt wurde. |
| export.traceIds | Erforderlich | Trägt die mit dem Export verbundenen Spurenreferenzen. |
| export.policySnapshots | Erforderlich | Trägt die vom Exporteur ausgewählten Richtlinien-Snapshot-Referenzen. |
| Feld | Status | Zweck |
|---|---|---|
| artifacts[] | Erforderlich | Listet jedes exportierte Artefakt auf, das durch die Merkle-Wurzel abgedeckt ist. |
| artifacts[].path | Erforderlich | Löst das Artefakt im Bundle-Verzeichnis auf. |
| artifacts[].sha256 | Erforderlich | Gibt den SHA-256-Hash der Artefakt-Bytes an. |
| artifacts[].bytes or sizeBytes | Erforderlich | Ermöglicht dem Prüfer, die deklarierte Größe mit der Datei zu vergleichen. |
| artifacts[].contentType | Erforderlich | Beschreibt den Inhaltstyp der exportierten Datei. |
| artifacts[].class | Optional | Beschriftet eine Artefaktklasse wie Ausführungsnachweis oder Artefakt-Index. |
| artifacts[].provenance | Optional | Trägt Metadaten zur Herkunft des Produzenten des Artefakts. |
| artifacts[].createdAt | Optional | Zeichnet auf, wann das Artefakt erstellt wurde. |
| artifacts[].source | Optional | Verbindet das Artefakt mit einem Quelltyp und Referenz. |
| record.decisionRequestId | Optional | Verbindet das Bündel mit der maßgeblichen Entscheidungsanfrage. |
| record.executionId | Optional | Verbindet das Bündel mit einer Ausführung. |
| record.lineageRecordId | Optional | Verbindet das Bündel mit der Ausführungshistorie. |
| scope | Optional | Beschreibt die Exportpopulation oder Zeitgrenze, wenn angegeben. |
| profile | Optional | Zeichnet das vom Produzenten gewählte Evidenzprofil auf: vollständig, redigiert oder minimal. |
| omissions | Optional | Zeichnet deklarierte Auslassungen auf. |
| redactions | Optional | Datensätze erklärten Redaktions-Metadaten. |
| Feld | Status | Zweck |
|---|---|---|
| merkle.algorithm | Erforderlich | Identifiziert kla-merkle-v1. |
| merkle.rootSha256 | Erforderlich | Verpflichtet sich zum sortierten Artefaktpfad und Digest-Set. |
| integrity.manifestHashAlgo | Erforderlich | Identifiziert SHA-256 für den Manifestdigest. |
| integrity.manifestHash | Erforderlich | Speichert den rohen hexadezimalen Digest des normalisierten Manifests. |
| integrity.signatureAlgo | Erforderlich | Identifiziert den Signaturalgorithmus des Manifests, derzeit ES256. |
| integrity.signaturePayload | Erforderlich | Gibt an, dass die Signatur-Nutzlast MANIFEST_HASH ist. |
| integrity.signingKeyId | Erforderlich | Identifiziert die Referenz des Signaturschlüssels des Herstellers. |
| integrity.anchors[] | Erforderlich | Listet Zeitstempel- und Ledger-Ankerdatensätze auf. |
| evidenceFactory.request.requestedArtifacts | Bedingt | Bestimmt, ob Empfangssignaturen und Ledger-Hash-Kette erforderlich sind. |
| evidenceFactory.contractVersion | Bedingt | Identifiziert den Evidence Factory-Anfragevertrag, wenn eine Fabrikanfrage eingebettet ist. |
| evidenceFactory.request.tenantId | Bedingt | Trägt die Tenant-Bindung für die eingebettete Evidence Factory-Anfrage. |
| evidenceFactory.request.actor | Bedingt | Identifiziert den menschlichen oder dienstleistenden Akteur, der den Fabrik-Export angefordert hat. |
| evidenceFactory.request.source | Bedingt | Identifiziert die KLA-Oberfläche, die den Fabrik-Export angefordert hat. |
| evidenceFactory.request.scope | Bedingt | Trägt die Chronologie und Selektoren, die für den Fabrik-Export verwendet wurden. |
| evidenceFactory.request.redactionProfile | Bedingt | Gibt das Redaktionsprofil des Fabrik-Exports an. |
| evidenceFactory.request.idempotencyKey | Bedingt | Trägt den Idempotenzschlüssel der Anfrage. |
04
Dieses synthetische Manifest verwendet denselben Exportbezeichner und dieselben Aufzeichnungslinks wie die vollständige Ausführungsreferenz. Die begleitende Bündelzusammenfassung wiederholt die Siegelwerte, die der Prüfer vergleicht.
{
"bundle": {
"exportId": "bundle_manifest_synthetic_20260721_01",
"tenantId": "tenant_synthetic_001",
"manifestDigestSha256": "1bae725ba61cf55f94310e37ee491d3d52145d98da8580df63e0b91fa9968117",
"merkleRootSha256": "cb170b4d42403ed97c4818a723ebd93607902a84159deb4555357bc73a432102",
"artifactCount": 2
},
"manifest": {
"formatVersion": "1.0",
"bundleSpec": "evidence-room-bundle-v1",
"record": {
"decisionRequestId": "dr_01JZ8V4Q4N9K6T2D5B3M7X1S0E",
"executionId": "run_01JZ8V4K2D9A6N3P7M5R1C8X0E",
"lineageRecordId": "lin_01JZ8V4R8A2C6N9Q3S5D7M1T0E"
},
"artifacts": [
{
"path": "artifacts/exports/evidence-export-synthetic.json",
"sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"bytes": 128,
"sizeBytes": 128,
"contentType": "application/json",
"class": "execution-evidence",
"source": {
"type": "synthetic",
"ref": "run_01JZ8V4K2D9A6N3P7M5R1C8X0E"
}
},
{
"path": "artifacts/index/artifact_index.json",
"sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"bytes": 64,
"sizeBytes": 64,
"contentType": "application/json",
"class": "artifact-index",
"source": {
"type": "synthetic",
"ref": "bundle_manifest_synthetic_20260721_01"
}
}
],
"integrity": {
"manifestHashAlgo": "SHA-256",
"manifestHash": "1bae725ba61cf55f94310e37ee491d3d52145d98da8580df63e0b91fa9968117",
"signatureAlgo": "ES256",
"signaturePayload": "MANIFEST_HASH",
"signingKeyId": "sample-key-sek-synthetic-01",
"anchors": [
{
"type": "immudb",
"status": "NOT_PRESENT",
"reason": "IMMUDB_DISABLED",
"ledger": "immudb",
"proofPath": "ledger_anchor.json",
"valueHash": ""
},
{
"type": "ots",
"status": "PRESENT",
"proofPath": "timestamp.ots"
}
]
}
}
}Valid seal values
The manifest digest is 1bae725ba61cf55f94310e37ee491d3d52145d98da8580df63e0b91fa9968117. The Merkle root is cb170b4d42403ed97c4818a723ebd93607902a84159deb4555357bc73a432102.
Cross-reference
The record fields and export identifier connect this file to the complete sanitized execution record and its evidence.manifest_ref.
05
Der Produktionsprüfer behandelt Bundle-Bytes und Manifeste als nicht vertrauenswürdige Eingaben und schlägt fehl („fail closed“), wenn eine erforderliche Überprüfung fehlschlägt. Das Verfahren umfasst sechs benannte Überprüfungen.
manifest-signature
Normalisiert das Manifest, berechnet die JCS/SHA-256-Prüfsumme, vergleicht die Zusammenfassungen von Manifest und Bundle, überprüft die abgetrennte Nutzlast, validiert ES256 SEK- und TEK-Signaturen gegen eingebettete nicht zurückgezogene Schlüssel und überprüft deklarierte Ankerpfade.
receipt-signatures
Wenn Governance EvidenceEntry[]-Material vorhanden ist, überprüft die Ed25519-Belegsignaturen, eingebettete Schlüssel, den Widerrufsstatus und prevReceiptHash-Links. Nicht unterschriebenes Belegmaterial folgt dem expliziten Pfad für nicht unterschriebene Belege des Prüfers.
ledger-hash-chain
Wenn Governance EvidenceEntry[] Material vorhanden ist, werden Ledger-Eintrags-Hashes neu berechnet, aufgenommene Redaktions-Transformierungen angewendet, Eintrags-Hashes überprüft und eine verbundene Ledger-Komponente benötigt.
merkle-inclusion
Löst jeden deklarierten Pfad im Bundle auf, vergleicht Dateigröße und SHA-256, berechnet kla-merkle-v1 neu, überprüft Einschlussnachweise, wenn vorhanden, und vergleicht die Wurzel und die Anzahl der Artefakte mit bundle.json.
ots-anchor
Parst timestamp.ots, überprüft dessen SHA-256-Verpflichtung gegen das Manifest-Digest und akzeptiert einen ausstehenden Kalendernachweis oder eine Bitcoin-Bestätigung innerhalb der Vertrauensgrenze des Offline-Prüfers.
pii-absence
Läuft nur, wenn der Aufrufer verbotene Marker bereitstellt. Es scannt Bundle-Dateien als Bytes, meldet maskierte Marker-Digests und schlägt fehl, wenn eine aufgeführte Datei oder das Manifest nicht gelesen werden kann.
The declared digest reproduces from the normalized manifest. The declared Merkle root is computed from the two sorted artifact entries. A complete on-disk bundle supplies the bytes and detached signatures for the remaining checks.
The tampered file changes one artifact sha256 from the valid example while retaining the original manifest digest and Merkle root. The manifest remains schema-valid. Digest comparison fails, and the full merkle-inclusion check also compares the declaration with the artifact bytes.
06
Diese Repository-Quellen definieren den Produzenten, den Manifestvertrag, den Prüfer und die hier beschriebenen einzelnen Überprüfungen.
| Contract | Repository source path | Mapping | Status |
|---|---|---|---|
| BundleManifest / BundleJson | packages/evidence-verifier/src/types.ts | Definiert Manifest, Zusammenfassung, Artefakt, Anker, Datensatz, JWS, JWKS, Überprüfungs- und Verifikationsformen. | Aktuelle Quelle |
| Versiegelter Manifestvertrag | packages/evidence-contract/src/index.ts | Validiert die erforderlichen Felder des Produzenten: formatVersion, export, artefakt, Merkle, Datensatz und Integrität. | Aktuelle Quelle |
| Bundle-Produzent | services/evidence-exporter/src/export-api.ts | Schreibt bundle.json, manifest.json, losgelöste JWS, JWKS, OTS-Beweis, Ledger-Anker und Artefaktindex. | Aktueller Produzent |
| Verifizierungsorchestrierung | packages/evidence-verifier/src/verifier.ts | Lädt nicht vertrauenswürdige Bytes, wählt bedingte Prüfungen und schlägt über die anwendbare Ergebnismenge hinweg fehl. | Aktueller Prüfer |
| Manifest- und Merkle-Prüfungen | packages/evidence-verifier/src/checks/manifest-signature.ts; packages/evidence-verifier/src/checks/merkle-inclusion.ts | Überprüft Konsistenz von Digest/Signaturen/Zusammenfassungen und Artefakt-Bytes, Pfade, Größen, Hashes und Wurzel. | Aktuelle Prüfungen |
| Beweis- und Ankerprüfungen | packages/evidence-verifier/src/checks/receipt-signatures.ts; packages/evidence-verifier/src/checks/ledger-hash-chain.ts; packages/evidence-verifier/src/checks/ots-anchor.ts; packages/evidence-verifier/src/checks/pii-absence.ts | Überprüft bedingten Empfang und Ledger-Beweise sowie OTS- und Opt-in-Markierungsscans. | Aktuelle Prüfungen |
Implementation source
The links above point to the current repository contract, exporter, and verifier. The documentation-layer reference helper lives at /ai-agent-evidence-bundle-manifest/v1/verify.ts; the production procedure remains the package verifier.
07
The implementation boundary stays visible in the answers below.
bundle.json ist die kurze Siegelzusammenfassung. manifest.json ist das vollständige Exportmanifest mit Artefakteinträgen, Verknüpfungen zu Aufzeichnungen, Umfangsmetadaten und Integritätsankern. Der Prüfer vergleicht ihre gemeinsamen Bezeichner, den Digest, die Merkle-Wurzel und die Anzahl der Artefakte.
Der Prüfer benötigt sie, wenn die Evidenzfabrik Ausführungsevidenz oder Roh-Evidenz anfordert, wenn das Feld angeforderte Artefakte fehlt oder wenn Evidenzdateien oder Evidenzladefehler vorhanden sind. Ein Bundle ohne diese Signale erhält für die beiden Prüfungen ausdrücklich die Ergebnisse nicht erforderlich.
Das Manifest bindet den Export an seinen deklarierten Mandanten und die Datensatzverweise. Autorisierungs- und Mandanten-Isolationsentscheidungen werden von den Diensten bewertet, die die Datensätze erstellen und bereitstellen. Der Bundles-Verifizierer prüft die interne Konsistenz und Integrität des versiegelten Bundles.
Es ändert einen Artefakt-SHA256, während der ursprüngliche Merkle-Wert und das Manifest-Digest beibehalten werden. Das Manifest bleibt strukturell gültig, während der Vergleich der Digests fehlschlägt. Eine vollständige Überprüfung auf der Festplatte vergleicht außerdem die geänderte Deklaration mit den Artefakt-Bytes und dem Merkle-Wert.
Die Offline-Überprüfungen analysieren die lokalen Zeitstempel- und Ledger-Ankerdateien. Die OTS-Überprüfung kann ausstehende oder Bitcoin-bewiesene Beweisstrukturen erkennen. Die Netzbestätigung gehört zu einem separaten operativen Verfahren.
Start with the action request, policy decision, approval, and audit event schemas. Then inspect the complete execution record and evidence-room sample.