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

3.1 KiB
Raw Blame History

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

  • Beide Callback-URLs an KWP gemeldet (app + staging, PKCE)
  • 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.