Zum Inhalt springen

Secrets-Management-Architektur: Vault, KMS und Workload Identity

Wie Secrets ohne langlebige Zugangsdaten zu Workloads gelangen: Workload Identity, dynamische Secrets mit kurzer TTL, KMS-Envelope-Encryption, Rotation und Audit.

· Gründer & Entwickler

Veröffentlicht am

Diagramm eines Pod-Rahmens mit Projected Token, einem Vault-Agent-Sidecar und der App. Nummerierte Kanten verbinden Kubernetes API server, Agent, Vault und PostgreSQL: Login, TokenReview, Credential-Abruf, CREATE ROLE, Verbindung, DROP ROLE. KMS und ein Audit-Log liegen rechts.

Das Passwort der Bestelldatenbank begann in einer .env-Datei. Dann wurde es in eine CI-Variable für Migrationen kopiert, in ein Kubernetes Secret für den Service und auf zwei Laptops während eines Incidents. Zwei Jahre später kennt niemand mehr alle Kopien, also wagt es niemand, es zu rotieren.

GitGuardian zählte 2025 in öffentlichen GitHub-Commits 28,65 Millionen neue hartkodierte Secrets, 34 % mehr als im Vorjahr, und über 64 % der 2022 als gültig bestätigten Secrets funktionierten im Januar 2026 noch (State of Secrets Sprawl 2026).

Dieser Beitrag baut eine Secrets-Management-Architektur ohne langlebige Datenbankpasswörter: Workload Identity, kurzlebige dynamische Zugangsdaten, KMS-Envelope-Encryption, Rotation und Audit, mit einem Diagramm des Ablaufs.

Wo statische Secrets schiefgehen

Jede Kopie eines statischen Secrets ist ein Ort, an dem es abfließen kann:

  • Die Git-History behält den Wert, auch nachdem du die Zeile gelöscht hast.
  • CI-Variablen kann jeder lesen, der einen Job ändern darf, der sie erhält.
  • Umgebungsvariablen sind für jeden Prozess im Container sichtbar und landen in Logs und Crash-Dumps. Das Secrets-Cheat-Sheet von OWASP rät davon ab, es sei denn, es gibt keine Alternative.
  • Kubernetes Secrets werden standardmäßig unverschlüsselt in etcd gespeichert, und jeder, der in einem Namespace einen Pod anlegen darf, kann dort alle Secrets lesen, wie die Kubernetes-Dokumentation warnt.

Ein Secrets Manager löst die Speicherung, nicht den Bootstrap: Die App braucht weiterhin Zugangsdaten, um ihre Zugangsdaten abzuholen. Die Lösung ist eine von der Plattform ausgestellte Identität, die gegen Zugangsdaten getauscht wird, die von selbst ablaufen.

Die Bausteine

Komponente Aufgabe Beispiele
Secrets Manager Speichert und stellt Secrets aus, setzt Policies durch, verfolgt Leases HashiCorp Vault, OpenBao, AWS Secrets Manager, Google Secret Manager, Azure Key Vault
KMS oder HSM Hält Key-Encryption-Keys, die es nie verlassen AWS KMS, Google Cloud KMS, Azure Key Vault Managed HSM
Workload Identity Beweist mit kurzlebigen Plattform-Tokens, welcher Workload anfragt Kubernetes-Service-Account-Tokens, EKS Pod Identity, Workload Identity Federation for GKE, Microsoft Entra Workload ID
Auslieferung Bringt das Secret in den Prozess Vault Agent, Secrets Store CSI Driver, External Secrets Operator, SDK-Aufrufe
Audit Protokolliert, wer was wann gelesen hat Vault Audit Devices, AWS CloudTrail, ein SIEM

Envelope Encryption mit KMS

Ein KMS ist nicht für große Datenmengen gebaut; AWS KMS Encrypt nimmt höchstens 4.096 Bytes. Envelope Encryption teilt die Arbeit auf:

  1. GenerateDataKey liefert einen einzigartigen Datenschlüssel doppelt zurück: im Klartext und verschlüsselt mit deinem KMS-Key, dem Key-Encryption-Key (KEK).
  2. Verschlüssele die Daten lokal mit dem Klartextschlüssel und lösche ihn dann aus dem Speicher.
  3. Speichere den verschlüsselten Datenschlüssel neben dem Ciphertext. Zum Lesen schickst du ihn an Decrypt und entschlüsselst lokal.
aws kms generate-data-key --key-id alias/orders-data --key-spec AES_256

