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.

