40 lines
3.1 KiB
Markdown
40 lines
3.1 KiB
Markdown
# 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.
|