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:
- In n8n: Workflows → Import from File →
yearly-secrets-rotation-reminder.jsonauswählen. - Node "Zammad-Ticket erstellen" öffnen → Credential neu anlegen/
zuweisen (Credential-IDs werden beim Import nicht mitgenommen):- Typ: Zammad Token Auth API
- Base URL:
https://zammad.tech.homeserver - Access Token: neuen Token in Zammad unter Profil → Token Access
erzeugen (Berechtigungticket.agentreicht), analog zu
capulus-core/f-cicd-automatisierung/f0040-github-release-watcher.md → Schritt 1
- 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). - Workflow aktivieren (Schalter oben rechts — Import allein reicht
nicht, wie bei jedem n8n-Workflow in diesem Repo). - 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.