Bevor Sie beginnen
Wählen Sie in Console Ihren Arbeitsbereich und Ihre Umgebung aus. Besorgen Sie sich einen API-Schlüssel, eine Aussteller-ID und einen aktiven Schlüssel, der für die serverseitige Signierung verfügbar ist. Verwenden Sie den für diesen Schlüssel angezeigten Algorithmus. Die alleinige Registrierung eines öffentlichen Schlüssels gibt dem Signaturdienst nicht seinen privaten Schlüssel. Verwenden Siehttps://sandbox-api.truthlocks.com mit einem Sandbox-Schlüssel (tl_test_). Verwenden Sie https://api.truthlocks.com mit einem Produktionsschlüssel (tl_live_) und einem genehmigten Arbeitsbereich. Ressourcen und Anmeldeinformationen müssen zur selben Umgebung gehören. Senden Sie X-Tenant-ID nicht, um einen Arbeitsbereich auszuwählen: Er wird von Ihren Anmeldeinformationen abgeleitet.
Einen Datensatz prägen
Dieses Beispiel verwendet die Standardbibliothek von Python 3. Legen Sie die vier erforderlichen Umgebungsvariablen über Ihre Shell oder Ihren Secret Manager fest. Setzen SieTRUTHLOCKS_BASE_URL nur, wenn Sie von Sandbox auf Produktion umstellen.
urllib.error.HTTPError aus. Behandeln Sie Fehler und Timeouts in Ihrer Anwendung; bewahren Sie denselben Idempotenzschlüssel und -text auf, wenn Sie ein unsicheres Prägeergebnis erneut versuchen.
Die Antwort verwendet attestation_id, issued_at_unix, signature und log. Sie gibt die Claims nicht als Top-Level-payload wieder. Behalten Sie die Original-Bytes für nachfolgende Integritätsprüfungen bei.
Ergebnis verifizieren
Verwenden Sie die Verifizierungsreferenz mit dem zurückgegebenenattestation_id. Geben Sie payload_b64url an, um die genauen Original-Bytes zu überprüfen, oder document_hash_hex, um einen Dateihash zu vergleichen. Überprüfen Sie verdict und reasons: eine erfolgreiche HTTP-Antwort allein bedeutet nicht, dass der Datensatz gültig ist.
Fehlerbehebung
- 401 oder 403: Überprüfen Sie Anmeldeinformationen, Umgebung, Berechtigungen und die Genehmigung des Arbeitsbereichs.
- 400: Überprüfen Sie UUIDs, den Idempotenz-Header und die ungepolsterte base64url-Kodierung.
- Schlüssel- oder Richtlinienfehler: Bestätigen Sie, dass der Aussteller und der Schlüssel zum Signieren verwendet werden können und der Algorithmus übereinstimmt.
- Timeout: Wiederholen Sie den Vorgang mit dem ursprünglichen Body und dem Idempotenzschlüssel, anstatt eine neue Prägung zu erstellen.

