Aller au contenu

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.

GuideDéveloppeur
Accès requis
Droit « Gérer les secrets » ; « Redémarrer un service » pour l'étape de redémarrage ; « Accès infrastructure en production » en prod
Durée
10 min, réparties sur un peu plus d'une heure
Voir en Markdown

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

  1. Ouvrez l'environnement, onglet Configuration, filtre Secret.
  2. 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.
  3. Saisissez la nouvelle valeur, ou choisissez Uploader un fichier s'il s'agit d'un fichier.
  4. 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.

Voir aussi