SOPS, age et ksops¶
Couche : Plateforme GitOps · Où : poste opérateur (sops, age), repo-server ArgoCD (ksops), CI (clé éphémère) · Version : ksops v4.5.1 ; sops et age du devshell
À quoi elle sert ici et pourquoi ce choix¶
Le dépôt est public : les secrets y sont commités chiffrés (SOPS + age) et jamais en clair. Deux clés age distinctes : celle de l'opérateur (déchiffre tout)
et celle du cluster (ne déchiffre que gitops/**, jamais secrets/). Décision : ADR 8 ; procédure : Secrets (SOPS + age).
Où elle tourne et comment elle est déployée¶
- Poste opérateur :
sops/agedu devshell ; clé dans~/.config/sops/age/keys.txt(variableSOPS_AGE_KEY_FILE). - Cluster : ksops (plugin exec de kustomize) est téléchargé par un init container du repo-server ArgoCD (binaire épinglé, sha256 vérifié) ; la clé du cluster arrive par le Secret
sops-age. - Ansible et tofu déchiffrent à l'exécution via
community.sopsetcarlpett/sops.
Version épinglée¶
| Élément | Version | Où |
|---|---|---|
| ksops | v4.5.1 (sha256 vérifié) | gitops/platform/argocd/values.yaml (init container install-ksops) |
community.sops |
2.5.0 | infra/ansible/requirements.yml |
carlpett/sops |
1.4.1 | infra/tofu/stacks/*/versions.tf (page) |
| sops, age | version du devshell | flake.nix / flake.lock |
Fichiers de configuration dans le dépôt¶
.sops.yaml: recipients (opérateur, cluster) et règles de chemin (secrets/*.sops.yaml,gitops/**/*.sops.yaml,infra/**).secrets/*.example.yamletgitops/**/*.example.yaml: modèles enCHANGEME.scripts/sopsctl.py,scripts/Taskfile.secrets.yml(task secrets:*),scripts/check-sops.sh,scripts/validate-gitops.sh.gitops/**/secret-generator.yaml: générateur ksops de chaque composant.
Interactions avec les autres briques¶
Consommé par ArgoCD, Ansible, OpenTofu, les scripts de bootstrap, de sauvegarde et de restauration ; la CI n'a jamais la vraie clé.
Sécurité¶
- Seuls
dataetstringDatades Secrets Kubernetes sont chiffrés ; les fichiers d'infra le sont entièrement. - Garde-fous avant commit :
bash scripts/check-sops.sh(blocssops:, valeursENC[...], pas de Secret ni de clé en clair) etbash scripts/check-site-leaks.sh. - La CI chiffre les modèles avec une clé éphémère pour valider
kustomize build: jamais la vraie clé. - Les clés privées age ne vont jamais dans le dépôt (
*.agekey,keys.txtsont ignorés).
Supervision¶
Pas de métrique propre ; un échec ksops se voit dans l'état de synchronisation d'ArgoCD : ArgoCD. Rotation : Rotation des secrets.
Opérations courantes¶
task secrets:keys # génère les clés age hors dépôt, renseigne .sops.yaml
task secrets:init # crée les *.sops.yaml manquants (valeurs aléatoires fortes)
task secrets:pending # liste les valeurs encore à renseigner (noms seulement)
task secrets:check
sops secrets/proxmox.sops.yaml
task secrets:rotate-cluster-key
Pièges connus¶
- Sauvegarder les deux clés privées hors machine : sans elles, plus rien ne se déchiffre.
- Après tout changement de recipient :
task secrets:update-keys. - Les valeurs partagées (secret SSO, mot de passe Valkey, clé S3...) sont générées une seule fois et recopiées à l'identique : ne pas les régénérer d'un seul côté.
Documentation officielle¶
getsops.io · age-encryption.org · github.com/viaduct-ai/kustomize-sops