Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/EXT-06.md
T

3.3 KiB

EXT-06 · Hetzner-Projekt HiveGrid: S3+Token + DEK-Master-Key

Typ Setup (External)
Owner Raffael
Cycle/Fenster W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1
Status geplant

Was zu tun ist

  • Hetzner-Projekt HiveGrid anlegen (Infra-ADR-009): S3-Object-Storage-Bucket + Token, Storage Box für Backups.
  • DEK-Master-Key in den Coolify-Secrets hinterlegen (AD-8 revidiert: app-seitige Envelope-Encryption, kein Cloud-KMS).
  • Die SCALEWAY_*-Env-Vars der Boilerplate auf den Hetzner-S3-Endpoint umziehen (S3-API ist identisch).
  • Muster aus dem Infra-Repo übernehmen.

Warum / was es blockt

Storage und Verschlüsselungs-Key sind Fundament für Datei-Uploads und Feld-Verschlüsselung; ohne sie steht das Infra-Live-Setup.

  • Blocks: P4 (Storage), P5/P17 (DEK), AK-INFRA1 (Infra-Live)

Abhängigkeiten

  • blocked-by: —
  • blocks: P4, P5/P17, AK-INFRA1

Definition of Done

  • S3-Bucket + Token (Staging) — eigenes HiveGrid-Object-Storage-Projekt + Prod-Bucket = Folge
  • DEK-Master-Key in Coolify-Secrets (app-seitig via CRYPTO_SECRET, AD-8)
  • SCALEWAY_*-Env → Hetzner-Endpoint (korrigiert: generisches STORAGE_*)

Umsetzung (2026-06-17)

  • Staging-Bucket hivegrid-staging-media auf Hetzner Object Storage (fsn1) angelegt — über die bestehenden Staging-Object-Storage-Creds (geteiltes Projekt mit mitapp-staging). Put/List/Delete-Roundtrip grün.
  • STORAGE_* (Endpoint/Region/Bucket/Access/Secret/FORCE_PATH_STYLE=true) auf web + api + worker-general/-mail/-import gesetzt (je 201). Bucket privat → signierte URLs.
  • DEK/Verschlüsselung: CRYPTO_SECRET (app-seitiger AES-Master, AD-8) bereits gesetzt; kein separates DEK-Env im Katalog.
  • „Scaleway→Hetzner" war ein Doc-Irrtum: Storage ist generisch STORAGE_*; .env.example auf Hetzner-Endpoint dokumentiert (Commit b5502f28).
  • Media-Auslieferung: Weg B beschlossen (privater Bucket + authentifizierter App-Proxy, kein public-read) → AD-23, Umsetzung in P4 (AK-P4a/b). Kein STORAGE_PUBLIC_BASE_URL/CNAME für authentifizierte Medien nötig.

Prod erledigt (2026-06-20, verifiziert)

  • Prod-Bucket hivegrid-prod auf Hetzner Object Storage (fsn1, https://fsn1.your-objectstorage.com) — liegt im separaten Prod-Hetzner-Account (ADR-016, harte Account-Isolation), nicht im geteilten Staging-Projekt.
  • STORAGE_* (Endpoint/Region/Bucket/Access-Key/Secret/FORCE_PATH_STYLE) auf web + api + worker als Build- + Runtime-Env gesetzt (Coolify-Prod).
  • Roundtrip verifiziert: List + Put + Get + Delete grün gegen den echten Bucket (aktuell 0 Objekte, Prod frisch live). Bucket privat → signierte URLs (Weg B / AD-23).
  • Creds lokal nachgetragen in ~/.cli-tokens/hivegrid-prod-services (mode 600, nicht im Repo).
  • Bucket-Name weicht vom ursprünglich geplanten hivegrid-media ab → real hivegrid-prod (im dedizierten Account konsistent zur Namens-Konvention). media.hivegrid.de erst relevant, falls P4 einen public/-Prefix für genuin öffentliche Assets braucht.

Status: DoD 3/3 erfüllt — 100 %. Staging-Bucket (17.06.) + Prod-Bucket (20.06., verifiziert) beide live, CRYPTO_SECRET gesetzt, Storage generisch STORAGE_*. Selbst machbar offen: 0. Ticket auf Done. Owner: Raffael.