Der KEK verlässt das KMS nie unverschlüsselt, daher ist jede Nutzung ein API-Aufruf, den du autorisieren und protokollieren kannst (AWS KMS cryptography details). Die automatische Rotation läuft, einmal aktiviert, standardmäßig jährlich und ändert nur das Schlüsselmaterial für neue Verschlüsselungen; alter Ciphertext lässt sich weiterhin entschlüsseln.

Das Muster taucht hier zweimal auf. Der Kubernetes-KMS-Provider umhüllt die Datenschlüssel, die Secrets in etcd verschlüsseln; nutze KMS v2, denn v1 ist ab Kubernetes 1.29 standardmäßig deaktiviert. Vaults Keyring wird von einem Root Key verschlüsselt, und mit Auto-Unseal entschlüsselt ein Cloud-KMS diesen Root Key, wenn Vault startet.

Wie ein Pod beweist, wer er ist

Jeder Pod hat bereits eine Identität, seinen Service Account, auf dem auch die Workload Identity in einem Service Mesh aufbaut. Mit der Vault Kubernetes Auth Method:

  1. Der kubelet fordert über die TokenRequest API ein Projected Service Account Token mit der Audience vault an. Es gilt standardmäßig eine Stunde (mindestens 10 Minuten) und wird bei 80 % seiner TTL erneuert.
  2. Vault Agent meldet sich mit dem Token und einer Vault-Rolle an.
  3. Vault validiert das Token über die Kubernetes TokenReview API. Ein Bound Token wird ungültig, wenn es abläuft oder sein Pod gelöscht wird.
  4. Vault prüft Service Account, Namespace und Audience gegen die Rolle und gibt ein Token mit den zugehörigen Policies zurück.
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

Das Token ist eine Bearer-Zugangsdaten, und die Vault-Kubernetes-Auth-Dokumentation warnt davor, es mit anderen Services zu teilen. Eine eigene Audience sorgt dafür, dass Services, die aud prüfen, es ablehnen.

Die Workload-Identity-Dienste aus der Tabelle tauschen ein Projected Service Account Token gegen kurzlebige Cloud-Zugangsdaten, sodass kein Cloud-Key gespeichert wird. GitHub Actions OIDC macht dasselbe für Deploy-Jobs in einer CI/CD-Pipeline. Der JWT authentication flow erklärt, wie solche Tokens verifiziert werden.

Dynamische Datenbank-Zugangsdaten

Ein dynamisches Secret wird auf Anfrage erzeugt und zerstört, wenn seine Lease endet. Mit der Database Secrets Engine von Vault legt jeder Lesezugriff auf database/creds/payments einen neuen PostgreSQL-User an:

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

Leases lassen sich bis max_ttl verlängern. Vault Agent verlängert erneuerbare Secrets nach zwei Dritteln der Lease und holt nicht erneuerbare Lease-Secrets bei 90 % ihrer TTL neu. Läuft eine Lease ab oder wird sie widerrufen, führt Vault die Revocation Statements aus, standardmäßig ein generisches Drop-User-Statement. Ohne TTL gilt Vaults Systemstandard von 768 Stunden (32 Tage).

Was du gewinnst:

  • Ein User pro Pod, sodass eine verdächtige Query auf eine Lease zeigt und nicht auf alle Services, die ein Passwort teilen.
  • Leaks laufen ab, spätestens eine Stunde nach der Ausgabe, sofern die Lease nicht verlängert wird.
  • Reaktion mit einem Befehl: vault lease revoke -prefix database/creds/payments widerruft alle aktiven Zugangsdaten der Rolle.

Ein Haken: VALID UNTIL lässt das Passwort ablaufen, was beim Login zählt. Gib gepoolten Verbindungen eine maximale Lebensdauer, die kürzer als die Lease ist (der Standard von HikariCP liegt bei 30 Minuten), und lade die Zugangsdaten neu, wenn Vault Agent die Datei neu schreibt.

Auslieferungsoptionen und Trade-offs

Auslieferung Funktionsweise Neue Werte Worauf achten
Umgebungsvariablen Werden beim Start des Containers gesetzt Nach einem Neustart Für jeden Prozess sichtbar; landen in Logs und Dumps
Synchronisiertes Kubernetes Secret External Secrets Operator (standardmäßig stündlicher Refresh) oder Vault Secrets Operator kopiert Werte in ein Secret Gemountete Volumes aktualisieren sich; Umgebungsvariablen nicht Eine Kopie in etcd: Encryption at Rest und strenges RBAC aktivieren
Agent-Sidecar Vault Agent Injector rendert Secrets in ein In-Memory-Volume unter /vault/secrets Ja, wenn die App die Datei neu liest Ein Sidecar und ein Init-Container in jedem Pod
CSI-Volume Secrets Store CSI Driver mountet Secrets beim Start des Pods Nur mit Alpha-Auto-Rotation, standardmäßig aus Die optionale Synchronisierung in ein Secret bringt die etcd-Kopie zurück
SDK-Aufruf Die App ruft die API des Secrets Managers auf Ja, im Code Auth, Caching und Retries in jedem Service

