Aller au contenu

Architecture de gestion des secrets : Vault, KMS et workload identity

Comment les secrets parviennent aux workloads sans identifiants durables : workload identity, secrets dynamiques, chiffrement par enveloppe KMS, rotation, audit.

· Fondateur et développeur

Publié le

Schéma d'un cadre Pod avec jeton projeté, sidecar Vault Agent et application. Des arêtes numérotées relient Kubernetes API server, l'agent, Vault et PostgreSQL : login, TokenReview, lecture des identifiants, CREATE ROLE, connexion, DROP ROLE. KMS et journal d'audit à droite.

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 :

  1. GenerateDataKey renvoie 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).
  2. Chiffrez les données localement avec la clé en clair, puis effacez-la de la mémoire.
  3. Stockez la clé de données chiffrée à côté du texte chiffré. Pour lire, envoyez-la à Decrypt et 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 :

  1. 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.
  2. Vault Agent se connecte avec le jeton et un rôle Vault.
  3. Vault valide le jeton avec l'API Kubernetes TokenReview. Un jeton lié devient invalide lorsqu'il expire ou que son Pod est supprimé.
  4. 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/payments ré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-root exige 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

Schéma d'un cadre Pod avec jeton projeté, sidecar Vault Agent et application. Des arêtes numérotées relient Kubernetes API server, l'agent, Vault et PostgreSQL : login, TokenReview, lecture des identifiants, CREATE ROLE, connexion, DROP ROLE. KMS et journal d'audit à droite.

12 composants · 11 connexions

Ouvrir dans Archboard
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
Un Pod obtient des identifiants de base de données sans mot de passe stocké. Le jeton de son compte de service prouve son identité, Vault crée un utilisateur PostgreSQL avec un bail d'une heure, supprimé à la fin du bail. KMS protège la clé racine de Vault, chaque requête est auditée.

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

  1. Connectez-vous avec Google ou GitHub et créez un schéma.
  2. 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.
  3. Au-dessus du cadre, ajoutez un Cluster Kubernetes du pack Cloud intitulé Kubernetes API server.
  4. 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.
  5. 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.
  6. 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.

Commencez gratuitement — un siège, sans carte bancaire.

Articles associés

← Retour au blog

Ouvrez un canevas en une minute

Connectez-vous avec Google ou GitHub. Gratuit pour un siège. Passez à un forfait supérieur quand l’équipe vous rejoint.