PKR-Lab

d0060 - Secrets-Rotation-Checkliste (Security-Härtung Phase 7)

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/d-sicherheit/d0060-secrets-rotation.md

Secrets-Rotation-Checkliste (Security-Härtung Phase 7)

Detail-Doku zu Phase 7 aus capulus-core/d-sicherheit/d0010-security-hardening-roadmap.md.

Ziel: Keine dokumentierte Rotationskadenz für die zentralen Secrets
dieses Setups. Statt einer reinen Doku, die niemand von sich aus wieder
aufschlägt, erinnert ein jährliches Zammad-Ticket aktiv daran — siehe
Automatisierte Erinnerung
unten. Diese Seite ist das Ziel, auf das das Ticket verlinkt.

Seit der Umsetzung des Token-Managements aus
40090

gibt es zusätzlich ein maschinenlesbares Register aller Tokens und
SealedSecrets: ops/token-register.yaml.
Diese Seite bleibt das Wie (Runbooks je Secret), das Register plus der
tägliche Workflow token-watch.yml
sind das Wann — er meldet nahende Abläufe automatisch als GitHub-Issue,
statt auf das jährliche Zammad-Ticket zu warten. scripts/check-token-register.py
erzwingt im CI, dass jede SealedSecret-Datei im Repo dort auch auftaucht, dass jeder Eintrag ein max_age_days hat, dass ein Eintrag mit bekanntem issued nicht älter als max_age_days ist und dass kein expires in der Vergangenheit liegt. Richtwerte: Passwörter, API-Tokens, Zertifikate und Tunnel-Credentials 365 Tage, Auth-Keys 90, der Sealed-Secrets-Schlüssel 30. Für 25 Einträge steht issued als Näherung: das Datum, an dem die Datei mit dem SealedSecret an ihrem heutigen Pfad zuerst eingecheckt wurde (git log --diff-filter=A; für 22 davon der 2026-09-19, den Tag der Verschiebung nach argocd/apps/tech/). Das echte Anlegedatum liegt davor, das Alter ist also zu klein eingeschätzt (um bis zu vier Monate). Bei der nächsten Rotation das tatsächliche Datum eintragen. Bei Einträgen mit issued: null (Vault-Variablen, GitHub-PATs, Auth-Key, Sealed-Secrets-Schlüssel, Tokens außerhalb des Repos) ist das Alter unbekannt, das Skript meldet deren Zahl als Hinweis.


Die vier zentralen Secrets

Secret Wo Empfohlener Turnus Rotieren
Ansible-Vault-Passwort Schützt alle !vault \|-Werte in group_vars/, host_vars/ Alle 1–2 Jahre, oder sofort bei Verdacht auf Kompromittierung ansible-vault rekey group_vars/all.yml (+ alle weiteren vault-verschlüsselten Dateien im Repo) — neues Passwort danach auch in semaphore_vault_password (capulus-ansible/b-kubernetes-gitops/b0030-semaphore.md) und bei allen, die lokal --ask-vault-pass nutzen, aktualisieren
restic-Passwort (NAS-Backup) Verschlüsselt das komplette Backup-Repository, siehe capulus-core/2-betrieb-hardware/20010-nas-backup.md Nicht routinemäßig rotieren — ein Passwortwechsel macht alle bisherigen Snapshots unlesbar, außer man migriert das ganze Repository (restic copy/init --repository2, aufwendig). Nur bei tatsächlichem Verdacht auf Kompromittierung, dann mit vollständiger Repo-Migration Bei Bedarf: neues Repo mit neuem Passwort anlegen, alte Snapshots per restic copy migrieren, siehe restic-Doku
ArgoCD-Admin-Passwort Login unter https://argocd.tech.homeserver Alle 6–12 Monate argocd account update-password (oder kubectl -n argocd patch secret argocd-secret ..., siehe ArgoCD-Doku)
Sealed-Secrets-Schlüssel Verschlüsselt alle SealedSecret-Objekte im Repo Rotiert automatisch — der Controller generiert standardmäßig alle 30 Tage einen neuen aktiven Schlüssel (--key-renew-period, hier auf Chart-Default belassen, siehe argocd/apps/tech/sealed-secrets/values.yaml). Alte Schlüssel bleiben für bereits versiegelte Secrets nötig und werden nicht automatisch gelöscht Nichts zu tun für neue Secrets. Nur bei Verdacht auf Kompromittierung: kubeseal --re-encrypt auf alle bestehenden SealedSecrets im Repo anwenden, danach alte Controller-Keys manuell löschen (siehe sealed-secrets-Doku)

Was seit der Multi-Cluster-Umstellung dazukommt

Die vier Secrets oben sind die zentralen. Mit den drei Clustern gibt es weitere Werte, die je Cluster
existieren und bei einer Rotation mitzudenken sind:

