Passer au contenu principal
Une attestation signe une charge utile et enregistre son hachage. La vérification contrôle l’intégrité cryptographique et l’état de l’enregistrement ; elle n’établit pas de manière indépendante que les affirmations de l’émetteur sont vraies.

Avant de commencer

Dans Console, sélectionnez votre espace de travail et votre environnement. Obtenez une clé API, un ID d’émetteur et une clé active disponible pour la signature côté serveur. Utilisez l’algorithme indiqué pour cette clé. L’enregistrement d’une clé publique seule ne donne pas au service de signature sa clé privée. Utilisez https://sandbox-api.truthlocks.com avec une clé de bac à sable (tl_test_). Utilisez https://api.truthlocks.com avec une clé de production (tl_live_) et un espace de travail approuvé. Les ressources et les identifiants doivent appartenir au même environnement. N’envoyez pas X-Tenant-ID pour choisir un espace de travail : il est dérivé de vos identifiants.

Créer un enregistrement

Cet exemple utilise la bibliothèque standard de Python 3. Définissez les quatre variables d’environnement requises via votre shell ou votre gestionnaire de secrets. Définissez TRUTHLOCKS_BASE_URL uniquement si vous passez du sandbox à la production.
Les erreurs HTTP déclenchent urllib.error.HTTPError. Gérez les erreurs et les délais d’attente dans votre application ; conservez la même clé d’idempotence et le même corps lors de la nouvelle tentative d’un résultat de frappe incertain. La réponse utilise attestation_id, issued_at_unix, signature et log. Elle ne renvoie pas les revendications en tant que payload de niveau supérieur. Conservez les octets d’origine pour les vérifications d’intégrité ultérieures.

Vérifier le résultat

Utilisez la référence de vérification avec le attestation_id retourné. Fournissez payload_b64url pour vérifier les octets originaux exacts, ou document_hash_hex pour comparer un hachage de fichier. Inspectez verdict et reasons : une réponse HTTP réussie seule ne signifie pas que l’enregistrement est valide.

Dépannage

  • 401 ou 403 : vérifiez les identifiants, l’environnement, les autorisations et l’approbation de l’espace de travail.
  • 400 : vérifiez les UUID, l’en-tête d’idempotence et l’encodage base64url non rembourré.
  • Erreur de clé ou de politique : confirmez que l’émetteur et la clé sont utilisables pour la signature et que l’algorithme correspond.
  • Délai d’attente : réessayez avec le corps original et la clé d’idempotence, plutôt que de créer une nouvelle attestation.
Continuez avec les paramètres de frappe, l’authentification et les environnements.