Le mot de passe de la base de données des commandes a commencé dans un fichier .env. Puis il a été copié dans une variable CI pour les migrations, dans un Kubernetes Secret pour le service et sur deux ordinateurs portables pendant un incident. Deux ans plus tard, personne ne connaît toutes les copies, donc personne n'ose le faire tourner.
GitGuardian a compté 28,65 millions de nouveaux secrets codés en dur dans les commits GitHub publics en 2025, soit 34 % de plus en un an, et plus de 64 % des secrets qu'il avait confirmés comme valides en 2022 fonctionnaient encore en janvier 2026 (State of Secrets Sprawl 2026).
Cet article construit une architecture de gestion des secrets sans mots de passe de base de données de longue durée : workload identity, identifiants dynamiques de courte durée, chiffrement par enveloppe KMS, rotation et audit, avec un schéma du flux.
Où les secrets statiques posent problème
Chaque copie d'un secret statique est un endroit d'où il peut fuiter :
- L'historique Git conserve la valeur après la suppression de la ligne.
- Les variables CI peuvent être lues par quiconque peut modifier un job qui les reçoit.
- Les variables d'environnement sont visibles de tous les processus du conteneur et finissent dans les logs et les crash dumps. L'aide-mémoire OWASP sur les secrets les déconseille, sauf si rien d'autre ne fonctionne.
- Les Kubernetes Secrets sont stockés non chiffrés dans etcd par défaut, et quiconque peut créer un Pod dans un namespace peut y lire tous les Secrets, comme le prévient la documentation Kubernetes.
Un gestionnaire de secrets règle le stockage, pas l'amorçage : l'application a toujours besoin d'un identifiant pour récupérer son identifiant. La solution est une identité émise par la plateforme, échangée contre des identifiants qui expirent d'eux-mêmes.
Les briques de base
| Composant | Rôle | Exemples |
|---|---|---|
| Gestionnaire de secrets | Stocke et émet les secrets, applique les politiques, suit les baux | HashiCorp Vault, OpenBao, AWS Secrets Manager, Google Secret Manager, Azure Key Vault |
| KMS ou HSM | Détient des clés de chiffrement de clés qui ne le quittent jamais | AWS KMS, Google Cloud KMS, Azure Key Vault Managed HSM |
| Workload identity | Prouve quel workload appelle, avec des jetons de plateforme de courte durée | Jetons de compte de service Kubernetes, EKS Pod Identity, Workload Identity Federation for GKE, Microsoft Entra Workload ID |
| Livraison | Amène le secret dans le processus | Vault Agent, Secrets Store CSI Driver, External Secrets Operator, appels SDK |
| Audit | Enregistre qui a lu quoi, et quand | Audit devices de Vault, AWS CloudTrail, un SIEM |
Chiffrement par enveloppe avec KMS
Un KMS n'est pas conçu pour les données volumineuses ; AWS KMS Encrypt accepte au plus 4 096 octets. Le chiffrement par enveloppe répartit le travail :
GenerateDataKeyrenvoie une clé de données unique en double : en clair et chiffrée avec votre clé KMS, la clé de chiffrement de clés (KEK).- Chiffrez les données localement avec la clé en clair, puis effacez-la de la mémoire.
- Stockez la clé de données chiffrée à côté du texte chiffré. Pour lire, envoyez-la à
Decryptet déchiffrez localement.
aws kms generate-data-key --key-id alias/orders-data --key-spec AES_256
La KEK ne quitte jamais le KMS en clair, donc chaque utilisation est un appel d'API que vous pouvez autoriser et journaliser (AWS KMS cryptography details). La rotation automatique, une fois activée, s'exécute chaque année par défaut et ne change que le matériel de clé pour les nouveaux chiffrements ; les anciens textes chiffrés se déchiffrent toujours.
Le motif apparaît deux fois ici. Le fournisseur KMS de Kubernetes enveloppe les clés de données qui chiffrent les Secrets dans etcd ; utilisez KMS v2, car la v1 est désactivée par défaut depuis Kubernetes 1.29. Le keyring de Vault est chiffré par une clé racine, et avec l'auto-unseal un KMS cloud déchiffre cette clé racine au démarrage de Vault.
Comment un Pod prouve son identité
Chaque Pod a déjà une identité, son compte de service, sur lequel repose aussi l'identité de workload dans un service mesh. Avec la méthode d'authentification Kubernetes de Vault :
- Le kubelet demande, via l'API TokenRequest, un jeton de compte de service projeté avec l'audience
vault. Il dure une heure par défaut (10 minutes au minimum) et est renouvelé à 80 % de son TTL. - Vault Agent se connecte avec le jeton et un rôle Vault.
- Vault valide le jeton avec l'API Kubernetes TokenReview. Un jeton lié devient invalide lorsqu'il expire ou que son Pod est supprimé.
- Vault vérifie le compte de service, le namespace et l'audience par rapport au rôle, puis renvoie un jeton avec ses politiques.
vault write auth/kubernetes/role/payments \
bound_service_account_names=payments-api \
bound_service_account_namespaces=payments \
audience=vault policies=payments-db token_ttl=1h
Le jeton est un identifiant porteur, et la documentation d'authentification Kubernetes de Vault déconseille de le partager avec d'autres services. Une audience dédiée fait que les services qui vérifient aud le rejettent.
Les services de workload identity du tableau échangent un jeton de compte de service projeté contre des identifiants cloud de courte durée, sans stocker aucune clé cloud. GitHub Actions OIDC fait de même pour les jobs de déploiement d'un pipeline CI/CD. Le JWT authentication flow explique comment de tels jetons sont vérifiés.
Identifiants dynamiques de base de données
Un secret dynamique est créé à la demande et détruit à la fin de son bail. Avec le moteur de secrets de base de données de Vault, chaque lecture de database/creds/payments crée un nouvel utilisateur PostgreSQL :
vault write database/roles/payments db_name=orders \
creation_statements="CREATE ROLE \"{{name}}\" WITH LOGIN PASSWORD '{{password}}' VALID UNTIL '{{expiration}}'; GRANT SELECT ON ALL TABLES IN SCHEMA public TO \"{{name}}\";" \
default_ttl=1h max_ttl=24h
Les baux peuvent être renouvelés jusqu'à max_ttl. Vault Agent renouvelle les secrets renouvelables après les deux tiers du bail et récupère à nouveau les secrets à bail non renouvelables à 90 % de leur TTL. Lorsqu'un bail expire ou est révoqué, Vault exécute les instructions de révocation, par défaut une instruction générique de suppression d'utilisateur. Sans TTL, la valeur par défaut du système Vault, 768 heures (32 jours), s'applique.
Ce que vous y gagnez :
- Un utilisateur par Pod, de sorte qu'une requête suspecte désigne un bail, et non tous les services partageant un mot de passe.
- Les fuites expirent, au plus une heure après l'émission, sauf si le bail est renouvelé.
- Une réponse en une commande :
vault lease revoke -prefix database/creds/paymentsrévoque tous les identifiants actifs du rôle.
Un piège : VALID UNTIL fait expirer le mot de passe, ce qui compte à la connexion. Donnez aux connexions poolées une durée de vie maximale inférieure au bail (la valeur par défaut de HikariCP est de 30 minutes) et rechargez les identifiants lorsque Vault Agent réécrit le fichier.
Options de livraison et compromis
| Livraison | Fonctionnement | Nouvelles valeurs | Points d'attention |
|---|---|---|---|
| Variables d'environnement | Définies au démarrage du conteneur | Après un redémarrage | Visibles de tous les processus ; fuient dans les logs et les dumps |
| Kubernetes Secret synchronisé | External Secrets Operator (rafraîchissement horaire par défaut) ou Vault Secrets Operator copie les valeurs dans un Secret | Les volumes montés se mettent à jour ; pas les variables d'environnement | Une copie dans etcd : activez le chiffrement au repos et un RBAC strict |
| Sidecar agent | Vault Agent Injector génère les secrets dans un volume en mémoire à /vault/secrets |
Oui, si l'application relit le fichier | Un sidecar et un init container dans chaque Pod |
| Volume CSI | Secrets Store CSI Driver monte les secrets au démarrage du Pod | Seulement avec l'auto-rotation alpha, désactivée par défaut | La synchronisation optionnelle vers un Secret ramène la copie dans etcd |
| Appel SDK | L'application appelle l'API du gestionnaire de secrets | Oui, dans le code | Authentification, cache et nouvelles tentatives dans chaque service |
Pour les identifiants dynamiques, les fichiers générés par l'agent conviennent le mieux : l'agent gère la connexion, le renouvellement et la régénération. Utilisez des Secrets synchronisés quand des Helm charts en attendent un ou quand vous gardez les secrets d'un dépôt GitOps sous forme de références, et le SDK en dehors de Kubernetes.
Rotation sans interruption
La rotation obéit à une règle : le nouvel identifiant doit fonctionner avant que l'ancien ne s'arrête.
- Les identifiants dynamiques tournent par conception, tant que les consommateurs rechargent à temps.
- Les mots de passe de base de données statiques exigent une tâche de rotation. Dans AWS Secrets Manager, la stratégie à utilisateur unique conserve les connexions ouvertes mais peut refuser brièvement des appels, donc les clients ont besoin de nouvelles tentatives ; la stratégie à utilisateurs alternés bascule entre deux utilisateurs, de sorte qu'un client ayant récupéré le secret en pleine rotation détient toujours des identifiants valides. La rotation peut s'exécuter aussi souvent que toutes les quatre heures.
- Clés d'API : déployez la nouvelle clé, vérifiez que le trafic a basculé, puis révoquez l'ancienne.
Journaux d'audit et accès break-glass
Vault envoie une entrée pour chaque requête et chaque réponse à tous les audit devices activés et refuse les requêtes qu'aucun device ne peut enregistrer, c'est pourquoi HashiCorp recommande d'en activer au moins deux. La plupart des chaînes sont journalisées sous forme de hachages HMAC-SHA256, et /sys/audit-hash calcule le hachage d'une valeur connue pour que vous puissiez la rechercher. Envoyez-le à votre SIEM et déclenchez une alerte sur l'usage du jeton racine et les changements de politique.
L'accès break-glass doit être ennuyeux et testé :
- Pas de jeton racine permanent. HashiCorp recommande les jetons racine uniquement pour la mise en place ou les urgences, révoqués juste après.
vault operator generate-rootexige un quorum de détenteurs de clés d'unseal ou de récupération. - Connaissez vos dépendances dures. Avec l'auto-unseal, les clés de récupération ne peuvent pas déchiffrer la clé racine, donc Vault ne peut pas se desceller sans sa clé KMS. AWS KMS attend de 7 à 30 jours avant de supprimer une clé ; déclenchez une alerte à chaque suppression planifiée.
Le schéma du flux des secrets
Contenu du diagramme
- Kubernetes API server
- Pod: payments-api
- Projected SA token
- Vault Agent (sidecar)
- App container
- Cloud KMS key
- Vault: auth, policies, leases
- Vault audit log to SIEM
- orders DB (PostgreSQL)
- 1 TokenRequest via kubelet
- read JWT
- 2 login: JWT + role payments
- 3 TokenReview
- 4 read database/creds/payments
- 5 CREATE ROLE ... VALID UNTIL
- 6 render /vault/secrets/db
- 7 connect as the short-lived user (TLS)
- 8 lease ends: DROP ROLE
- at startup: decrypt root key
- every request and response
Comment le lire :
- Gauche : le cadre Pod avec le jeton projeté, le sidecar Vault Agent et l'application, sous le Kubernetes API server.
- Arêtes violettes 1 à 3, identité : TokenRequest (1), login avec le rôle payments (2), TokenReview (3).
- Arêtes turquoise 4 à 7, l'identifiant : lecture de
database/creds/payments(4),CREATE ROLE ... VALID UNTIL(5), génération de/vault/secrets/db(6), connexion via TLS (7). - Arête rouge en pointillés 8 : le bail se termine et Vault supprime l'utilisateur.
- Droite : KMS déchiffre la clé racine de Vault au démarrage ; le journal d'audit reçoit chaque requête et chaque réponse.
- Le bloc Markdown liste toutes les durées de vie.
Dessiner clairement des schémas de gestion des secrets
- Numérotez les étapes et colorez-les par phase : identité, livraison, révocation.
- Écrivez les durées de vie et les audiences sur le schéma. « aud vault, 1h » invite à la relecture ; « de courte durée » invite à la discussion.
- Montrez où le texte en clair existe : mémoire, volumes en mémoire, variables d'environnement, etcd.
- Dessinez les chemins de révocation et d'audit, pas seulement le chemin nominal.
- Ne mettez jamais de vraies clés, de vrais jetons ou de noms d'hôte internes dans un schéma.
- Laissez le stockage et le fonctionnement interne du cluster de Vault à un schéma d'exploitation.
Le schéma de flux de données de threat modeling ajoute les frontières de confiance, le modèle zero trust montre le cadre d'accès plus large, et le schéma d'architecture Kubernetes couvre l'API server et le kubelet.
Le construire dans Archboard
- Connectez-vous avec Google ou GitHub et créez un schéma.
- Ajoutez un Cadre du pack Base nommé Pod: payments-api. À l'intérieur, empilez un Jeton du pack Sécurité et deux nœuds Conteneur du pack Docker : Vault Agent (sidecar) et App container.
- Au-dessus du cadre, ajoutez un Cluster Kubernetes du pack Cloud intitulé Kubernetes API server.
- Ajoutez un Coffre-fort du pack Sécurité au milieu. À droite, ajoutez une Ressource cloud du pack Cloud pour la clé KMS, Journaux du pack DevOps pour le journal d'audit et Postgres du pack Données.
- Tracez les arêtes 1 à 8 avec des flèches pleines (violet pour l'identité, turquoise pour l'identifiant, rouge en pointillés pour DROP ROLE), plus l'arête de démarrage vers la clé KMS et une arête en pointillés vers le journal d'audit.
- Ajoutez un bloc Markdown du pack Base avec les durées de vie, et deux annotations Texte du pack Base pour le rôle Vault et l'utilisateur de base de données.
L'outil Kubernetes YAML to diagram transforme des manifestes existants en première ébauche. L'exemple utilise 10 nœuds de diagramme et reste dans les limites de l'offre Free.
FAQ
Quelle est la différence entre un gestionnaire de secrets et un KMS ? Un KMS détient des clés qui ne le quittent jamais et chiffre de petits éléments comme des clés de données. Un gestionnaire de secrets stocke et émet les secrets eux-mêmes, comme les mots de passe et les clés d'API, souvent protégés par un KMS.
Les Kubernetes Secrets sont-ils chiffrés ? Pas par défaut. Activez le chiffrement au repos pour etcd, idéalement avec le fournisseur KMS v2, et restreignez le RBAC : quiconque peut créer des Pods dans un namespace peut en lire les Secrets.
Que sont les secrets dynamiques ? Des identifiants créés à la demande et supprimés à la fin de leur bail, comme les utilisateurs de base de données d'une heure que le moteur de secrets de base de données de Vault crée à chaque requête.
Dois-je passer les secrets en variables d'environnement ? Évitez-le si possible : tous les processus du conteneur peuvent les lire, ils fuient dans les logs et les crash dumps, et ils ne changent qu'au redémarrage. Les fichiers générés par l'agent sont plus faciles à protéger et à faire tourner.
À quelle fréquence faut-il faire tourner les secrets ? Les identifiants dynamiques expirent en quelques heures et n'ont besoin d'aucun calendrier. Faites tourner les secrets statiques selon un calendrier et après toute exposition suspectée ou tout départ de personnel, et testez d'abord la rotation en staging.