Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/docs/security/SECURITY-AUDIT-2026-07-22.md
T

118 lines
6.0 KiB
Markdown

# Security-Audit und offene Nachzüge — 2026-07-22
Diese Datei ist die zentrale Fundstelle für den repo-weiten Security-Audit vom
22. Juli 2026. Der Audit wurde parallel über Anwendungsoberfläche,
Authentifizierung/RLS sowie Infrastruktur/Supply Chain durchgeführt. Die
direkt im Repository behebbaren Befunde wurden auf dem Branch
`fix/security-audit-20260722` umgesetzt und lokal verifiziert.
Die folgenden drei Punkte sind **bewusst offen**. Raffael hat am 22. Juli 2026
entschieden, sie vorübergehend zu verschieben. Das ist eine dokumentierte
Risikoakzeptanz, keine Behebung und kein Ticket. Diese Datei muss bei der
nächsten Security-Härtungsrunde und vor Änderungen an Deploy-Credentials oder
CI-Qualitätsgates erneut geprüft werden.
| Suchmarker | Priorität | Status | Wieder aufnehmen |
| --- | --- | --- | --- |
| `SECURITY-FOLLOWUP-COSIGN` | Hoch | bewusst verschoben | Nächste Deploy-Härtungsrunde, spätestens vor einer Zusage signierter Herkunftsnachweise |
| `SECURITY-FOLLOWUP-REGISTRY-PULL` | Hoch | bewusst verschoben | Nächste Credential-Rotation oder Coolify-/Registry-Wartung |
| `CI-FOLLOWUP-RESTORE-QUALITY-GATES` | Mittel | temporäre CI-Ausnahme | Nach der kurzfristigen Beschleunigungsphase in den kommenden Tagen |
## SECURITY-FOLLOWUP-COSIGN
**Offenes Risiko:** Die Gitea-Deploy-Pipeline signiert Images derzeit nur,
wenn `COSIGN_PRIVATE_KEY` und `COSIGN_PASSWORD` vorhanden sind. Fehlende Keys
werden skip-safe behandelt. Ein öffentlicher Schlüssel ist nicht eingecheckt,
und vor Promote bzw. Coolify-Deployment gibt es keine fail-closed
Signaturprüfung. Ein Registry- oder Credential-Angriff könnte deshalb nicht
zuverlässig von einem autorisierten Build unterschieden werden.
**Externe Voraussetzung:** Ein Operator erzeugt und verwahrt das Schlüsselpaar
außerhalb des Repositories und setzt die geschützten Gitea-Secrets. Der private
Schlüssel gehört ausschließlich in die geschützte Gitea-CI-Secret-Ablage,
nicht nach Coolify oder auf Runtime-Hosts.
**Abnahmekriterien:**
1. `COSIGN_PRIVATE_KEY` und `COSIGN_PASSWORD` sind als geschützte
Repository-Secrets gesetzt; der öffentliche Schlüssel liegt als
`cosign.pub` im Repo.
2. Stage schlägt fehl, wenn die Signing-Konfiguration fehlt oder Signieren
fehlschlägt.
3. Alle deployten Targets werden digestgebunden signiert: `web`, `api`,
`worker`, `mcp`, `hocuspocus` und `portal-domain-controller`.
4. Jede dieser Signaturen wird nach Stage und vor Promote/Coolify-Mutation
gegen Digest und `cosign.pub` fail-closed geprüft.
5. Die derzeit deaktivierte Provenance-Erzeugung wird entweder aktiviert und
verifiziert oder in einer eigenen, dokumentierten Entscheidung begründet.
6. Workflow-Verifier und Tests decken fehlende Keys, fehlende Signaturen,
falsche Digests und alle sechs Targets ab.
7. Abschluss-Proof: grüner Stage- und Promote-Lauf sowie erfolgreiche
`cosign verify`-Nachweise für alle sechs Images; kein Signing-Skip im Lauf.
## SECURITY-FOLLOWUP-REGISTRY-PULL
**Offenes Risiko:** Der letzte dokumentierte Prod-Rollout verwendete
`gitea-admin` zum Registry-Pull. Diese Credential hat deutlich mehr Rechte als
ein Runtime- oder Coolify-Pull benötigt. Ein Leak auf einem Host oder in
Coolify hätte dadurch einen unnötig großen Blast Radius.
**Externe Voraussetzung:** Ein persönlicher Developer-Token und insbesondere
`gitea-admin` dürfen für diese Änderung nicht verwendet werden. Ein Operator
muss ein dediziertes Servicekonto beziehungsweise einen read-only PAT mit
minimalem Package-Zugriff bereitstellen und die externen Coolify-/Host-
Credentials rotieren.
**Abnahmekriterien:**
1. Dediziertes Konto, beispielsweise `hivegrid-registry-pull`, mit reinem
Lesezugriff auf die HiveGrid-Containerpakete; keine Repo-Schreib-,
Organisations- oder Admin-Rechte.
2. Registry-Credentials in Prod-Coolify und auf allen noch direkt pullenden
Hosts auf das neue Konto rotieren.
3. Pull eines unveränderlichen Full-SHA-Tags für jedes benötigte Image
erfolgreich verifizieren.
4. Alte Admin-PATs und gespeicherte Docker-Credentials nach erfolgreichem
Cutover widerrufen beziehungsweise entfernen.
5. Gitea-Audit-Logs auf unerwartete Nutzung der alten Credential prüfen.
6. Dieses Runbook mit Datum und redigiertem Proof aktualisieren; keine Tokens,
Tokenfragmente oder Registry-Passwörter dokumentieren.
## CI-FOLLOWUP-RESTORE-QUALITY-GATES
**Temporäre Ausnahme:** Für eine kurzfristig schnellere CI wurden die aktiven
Gitea-Workflows für Coverage und Bundle-Budget entfernt und der
Bundle-Budget-Aufruf aus der Haupt-CI gelöst. Die zugrunde liegenden
Verifier, Konfigurationen und die Legacy-/Mirror-Workflows bleiben erhalten.
Bis zur Wiederherstellung können Coverage-Rückgänge und Bundle-Wachstum ohne
dedizierten Gitea-Report passieren.
**Abnahmekriterien:**
1. `.gitea/workflows/coverage.yml` und
`.gitea/workflows/bundle-budget.yml` wiederherstellen.
2. Bundle-Budget wieder in die aktive Haupt-CI und ihre Workflow-Verifier
einbinden.
3. Concurrency-, Wiring- und Reporting-Tests für beide Workflows wieder
aktivieren beziehungsweise auf den ursprünglichen Vertrag zurückführen.
4. Coverage- und Bundle-Budget-Läufe auf dem dann aktuellen `main` grün
ausführen; Baselines nur mit expliziter Review anheben.
5. Diese Ausnahme mit Datum und CI-Run-Proof als abgeschlossen markieren.
## Im Repository behobene Befunde
- Formel-Injection in Spreadsheet-Exports neutralisiert.
- Collaboration-Berechtigungen serverseitig erzwungen.
- Backup-/Restore-Eingaben und Trust-Grenzen gehärtet.
- Trusted-Proxy-/Client-IP-Auflösung gegen gespoofte Header gebunden.
- Ausführbare Supply-Chain-Inputs, Container-Images und externe Quellen
unveränderlich gepinnt.
- Bekannte Dependency-Advisories behoben.
- Secret-Scan auf alle von Git getrackten Dateien und zusätzliche
Credential-Muster erweitert.
- Verschlüsselte Dev-Secrets aus dem Docker-Build-Kontext ausgeschlossen.
Der technische Proof und die einzelnen atomaren Commits stehen im zugehörigen
PR. Operative Geheimnisse oder externe Credential-Werte gehören ausdrücklich
nicht in diese Datei.