Rotation des secrets¶
Principes : un secret partagé doit changer aux deux endroits dans l'ordre qui évite la coupure ; un secret exposé (fuite) impose de changer la valeur, pas seulement la clé de chiffrement, car l'historique Git conserve les anciens chiffrements. Voir Secrets pour les mécanismes SOPS.
Après toute modification : task secrets:check, commiter les *.sops.yaml, puis déployer (task ansible:services
pour l'infra, push pour le cluster).
Secret HMAC front et CTFd (PAD_SSO_SHARED_SECRET)¶
Rotation sans coupure (le plugin sso_bridge accepte l'ancienne et la nouvelle valeur pendant la transition) :
- Générer une valeur aléatoire d'au moins 32 octets.
- CTFd :
PAD_SSO_SHARED_SECRET_PREVIOUS= ancienne valeur,PAD_SSO_SHARED_SECRET= nouvelle (Secretctfd-secrets, fichier SOPS degitops/apps/ctfd). Déployer, laisser CTFd redémarrer. - Front :
PAD_SSO_SHARED_SECRET= nouvelle valeur (Secretfrontend-secrets). Déployer. - Une fois les anciens pods remplacés, retirer
PAD_SSO_SHARED_SECRET_PREVIOUSde CTFd.
Symptôme d'une rotation ratée : 401 sur /api/v1/sso/session, joueurs déconnectés (Front).
Clé age du cluster¶
task secrets:rotate-cluster-key # nouvelle clé, updatekeys + rotation des clés de données gitops/**
git add -A && git commit -m "chore(secrets): rotation de la clé du cluster"
task bootstrap:gitops # recrée le Secret sops-age avec la nouvelle clé
# puis détruire l'ancienne clé (*.old)
Si l'ancienne clé a fuité, changer aussi les valeurs des secrets de gitops/**.
Clé age de l'opérateur¶
- Générer une nouvelle clé, ajouter sa clé publique sous
keys:dans.sops.yamlet dans les règles. task secrets:update-keys, commiter.- Retirer l'ancienne clé publique,
task secrets:update-keysà nouveau, et rechiffrer les données (sops rotate). - Sauvegarder la nouvelle clé hors machine, détruire l'ancienne.
Jetons d'infrastructure¶
| Secret | Où | Comment |
|---|---|---|
| Jeton API Proxmox | secrets/proxmox.sops.yaml |
nouveau jeton dans Proxmox, sops, task tofu:apply-stack pour valider ; mettre à jour aussi le Secret de CAPMOX et de Proxmox CSI (gitops/platform/proxmox-csi) |
| Jeton DNS OVH | secrets/ovh.sops.yaml, secrets/edge.sops.yaml, gitops/platform/{cert-manager,external-dns} |
nouveau jeton chez le fournisseur, remplacer partout où il est utilisé |
| Webhook Discord, SMTP | secrets/monitoring.sops.yaml |
sops, task ansible:services |
| PAT NetBird (tofu) | secrets/netbird-tofu.sops.yaml |
nouveau PAT dans le dashboard, sops |
PAT NetBird de netbird-sync |
gitops/apps/netbird-sync (NETBIRD_API_TOKEN) |
nouveau PAT de l'utilisateur de service, sops, push |
| Secrets clients OIDC | sorties de la stack 30-authentik |
tofu apply -replace='random_password.client_secret["<client>"]' sur 30-authentik (depuis le bastion), task secrets:oidc-sync (front, NetBird, Warpgate, Grafana), ArgoCD à la main, puis task ansible:services -- --tags monitoring,warpgate,netbird et push du front |
| Mots de passe admin (Authentik, Warpgate, Zot) | secrets/*.sops.yaml, secrets/credentials.sops.yaml |
sops, redéployer le service |
Valeurs partagées en plusieurs endroits¶
task secrets:init génère une seule fois et recopie : PAD_INTERNAL_TOKEN (ctfd-secrets = secret netbird-sync), clé S3 de Garage (garage-s3-credentials = AWS_* de CTFd), mot de passe Valkey (Valkey, REDIS_PASSWORD de CTFd,
VALKEY_URL du front), secret metrics de Zot, compte pad-pull de Zot (= chall-manager-oci), bootstrap_token
d'Authentik (= authentik-tofu). Pour les changer, modifier tous les fichiers concernés dans le même commit, puis
redémarrer les consommateurs.
Après une fuite¶
- Considérer le secret comme public : le révoquer à la source (fournisseur, service) avant de le remplacer.
- Remplacer la valeur (pas seulement rechiffrer).
- Chercher d'autres occurrences :
bash scripts/check-sops.sh, gitleaks (.gitleaks.toml). - Si le secret est dans l'historique Git d'un dépôt déjà public, la révocation reste la seule vraie protection.