# 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 - [x] S3-Bucket + Token (Staging) — eigenes HiveGrid-Object-Storage-Projekt + Prod-Bucket = Folge - [x] DEK-Master-Key in Coolify-Secrets (app-seitig via `CRYPTO_SECRET`, AD-8) - [x] `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.