42 KiB
VEXT-1 · KWP-API-Zugang nutzen + Recut-Detailplanung gegen API-Doku
| Typ | Setup (Externals — typ:external) |
| Owner | Raffael |
| Phase | Phase 32 (v2-P5) — KWP-Integration (Vorlauf) |
| Cycle/Fenster | v2-W2 — KWP/Portal/Mobile-Start · fällig 2026-07-20 |
| Status | Done · Demand-Refresh-Dauerbetrieb auf Staging verifiziert · 4/4 DoD = 100 % done |
🔴 Regression 2026-07-23: Der Dauer-Proof vom 22.07. bleibt als historischer Nachweis gültig, reicht aber nicht mehr für einen aktuellen Haltbarkeits-Claim. Nach 20 weiteren erfolgreichen automatischen Rotationen akzeptierte der Token-Endpunkt um 21:08:10 CEST noch eine HTTP-2xx-JSON-Antwort, die anschließend an einem der zusammengefassten semantischen Refresh-Checks scheiterte. Die Connection wurde fail-closed auf
brokengesetzt und benötigt nach dem Fix einen normalen OAuth-Reconnect. Die vorhandene Diagnose unterschied fehlenden Access-/Refresh-Token, nicht rotierenden Refresh-Token, Scope-Echo und Ablaufzeit nicht. Zusätzlich verlangte der automatische Refresh fälschlich exaktexpires_in=300, obwohl der Erst-Login bereits jede positive Laufzeit bis maximal 300 Sekunden akzeptiert und OAuthexpires_inals tatsächliche Laufzeit definiert. Der Fix vereinheitlicht diesen Vertrag, protokolliert ausschließlich feste redigierte Diagnosecodes und behält den sicheren Nicht-Replay bei möglicherweise verbrauchtem Einmal-Refresh-Token bei. Bis Deploy, Reconnect und erneutem Langzeit-Proof gilt: VEXT-1: 3/4 DoD = 75 % done · 1 Punkt offen · 1 selbst machbar.
🟢 Regression geschlossen 2026-08-01: Der Demand-Refresh-Fix aus PR
#312lief nach einem normalen OAuth-Reconnect zwei Stunden stabil auf Staging. 20/20 Einmal-Refresh-Token-Rotationen aus Web-, Import- und Health-Pfaden gelangen; acht Health-Sweeps meldetenchecked=1,unhealthy=0. Es gab keinen Provider-, Persistenz- oder Claim-Fehler und keine erneute Reconnect-Aufforderung. VEXT-1: 4/4 DoD = 100 % done · 0 Punkte offen · Done.
🟢 Superseding Scope-Entscheidung 2026-07-22: VEXT-1 ist für den initialen aktuellen read-only KWP-Vertrag vollständig abgeschlossen. Project-/Auftrag-Create, Writeback, Push-Queue und M091 sind keine Rest-DoD von VEXT-1 oder
VR-P32a; die fehlende externe Write-/Create-Capability wird separat inVEXT-6als Blocked / On Hold nachgehalten.VEXT-6blockiert keine read-only Connector-/Inbound-Tickets. Die datierten Vertrags- und Diagnoseeinträge unten bleiben als Historie erhalten.
🟢 Update 2026-06-25 — Freischaltungsdaten eingetroffen (früher als ~19./20.07.): KWP hat den OAuth2-Client für den Mandanten
geerkens2bereitgestellt. Der reine Kalenderblocker ist damit aufgelöst; die KWP-Phase bleibt jedoch durch Runtime-Token/Scope-Proof und die fehlende Auftrag-Create-Capability blockiert. R-P5 (Apps-Engine M33a) ist inzwischen abgeschlossen. Stand der 7 Vertrags-Fragen siehe Umsetzungs-Notiz unten. KWP bleibt v2-Scope.
🟡 Update 2026-07-12 — tenant-spezifischer Vertrag verifiziert: Der KWP-Loadbalancer löst
geerkens2aktuell aufhttps://geerkens2.app04.kwp-online.deauf. Maßgeblich ist die Tenant-OpenAPI unter/relay/geerkens2/pwa/swagger/v1/swagger.json(OAS 3.0.1, 301 Pfade, 303 Operationen, 396 Schemas, SHA-2565c504ffa955bc492fcc16ae01a92ad0491db29a904ad59058123fc3b24f26762). Endpoints, Dokumentenfluss und partielle Konfliktfelder sind damit belastbar erfasst. Ein echter Token-/Resource-Call bleibt offen, weil die per Mail genannten Keycloak-Endpunkte von den OAuth-Endpunkten der Tenant-Swagger abweichen. Formal abgeschlossen sind der Recut-Ausschluss vonkwpsync.exesowie Redirect-/AVV-Nachzug.
🟡 Runtime-Probe 2026-07-12 — Benutzerlogin fehlt: Client-ID, Client-Secret, Kundenkürzel und die von KWP gelieferten Scopes liegen verschlüsselt in
secrets/dev.sops.env; Klartextwerte stehen nicht in Git oder dieser Doc. Keycloak lehntclient_credentialsab, weil der Service-Account für den Client deaktiviert ist, und lehnt den Device Authorization Grant ab, weil dieser Flow ebenfalls deaktiviert ist. Damit ist Authorization Code + PKCE mit einem echten bnWin-Benutzer der einzige freigeschaltete Login-Pfad. Die Kombinationopenid+ fünf*-extern-Scopes +offline_accesswird am Authorization-Endpunkt akzeptiert; der zusätzliche Discovery-Scopeinvalid_scope. Token-Austausch und erster Resource-Call warten auf einen berechtigten Geerkens/bnWin-Testbenutzer ausVN-1.
🟢 Herstellerantworten 2026-07-20 — Recut-Planung fachlich geklärt: Pro Client gilt ein Hard-Cap von 60 Requests/Minute; weitere Vorgaben zu Parallelität, Backoff, Jitter oder
429wurden nicht gemacht. Access-Token gelten 5 Minuten plus 5 Minuten technischen Clock-Skew. Refresh-Token gelten 30 Tage idle / maximal 365 Tage, sind einmalig und rotieren bei jeder Access-Token-Anforderung; eine Passwortänderung oder Benutzerdeaktivierung widerruft sie. KWP bietet keine Änderungs-Webhooks oder authentifizierten Änderungs-Callbacks, Delta-Cursor, als Delta-Vertrag nutzbaren einheitlichen Änderungszeitstempel oder „geändert seit“-Filter und keine Sandbox bzw. keinen Testkunden.x-kwp-client-versionist optional. Die Neuanlage eines Projekts/Auftrags über die API ist ausdrücklich nicht vorgesehen.mandantwird nur gesendet, wenn in kwp-bnWin.net ein Mandant eingerichtet ist, dann mit dessen Kürzel; andernfalls entfällt der Queryparameter. Ob dies für Geerkens zutrifft, ist noch offen. Damit ist die Recut-Detailplanung abgeschlossen; nur der echte Login-/Token-/Resource-Proof bleibt offen.
🟢 Herstellerdiagnose zum fehlgeschlagenen Login 2026-07-20: Laut KWP-Logs aktualisierte sich der BackendApi-Dienst erst am 13.07.2026 auf 2.81.62; die damaligen Tests liefen größtenteils am 12.07. und damit vor dem erforderlichen Backend-Stand. KWP erwartet, dass die Anmeldung jetzt funktioniert. Diese Diagnose ersetzt den ausstehenden Retest nicht. Verbindlich sind der zentrale Issuer
https://id.kwp-online.de/realms/kwp-federatedund für die Geerkens-Resource die Audiencehttps://geerkens2.app04.kwp-online.de/relay/geerkens2/pwa. Einen separatenresource-Wert hat KWP nicht benannt, sondern um Präzisierung gebeten; er bleibt deshalb ohne erfundenen Claim-/Parametervertrag offen.
🟡 Lokaler Retest 2026-07-20 — Versionsblocker weg, BNWIN-Login offen: Der echte lokale HiveGrid-Pfad erreicht nach Login, Tenant-/Feature-/Permission-Gate und CSRF-Prüfung den zentralen Keycloak-Authorization- Endpoint mit allen sieben vereinbarten Scopes,
tenant=geerkens2, State, Nonce und PKCE/S256. Die lokale Callback-URL wird erwartungsgemäß mit400 invalid_redirect_uriabgelehnt; die bereits registrierte Staging-Callback-URL liefert mit demselben Request200und das BNWIN-Loginformular. Parallel liefernCore/GetApiVersionden Wert2undCore/GetVersiondie Hersteller-Version 2.81.62. Ein geschützter Adressaufruf ohne Token endet korrekt mit401 Bearer. Damit ist der frühere Backend-Versionsblocker ausgeräumt. Die registrierten HiveGrid-Staging-Routen selbst liefern aktuell noch404, weil der lokale Pilot-Branch nicht deployt ist. Auth-Code, Token, Scope-Claims, authentifizierter Resource-Call und Refresh bleiben bis zu Deploy und echtem BNWIN-Login offen. Es wurde kein Credential rotiert.
🟢 Dependency-Ausnahme 2026-07-20: In
VR-P32adarf ausschließlich der schmale Geerkens-Pilot-Slice vor Abschluss dieses Tickets umgesetzt werden: OAuth2/PKCE-Start, fester Callback, Code-/Token-Austausch und per-Tenant-DEK-verschlüsselte Persistenz. Read-only Relay-Discovery und Health sind ausschließlich als notwendiger Live-Proof enthalten; Refresh-Rotation gehört zum Token-Lifecycle. Pull, Push und manueller Sync sind in diesem Slice nicht freigegeben. Die Ausnahme ersetzt weder den berechtigten bnWin-Testbenutzer ausVN-1noch Auth-Code-, Token-, Scope- und Resource-Proof.VEXT-1bleibt deshalb Blocker für Live-Verifikation und Done vonVR-P32a; ohne erfolgreichen bnWin-Login begründet der Slice keinen Live- oder Done-Claim.
🟡 Staging-Erst-Proof 2026-07-21: Der echte BNWIN-Authorization-Code-/PKCE-Flow war auf Staging vollständig erfolgreich. HiveGrid tauschte den Code am zentralen Keycloak aus, akzeptierte ausschließlich die fünf verpflichtenden
*-extern-Scopes, rief mit dem Access-Token den geschützten Relay-EndpunktCore/GetApiVersionerfolgreich auf und persistierte die OAuth-Credentials per-Tenant-DEK-verschlüsselt in einer aktivenDataConnection. Der General Worker rotierte den einmaligen Refresh-Token anschließend automatisch; die Token-Ablaufzeit rückte dabei um weitere fünf Minuten vor und der Connection-Health bliebactive. Kein Client-Secret, Passwort oder API-Key wurde rotiert; ausschließlich der von KWP zwingend rotierende Einmal-Refresh-Token wurde im normalen Refresh-Flow ersetzt.KWP_MANDANTblieb ungesetzt und Produktion blieb unverändert. Dieser Lauf beweist den echten Auth-/Resource-Pfad, aber noch keinen stabilen Dauerbetrieb: Ein späterer Refresh schlug um 03:09:54 CEST fehl und setzte die Verbindung aufbroken.
🟢 Mandantenvertrag und Scope-Freigabe 2026-07-21: Die aktuelle Geerkens-Tenant-OpenAPI enthält
GET /api/Mandant/Load. Der Endpoint beschreibt die für den angemeldeten Benutzer zulässigen Mandanten alsDtoMandant{id, kuerzel, bezeichnung}und ist damit die bevorzugte Discovery für den neuen VR-P32a-Verbindungsflow. Seine OpenAPI-Security nennt jedoch nicht die fünf für HiveGrid gelieferten*-extern-Scopes, sondern andere KWP-interne Produkt-Scopes; die Capability ist für den externen Client deshalb erst zur Laufzeit beweisbar. Die Implementierung darf bei fehlender Berechtigung nicht „kein Mandant“ annehmen, sondern verlangt eine ausdrücklichenone-Bestätigung oder das manuell eingegebene exakte Kürzel. Die konkrete Geerkens-Zuordnung bleibt Live-/E2E-Input, blockiert aber nicht mehr den generischen Setup-Bau. Der vorprovisionierte Pilot bleibt processweit anKWP_HIVEGRID_TENANT_IDgebunden; eine sichere Mehr-Tenant-/Mehr-Kunden-Provisionierung ist Folge-Scope.
Was zu tun
KWP-API-Zugang aktivieren und die Recut-Detailplanung pro Milestone gegen die echte API-Doku durchführen — nicht gegen Annahmen. Konkret die 7 ursprünglich offenen Vertrags-Fragen aus dem bindenden Recut klären und je Milestone (M089–M095) entscheiden (Auflösungsstand siehe Umsetzung):
- Auth-Runtime (Keycloak- oder Relay-
/connect/*-Endpoint, Token-/Refresh-Verhalten) →App.connectionType='oauth2'+ Credential-Handling ist bereits gesetzt - Endpoints + Capabilities (welche Entitäten les-/schreibbar: Aufträge, Stammdaten, Belege, Plantafel, Dokumente?)
- Webhook-/Delta-Support außerhalb der Tenant-OpenAPI → laut Hersteller nicht vorhanden; ein späterer Pull muss ohne Delta-Mechanismus geplant werden
- Rate-Limits → 60 Requests/Minute Hard-Cap pro Client; bestimmt Replay-Rate (M091) und Pull-Intervalle
- Versionierung/Changelog → API
v1,x-kwp-client-versionoptional; bestimmt Umfang M092 (eigenständig vs. in M089) - Dokumenten-API (Listing + Download) → Voraussetzung M095
- Konflikt-Felder pro Endpoint → M093 nutzt mangels einheitlicher Felder HiveGrid-Snapshots + Audit-Restore
In v1 bereits erledigt (Andockpunkte): Callback-URL https://app.hivegrid.de/integrations/kwp/oauth/callback an KWP gemeldet (feste URL, Tenant im state, OAuth Auth-Code + PKCE); bnWin.net-8.1-N3-Update bei Geerkens angestoßen. Produktions- und Staging-Redirect werden vom Authorization-Endpunkt akzeptiert (Probe 2026-07-12).
Warum / blockt
Die Detailplanung ist durch OpenAPI, Herstellerantworten und den erfolgreichen Staging-Runtime-Proof belastbar.
Der Proof gibt keinen über den read-only Geerkens-Scope hinausgehenden Sync-Bau frei. Der vom Hersteller
nicht unterstützte Project-/Auftrag-Create wird in VEXT-6 geparkt; die fehlenden kontrollierten fachlichen
Testdaten bleiben in VN-1 separat zu klären.
kwpsync.exe NICHT bauen (Recut bindend, M089 = Connector statt Windows-Client). ⚠ Creds liegen bei API-Anbindung verschlüsselt in der Cloud
(DataConnection.credentialsCiphertext, Per-Tenant-DEK) — Spec-19.1.2 gilt nicht mehr 1:1 → Vermerk an AVV/Subprozessoren
(VR-P31/M166) weiterreichen.
Abhängigkeiten
- Blocked by: keine.
VN-1bleibt wegen des noch nicht kontrolliert freigegebenen Geerkens-Datenbereichs und des fehlenden minimal berechtigten BNWIN-Testbenutzers eigenständig bei 0/1. Die generische Discovery-/Auswahl-Implementierung inVR-P32aist abgeschlossen; im Live-Reconnect wurde genau eine Geerkens-Bindung ausdrücklich bestätigt und verschlüsselt gespeichert. Kontrollierte fachliche Daten-Calls und Sync-E2E bleiben weiterhin Scope vonVN-1/VN-2. - Blocks: keine read-only Connector-Tickets mehr.
VR-P32aist nach dem zweistündigen Demand-Refresh- Dauer-Proof 5/5 Done; der Code-/Fixture-Proof und credential-geschützte Staging-Betrieb vonVR-P32b/VR-P32dbleiben abgeschlossen. Ein möglicher späterer Write-/Create-Vertrag liegt ausschließlich inVEXT-6. - Parallel: v1-Andockpunkte (Apps-Engine M33a, Extension-Points) stehen bereits — dieser Task füllt nur die Vertrags-Lücken.
Definition of Done
- KWP-API-Zugang dauerhaft aktiv (Auth-Code, Token, Scope und geschützter Resource-Call bleiben bewiesen; erneuter Langzeit-Proof nach Refresh-Regression mit 20/20 Demand-Rotationen erbracht)
- Recut-Detailplanung pro Milestone (M089–M095) gegen echte Doku + Herstellerantworten — alle 7 Vertrags-Fragen für die Planung beantwortet
kwpsync.exeNICHT gebaut (Recut bindend bestätigt)- Staging-Redirect-URI bei KWP registriert; AVV/Subprozessor-Vermerk an VR-P31 weitergereicht
Quellen (granular)
.planning/KWP-API-CONTRACT.md(bindend) → 7 offene Vertrags-Fragen,appsEngine.prisma-Übernahme-Liste, Credential-Hinweis- Offizielle KWP-API-Dokumentation → dynamische
Host-Auflösung, userbezogene Auth,
mandant-Query und Azure-Blob-Dokumentenaustausch - Tenant-OpenAPI
https://geerkens2.app04.kwp-online.de/relay/geerkens2/pwa/swagger/v1/swagger.json→ maßgeblicher maschinenlesbarer Vertrag fürgeerkens2, einschließlichGET /api/Mandant/Load/DtoMandant(Snapshot/Hash siehe Umsetzung) ROADMAP-V2.md→ §v2-P5 + §Offene Vorlauf-Tasks #1 (Runtime-/Capability-Restvertrag)ROADMAP.md→ Phase 32 · Milestones: (Callback-URL gemeldet, bnWin.net-8.1-N3, Andockpunkte v1)- abhängig-für:
ticket-docs/VR-P32a.md/VR-P32b.md/VR-P32c.md
Umsetzung (2026-06-25 / Vertragsprüfung 2026-07-12 / Herstellerantworten 2026-07-20, Owner Raffael)
Historischer Abschlussstand: VEXT-1: 4/4 DoD = 100 % done. Der Staging-Erst-Proof vom 2026-07-21 schloss Auth-Code,
Token, Scope, geschützten Resource-Call und verschlüsselte Persistenz ab. Der Haltbarkeits-Deploy und neun
aufeinanderfolgende automatische Refresh-Rotationen vom 2026-07-22 schließen den Dauer-Live-Punkt. VN-1
bleibt als eigenständiges Testumgebungs-Ticket offen. Im Reconnect wurde eine Bindung über den generischen
Verbindungsflow ausdrücklich bestätigt und verschlüsselt gespeichert; ihr Wert wird nicht in dieser Doc
wiederholt und begründet keine Freigabe kontrollierter Fach-E2E-Daten. Proof
2026-07-12: Tenant-OpenAPI vollständig
abgerufen und per SHA-256 fixiert; offizielle KWP-Webdoku gegengeprüft; Keycloak-Authorization-Probe mit dem
gelieferten externen Client, PKCE/S256 und den fünf externen Scopes für Produktions- und Staging-Redirect jeweils
HTTP 200/Login-Seite ohne invalid_client oder invalid_redirect; kein ausführbarer kwpsync.exe-Konsument
im Repository angelegt. Der Staging-Redirect ist damit am Authorization-Endpunkt plausibilisiert; der konkrete
Cloud-Credential-/Relay-/Azure-Austausch-Vermerk wurde am 2026-07-12 in VR-P31 übernommen.
Zusatz-Proof 2026-07-12: Die Freischaltungs-Mail wurde ausschließlich lokal verarbeitet; die Felder
KWP_OAUTH_CLIENT_ID, KWP_OAUTH_CLIENT_SECRET, KWP_OAUTH_SCOPES, KWP_CUSTOMER_CODE und
KWP_OIDC_ISSUER wurden per SOPS/age verschlüsselt abgelegt. Für lokale Tests und Staging bleibt das aktuell
provisionierte Secret unverändert; ohne ausdrücklichen User-Auftrag wird es weder rotiert noch als Test- oder
Deploy-Blocker behandelt. Der Token-Endpunkt antwortete auf
client_credentials mit 401 unauthorized_client (Service-Account deaktiviert); der Device-Endpoint auf den
Device Authorization Grant mit 400 unauthorized_client (Flow deaktiviert). Scope-Probes bestätigten die fünf
gelieferten *-extern-Scopes gemeinsam mit openid/offline_access; nur email ist für den Client nicht
freigeschaltet. Der Auth-Code-Flow leitete an die bei KWP registrierte Staging-Redirect-URL weiter; dort war zu
diesem Zeitpunkt noch kein HiveGrid-Callback-Handler deployt. Ohne bnWin-Benutzerlogin entstand zudem kein
Code/Token. Einmalige PKCE-State-/Verifier-Dateien wurden danach lokal entfernt.
Lokaler Pilot-Slice 2026-07-20: Der Worktree enthält nun den festen Setup-/Callback-Pfad und bindet die
Prozess-Credentials über KWP_HIVEGRID_TENANT_ID an genau einen HiveGrid-Tenant. Dieser Stand ist nicht auf
Staging oder Produktion deployt und begründet weder einen erfolgreichen Callback noch Token-/Resource-Proof.
KWP_MANDANT bleibt bis zur Geerkens-Antwort bewusst ungesetzt. Lokaler Basis-Proof: Implementierungs-Commit
f0a0033bb, Typecheck/Lint grün und 6.926 Tests bestanden; den vollständigen Verify-Stand einschließlich der
vorbestehenden Route-Inventar-Drift dokumentiert VR-P32a. Das ist nur Code-Regressions-Proof und kein
Auth-/Token-/Scope-/Resource-/Refresh-Live-Proof. KWP-Disconnect ist im Pilot in UI und Action fail-closed deaktiviert, weil eine lokale
Connection-Löschung den Keycloak-Refresh-Token nicht nachweisbar widerruft. Reconnect bleibt möglich;
providerseitige Revocation ist unverifiziert und bleibt Token-Lifecycle-Nachzug sowie Live-Blocker.
Plane-Kommentar: 00c2720b-1a72-44b8-9d51-5b7c7c1fa647. VEXT-1 bleibt 3/4 DoD = 75 % done.
Lokaler HTTP-/Provider-Proof 2026-07-20: Login 200, Session 302, authentifiziertes KWP-Setup 200
und Authorization-Redirect 302 wurden über den laufenden lokalen Web-Prozess ausgeführt. Der erzeugte
Authorization-Request ist vollständig und verwendet exakt die sieben vereinbarten Scopes sowie PKCE/S256.
Keycloak akzeptiert die registrierte Staging-Callback-URL (200, BNWIN-Loginformular), nicht jedoch die nicht
registrierte Localhost-Callback-URL (400 invalid_redirect_uri). Die Staging-Setup-/Callback-Routen liefern
bis zum Deploy dieses Branches beide 404. Damit endet ein rein lokaler E2E-Lauf vor der Benutzeranmeldung.
Dieser Proof ändert die DoD-Zählung nicht: VEXT-1 bleibt 3/4 DoD = 75 % done; offen:
1 Punkt, extern durch BNWIN-Testzugang/mandant-Auskunft blockiert, 0 selbst machbar.
Staging-Callback-Retest 2026-07-20: Der echte BNWIN-Login einschließlich Zustimmung wurde abgeschlossen
und der gültige OAuth-Rückruf erreichte HiveGrid. Challenge und state wurden erfolgreich eingelöst; der
anschließende Token-/Aktivierungspfad endete jedoch vor jeder verschlüsselten Token-Persistenz, und die
reservierte Verbindung blieb pending. Der bisherige Catch ließ Token-Austausch, KWP-Health und Persistenz
nicht sicher unterscheiden; der Follow-up ergänzt dafür ausschließlich feste, secretsichere Diagnosecodes.
Ein geschützter Resource-Aufruf steht weiter aus. Es gab keine Credential-Rotation und keine Änderung an
Produktion oder KWP_MANDANT. VEXT-1 bleibt 3/4 DoD = 75 % done; offen: 1 Live-Proof-Punkt.
Der secretsichere Diagnose-Follow-up liegt lokal in Commit 4886f3132; 57/57 gezielte KWP-Tests und der
vollständige Lauf mit 6.975 bestandenen / 55 übersprungenen Tests sind grün. Ein neuer Live-Versuch folgt
erst nach dem Staging-Deploy dieses Commits.
Staging-Scope-Diagnose 2026-07-21: Nach dem Deploy der secretsicheren Diagnose auf Revision
65976d712 erreichten zwei frische OAuth-Rückrufe den Token-Austausch und scheiterten reproduzierbar mit
exchange_failed / scope_mismatch. Damit ist die alte einzelne pending-Verbindung als Ursache
ausgeschlossen: Der Setup-Pfad verwendet sie bei jedem neuen Versuch weiter, und ein fehlgeschlagener Callback
verändert sie nicht. Der Token-Response enthielt bereits Access-Token, Refresh-Token und eine gültige Ablaufzeit;
HiveGrid verlangte danach jedoch fälschlich ein exaktes Echo aller sieben Request-Scopes. Der lokale Fix lässt
im Response-Echo ausschließlich das Fehlen von openid und/oder offline_access zu. Alle fünf
*-extern-Scopes bleiben zwingend, unbekannte und doppelte Scopes werden abgelehnt, und Requests sowie
verschlüsselte Soll-Policy bleiben exakt auf den sieben kanonischen Scopes. Derselbe Vertrag gilt beim Refresh;
Rotation und 300-Sekunden-TTL ändern sich nicht. Lokaler Proof: 80/80 gezielte KWP-Tests, 189/189
Tests im Integrationspaket und der vollständige Lauf mit 6.985 bestandenen / 55 übersprungenen Tests sind
grün; ebenso Typecheck, Lint, die vier allgemeinen Repository-Validatoren, git diff --check und der
EU-Provider-Scan. Keine Rotation, keine Änderung an KWP_MANDANT, keine Produktionsänderung. Ein Deploy und
der geschützte Resource-Call stehen weiter aus;
VEXT-1 bleibt 3/4 DoD = 75 % done.
Staging-Abschluss-Proof 2026-07-21: Der Scope-Fix aus PR #191 wurde als Revision 56d2b4f00
ausschließlich auf Staging deployt; Deploy-Run 10863 war erfolgreich und alle Staging-Runtime-Container
liefen anschließend auf exakt dieser Revision. Der danach neu gestartete echte BNWIN-Login samt Zustimmung
schloss den Authorization-Code-/PKCE-Flow ab. Der Callback aktivierte genau eine DataConnection, speicherte
die Credentials per-Tenant-DEK verschlüsselt und führte über den registrierten KWP-Adapter einen erfolgreichen
geschützten Health-Aufruf auf Core/GetApiVersion aus. Der Datenbank-Proof zeigte connectionStatus=active,
vorhandenes Ciphertext-Material und healthMessageKey=integrations.kwp.health.active. Um 02:54:47 CEST
schloss der General Worker integrations-token-refresh erfolgreich ab; tokenExpiresAt rückte dabei auf
02:59:47 CEST vor und der anschließende Health-Stand blieb active. Da der Adapter beim Refresh einen
neuen, vom vorherigen Wert verschiedenen Refresh-Token verlangt, beweist dieser Lauf auch die einmalige
Refresh-Token-Rotation. Es wurden keine Token-, Secret- oder Passwortwerte ausgelesen oder protokolliert.
Kein Client-Secret, Passwort oder API-Key wurde rotiert; ausschließlich der von KWP zwingend rotierende
Einmal-Refresh-Token wurde im normalen Refresh-Flow ersetzt. KWP_MANDANT blieb ungesetzt und Produktion
blieb auf der unveränderten Revision 6100b4e16. Dieser Erstlauf erfüllte den Live-Proof zunächst vollständig;
die nachfolgende Langzeitkorrektur nimmt den damaligen Abschluss-Claim wieder zurück.
Langzeit-Korrektur 2026-07-21: Der Erst-Proof war echt, der Dauerbetrieb ist jedoch nicht grün. Nach einem
erfolgreichen Refresh um 03:04:46 CEST (refreshed=1, Dauer 701 ms) endete der nächste Lauf um
03:09:54 CEST nach 7,36 s mit refreshed=0, failed=1. Die DataConnection steht seitdem auf
broken, healthMessageKey=integrations.health.refreshFailed; Ciphertext bleibt vorhanden. Der auf der
damaligen Staging-Revision laufende Worker verwirft beim Provider-Aufruf den konkreten Fehlercode, daher lässt
sich aus Worker-, BullMQ- und Loki-Proof nicht sicher zwischen Provider-Ablehnung und transientem
Transportfehler unterscheiden. Kein
Client-Secret, Passwort oder API-Key wurde rotiert, KWP_MANDANT blieb ungesetzt und Produktion unverändert.
Der vorherige 100-%-Claim wird zurückgenommen: VEXT-1: 3/4 DoD = 75 % done · 1 Punkt diagnostisch offen ·
1 selbst machbar.
Lokaler Refresh-Stabilitätsfix 2026-07-21: Der zu diesem Zeitpunkt noch nicht deployte Follow-up klassifiziert
Providerfehler ausschließlich über feste Diagnosecodes und einen optionalen numerischen HTTP-Status; weder
Provider-Body noch Token- oder Secret-Werte werden gespeichert oder geloggt. Genau ein transienter Fehler
(408, 429, 5xx, Netzwerk/Timeout oder die allowgelisteten OAuth-Fehler server_error und
temporarily_unavailable) wird nach frühestens fünf Minuten einmal wiederholt. Dauerhafte Auth-/Scope-/
Credential-Fehler und ein zweiter transienter Fehler setzen die Verbindung auf broken und verlangen einen
Reconnect. Während des Retry-Fensters läuft keine konkurrierende Health-Probe. Auch nach erfolgreichem
Token-Retry bleibt die Verbindung degraded mit integrations.health.refreshRecovered, bis ein echter
geschützter Core/GetApiVersion-Probe sie wieder auf active setzt. Ein älter als zehn Minuten liegen
gebliebener Claim wird ohne erneuten Provider-Aufruf terminalisiert. BullMQ weist geplante Retries separat als
retryScheduled statt als failed aus. Tests decken die persistierte Einmal-Token-Kette r1 → r2 → r3,
die Fünf-Minuten-Grenze, unbekannten POST-Ausgang, Status-/OAuth-Klassifizierung, Retry-Erschöpfung,
Resource-Probe und Stale-Claim-Recovery ab. Der bestehende broken-Datensatz wird absichtlich nicht mit alten
Credentials erneut verwendet; nach dem Staging-Deploy ist genau ein neuer interaktiver OAuth-Reconnect nötig.
Lokaler Proof: 80/80 gezielte KWP-Tests, 217/217 Tests im Integrationspaket, 1/1 fokussierter
Worker-Handler-Test sowie der vollständige Root-Lauf mit 7.026 bestandenen / 55 übersprungenen Tests sind
grün. Ebenso grün sind Root-Typecheck, Root-Lint, Integrations-/Worker-Typecheck, verify:ci-baseline,
verify:source-health, verify:i18n, verify:secrets, git diff --check und der EU-Provider-Scan.
Bis dieser Reconnect und mehrere echte Refresh-/Resource-Zyklen stabil belegt sind, bleibt
VEXT-1: 3/4 DoD = 75 % done · 1 Live-Punkt offen · 1 selbst machbar. Es wurde nichts manuell rotiert,
KWP_MANDANT bleibt ungesetzt und Produktion bleibt unverändert.
Staging-Langzeitstand und lokaler Haltbarkeits-Nachzug 2026-07-22: Die beobachtete Staging-Revision war
d4daa0421. Der präzisierte Worker-/Datenbankabgleich zeigt um 03:04:47 CEST einen erfolgreichen
Refresh und um 03:09:53 CEST den direkt folgenden fehlgeschlagenen Lauf. Die DataConnection wechselte
auf broken mit integrations.health.refreshFailed; eine konkrete Provider-/Transportklassifikation war in
den verfügbaren Runtime-Diagnosen nicht vorhanden. Der dauerhafte Runtime-Proof bleibt deshalb offen.
Der Haltbarkeits-Nachzug ist lokal abgeschlossen, aber noch nicht deployt. Er bindet die Handler-Diagnostik an den strukturierten Runtime-Logger, trennt nachweislich replay-sichere Fehlerantworten von mehrdeutigen Token-POST-Ausgängen und wiederholt einen möglicherweise bereits verbrauchten Einmal-Refresh-Token niemals beim Provider. Retries gelten ausschließlich der lokalen Persistenz eines schon erhaltenen Provider-Ergebnisses; der KWP-spezifische Refresh-/Health-Gate wird außerdem früher ausgeführt. Erst mehrere erneute echte Refresh-/Resource-Zyklen können den Live-Punkt schließen. Keine manuelle Rotation, keine Deploy- oder Live-Proof-Behauptung für diesen Nachzug. Der vollständige lokale Root-Testlauf ist mit 7.115 bestandenen / 55 übersprungenen Tests grün; ebenso Root-Typecheck/-Lint, Worker-Build und die relevanten Deploy-, Runtime-, i18n-, Observability-, CI-, Source-, Secret- und Env-Gates. VEXT-1 bleibt 3/4 DoD = 75 % done · 1 Live-Punkt offen · 1 selbst machbar.
Staging-Abschluss des Dauer-Live-Proofs 2026-07-22: Der Haltbarkeits-Nachzug aus PR #210 wurde als
Revision 2938f29da über den erfolgreichen Deploy-Run 10995 auf Staging ausgerollt. Nach genau einem
normalen Authorization-Code-/PKCE-Reconnect war die Connection spätestens beim automatischen geschützten
Health-Probe um 03:54:47 UTC active; der Probe meldete checked=1, unhealthy=0. Der
worker-general rotierte die KWP-Einmal-Refresh-Token danach neunmal automatisch und ohne Fehler:
03:58:09, 04:02:09, 04:06:09, 04:10:09, 04:14:09, 04:18:09, 04:22:09,
04:38:09 und 04:42:09 UTC; tokenExpiresAt stieg dabei bis auf 04:47:09.642 UTC. Alle neun Läufe
meldeten outcome=refreshed, failed=0 und retryScheduled=0; weder Provider- noch Persistenzfehler traten
auf. Die automatischen geschützten Health-Sweeps um 04:24:47 UTC und 04:39:47 UTC meldeten jeweils
checked=1, unhealthy=0. Der abschließende Read-only-Snapshot um 04:44:48 UTC blieb active /
integrations.kwp.health.active mit
verschlüsselten Credentials. Kein Client-Secret, Passwort,
API-Key oder anderes Staging-Credential wurde manuell rotiert; ausschließlich KWP rotierte den
Einmal-Refresh-Token im normalen OAuth-Flow. Produktion blieb unverändert. Der Dokumentationsnachzug ist mit
Root-Typecheck, Root-Lint, 7.115 bestandenen / 55 übersprungenen Tests, verify:ci-baseline,
verify:source-health, verify:secrets, git diff --check und dem EU-Provider-Scan grün.
VEXT-1: 4/4 DoD = 100 % done.
Geliefert von KWP (Mandant geerkens2): OAuth2-Zugang via Keycloak-OIDC, Realm kwp-federated
(id.kwp-online.de). Confidential Client (offline_access), ClientId-Schema _extern-<tenant>, Tenant-Kürzel
als URL-Param tenant=geerkens2 am Authorization-Endpoint. Secret NICHT in Repo/Doc — gehört in
Coolify-Secret-Store bzw. später per-Tenant-DEK in DataConnection.credentialsCiphertext (AD-8). Für Staging gilt die
verbindliche No-Rotation-Regel aus AGENTS.md: vorhandene Credentials unverändert verwenden, solange der User
nicht ausdrücklich eine Rotation anordnet.
OIDC-Discovery aus dem Mail-/Keycloak-Pfad verifiziert (…/realms/kwp-federated/.well-known/openid-configuration):
Auth …/protocol/openid-connect/auth · Token …/token · Userinfo · JWKS …/certs · Logout · Introspection ·
Revocation. grant_types: authorization_code, refresh_token, client_credentials, device_code, token-exchange u.a.
code_challenge_methods: plain, S256 (PKCE ✓). Token-Auth: client_secret_basic/-post, private_key_jwt, mTLS.
scopes_supported global nur openid, email → die fachlichen Scopes sind Client-zugewiesene Keycloak-Scopes
(die aus der Mail sind maßgeblich für unseren Token-Request).
Token-Lifecycle laut Herstellerantwort 2026-07-20: Access-Token gelten 5 Minuten zuzüglich 5 Minuten technischem Clock-Skew. Refresh-Token gelten 30 Tage idle, höchstens 365 Tage, sind einmalig und werden bei jeder Access-Token-Anforderung rotiert. Passwortänderung und Benutzerdeaktivierung widerrufen die Token. Der Geerkens-Pilot muss den jeweils neu gelieferten Refresh-Token verschlüsselt ersetzen.
Auth-Endpunkt-Diskrepanz — Runtime-Pfad live geklärt: Die Tenant-OpenAPI nennt dagegen
https://geerkens2.app04.kwp-online.de/relay/geerkens2/pwa/connect/authorize und …/connect/token.
Der Staging-Live-Lauf bestätigt den von KWP per Mail benannten zentralen Keycloak-Authorization- und
Token-Endpunkt als verbindlichen Runtime-Pfad: Authorization Code + PKCE, Token-Austausch, geschützter
Relay-Resource-Aufruf und Refresh liefen dort erfolgreich. Die abweichenden /connect/*-Metadaten der
Tenant-Swagger werden daher nicht für HiveGrid verwendet. Service-Account- und Device-Flow bleiben für den
Client deaktiviert; der echte bnWin-Benutzerlogin ist zwingend. Laut offizieller KWP-Doku handelt die API
immer im Namen dieses Benutzers; dessen Rechte begrenzen alle Antworten und Schreibaktionen.
Maßgebliche Resource-API für Geerkens: Hosts werden nicht hart kodiert, sondern über
https://loadbalancer.kwp-online.de/Relay/GetAppUrl?linkId=<KUNDENKUERZEL> ermittelt. Für geerkens2 lieferte
der Loadbalancer am 2026-07-12 https://geerkens2.app04.kwp-online.de; der Vertrag liegt unter
/relay/geerkens2/pwa/swagger/v1/swagger.json. Snapshot: OAS 3.0.1 · 301 Pfade · 303 Operationen ·
396 Schemas · SHA-256 5c504ffa955bc492fcc16ae01a92ad0491db29a904ad59058123fc3b24f26762.
Eine erneute Live-Probe am 2026-07-20 nach dem Hersteller-Update liefert OAS 3.0.4 · 550 Pfade · 554
Operationen · 490 Schemas · SHA-256
dcaff9253fe1bd2bf9bf6f29c89de7bd1f4415e115d90320775ead7e49c5febc. Der ältere Wert bleibt als
historischer 12.07.-Snapshot dokumentiert; für weitere Planung ist der 20.07.-Vertrag maßgeblich.
Der Server-Pfad ist /relay/geerkens2/pwa; die API bleibt RPC-artig. Nutzt ein Kunde bnWin-Mandanten, verlangt
die offizielle Doku bei jedem Request zusätzlich den Queryparameter mandant=<Mandantenkürzel>. Der Hersteller
hat präzisiert: Der Parameter wird nur gesetzt, wenn in kwp-bnWin.net tatsächlich ein Mandant eingerichtet ist,
dann mit dem dortigen Kürzel; andernfalls wird er weggelassen. GET /api/Mandant/Load beschreibt die für den
aktuellen Benutzer zulässigen Mandanten als DtoMandant mit interner id, Kürzel und Bezeichnung. Da die
OpenAPI-Security dieses Endpoints andere KWP-Produkt-Scopes statt der fünf gelieferten *-extern-Scopes nennt,
muss VR-P32a den Zugriff opportunistisch prüfen und einen bewussten manuellen Fallback anbieten. Ein Fehler oder
eine leere Antwort darf nicht automatisch als „kein Mandant“ gelten. Die konkrete Geerkens-Bindung steht noch
aus.
Stand der 7 Vertrags-Fragen:
- Auth-Methode → 🟡 Vertrag sowie Auth-/Resource-Erst-Proof abgeschlossen; Dauerbetrieb offen: OAuth2/Auth-Code + PKCE und Refresh/
offline_access→App.connectionType='oauth2'.client_credentialsund Device Flow sind für den Client deaktiviert. Gültiger Request-Scope istopenid+ fünf*-extern-Scopes +offline_access;emaildarf nicht angefordert werden. Userbezogene Rechte sind bindend. Access-Token: 5 Minuten plus 5 Minuten Clock-Skew; Refresh-Token: 30 Tage idle/maximal 365 Tage, einmalig und bei jeder Access-Token-Anforderung rotiert, Widerruf bei Passwortänderung oder Benutzerdeaktivierung. Staging bewies Token-Austausch, geschützten Relay-Aufruf und automatische Refresh-Rotation über den zentralen Keycloak-Pfad. - Endpoints/Capabilities → 🟢 tenant-spezifisch erfasst, Project-Create nicht unterstützt: In den
Operation-Security-Angaben erscheint
adresse-externaktuell an 23,archiv-externan 15,termin-externan 14,vorgang-externan 31 undaktivitaet-externan 31 Operationen. Adresse, Aktivität, Termin/Monteursteuerung, Projekt/Projektampel/Vorgangsanzeige und Archiv sind vorhanden. Laut Hersteller ist die Neuanlage eines kaufmännischen Auftrags/Projekts über die API ausdrücklich nicht vorgesehen;/api/Projekt/Saveändert laut Vertrag nur die Bezeichnung eines bestehenden Projekts. Der geplante Won→Auftrag-Push ist damit im aktuellen Vertrag nicht umsetzbar und darf nicht auf eine andere Operation umgedeutet werden. - Webhook-/Delta-Support → 🟢 geklärt, nicht vorhanden: KWP bietet keine Änderungs-Webhooks oder authentifizierten Änderungs-Callbacks und keine Delta-Cursor, als Delta-Vertrag nutzbaren einheitlichen Änderungszeitstempel oder „geändert seit“-Filter. Einzelne DTO-Felder aus Punkt 7 bilden keinen Delta-Vertrag. Ein späterer Pull muss daher ohne diese Herstellermechanismen geplant werden; er gehört nicht zum freigegebenen Callback-Slice.
- Rate-Limits → 🟢 geklärt: 60 Requests/Minute Hard-Cap pro Client. Weitere Vorgaben zu parallelen
Verbindungen, Backoff, Jitter oder
429wurden nicht gemacht. Replay und Pull müssen den Hard-Cap selbst sicher einhalten; ihre Implementierung gehört nicht zum freigegebenen Callback-Slice. - Versionierung → 🟢 Planungsgrundlage geklärt: API-Dokument
v1; der an allen 554 Operationen geführte Headerx-kwp-client-versionist laut Hersteller optional. Ein Pflicht-/Mindestwert wurde nicht vorgegeben; M092 plant deshalb gegen den verifizierten Vertrag statt gegen einen angenommenen Mindestwert. - Dokumenten-API → 🟢 vertraglich geklärt: Listing/Suche/Details/Revisionen und Export sind unter
/api/archiv-extern/*vorhanden. Dateien laufen laut offizieller Doku nicht im API-Body, sondern über Azure Blob Storage:GetSetup.azureConnectionUrimaximal 6 h cachen; Blobs werden nach 24 h gelöscht;ExportDatei(revisionId,guid)liefertexchangeFileUri, diese URL liefert JSON mit dem eigentlichen Downloadlink. Upload: Blob ablegen, dannImportDatei(containerId,dateiname)aufrufen. - Konflikt-Felder → 🟢 Planungsentscheidung abgeschlossen: Aktivitäten liefern
datumAenderung/userAenderung; Archiv- DTOs liefernletzteAenderungAm/letzteAenderungVonsowierevisionId/revision. Adresse, Termin und Projekt/Vorgang haben keine einheitlichen Record-Versionen oder Änderungszeitstempel. Es gibt keineETag-/Last-Modified-Responses oderIf-Match-Preconditions. M093 darf daher nicht auf uniformes KWP-Optimistic-Locking bauen.
Scope-Mapping — Authorization und Resource-Akzeptanz live bewiesen: Die fünf *-extern-Scopes stehen jetzt direkt
an den oben gezählten Operationen. Sie fehlen jedoch in der Scope-Liste des OAuth-Flows; außerdem kombiniert die
Spec interne und externe Scope-Namen in einer Security-Liste, die nach strikter OpenAPI-Semantik alle Scopes
gleichzeitig verlangen würde. Der Live-Lauf bestätigte alle fünf Pflicht-Scopes im Provider-Echo und die
Akzeptanz des Access-Tokens am geschützten read-only Resource-/Health-Endpunkt. Schreib-Calls gehören nicht
zum Geerkens-Pilot-Slice und wurden nicht ausgeführt.
Abschluss: Auth-Code, Token-Austausch, Pflicht-Scopes, Relay-Pfad, geschützter read-only Resource-/Health-
Call, neun aufeinanderfolgende automatische Refresh-Rotationen und automatische geschützte
Health-Probes sind live bewiesen. Der Providerpfad ist
secretsicher klassifiziert; die Connection blieb active. Der AVV/Subprozessor-Vermerk ist in VR-P31/M166
übernommen und beide Redirects sind registriert. Die weiterhin fehlende KWP-Testumgebung bleibt in VN-1;
sie verhindert keine Erfüllung dieses Zugangstickets. Im Reconnect wurde genau eine Mandantenbindung
ausdrücklich bestätigt und verschlüsselt gespeichert; der konkrete Wert wird nicht in die Ticket-Doc kopiert.
KWP_MANDANT bleibt als processweite Mapping-Quelle ungenutzt.
Superseding Scope-Abschluss 2026-07-22: Der aktuelle Produktvertrag nutzt ausschließlich lesende
KWP-Operationen. Die fehlende Project-/Auftrag-Create-Capability wird nicht mehr als Blocker des Connectors
oder der Inbound-Tickets geführt, sondern in VEXT-6 bis zu einem belastbaren Herstellervertrag geparkt.
VEXT-1: 4/4 DoD = 100 % done.
Regression-Nachzug 2026-07-23: Die Scope-Entscheidung bleibt unverändert read-only. Der erste Dauerbetriebs-DoD ist wegen der oben dokumentierten späteren Refresh-Regression erneut offen; die drei Vertrags-/Recut-Punkte bleiben erfüllt. VEXT-1: 3/4 DoD = 75 % done · 1 Punkt offen · 1 selbst machbar.
Lokaler Regressionsfix-Proof 2026-07-23: Commit ccdc74ebe vereinheitlicht die Laufzeitprüfung von
Erst-Login und automatischem Refresh auf positive ganzzahlige Werte bis maximal 300 Sekunden und ergänzt
feste redigierte Diagnosecodes für sämtliche semantischen Ablehnungsgründe. Ein mehrdeutiger Token-POST wird
weiterhin nicht wiederholt; es wurden keine Credentials manuell rotiert. Proof: Integrationspaket
290/290, fokussierter Worker-Satz 6/6, Root-Typecheck, Root-Lint und Root-Testlauf 1.028 Dateien /
7.387 Tests bestanden, 55 übersprungen sowie sämtliche release-relevanten Vertrags-, RLS-, Coverage-,
Hot-Swap-, Secret-, Deploy- und Build-Gates grün. Der dauerhafte Runtime-Proof bleibt bis normalem Reconnect
und erneutem Staging-Langzeitlauf offen. VEXT-1: 3/4 DoD = 75 % done · 1 Live-Punkt offen.
Demand-Refresh-Live-Abschluss 2026-08-01: PR #312 wurde nach 11/11 grünen CI-Jobs als normaler
Merge a55b811ccd652cc04264d8d09e0f270a6487f27d über Deploy-Run 11609 auf Staging ausgerollt. Nach einem
normalen Authorization-Code-/PKCE-Reconnect endeten im zweistündigen Fenster 20/20 Demand-Refreshes mit
outcome=refreshed; acht Health-Sweeps meldeten checked=1, unhealthy=0. Es gab keine Provider-,
Persistenz- oder Claim-Fehler, keinen broken-/degraded-Status und keine erneute Reconnect-Aufforderung.
KWP wurde aus dem generischen Minutensweep ausgeschlossen und rotierte nur noch vor echter Arbeit oder dem
regulären Health-Fenster. Damit ist der Runtime-DoD wieder geschlossen:
VEXT-1: 4/4 DoD = 100 % done · 0 Punkte offen · Done.
Herstellerantworten (eingearbeitet 2026-07-20)
- Project-Create: Die Neuanlage eines Projekts/Auftrags über die API ist nicht vorgesehen.
- Synchronisation: Keine Änderungs-Webhooks oder authentifizierten Änderungs-Callbacks; keine Delta-Cursor, als Delta-Vertrag nutzbaren einheitlichen Änderungszeitstempel oder „geändert seit“-Filter.
- Rate-Limit: 60 Requests/Minute Hard-Cap pro Client; keine weiteren Vorgaben zu Parallelität,
Backoff, Jitter oder
429. - Token: Access 5 Minuten plus 5 Minuten technischer Clock-Skew; Refresh 30 Tage idle/maximal 365 Tage, einmalig und bei jeder Access-Token-Anforderung rotiert; Widerruf bei Passwortänderung oder Benutzerdeaktivierung.
- Testumgebung: Keine Sandbox und kein Testkunde.
- Mandant: Nur setzen, wenn in kwp-bnWin.net ein Mandant eingerichtet ist; dann dessen Kürzel verwenden,
sonst den Queryparameter erst nach ausdrücklicher
none-Bestätigung weglassen. Bevorzugte Discovery istGET /api/Mandant/Load; wegen der abweichenden Security-Scopes ist ein fail-closed manueller Fallback erforderlich. Im Live-Reconnect wurde genau eine Geerkens-Bindung bestätigt und verschlüsselt gespeichert; ihr konkreter Wert bleibt bewusst außerhalb der Ticket-Doc. - Client-Version:
x-kwp-client-versionist optional.
ClientId, Secret und reale Redirect-Werte bleiben ausschließlich im vereinbarten sicheren Kanal.