Die aktuelle Anmeldetransaktion abbrechen
POST /fapi/v1/transactions/current:cancel · wird vom Anmeldehost der Umgebung aufgerufen
Bricht die aktuelle Transaktion ab. Die Transaktion wechselt in den Status failed, und das Transaktions-Cookie wird entfernt.
Anfrage
Header:
| Header | Pflicht | Beschreibung |
|---|---|---|
Idp-Client |
ja | SDK-Kennung. |
Origin |
ja | Muss genau https://<Anmeldehost> sein. |
Idp-Csrf-Token |
ja | Der csrf_token aus dem Transaktionsobjekt. |
Kein Body.
Antwort
200 OK mit der abgebrochenen Transaktion.
DPoP-gebundene Headless-Transaktionen
Für eine Transaktion, die mit einem DPoP-Header gestartet wurde, einen neuen Proof mit demselben Schlüssel senden (htm POST, htu diese URL)
anstelle von Idp-Csrf-Token.
Fehler
| Status | Code | Wann |
|---|---|---|
| 403 | origin_not_allowed |
Origin oder Idp-Csrf-Token fehlt oder ist falsch. |
| 409 | transaction_state_conflict |
Die Transaktion kann nicht mehr abgebrochen werden. |
| 410 | transaction_expired |
Die Transaktion ist beendet. |
| 401 | invalid_dpop_proof |
Der DPoP-Proof ist ungültig oder wurde wiederverwendet. |
Beispiel
curl -X POST https://example.keenauth.app/fapi/v1/transactions/current:cancel \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Idp-Csrf-Token: $CSRF_TOKEN" \
-b cookies.txt