Passer au contenu principal
Ce guide explique les éléments fondamentaux de la plateforme Truthlocks. Comprendre ces concepts est essentiel pour une intégration efficace.

Locataires

Un locataire est l’unité organisationnelle de niveau supérieur dans Truthlocks. Chaque locataire représente un client ou une organisation distincte avec une isolation complète des données.

Contrôles multi-locataires

  • Isolation des données : Les données de chaque locataire sont complètement isolées au niveau de la base de données
  • Limites de ressources: Les limites de débit et les quotas sont appliqués par locataire
  • Portée des clés API : Les clés API sont liées à un seul locataire et ne peuvent pas accéder aux données d’autres locataires
  • Séparation d’audit : Les journaux d’audit sont partitionnés par locataire

Émetteurs

Un émetteur est une entité qui peut créer et signer des attestations. Les émetteurs représentent des organisations, des institutions ou des services qui font des revendications sur des sujets.

Identité

Chaque émetteur a un domaine vérifié (par exemple, acme.edu) qui établit son identité réelle.

Clés cryptographiques

Les émetteurs enregistrent les clés publiques Ed25519 utilisées pour vérifier les signatures d’attestation.

Statut de confiance

Les nouveaux émetteurs sont activés immédiatement lors de leur création. Les niveaux de confiance supérieurs nécessitent un examen de la demande : ACTIF → SUSPENDU.

Niveau de confiance

BASIC, VERIFIED ou PREMIUM en fonction de la profondeur de la vérification d’identité.

Cycle de vie de l’émetteur

Les nouveaux émetteurs sont activés immédiatement avec le niveau de confiance Basique. Aucune approbation manuelle n’est requise pour commencer à émettre des attestations. Pour passer à un niveau de confiance supérieur (Organisation vérifiée, Entité gouvernementale ou Institution accréditée), soumettez une demande d’émetteur pour examen.

Attestations

Une attestation est une revendication signée cryptographiquement faite par un émetteur à propos d’un sujet. Les attestations sont le primitif central du système Truthlocks.

Structure d’attestation

Propriétés d’attestation

Protections des consommateurs

Une protection du consommateur est une attestation créée via le flux simplifié consumer mint, conçu pour les créateurs individuels. Vous hachez votre fichier côté client (SHA-256) et soumettez le hachage avec des métadonnées telles que le titre, la catégorie et le type de contenu. Truthlocks provisionne automatiquement votre identité de signature lors de la première utilisation. La réponse de frappe du consommateur comprend : Chaque protection génère une page de preuve publique. N’importe qui peut récupérer les métadonnées de la page de preuve via GET /v1/public/proof/{attestation_id} — aucune authentification n’est requise. Ce point de terminaison est conçu pour le rendu des pages de preuve et la génération d’aperçus de liens Open Graph pour les URL partagées. Voir le point de terminaison des métadonnées de preuve pour plus de détails.

Signaux de risque

Un signal de risque est une observation notée provenant d’une source de détection de fraude — empreinte digitale de l’appareil, réputation IP, vérification d’e-mail, analyse de documents ou votre propre moteur de règles. Vous pouvez ingérer des signaux directement via l’API, ou soumettre des événements d’identité bruts et laisser la plateforme les normaliser automatiquement en signaux. Chaque signal comprend :

Normalisation des événements

Au lieu de construire manuellement des signaux de risque, vous pouvez soumettre des événements d’identité bruts — échecs de connexion, signatures invalides, suspects de deepfake — à POST /v1/risk/events. La plateforme mappe automatiquement chaque événement à un type de signal canonique et à un score de risque de base. Consultez la référence de l’API de normalisation des événements d’identité. Les signaux de risque sont entièrement isolés par locataire à l’aide de la sécurité au niveau des lignes et constituent la base du pare-feu d’identité anti-fraude. Consultez le guide des signaux de risque pour les détails d’intégration.

Agents machine

Un agent machine est un agent IA, un bot ou un service automatisé enregistré avec le Protocole d’identité d’agent machine (MAIP). Chaque agent reçoit un identifiant unique (maip-agent:<ulid>) et une paire de clés Ed25519 pour signer les reçus. Les agents opèrent au sein de sessions — des contextes d’exécution de courte durée, liés à une portée et avec expiration automatique. Chaque action qu’un agent entreprend génère un reçu signé cryptographiquement qui s’enchaîne au reçu précédent pour des pistes d’audit infalsifiables. Neuf types de reçus couvrent le cycle de vie complet de l’agent : genèse, délégation, action, révocation, attestation de données, attestation de modèle, conformité, revendication de vérité et vérification. Consultez le guide d’identité machine pour la configuration et le guide d’autorisation d’agent pour le modèle de portée et de session.

Lots de preuves

Un bundle de preuves est un paquet autonome qui inclut tout le nécessaire pour vérifier une attestation hors ligne, sans contacter les serveurs Truthlocks.
Cas d’utilisation : Les bundles de preuves sont idéaux pour les scénarios où les vérificateurs peuvent être hors ligne ou souhaitez vérifier indépendamment sans appels API.

Modèle de vérification

La vérification Truthlocks vérifie plusieurs couches pour déterminer si une attestation doit être approuvée :
1

Vérification cryptographique

Vérifiez que la signature Ed25519 correspond à la charge utile en utilisant la clé publique de l’émetteur clé.
2

Vérification du statut

Vérifiez si l’attestation a été révoquée ou remplacée par l’émetteur. Les attestations remplacées renvoient à leur remplacement via superseded_by_attestation_id.
3

Statut de confiance de l'émetteur

Confirmez que l’émetteur est en statut ACTIF et non suspendu.
4

Validité de la clé

Vérifiez que la clé de signature était active au moment de la création de l’attestation.

Prochaines étapes

Environnements

Découvrez les environnements de développement et de production et leur configuration.

Authentification

Approfondissement des clés API, des jetons JWT et de l’intégration OAuth.