Renouveler et révoquer
La clé et le secret de signature se renouvellent depuis la page Connexion du module API, par un administrateur de l'espace. Votre application garde ses valeurs dans son environnement, que Kult Lab ne peut pas écrire : le renouvellement laisse donc sept jours pour déployer les nouvelles.
Renouveler
Le commerçant clique « Renouveler »
Kult Lab affiche une nouvelle KULTLAB_API_KEY et un nouveau KULTLAB_SIGNING_SECRET, une seule
fois. Les anciennes valeurs continuent de fonctionner pendant sept jours ; la page affiche la date
de fin.
Vous déployez les deux nouvelles valeurs ensemble
Une clé ne fonctionne qu'avec le secret créé en même temps qu'elle. Une requête faite avec la nouvelle
clé et l'ancien secret, ou l'inverse, reçoit un 401 signature_other_secret : un fichier
d'environnement à moitié mis à jour se reconnaît à ce code.
Kult Lab passe au nouveau secret
Les commandes que Kult Lab vous envoie restent signées avec l'ancien secret jusqu'à votre première requête faite avec la nouvelle clé. À partir de là, elles sont signées avec le nouveau. Pendant les sept jours, Kult Lab accepte vos réponses signées avec l'un ou l'autre.
L'ancienne clé expire
Au bout de sept jours, l'ancienne clé reçoit 401 invalid_key. Elle reste valable jusque-là même
après le passage au nouveau secret, pour qu'un déploiement progressif garde ses anciens processus en
service le temps de les remplacer.
Pour que le passage se fasse sans coupure, faites vérifier les signatures des commandes avec les deux secrets pendant le déploiement : l'ancien et le nouveau, dans cet ordre.
Faites aussi dire bonjour à votre application dès son démarrage : sa première requête sur la nouvelle clé est ce qui fait passer Kult Lab au nouveau secret.
Renouveler une seconde fois
Un nouveau « Renouveler » pendant les sept jours garde toujours la paire que votre application utilise :
- si votre application n'a encore jamais utilisé la nouvelle clé, cette clé est remplacée par une autre, l'ancienne paire continue de fonctionner, et les sept jours repartent ;
- si elle l'a déjà utilisée, la plus ancienne paire est révoquée aussitôt, et la nouvelle devient l'ancienne pour sept jours.
Deux paires au plus fonctionnent à la fois.
Révoquer maintenant
Une clé perdue ou exposée se coupe sans attendre : Révoquer maintenant, pendant les sept jours, met fin à l'ancienne clé et à l'ancien secret sur-le-champ. Votre application ne parle plus à Kult Lab tant qu'elle n'a pas les nouvelles valeurs : déployez-les aussitôt.
Perdre les deux valeurs
Une valeur perdue avant d'avoir été copiée ne se retrouve pas : Kult Lab n'en garde que l'empreinte. Renouvelez, puis révoquez l'ancienne si elle a pu fuir.
La déconnexion
Déconnecter l'application révoque la clé et le secret avec la connexion, anciens compris. Une nouvelle connexion crée deux nouvelles valeurs.