Aller au contenu

Clés et environnements

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.

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 :

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.

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.

  • 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]