Faire une rotation d'un secret d'API
Une rotation donne un nouveau secret à un identifiant d'API pendant que l'ancien fonctionne encore quelques jours, ce qui permet à votre système de passer au nouveau sans interruption. Faites-la avant que le secret expire, quand une personne qui le connaissait part, ou tout de suite s'il a pu fuir.
Avant de commencer
- Un administrateur fait la rotation des secrets des comptes de service dans Paramètres, puis API. Chaque membre fait celle de ses propres identifiants dans Mon profil, puis API.
- Ayez accès au système qui utilise le secret, pour y inscrire le nouveau.
Quand un secret expire
Un secret expire 12 mois après sa création. Sa date d'expiration passe à l'orange 30 jours avant, puis au rouge sept jours avant, et Finaxis vous prévient. Un identifiant garde au plus deux secrets : l'actuel et celui qui le remplace.
Faire la rotation
- Ouvrez la page API où l'identifiant est listé.
- Sur la ligne de l'identifiant, cliquez sur Rotation.
- Choisissez Nouveau secret, l'actuel expire dans 7 jours pour avoir le temps de mettre le système à jour, ou Nouveau secret, l'actuel expire maintenant si le secret a pu fuir.
- Copiez le nouveau client_secret, puis cliquez sur Je l'ai copié. Finaxis l'affiche une seule fois.
- Inscrivez le nouveau secret dans le système. Sous Secrets, l'ancien indique Remplacé, expire le avec sa date de fin.
Le client_id ne change pas : seul le secret change. Pour vérifier que le système utilise le nouveau secret, regardez la mention d'utilisation sous chaque secret, ou le journal des requêtes.
Dépannage
| Situation | Quoi faire |
|---|---|
| Vous avez perdu le secret | Faites une rotation. Choisissez expire maintenant si quelqu'un d'autre a pu l'avoir, sinon expire dans 7 jours. |
| Le système a cessé de fonctionner après une rotation | L'ancien secret a expiré avant que le système reçoive le nouveau. Inscrivez le nouveau secret dans le système. Si vous l'avez perdu aussi, refaites une rotation. |
| Il n'y a pas de bouton Rotation | Dans Mon profil, vous ne voyez que vos propres identifiants. Les comptes de service sont dans les Paramètres, pour les administrateurs. |
Un secret a pu fuir et vous avez besoin d'aide? Écrivez à support@finaxis.ai, et notre équipe vous aidera.
Articles liés
Vous ne trouvez pas ce que vous cherchez?
Notre équipe de soutien est là pour vous aider.