Faire une rotation d'un secret d'API

Mis à jour le S'applique à : Tous les forfaits
Read in English

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

  1. Ouvrez la page API où l'identifiant est listé.
  2. Sur la ligne de l'identifiant, cliquez sur Rotation.
  3. 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.
  4. Copiez le nouveau client_secret, puis cliquez sur Je l'ai copié. Finaxis l'affiche une seule fois.
  5. Inscrivez le nouveau secret dans le système. Sous Secrets, l'ancien indique Remplacé, expire le avec sa date de fin.
Le menu Rotation de l'identifiant Power BI avec ses deux choix : l'actuel secret expire dans 7 jours, ou maintenant.
La liste Secrets de l'identifiant Power BI après une rotation : l'ancien secret marqué Remplacé, expire le 17 nov. 2026, et le nouveau, jamais utilisé.

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.