Zum Hauptinhalt springen
Ein Truthlocks Proof Bundle enthält Nachweise für unterstützte kryptografische Prüfungen eines Datensatzes. Die Offline-Verifizierung erfordert die entsprechende Nutzlast, ein unterstütztes Format sowie unabhängig vertrauenswürdige Aussteller- und Protokollschlüssel. Es stellt weder den aktuellen Widerrufsstatus, die Autorität des Ausstellers, die faktische Wahrheit noch das Eintreten einer realen Handlung fest.
SPEZIFIKATION v1.0

1. Übersicht

Ein Truthlocks Proof Bundle ist ein portables Nachweisdokument. Verwenden Sie das Format und den Verifizierer, die für den Endpunkt dokumentiert sind, der es erstellt hat. CBOR-Unterstützung ist unten als zukünftige Erweiterung aufgeführt, nicht als Garantie für aktuelle Exporte. Beweismittel können Attestierungsdaten, Schlüsselreferenzen und Transparenzprotokollnachweise umfassen. Verifizieren Sie die Signatur und die Protokollaufnahme separat; fehlende Beweismittel dürfen nicht als bestandene Prüfung gemeldet werden. Vertrauen Sie niemals einem öffentlichen Schlüssel allein, weil er im Bundle enthalten ist: Etablieren Sie den autorisierten Schlüssel über einen vertrauenswürdigen Kanal. Das untenstehende Schema ist eine Referenzbeschreibung; gleichen Sie die tatsächliche Exportversion und ihren signierten Byte-Vertrag ab, bevor Sie einen Verifizierer implementieren.

2. Bundle-Struktur

Proof-Bundles werden als JSON-Objekte serialisiert und folgen diesem Schema:

3. Felddefinitionen

3.1 Kopfzeile

3.1.1 Bundle-Integritäts-Hash

3.2 Attestierung

3.3 Nachweise (Transparenzprotokoll)

3.4 Ausstellerzertifikat

4. Verifizierungsalgorithmus

Um ein Truthlocks Proof Bundle zu verifizieren, führen Sie die folgenden Schritte der Reihe nach aus. Wenn ein Schritt fehlschlägt, ist das Bundle ungültig.

Schritt 1: Integrität des Bundles validieren

Berechnen Sie den SHA-256-Hash aller Bundle-Felder mit Ausnahme von bundle_hash_b64url und bundle_signature. Dekodieren Sie den bundle_hash_b64url-Wert mit Base64url und vergleichen Sie ihn mit Ihrem berechneten Hash. Wenn sie nicht übereinstimmen, wurde das Bundle manipuliert.

Schritt 2: Attestierungssignatur überprüfen

Verwenden Sie den öffentlichen Schlüssel von issuer_certificate.public_key_der und den in attestation.signature_format angegebenen Algorithmus, um attestation.signature mit der kanonischen Bestätigungsnutzlast (alle Bestätigungsfelder außer signature und status) zu überprüfen.

Schritt 3: Inhaltshash überprüfen

Wenn Sie die Originaldatei haben, berechnen Sie ihren SHA-256-Hash und vergleichen Sie ihn mit attestation.content_hash. Dies bestätigt, dass die Datei seit der Attestierung nicht geändert wurde. Wenn ein document_hash-Wert vorhanden ist, können Sie ihn auch mit Ihrem berechneten Hash vergleichen. Der document_hash ist ein vorab berechneter SHA-256-Hex-Hash, den der Minter zum Zeitpunkt der Prägung übergeben hat, was eine zusätzliche Integritätsprüfung unabhängig von der Payload-Kodierung bietet.

Schritt 4: Überprüfung der Aufnahme in das Transparenzprotokoll

Für jeden Eintrag in proofs überprüfen Sie den Merkle-Inklusionsbeweis. Beginnend mit leaf_hash an Position leaf_index, berechnen Sie den Root neu, indem Sie mit jedem Geschwisterknoten in inclusion_proof hashen. Das Ergebnis muss mit root_hash übereinstimmen.

Schritt 5: Schlüsselgültigkeit überprüfen

Bestätigen Sie, dass issuer_certificate.valid_from ≤ attestation.issued_at ≤ issuer_certificate.valid_until (falls vorhanden).

5. Unterstützte Algorithmen

6. Verifizierungstools

Proof-Bundles können mit einer dieser Methoden verifiziert werden:
  • CLI: truthlock verify -b bundle.json -f original-file --trusted-log-key "$TRUTHLOCKS_LOG_PUBLIC_KEY" --trusted-issuer-key "$TRUTHLOCKS_ISSUER_PUBLIC_KEY". Pinnen Sie beide öffentlichen Schlüssel unabhängig vom Bundle. Offline-Prüfungen stellen den aktuellen Widerrufsstatus nicht fest.
  • Web: Hochladen unter verify.truthlocks.com/proof/[id]
  • SDK: client.verify.verifyBundle(bundleJson, fileBuffer)
  • Manuell: Befolgen Sie den obigen Verifizierungsalgorithmus mit jeder Ed25519/ECDSA-Bibliothek

7. Erweiterungspunkte

Das Feld metadata im Attestierungsobjekt ist erweiterbar. Benutzerdefinierte Schemata können zusätzliche Felder enthalten, ohne die Verifizierung zu beeinträchtigen. Der Kernverifizierungsalgorithmus hängt nur von content_hash, signature und den Transparenzprotokoll-Nachweisen ab. Zukünftige Formatversionen können einführen:
  • CBOR-Kodierung für kompakte binäre Darstellung
  • Multi-Attestierungs-Bundles (Stapelverifizierung)
  • Konsistenznachweise über mehrere Protokolle hinweg
  • Nachweise des Widerrufsstatus (eingebettet)

8. Designprinzipien

  • Eigenständig: Keine Netzwerkzugriff für die Verifizierung erforderlich
  • Vertrauensminimiert: Verifizierbar, auch wenn Truthlocks den Betrieb einstellt
  • Vorwärtskompatibel: Unbekannte Felder werden von älteren Verifizierern ignoriert
  • Deterministisch: Kanonische JSON-Kodierung gewährleistet konsistentes Hashing
  • Offen: Verwendet standardmäßige kryptografische Primitive (keine proprietären Formate)