3.3 KiB
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
HiveGridanlegen (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: generischesSTORAGE_*)
Umsetzung (2026-06-17)
- Staging-Bucket
hivegrid-staging-mediaauf Hetzner Object Storage (fsn1) angelegt — über die bestehenden Staging-Object-Storage-Creds (geteiltes Projekt mitmitapp-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.exampleauf Hetzner-Endpoint dokumentiert (Commitb5502f28). - Media-Auslieferung: Weg B beschlossen (privater Bucket + authentifizierter App-Proxy, kein public-read) → AD-23, Umsetzung in P4 (
AK-P4a/b). KeinSTORAGE_PUBLIC_BASE_URL/CNAME für authentifizierte Medien nötig.
Prod erledigt (2026-06-20, verifiziert)
- Prod-Bucket
hivegrid-prodauf 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-mediaab → realhivegrid-prod(im dedizierten Account konsistent zur Namens-Konvention).media.hivegrid.deerst relevant, falls P4 einenpublic/-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.