# AK-INFRA2 · DNS + Wildcard-TLS + zentrale Dienste anbinden | | | |---|---| | **Typ** | Dev (Ops/Infra — `typ:external`) | | **Owner** | Akeshan | | **Phase** | P1-Querschnitt (Infra-Schiene, kein Code-Modul) | | **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-18 · Gate W1 | | **Status** | geplant | ## Abhängigkeiten & Parallelität - **Blocked by:** `AK-INFRA1` (Staging + Coolify-Apps + DB müssen erst stehen) - **Blocks:** `R-P2a` (mCaptcha), `AK-P4a` (ClamAV), `R-P11a` (Meilisearch) — alle drei brauchen die per-ENV angebundenen Zentral-Dienste - **Läuft parallel zu:** Raffaels P1-Code — **reines Ops, kein Code-Konflikt.** Keine Schema-Berührung. - **Konflikt-Risiko:** keines. ## Was wir bauen Die **Netzwerk-/TLS-Schicht** und die Anbindung der **zentral vorhandenen Dienste** (Memory: Meilisearch/mCaptcha/ClamAV zentral verfügbar). Cloudflare-**Wildcard-TLS** `*.hivegrid.de` inkl. `admin.`- und `staging.`-Subdomains (Multi-Host-Topologie aus den URL-Schemata von R-P1a), plus per-ENV-Anbindung von Meili-scoped-Key, mCaptcha und ClamAV an die Apps. ## Definition of Done - [x] **Meilisearch** (scoped-Key) per ENV angebunden — `MEILI_URL` + `MEILI_API_KEY` auf web/api/worker gesetzt (Coolify, verifiziert 19.06.) - [x] **mCaptcha** per ENV angebunden — `MCAPTCHA_INSTANCE_URL`/`_ACCOUNT_SECRET`/`_SITEKEY_*` + `CAPTCHA_FAIL_OPEN` gesetzt; live: `captcha.saas-ctrl.com` - [x] **ClamAV** per ENV angebunden — `CLAMAV_HOST` (10.42.0.4, privates Netz) + `CLAMAV_PORT` gesetzt - [x] **TLS + Subdomains** für Multi-Host-Architektur — **Staging:** `staging-web`/`staging-api` lösen auf, TLS gültig (HSTS). **Prod (erledigt 20.06. via Prod-Rollout):** `app./api./admin./captcha./coolify.hivegrid.de` lösen auf, alle mit gültigem TLS (`app/api/captcha` CF-proxied, `admin/coolify` Traefik+LE). **Bewusst KEINE `*`-Wildcard**, sondern explizite A-Records pro Subdomain — die ticket-doc selbst warnte vorm Wildcard-Fehlrouting; einzelne Records sind sauberer + zielgenau auf die Prod-IPs. ## Umsetzungsstand / Verifikation (2026-06-19, Owner Raffael) **Verifiziert (Coolify-ENV + Cloudflare-DNS via dig/API):** - Zentral-Dienste mCaptcha/Meilisearch/ClamAV auf web/api/worker **per ENV gebunden** (3/3). - TLS auf Staging gültig (HSTS); `staging-web`/`staging-api` → A `46.225.5.93` (dns-only). Admin = `staging-web` (ADMIN_APP_HOST==WEB_APP_HOST) → kein eigener Host nötig. - **Kein** Wildcard `*.hivegrid.de`; `app./admin./portal.` lösen nicht auf (Prod offen). **Bewusst vertagt → Prod-Rollout (kommt direkt im Anschluss):** Wildcard + echte Prod-Subdomains (`app./admin./api./portal.` → Prod-IPs). Ein Wildcard auf eine Staging-/Marketing-IP würde Prod- Subdomains fehlrouten, deshalb hier KEINE Records angelegt. **Topologie-Überlegung (Raffael, 19.06.):** Prod evtl. unter **eigenem Hetzner-Account** (saubere Trennung Staging/Prod) — betrifft dann DEK-Master-Key, Object-Storage-Bucket und v.a. die Erreichbarkeit der heute privat adressierten Zentral-Dienste (ClamAV `10.42.0.4`, interne PG/Redis-URLs). Entscheidung + ggf. ADR beim Prod-Rollout. **Update 2026-06-20 — Prod-Subdomains live (DoD 4/4 erfüllt → 100 %):** Mit dem Prod-Rollout (eigener Hetzner-Account + eigenes Coolify, ADR-024 / infra ADR-016) sind die echten Prod-Subdomains live mit TLS: `app./api./admin.hivegrid.de` (Apps), `captcha.hivegrid.de` (mCaptcha), `coolify.hivegrid.de` (Coolify-UI). Zentral-Dienste auf Prod neu angebunden (Meili/ClamAV/mCaptcha auf der worker-VM über das private Netz, nicht mehr `10.42.0.4`). Voller Ablauf: `docs/ops/prod-rollout-hivegrid.md`. **Status:** **DoD 4/4 erfüllt — 100 %.** Staging-Scope (W1) + Prod-Subdomains+TLS beide live. Selbst machbar offen: 0. (Estate-Doku im infra-Repo nachgezogen: README-DNS + ADR-016.) ## Warum Die Multi-Host-Architektur (App/Admin/Portal getrennte Subdomains, R-P1a) braucht Wildcard-TLS. Die drei Zentral-Dienste sind harte Vorbedingungen: mCaptcha (Login ab 3. Fehlversuch), ClamAV (Upload-Scan), Meilisearch (Suche P11). Anbindung per ENV statt eigener Deployments (Dienste laufen zentral). ## Quellen (granular) - `EXTERNALS-CHECKLISTE.md` → C1/C2/C5 (DNS/TLS + Zentral-Dienste) - `project_infra_stack` (Memory) → Meilisearch/mCaptcha/ClamAV zentral vorhanden, Cloudflare - `docs/INTEGRATION-CONTRACTS.md` (URL-Schemata / Subdomains aus R-P1a) - abhängig: `AK-INFRA1`