# 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.

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](/v1.0/bases-de-donnees).
- 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

::::steps
### 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

- [Prise en compte des changements](/v1.0/variables-et-secrets/prise-en-compte-des-changements)
- [Liste de contrôle avant la production](/v1.0/variables-et-secrets/liste-de-controle)