Für dynamische Zugangsdaten passen vom Agent gerenderte Dateien am besten: Der Agent übernimmt Login, Verlängerung und erneutes Rendern. Nutze synchronisierte Secrets, wenn Helm-Charts eines erwarten oder du Secrets in einem GitOps-Repository nur als Referenzen ablegst, und das SDK außerhalb von Kubernetes.

Rotation ohne Downtime

Rotation hat eine Regel: Die neuen Zugangsdaten müssen funktionieren, bevor die alten aufhören.

  • Dynamische Zugangsdaten rotieren per Design, solange die Verbraucher rechtzeitig neu laden.
  • Statische Datenbankpasswörter brauchen einen Rotationsjob. In AWS Secrets Manager behält die Single-User-Strategie offene Verbindungen, kann Aufrufe aber kurz ablehnen, daher brauchen Clients Retries; die Alternating-Users-Strategie wechselt zwischen zwei Usern, sodass ein Client, der das Secret mitten in der Rotation geholt hat, weiterhin gültige Zugangsdaten besitzt. Die Rotation kann bis zu alle vier Stunden laufen.
  • API-Keys: Deploye den neuen Key, bestätige, dass der Traffic umgezogen ist, und widerrufe dann den alten.

Audit-Logs und Break-Glass-Zugang

Vault sendet für jede Anfrage und Antwort einen Eintrag an alle aktivierten Audit Devices und lehnt Anfragen ab, die kein Device aufzeichnen kann, weshalb HashiCorp empfiehlt, mindestens zwei zu aktivieren. Die meisten Strings werden als HMAC-SHA256-Hashes geloggt, und /sys/audit-hash berechnet den Hash eines bekannten Werts, damit du danach suchen kannst. Leite die Logs an dein SIEM weiter und alarmiere bei der Nutzung des Root Tokens und bei Policy-Änderungen.

Break-Glass-Zugang sollte langweilig und getestet sein:

  • Kein dauerhaftes Root Token. HashiCorp empfiehlt Root Tokens nur für die Einrichtung oder für Notfälle und rät, sie direkt danach zu widerrufen. vault operator generate-root braucht ein Quorum der Inhaber von Unseal- oder Recovery-Keys.
  • Kenne deine harten Abhängigkeiten. Mit Auto-Unseal können Recovery Keys den Root Key nicht entschlüsseln, Vault kann also ohne seinen KMS-Key nicht unsealen. AWS KMS wartet 7 bis 30 Tage, bevor es einen Key löscht; alarmiere bei jeder geplanten Löschung.

Das Diagramm des Secrets-Flows

Diagramm eines Pod-Rahmens mit Projected Token, einem Vault-Agent-Sidecar und der App. Nummerierte Kanten verbinden Kubernetes API server, Agent, Vault und PostgreSQL: Login, TokenReview, Credential-Abruf, CREATE ROLE, Verbindung, DROP ROLE. KMS und ein Audit-Log liegen rechts.

12 Komponenten · 11 Verbindungen

In Archboard öffnen
Diagramminhalt
  • 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
Ein Pod erhält Datenbank-Zugangsdaten ohne gespeichertes Passwort. Sein Service-Account-Token beweist, wer er ist, Vault legt einen PostgreSQL-User mit einer Lease von einer Stunde an, der User wird danach gelöscht. KMS schützt Vaults Root Key, jede Anfrage wird auditiert.

So liest du es:

  • Links: der Pod-Rahmen mit dem Projected Token, dem Vault-Agent-Sidecar und der App, unter dem Kubernetes API server.
  • Violette Kanten 1 bis 3, Identität: TokenRequest (1), Login mit der Rolle payments (2), TokenReview (3).
  • Türkise Kanten 4 bis 7, die Zugangsdaten: database/creds/payments lesen (4), CREATE ROLE ... VALID UNTIL (5), /vault/secrets/db rendern (6), Verbindung über TLS (7).
  • Rote gestrichelte Kante 8: Die Lease endet und Vault löscht den User.
  • Rechts: KMS entschlüsselt Vaults Root Key beim Start; das Audit-Log erhält jede Anfrage und Antwort.
  • Der Markdown-Block listet alle Lebensdauern auf.

