Méthodes d’authentification
Clés API
Identifiants de longue durée pour la communication de serveur à serveur. Recommandé pour
services backend.
Jetons du porteur (JWT)
Jetons de courte durée pour les utilisateurs authentifiés. Idéal pour les applications frontend
et le contexte utilisateur.
Clés API
Truthlocks propose deux types de clés API selon la façon dont vous utilisez la plateforme :Transmission de votre clé
Incluez votre clé API en utilisant l’un de ces en-têtes :Authorization avec le schéma ApiKey :
X-API-Key est plus courant dans les exemples de cette documentation.
Clés API du locataire
Les clés de locataire sont la méthode d’authentification principale pour les organisations utilisant Truthlocks. Elles sont limitées à un locataire et prennent en charge des permissions granulaires.Structure de clé
Portées
Les clés API du locataire peuvent être restreintes à des permissions spécifiques :Principe du moindre privilège : N’accordez que les portées dont votre application a besoin
a réellement besoin. Une clé avec
attestations:mint seulement ne devrait pas avoir également
users:write.Création d’une clé de locataire
Via la console
- Naviguez vers console.truthlocks.com/api-keys
- Cliquez sur « Créer une clé API »
- Entrez un nom descriptif (par exemple, “Backend de production”)
- Sélectionnez l’environnement (production ou sandbox) et les portées requises
- Copiez la clé immédiatement — elle ne sera plus affichée
Via l’API
Request
Response
Clés API du consommateur
Les clés de consommateur permettent aux utilisateurs individuels d’accéder aux API de protection et de vérification par programmation — par exemple, pour créer des attestations à partir d’un pipeline CI ou intégrer la protection de contenu dans vos propres outils.Détails clés
- Chaque compte prend en charge jusqu’à 5 clés actives.
- Les clés expirent automatiquement après 90 jours.
- Les clés révoquées ou expirées ne peuvent pas être réactivées — créez-en une nouvelle à la place.
Portées fixes
Les clés de consommateur sont émises avec un ensemble fixe de portées qui ne peuvent pas être personnalisées :Création d’une clé consommateur
1
Ouvrir les paramètres
Dans la barre latérale du portail de vérification, allez dans Paramètres > Clés API.
2
Créer une clé
Cliquez sur Créer une clé API, entrez un nom descriptif et confirmez. Le plein
le secret est affiché une seule fois — copiez-le et stockez-le en toute sécurité.
3
Utiliser la clé
Passez la clé dans l’en-tête
X-API-Key avec chaque requête :Jetons Bearer (JWT)
Les jetons JWT sont utilisés lorsque vous devez effectuer des appels API au nom d’un utilisateur authentifié, par exemple à partir d’une application web ou mobile.Utilisation des jetons Bearer
Structure du jeton
Durée de vie du jeton
Authentificateur MFA pour les comptes Console
Dans la Console, ouvrez Paramètres → Sécurité → Authentificateur MFA pour connecter Google Authenticator ou une autre application d’authentification basée sur le temps.- Confirmez votre mot de passe Truthlocks local actuel.
- Scannez le code QR privé, ou entrez la clé de configuration dans votre authentificateur comme un compte basé sur le temps.
- Entrez le code à six chiffres de l’application pour activer l’AMF.
- Enregistrez les dix codes de récupération affichés après confirmation. Ils sont affichés une seule fois, et chaque code fonctionne une fois.
Meilleures pratiques de sécurité
✅ Utiliser la gestion des secrets
Stockez les clés API dans Google Secret Manager, HashiCorp Vault ou similaire. Jamais
coder en dur les clés dans le code de l’application.
✅ Faire pivoter les clés régulièrement
Créez de nouvelles clés et révoquez les anciennes périodiquement. Utilisez des noms descriptifs avec
dates (par exemple, “Backend-2026-Q1”).
✅ Restreindre les portées
N’accordez que les autorisations réellement nécessaires. Examinez et auditez les portées des clés
régulièrement.
❌ Ne jamais exposer en frontend
Les clés API ne doivent jamais être incluses dans le JavaScript côté client. Utilisez des jetons JWT
pour l’authentification frontend.
❌ Ne jamais commettre sur Git
Utilisez des variables d’environnement ou la gestion des secrets. Ajoutez
.env* à
.gitignore.Prochaines étapes
Portail consommateur
Gérez les clés API des consommateurs, les protections et les paramètres.
Environnements
Configuration Sandbox vs. production et URL de base.
RBAC et autorisations
Comprendre les rôles, les permissions et le contrôle d’accès.
Journaux d'audit
Suivez toutes les activités API et les événements de sécurité.

