Clés et environnements
La forme d’une clé
Section intitulée « La forme d’une clé »Une clé d’API s’écrit tano_<environnement>_<identifiant>_<secret> :
| Environnement | Début de la clé | Usage |
|---|---|---|
| Bac à sable | tano_sandbox_… |
intégration et essais |
| Test | tano_test_… |
tests automatisés |
| Production | tano_prod_… |
vos clients réels |
L’environnement est porté par la clé, pas par l’adresse appelée : l’API est la même
(https://api.tano.africa). Une clé de bac à sable ne sert pas en production, et l’inverse non
plus. Une clé de production collée par erreur dans une configuration de test se voit donc au
premier coup d’œil.
La dernière partie de la clé, le secret, sert à signer les requêtes.
Le bac à sable
Section intitulée « Le bac à sable »Avec une clé tano_sandbox_…, tout suit les chemins de la production — statuts, webhooks,
erreurs —, mais rien n’est facturé et rien ne part chez une vraie personne. Ce qui est simulé
dépend du module :
- Vérification d’identité : le nom de famille déclaré choisit le résultat, et le parcours se simule sans téléphone ;
- Signature électronique : aucun message, le code
000000, un document spécimen ; - Cachet électronique : un spécimen, sans cachet.
Créer une clé
Section intitulée « Créer une clé »Dans la console, menu Clés d’API : choisissez l’environnement et les services autorisés. La clé complète n’est affichée qu’une seule fois. Tano n’en conserve qu’une empreinte : une clé perdue ne se retrouve pas, elle se remplace.
Permissions
Section intitulée « Permissions »Au-delà de ses services, une clé ne porte que les permissions qu’on lui accorde à sa création :
| Permission | Ce qu’elle ouvre |
|---|---|
personal_data |
Lire les données personnelles et les images d’un dossier. Chaque lecture est inscrite au journal des consultations. Lire le nom des signataires d’une demande de signature. |
decisions |
Trancher un dossier en revue depuis votre système (POST /v1/cases/{id}/decision). |
administration |
Gérer les clés, les destinations de notification, l’intégration de la page et les parcours. |
Une clé ne crée jamais de clé plus large qu’elle : ni service ni permission qu’elle n’a pas. Les
clés créées avant le 2 octobre 2026 ont reçu administration ; créez-en de plus étroites pour les
systèmes qui n’administrent rien.
Une clé ne voit que les dossiers, les demandes de signature et les cachets de son environnement : une clé de bac à sable ne lit ni ne modifie ceux de production.
Bonnes pratiques
Section intitulée « Bonnes pratiques »- Rangez la clé dans les secrets de votre serveur (variables d’environnement, coffre de secrets), jamais dans le code source ni dans une application mobile.
- Une clé par système qui appelle Tano : vous pourrez en révoquer une sans arrêter les autres.
- Vous pouvez restreindre une clé à une liste d’adresses IP.
- Révoquez sans attendre une clé exposée (console, ou
DELETE /v1/api-keys/{id}).
© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]