118 lines
6.0 KiB
Markdown
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.
|