d0010 - Security-Härtung — Roadmap
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/d-sicherheit/d0010-security-hardening-roadmap.md
Security-Härtung — Roadmap
Laufende, mehrteilige Security-Härtung des Homeservers. Diese Seite ist die
Übersicht über alle Phasen — erledigte mit Verweis auf die jeweilige
Detail-Doku, offene mit dem, was konkret noch zu tun ist. Reihenfolge ist
absichtlich so gewählt, dass jede Phase auf der vorherigen aufbaut.
Erledigt
| Phase | Inhalt | Doku |
|---|---|---|
| 0 | Quick Wins: Vaultwarden SIGNUPS_ALLOWED: false, ArgoCD-NodePort 30080 (HTTP) aus UFW entfernt, nur noch HTTPS (30443) — Stand 2026-09-24 korrigiert: 30443 sprach wegen server.insecure nie TLS; die Web-UI läuft jetzt per HTTPS über Traefik (argocd.tech.homeserver), 30080 (Klartext) ist nur aus LAN, Tailnet und WireGuard erreichbar und steht als Regel im Repo |
capulus-core/b-kubernetes-gitops/b0010-argocd.md, capulus-core/c-netzwerk-dns/c0030-port-uebersicht.md |
| 1 | CrowdSec — Brute-Force-Schutz SSH + Traefik | capulus-ansible/d-sicherheit/d0020-crowdsec.md |
| 2 | ArgoCD AppProject-Trennung Platform/Workloads + Namespace-Tier-Label | capulus-core/b-kubernetes-gitops/b0020-argocd-projects.md — inkl. eines Incidents beim Rollout, siehe capulus-core/d-sicherheit/d0000-incident-2026-08-12.md |
| 9 | Renovate (automatische Update-PRs) + semantic-release (GitHub Release bei jedem Merge auf main) |
capulus-core/f-cicd-automatisierung/f0020-renovate.md, capulus-core/f-cicd-automatisierung/f0030-release-automation.md |
| 3 | Cluster-NetworkPolicies — grobe Tier-Policy + vollständige Verfeinerung auf alle 36 App-Namespaces (nur noch eigener Namespace + kube-system + monitoring + cloudflared + gezielte Ausnahmen) | capulus-core/d-sicherheit/d0030-network-policies.md — inkl. eines Beinahe-Incidents (Cloudflare-Tunnel-Ausfall während des Rollouts) |
| 4 | k3s Secrets-Encryption-at-Rest (AES-CBC, per Byte-Dump verifiziert) + Audit-Log (Metadata-Level, 14 Tage Retention) | capulus-ansible/d-sicherheit/d0050-secrets-encryption-audit-log.md |
| 10 | Code-Scanning (CodeQL für Go, JS, Python, Swift, Workflows) + Dependabot (Alerts und Fix-PRs für verwundbare Abhängigkeiten) + automatische Security-Issues; einmalig die Repo-Einstellungen aktivieren | capulus-core/d-sicherheit/d0080-codeql-dependabot.md |
Offen
Phase 5 — Internes TLS für *.homeserver
Status (16.08.2026): auf cert-manager umgestellt. Der ursprüngliche
manuelle openssl/mkcert-Ablauf ist abgelöst durch cert-manager, das
Zertifikate automatisch aus derselben Homeserver-Root-CA signiert und vor
Ablauf selbstständig erneuert — Auslöser war ein stillschweigend
veraltetes Zertifikat nach der Domain-Tier-Migration
(capulus-core/c-netzwerk-dns/c0040-domain-tiers.md), das sich ohne laufenden
Signier-Dienst nicht per Commit reparieren ließ. Vollständige Detail-Doku,
Design-Entscheidungen und Anleitung pro Geräte-Typ
(Linux/Windows/macOS/iOS/Android): capulus-core/d-sicherheit/d0040-internal-tls.md.
Ziel: Aktuell laufen alle *.homeserver-Adressen über Klartext-http://
(Traefik hat keine TLS-Zertifikate für das interne LAN).
Ansatz:
- Eigene kleine CA (openssl statt mkcert). Erledigt
- Zertifikat (SAN-Liste statt Wildcard, siehe capulus-core/d-sicherheit/d0040-internal-tls.md), als
Traefik-Default-TLS-Cert (TLSStore) hinterlegt, jetzt automatisch von
cert-manager ausgestellt/erneuert statt manuell signiert. Erledigt,
Umstellung auf cert-manager siehe capulus-core/d-sicherheit/d0040-internal-tls.md - Root-CA-Zertifikat auf allen Client-Geräten im Trust-Store installieren
— das ist der aufwendigste Teil (pro Gerät manuell), unverändert durch
die cert-manager-Umstellung, da dieselbe CA weiterverwendet wird.
Teilweise — Haupt-Dev-Rechner erledigt, weitere Geräte offen, bewusst
nicht blockierend für Schritt 4 http://→https://in Docs/README nachziehen, sobald verifiziert.
Erledigt
Risiko: gering für den Cluster selbst, Aufwand liegt beim Verteilen des
CA-Zertifikats auf alle Geräte.
Phase 6 — NAS/UGOS-Härtung
Ziel: Das UGREEN-NAS wird bewusst nicht per Ansible verwaltet — kein
automatisches Patch-Management, keine dokumentierte Firewall-/2FA-Härtung
für das Admin-Panel des NAS selbst.
Ansatz: Checkliste als neue Doku (docs/NN-nas-hardening.md): Auto-Update
im UGOS-Panel aktivieren, Admin-2FA einschalten, Web-Admin-UI nicht
LAN-weit ohne Not exponieren, unnötige UGOS-Dienste deaktivieren. Rein
manuell, kein Ansible (bewusste bestehende Design-Entscheidung, siehe
capulus-core/2-betrieb-hardware/20000-nas-storage.md).
Risiko: keins — reine Doku + manuelle Klicks im NAS-Panel.
Phase 7 — Secrets-Rotation & Security-Alerting
Status (13.08.2026): Punkt 1 umgesetzt (auf Nutzerwunsch vor Phase 6
vorgezogen), verifiziert bis auf den finalen n8n-Import. Statt einer
reinen Doku-Checkliste: ein n8n-Workflow, der einmal jährlich automatisch
ein Zammad-Ticket eröffnet. Vollständige Doku, Rotations-Checkliste je
Secret und Import-Anleitung: capulus-core/d-sicherheit/d0060-secrets-rotation.md.
Ziel: Keine dokumentierte Rotationskadenz für Ansible-Vault-Passwort,
restic-Passwort, ArgoCD-Admin-PW, Sealed-Secrets-Key. Kein Alerting auf
sicherheitsrelevante Events (UFW-Denies, CrowdSec-Bans, gehäufte
Login-Fehlschläge auf den geschützten Diensten).
Ansatz:
- Erledigt Rotations-Checkliste mit empfohlenem Turnus je Secret
(capulus-core/d-sicherheit/d0060-secrets-rotation.md) — plus aktive jährliche Erinnerung statt nur passiver Doku:
n8n-Workflow (yearly-secrets-rotation-reminder.json, nativer
Zammad-Node) eröffnet automatisch ein Ticket inSupport::Administration.
Muss noch manuell in n8n importiert + aktiviert werden (siehe capulus-core/d-sicherheit/d0060-secrets-rotation.md). - Offen CrowdSec-Ban-Events (aus Phase 1) über den bestehenden
ntfy-Bridge-Mechanismus ausliefern — keine neue Infrastruktur
nötig, nur eine weitere Alert-Quelle an den bestehenden Stack anhängen.
Risiko: gering, additiv zum bestehenden Monitoring.
Phase 8 — Authentik SSO vor allen Apps mit Login
Status: umgesetzt (Authentik seit 06.09.2026 live), im Oktober 2026 wieder aus dem Repo entfernt. Authelia lief als Zwischenlösung
(SQLite, kein Postgres/Redis wie beim ursprünglichen Authentik-Setup),
schützte Uptime Kuma und Mealie per Traefik-ForwardAuth und wurde
vollständig durch Authentik ersetzt.
Historischer Kontext zu Authelia: capulus-core/4-planung/40000-authelia-sso.md.
Es gibt aktuell kein zentrales SSO, jede App nutzt ihren eigenen Login.
Ziel: Eine zentrale Anmeldung (+2FA für Admin-Tools) statt pro App
eigener, unabhängiger Zugangsdaten — inkl. der Möglichkeit, bei Verdacht auf
ein kompromittiertes Passwort zentral zu reagieren.
Risiko: gering pro Batch (gestaffelter Rollout mit Verifikation
dazwischen, analog Phase 3). Vaultwarden, Pacman und MediaMTX bleiben
bewusst ausgenommen (native Clients bzw. öffentlicher Zweck).
Reihenfolge-Empfehlung
Phase 3 → 4 → 5 → 6 → 7 → (8 optional). Phase 6 kann jederzeit
zwischengeschoben werden (rein manuell, keine Abhängigkeiten). Vor Phase 3
und 4 jeweils sicherstellen, dass der Cluster in einem stabilen,
vollständig verifizierten Zustand ist — siehe die offenen Punkte in
capulus-core/d-sicherheit/d0000-incident-2026-08-12.md, die vor
weiteren strukturellen Cluster-Änderungen abgeschlossen sein sollten.