Comment renouveler le mot de passe Redis
Ce guide explique comment générer un nouveau mot de passe pour un cluster Redis depuis la console Hikube, par exemple après la perte du mot de passe initial ou dans le cadre d'une rotation périodique.
Prérequis
- Un cluster Redis avec l'authentification activée. Sur un cluster sans authentification, la rotation est refusée : activez d'abord l'Authentification requise depuis Modifier (voir Modifier les ressources).
- La liste des applications qui utilisent ce cluster, pour les mettre à jour juste après le redémarrage
- Pour l'onglet API : une clé d'API
admindu projet et les variablesHIKUBE_API,HIKUBE_API_KEYetPROJECT_ID(voir Préparer l'environnement) ; les exemples utilisentcurletjq
Le nouveau mot de passe ne s'applique qu'après un redémarrage du cluster. D'ici là, les serveurs Redis acceptent encore l'ancien mot de passe et refusent le nouveau. Le redémarrage interrompt brièvement le cluster (environ une minute) : planifiez la rotation dans une fenêtre de maintenance.
Étapes
- Console
- API
1. Ouvrir la section Sécurité
Ouvrez DB & Messaging → Redis, puis le cluster concerné. La section Sécurité permet de générer un nouveau mot de passe global pour ce cluster.
2. Lancer la rotation
- Cliquez sur Effectuer une rotation.
- Dans la fenêtre Rotation du mot de passe, confirmez avec Effectuer la rotation.
3. Copier le nouveau mot de passe
La fenêtre Mot de passe généré affiche le nouveau mot de passe. Copiez-le dans votre gestionnaire de mots de passe : il ne sera plus affiché après la fermeture de la fenêtre.
La fenêtre rappelle : « Le nouveau mot de passe ne sera accepté qu'après un redémarrage du cluster ; d'ici là, les serveurs acceptent encore l'ancien. »
4. Redémarrer le cluster
- Dans la même fenêtre, cliquez sur Redémarrer maintenant, puis confirmez avec Redémarrer.
- Pour redémarrer plus tard, cliquez sur Terminer : la page du cluster affiche le bandeau Redémarrage requis jusqu'au redémarrage, avec un bouton Redémarrer maintenant.
Le cluster est injoignable pendant environ une minute. Voir Redémarrer un cluster.
Les étapes 1 à 3 se font en un appel, sans corps de requête :
curl -sS -X POST "$HIKUBE_API/redis/v1alpha1/projects/$PROJECT_ID/clusters/democache/rotate-password" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq -r '.password'
Le champ password de la réponse contient le mot de passe que le cluster utilisera après son prochain redémarrage. Il n'est renvoyé qu'ici : enregistrez-le aussitôt dans votre gestionnaire de secrets. Sur un cluster sans authentification, la rotation est refusée (code 120206) ; juste après l'activation de l'authentification, réessayez au bout de quelques secondes si la réponse porte le code 120207.
Tant que le cluster n'a pas redémarré, restartRequired vaut true dans GET $HIKUBE_API/redis/v1alpha1/projects/$PROJECT_ID/clusters/democache. Redémarrez-le (étape 4) :
curl -sS -X POST "$HIKUBE_API/redis/v1alpha1/projects/$PROJECT_ID/clusters/democache/restart" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY"
restartRequired repasse à false une fois tous les serveurs redémarrés.
5. Mettre à jour vos applications
Une fois le cluster redémarré, remplacez l'ancien mot de passe dans la configuration de vos applications (variables d'environnement, secrets Kubernetes de vos clusters, fichiers de configuration), puis redémarrez-les si elles ne relisent pas la configuration à chaud. Avant le redémarrage du cluster, le nouveau mot de passe est encore refusé.
Vérification
REDISCLI_AUTH='<nouveau mot de passe>' redis-cli -h <hôte> -p 6379 ping
# PONG
Si la commande répond WRONGPASS, le cluster n'a pas encore redémarré : vérifiez si le bandeau Redémarrage requis est affiché sur la page du cluster.
Pour aller plus loin
- Redémarrer un cluster
- Concepts Redis : authentification
- Dépannage Redis