Secrets-Management-Diagramme klar zeichnen

  • Nummeriere die Schritte und färbe sie nach Phase: Identität, Auslieferung, Widerruf.
  • Schreibe Lebensdauern und Audiences ins Diagramm. «aud vault, 1h» lädt zur Prüfung ein; «kurzlebig» lädt zum Streit ein.
  • Zeige, wo Klartext existiert: Speicher, In-Memory-Volumes, Umgebungsvariablen, etcd.
  • Zeichne Widerrufs- und Audit-Pfade, nicht nur den Happy Path.
  • Nimm nie echte Keys, Tokens oder interne Hostnamen in ein Diagramm auf.
  • Überlasse Vaults Storage und Cluster-Interna einem Betriebsdiagramm.

Das Threat-Modeling-Datenflussdiagramm ergänzt Trust Boundaries, das Zero-Trust-Modell zeigt den größeren Rahmen für Zugriffe, und das Kubernetes-Architekturdiagramm behandelt API server und kubelet.

In Archboard nachbauen

  1. Melde dich mit Google oder GitHub an und erstelle ein Diagramm.
  2. Füge aus dem Paket Basis einen Rahmen namens Pod: payments-api hinzu. Staple darin einen Token aus dem Paket Sicherheit und zwei Container-Nodes aus dem Paket Docker: Vault Agent (sidecar) und App container.
  3. Füge über dem Rahmen einen Kubernetes-Cluster aus dem Paket Cloud mit der Beschriftung Kubernetes API server hinzu.
  4. Füge in der Mitte einen Tresor aus dem Paket Sicherheit hinzu. Rechts fügst du eine Cloud-Ressource aus dem Paket Cloud für den KMS-Key, Protokolle aus dem Paket DevOps für das Audit-Log und Postgres aus dem Paket Daten hinzu.
  5. Zeichne die Kanten 1 bis 8 mit Blockpfeilen (violett für Identität, türkis für die Zugangsdaten, rot gestrichelt für DROP ROLE) sowie die Startkante zum KMS-Key und eine gestrichelte Kante zum Audit-Log.
  6. Füge einen Markdown-Block aus dem Paket Basis mit den Lebensdauern hinzu und zwei Text-Anmerkungen aus dem Paket Basis für die Vault-Rolle und den Datenbank-User.

Das Tool Kubernetes YAML to diagram macht aus vorhandenen Manifesten einen ersten Entwurf. Das Beispiel nutzt 10 Diagramm-Nodes und bleibt damit im Free-Plan.

FAQ

Was ist der Unterschied zwischen einem Secrets Manager und einem KMS? Ein KMS hält Schlüssel, die es nie verlassen, und verschlüsselt kleine Elemente wie Datenschlüssel. Ein Secrets Manager speichert und stellt die Secrets selbst aus, etwa Passwörter und API-Keys, oft geschützt durch ein KMS.

Sind Kubernetes Secrets verschlüsselt? Standardmäßig nicht. Aktiviere Encryption at Rest für etcd, idealerweise mit dem KMS-v2-Provider, und beschränke RBAC: Jeder, der in einem Namespace Pods anlegen darf, kann dessen Secrets lesen.

Was sind dynamische Secrets? Zugangsdaten, die auf Anfrage erzeugt und gelöscht werden, wenn ihre Lease endet, etwa die einstündigen Datenbank-User, die die Database Secrets Engine von Vault pro Anfrage anlegt.

Soll ich Secrets als Umgebungsvariablen übergeben? Vermeide es, wenn du kannst: Jeder Prozess im Container kann sie lesen, sie landen in Logs und Crash-Dumps und ändern sich nur bei einem Neustart. Vom Agent gerenderte Dateien lassen sich leichter schützen und rotieren.

Wie oft sollten Secrets rotiert werden? Dynamische Zugangsdaten laufen innerhalb von Stunden ab und brauchen keinen Zeitplan. Rotiere statische Secrets nach einem Zeitplan und nach jedem vermuteten Bekanntwerden oder Personalwechsel, und teste die Rotation zuerst im Staging.

Kostenlos starten — ein Seat, keine Kreditkarte.

Ähnliche Beiträge

← Zurück zum Blog

In einer Minute ein Canvas öffnen

Melden Sie sich mit Google oder GitHub an. Kostenlos für einen Sitzplatz. Upgraden Sie, wenn das Team dazukommt.