Faire tourner un secret
Remplacer la valeur d'un secret sans interruption, en tenant compte du délai de rafraîchissement de la copie du cluster.
- Required access
- Droit « Gérer les secrets » ; « Redémarrer un service » pour l'étape de redémarrage ; « Accès infrastructure en production » en prod
- Duration
- 10 min, réparties sur un peu plus d'une heure
This page has not been translated yet and is shown in French.
Faire tourner un secret, c'est remplacer sa valeur (clé API, mot de passe d'un service tiers, certificat) avant qu'elle n'expire ou après une fuite. La console remplace la valeur dans le coffre et redémarre les services qui l'utilisent. Comme la copie du secret dans le cluster se rafraîchit toutes les heures, la rotation se fait en deux temps.
Avant de commencer
- Le secret a été créé dans l'onglet Configuration de l'environnement. Les identifiants des bases et des buckets, marqués Lecture seule (auto-générée), ne se remplacent pas ici : voir Bases de données.
- Votre fournisseur permet d'avoir deux valeurs valides en même temps pendant la bascule (deux clés API actives, par exemple).
Remplacer la valeur
Créer la nouvelle valeur chez le fournisseur
Générez la nouvelle clé chez votre fournisseur, sans révoquer l'ancienne.
Remplacer le secret dans la console
- Ouvrez l'environnement, onglet Configuration, filtre Secret.
- Sur la ligne du secret, cliquez sur l'icône Modifier. Le dialogue Remplacer la valeur du secret s'ouvre : la valeur actuelle n'est pas relisible.
- Saisissez la nouvelle valeur, ou choisissez Uploader un fichier s'il s'agit d'un fichier.
- Cliquez sur Enregistrer.
Résultat : le message Secret mis à jour. Les services qui l'utilisent sont en cours de redémarrage. s'affiche. Un déploiement Secret mis à jour apparaît sur chacun de ces services.
Attendre le rafraîchissement
Attendez une heure. Pendant ce délai, la copie du secret dans le cluster peut encore contenir l'ancienne valeur ; les services redémarrés à l'étape précédente l'utilisent peut-être encore. C'est pourquoi l'ancienne valeur doit rester valide.
Redémarrer les services
Pour chaque service qui utilise le secret, ouvrez sa page et cliquez sur Redémarrer.
Résultat : le service démarre avec la nouvelle valeur.
Révoquer l'ancienne valeur
Vérifiez que les services fonctionnent avec la nouvelle valeur (étape suivante), puis révoquez l'ancienne chez votre fournisseur.
Vérifier le résultat
- Dans l'onglet Déploiements de chaque service, le dernier déploiement est Réussi.
- Chez votre fournisseur, l'ancienne clé ne reçoit plus d'appels avant que vous la révoquiez ; la nouvelle en reçoit.
- Dans l'onglet Logs, aucune erreur d'authentification vers le service tiers.
Après une fuite
Si le secret a fui, la priorité est de couper l'accès : révoquez l'ancienne valeur dès la nouvelle enregistrée, puis redémarrez les services une heure plus tard. Entre les deux, les services qui ont gardé l'ancienne valeur échouent sur leurs appels au service tiers ; prévenez vos utilisateurs si nécessaire.