Rotation
Il n'existe pas d'opération de rotation : on remplace une clé en en créant une nouvelle puis en révoquant l'ancienne. La procédure sans interruption, et ce qui survit au changement.
Noryo Merchant API ne propose pas d'opération de rotation : aucun bouton, aucune route ne transforme une clé en une autre. Remplacer une clé se fait en deux gestes visibles, dont chacun laisse sa trace : créer une nouvelle clé, puis révoquer l'ancienne. Plusieurs clés actives peuvent coexister dans un workspace, ce qui permet de changer de clé sans interruption.
Quand remplacer une clé
- Le secret est perdu : il n'est jamais récupérable.
- Le secret a fuité, ou vous le soupçonnez : voir aussi Sécurité des secrets.
- Une personne ou un prestataire qui connaissait le secret ne doit plus y avoir accès.
- Vous voulez changer les scopes d'une clé : les scopes se choisissent à la création.
1. Créer la nouvelle clé
Dans la page Clés d'API de Platform, créez une clé dans le même workspace et le même environnement, avec les scopes requis. Copiez le secret : il n'est affiché qu'une fois.
Platform émet des clés Sandbox : c'est à elles que cette procédure s'applique telle quelle.
2. Déployer la nouvelle clé
Remplacez la valeur dans votre gestionnaire de secrets ou votre variable d'environnement, puis redéployez. Pendant la transition, les deux clés fonctionnent.
3. Vérifier que l'ancienne clé ne sert plus
La liste des clés affiche la date de dernier usage de chaque clé. Attendez que la nouvelle clé soit utilisée et que l'ancienne ne le soit plus. La page Usage liste aussi les appels récents réglés, avec leur request_id.
4. Révoquer l'ancienne clé
Révoquez-la dans la même page. Dès la requête suivante, elle est refusée en 401 invalid_api_key. La révocation ne se défait pas depuis Platform. Voir Révocation.
Ce qui survit au changement de clé
Les résultats, l'idempotence et la déduplication appartiennent au workspace et à l'environnement, pas à la clé. Changer de clé dans le même workspace ne casse donc rien :
| Élément | Après le changement de clé |
|---|---|
| Résultats | Les enrichment_id créés avec l'ancienne clé restent lisibles avec la nouvelle |
Idempotency-Key | Une reprise envoyée avec la nouvelle clé, la même Idempotency-Key et le même corps rejoue la réponse mémorisée, dans la fenêtre de 24 heures |
external_transaction_id | La déduplication continue : une transaction déjà réglée n'est pas facturée une seconde fois |
| Seau de débit | La nouvelle clé a son propre seau, plein au départ |
| Scopes | Ceux choisis à la création de la nouvelle clé |
Une clé créée dans un autre workspace ne voit ni les résultats, ni les clés d'idempotence, ni la déduplication de l'ancien. Remplacez toujours une clé par une clé du même workspace.
Ce qui n'existe pas
Il n'y a ni rotation automatique, ni expiration programmée, ni période de grâce après révocation : une clé reste valide jusqu'à ce que vous la révoquiez, et cesse de l'être dès qu'elle est révoquée.
Publié le 2026-10-09 10:18 UTC (version 2).