Chaîne des secrets¶
Le dépôt est public : les secrets y sont commités chiffrés avec SOPS et age. Aucune clé privée n'est dans le dépôt. La procédure opérateur détaillée est dans Secrets ; cette page montre le chemin d'un secret du fichier chiffré jusqu'au processus qui l'utilise.
flowchart LR
subgraph poste[Poste opérateur]
OK[(clé age opérateur<br/>~/.config/sops/age)]
CK[(clé age du cluster<br/>~/.config/pad)]
end
subgraph repo[Dépôt Git public]
S1[secrets/*.sops.yaml<br/>recipient : opérateur]
S2[gitops/**/*.sops.yaml<br/>recipients : opérateur + cluster]
EX[*.example.yaml<br/>valeurs CHANGEME]
end
OK -->|déchiffre| TOFU[OpenTofu<br/>provider carlpett/sops]
OK -->|déchiffre| ANS[Ansible<br/>community.sops]
OK -->|déchiffre| SCR[scripts bootstrap, backup]
S1 --> TOFU
S1 --> ANS
S1 --> SCR
CK -->|task bootstrap:gitops| SA[Secret sops-age<br/>namespace argocd]
SA --> KS[ksops dans le repo-server ArgoCD]
S2 --> KS
KS -->|kustomize build| KSEC[Secrets Kubernetes<br/>sync-wave -8]
KSEC --> POD[Pods]
EX -.->|task secrets:init| S1
EX -.->|task secrets:init| S2
Deux clés, deux périmètres¶
| Clé | Où elle vit | Ce qu'elle déchiffre |
|---|---|---|
| Opérateur | poste opérateur, sauvegardée hors machine | tout : secrets/** et gitops/** |
| Cluster | poste opérateur, puis Secret sops-age dans ArgoCD |
gitops/** uniquement |
Conséquence : un attaquant qui compromet le cluster n'obtient ni les jetons Proxmox, ni OVH, ni la configuration
d'Authentik. bootstrap:gitops refuse d'injecter la clé opérateur dans le cluster.
Garde-fous¶
- Avant de commiter :
bash scripts/check-sops.sh(outask secrets:check). Il exige un blocsops:complet dans chaque*.sops.*, aucune valeur horsENC[...], aucunCHANGEME, aucune clé privée suivie. - En CI : la validation de
gitops/travaille sur une copie, avec une clé age éphémère qui chiffre les*.example.yaml. La CI n'a jamais accès à une vraie clé. gitleaks complète le dispositif. - Valeurs partagées : certaines valeurs doivent être identiques à deux endroits (secret HMAC entre front et CTFd,
jeton interne entre CTFd et netbird-sync, mot de passe Valkey, clé S3 Garage de CTFd...).
task secrets:initles génère une seule fois et les recopie. Les secrets des clients OIDC sont produits par tofu (30-authentik) et recopiés partask secrets:oidc-sync.
Rotation¶
La rotation de la clé du cluster, d'un secret HMAC ou d'un jeton est décrite dans le runbook de rotation.