Secret Wo Hinweis
Sealed-Secrets-Schlüssel je Cluster TECH, PROD und ENTW haben jeweils eigene Controller-Schlüssel Rotiert je Controller automatisch (siehe oben). Ein Secret muss für den Ziel-Cluster versiegelt sein, für PROD mit scripts/reseal-for-prod.sh
ArgoCD-Admin-Passwort ENTW Eigene ArgoCD-Instanz auf der entw-vm Unabhängig vom Hub-Passwort, Passwort-Update per UI/CLI der ENTW-Instanz (b0050)
Cluster-Token argocd-manager (PROD im Hub) Secret cluster-prod im Hub, ServiceAccount-Token in der prod-vm Berechtigt den Hub zu Cluster-Admin in PROD, bei Verdacht neu ausstellen (capulus-core/komponenten/bootstrap-prod.md)
Cloudflare-Tunnel-Credentials Tunnel homeserver (TECH) und homeserver-prod (PROD), je als SealedSecret Rotation je Tunnel, siehe e0010
Interne CA Root-CA-Schlüssel (nur lokal) und PROD-Intermediate-CA Siehe d0040
lldap-Secrets lldap-secrets als SealedSecret in TECH Aufbau und Betrieb: d0072

Automatisierte Erinnerung: n8n → Zammad

Eine reine Markdown-Checkliste wird erfahrungsgemäß nie von sich aus
wieder aufgeschlagen. Deshalb: ein n8n-Workflow
(argocd/apps/tech/n8n/workflows/yearly-secrets-rotation-reminder.json)
mit einem jährlichen Schedule-Trigger, der ein Zammad-Ticket in der
Gruppe Support::Administration eröffnet — Titel, Fälligkeits-
Charakter und ein Link auf diese Seite, nicht die volle Checkliste im
Ticket-Text dupliziert (diese Seite bleibt die Quelle der Wahrheit für
das Wie, das Ticket ist nur der Auslöser).

Nutzt den nativen n8n-nodes-base.zammad-Node (Ticket → Create), nicht
den generischen HTTP-Request-Node wie beim älteren
banana-pi-down-to-zammad.json-Workflow — auf Wunsch, um n8n-eigene
Zammad-Credentials (Type: zammadTokenAuthApi) statt eines rohen
API-Tokens im HTTP-Header zu nutzen.

Import-Anleitung:

  1. In n8n: Workflows → Import from File →
    yearly-secrets-rotation-reminder.json auswählen.
  2. Node "Zammad-Ticket erstellen" öffnen → Credential neu anlegen/
    zuweisen (Credential-IDs werden beim Import nicht mitgenommen):
  3. Trigger-Zeitpunkt bei Bedarf anpassen (Node "Jährlicher Trigger" —
    Default: 15. Januar, 08:00 Uhr; bewusst nicht der 1. Januar, um nicht
    im Feiertagsrauschen unterzugehen).
  4. Workflow aktivieren (Schalter oben rechts — Import allein reicht
    nicht, wie bei jedem n8n-Workflow in diesem Repo).
  5. Zum Testen: Trigger-Node → Test Workflow einmalig manuell ausführen,
    prüfen, dass das Ticket wie erwartet in Zammad unter
    Support → Administration auftaucht.

Ticket-Anfrager (customer): [email protected], wie beim
bestehenden banana-pi-down-to-zammad.json-Workflow — muss ein
bereits existierender Zammad-User sein (siehe Hinweis in
capulus-core/f-cicd-automatisierung/f0040-github-release-watcher.md).


Fehlersuche

Symptom Ursache Lösung
CI-Job token register schlägt fehl Register unvollständig, Rotation überfällig, SealedSecret ohne Eintrag Meldungen: f00c0: Token-Register
token-watch legt ein Issue Token laeuft ab: … an Ablauf in höchstens 60 Tagen Token rotieren, Datum eintragen (cubi tokens)
token-watch-Lauf ist rot Token läuft in weniger als 7 Tagen ab sofort rotieren
Dienst nach Rotation ohne Anmeldung (401/403) altes Token widerrufen, bevor alle Verbraucher umgestellt waren Überlappungsregeln beachten: neues Token anlegen, umstellen, prüfen, dann altes widerrufen
SealedSecret lässt sich nach der Rotation nicht entschlüsseln falscher Cluster oder Name Sealed Secrets: Fehlersuche
Shutdown-Code in der iOS-App geht nicht mehr ArgoCD-Admin-Passwort rotiert, carplay-api-shutdown-code nicht nachgezogen carplay-api: Ersteinrichtung Schritt 4
Rotationsskript meldet einen Fehler Voraussetzungen fehlen f00c0: Skripte
cubi tokens kann nicht rotieren (Im Register fehlt rotation.command) scripted-Einträge ohne Befehl cubi: Tokens

Allgemeine Fehlersuche: zentrale Fehlersuche.