Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/EXT-04.md
T

40 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.