Passer au contenu principal
Un Truthlocks Proof Bundle contient des preuves pour les vérifications cryptographiques prises en charge d’un enregistrement. La vérification hors ligne nécessite la charge utile correspondante, le format pris en charge et des clés d’émetteur et de journal fiables de manière indépendante. Il n’établit pas le statut de révocation actuel, l’autorité de l’émetteur, la vérité factuelle ou si une action réelle a eu lieu.
SPÉCIFICATION v1.0

1. Aperçu

Un Truthlocks Proof Bundle est un document de preuve portable. Utilisez le format et le vérificateur documentés pour le point de terminaison qui l’a produit. Le support CBOR est listé ci-dessous comme une extension future, pas une garantie pour les exportations actuelles. Les preuves peuvent inclure des données d’attestation, des références de clés et des preuves de journal de transparence. Vérifiez la signature et l’inclusion du journal séparément ; l’absence de preuve ne doit pas être signalée comme une vérification réussie. Ne faites jamais confiance à une clé publique uniquement parce qu’elle est incluse dans le paquet : établissez la clé autorisée via un canal de confiance. Le schéma ci-dessous est une description de référence ; faites correspondre la version d’exportation réelle et son contrat d’octets signés avant d’implémenter un vérificateur.

2. Structure du bundle

Les paquets de preuves sont sérialisés sous forme d’objets JSON et suivent ce schéma :

3. Définitions des champs

3.1 En-tête

3.1.1 Hachage d’intégrité du bundle

3.2 Attestation

3.3 Preuves (Journal de Transparence)

3.4 Certificat de l’émetteur

4. Algorithme de vérification

Pour vérifier un paquet de preuves Truthlocks, exécutez les étapes suivantes dans l’ordre. Si une étape échoue, le paquet est invalide.

Étape 1: Valider l’intégrité du bundle

Calculez le hachage SHA-256 de tous les champs du paquet, à l’exclusion de bundle_hash_b64url et bundle_signature. Décodez la valeur bundle_hash_b64url en Base64url et comparez-la à votre hachage calculé. S’ils ne correspondent pas, le paquet a été altéré.

Étape 2: Vérifier la signature de l’attestation

En utilisant la clé publique de issuer_certificate.public_key_der et l’algorithme spécifié dans attestation.signature_format, vérifiez attestation.signature par rapport à la charge utile d’attestation canonique (tous les champs d’attestation sauf signature et status).

Étape 3 : Vérifier le hachage du contenu

Si vous avez le fichier original, calculez son hachage SHA-256 et comparez-le à attestation.content_hash. Cela confirme que le fichier n’a pas été modifié depuis l’attestation. Si une valeur document_hash est présente, vous pouvez également la comparer à votre hachage calculé. Le document_hash est un hachage hexadécimal SHA-256 pré-calculé que le minteur a transmis au moment de la frappe, fournissant une vérification d’intégrité supplémentaire indépendante de l’encodage de la charge utile.

Étape 4 : Vérifier l’inclusion dans le journal de transparence

Pour chaque entrée dans proofs, vérifiez la preuve d’inclusion Merkle. À partir de leaf_hash à la position leaf_index, recalculez la racine en hachant avec chaque frère dans inclusion_proof. Le résultat doit correspondre à root_hash.

Étape 5 : Vérifier la validité de la clé

Confirmez que issuer_certificate.valid_from ≤ attestation.issued_at ≤ issuer_certificate.valid_until (si présent).

5. Algorithmes pris en charge

6. Outils de vérification

Les paquets de preuves peuvent être vérifiés en utilisant l’une de ces méthodes :
  • CLI : truthlock verify -b bundle.json -f original-file --trusted-log-key "$TRUTHLOCKS_LOG_PUBLIC_KEY" --trusted-issuer-key "$TRUTHLOCKS_ISSUER_PUBLIC_KEY". Épinglez les deux clés publiques indépendamment du paquet. Les vérifications hors ligne n’établissent pas le statut de révocation actuel.
  • Web : Télécharger sur verify.truthlocks.com/proof/[id]
  • SDK: client.verify.verifyBundle(bundleJson, fileBuffer)
  • Manuel : Suivez l’algorithme de vérification ci-dessus avec n’importe quelle bibliothèque Ed25519/ECDSA

7. Points d’extension

Le champ metadata dans l’objet d’attestation est extensible. Les schémas personnalisés peuvent inclure des champs supplémentaires sans rompre la vérification. L’algorithme de vérification principal ne dépend que de content_hash, signature et des preuves du journal de transparence. Les futures versions de format pourront introduire :
  • Encodage CBOR pour une représentation binaire compacte
  • Lots d’attestations multiples (vérification par lots)
  • Preuves de cohérence inter-journaux
  • Preuves de statut de révocation (intégrées)

8. Principes de conception

  • Autonome: Aucun accès réseau requis pour la vérification
  • Confiance minimisée : Vérifiable même si Truthlocks cesse de fonctionner
  • Compatible avec les versions futures : Les champs inconnus sont ignorés par les anciens vérificateurs
  • Déterministe : L’encodage JSON canonique assure un hachage cohérent
  • Ouvert: Utilise des primitives cryptographiques standard (pas de formats propriétaires)