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

6.0 KiB

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.