# EXT-04 · KWP: Callback-URLs melden + bnWin.net 8.1 N3 | | | |---|---| | **Typ** | Setup (External) | | **Owner** | Raffael | | **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 | | **Status** | Done · **2/2 DoD = 100 % done** | ## Was zu tun ist - Beide **OAuth-Callback-URLs** (PKCE) an KWP melden: - `https://app.hivegrid.de/integrations/kwp/oauth/callback` - `https://staging-app.hivegrid.de/integrations/kwp/oauth/callback` - **kwp-bnWin.net auf Version 8.1 N3** bei Geerkens-IT aktualisieren lassen (Voraussetzung für die offizielle KWP-API). - KWP-Antwort-Mail in dieser Woche abwarten (Zugang verfügbar ~19.07., nach Launch). ## Warum / was es blockt KWP ist das erste v2-Modul; die API-Anbindung in v2-P10 braucht registrierte Callback-URLs und die aktuelle bnWin.net-Version. - **Blocks:** v2-P10 (KWP-Integration) ## Abhängigkeiten - **blocked-by:** N-KWP (Noah / Geerkens-IT) - **blocks:** v2-P10 (KWP-Integration) ## Definition of Done - [x] Beide Callback-URLs an KWP gemeldet (app + staging, PKCE) - [x] bnWin.net-Update 8.1 N3 bei Geerkens-IT angestoßen ## Umsetzung (2026-06-21, Owner Raffael) - Mail an Noah/Geerkens-IT raus: beide OAuth-Callback-URLs (`app.` + `staging-app.hivegrid.de/integrations/kwp/oauth/callback`, Auth-Code + PKCE, Tenant im `state`) gemeldet, bnWin.net-Update auf 8.1 N3 angestoßen. - Pfad auf `/integrations/kwp/...` aktualisiert (INTEGRATION-CONTRACTS §3, abgelöstes `/api/apps/kwp/...`). - **Außerhalb dieses Tickets:** KWP-Runtime-Proof + read-only Anbindung laufen im v2-Modul → [[VEXT-1]] / [[VR-P32a]]. Freischaltungsdaten, Runtime-Scopes und Dauer-Refresh sind dort bewiesen; `VR-P32a` ist im read-only Scope 5/5 Done. Ein späterer Write-/Auftrag-Create-Vertrag wird ausschließlich in `VEXT-6` nachgehalten und blockiert die initiale Anbindung nicht. - **Nachtrag 2026-06-25:** KWP-Zugang ist **eingetroffen — ~3–4 Wochen früher** als ~19.07. (OAuth2/Keycloak `kwp-federated`, Mandant `geerkens2`). Details + Vertrags-Fragen-Stand in [[VEXT-1]]. Bleibt v2-Scope. - **Nachtrag 2026-06-28 (Callback-Host-Korrektur):** Bei einem Review fiel auf, dass die an KWP gemeldete **Staging**-Callback-URL `https://staging-app.hivegrid.de/...` zum Meldezeitpunkt **nicht als Host existierte** — der reale Staging-Host hieß `staging-web.hivegrid.de` (DNS-Lookup: `staging-app` = NXDOMAIN, `staging-web`/`staging-api` → 46.225.5.93). Die gemeldete URL hätte bei KWP-OAuth ins Leere gezeigt. **Behoben (statt KWP eine neue URL zu melden, den Host an die gemeldete URL angepasst):** Cloudflare A-Record `staging-app.hivegrid.de` → 46.225.5.93 (proxied=false, analog `staging-web`/`-api`) + die Coolify-Domain der App `hivegrid-web` (zentrales Coolify auf `control`) von `staging-web` auf `staging-app` umgestellt + Redeploy (LE-Cert). Der obsolete `staging-web` wurde entfernt (Cloudflare-DNS gelöscht + nicht mehr in der Coolify-Route). Die an KWP/Noah gemeldete URL ist damit gültig — **keine erneute Meldung nötig**. **Status:** **DoD 2/2 erfüllt — 100 %, Done.** Beide selbst-machbaren Punkte (melden + anstoßen) erledigt. Selbst machbar offen: 0.