Aktuelle Anmeldetransaktion abrufen
GET /fapi/v1/transactions/current · wird vom Anmeldehost der Umgebung aufgerufen
Gibt die Transaktion zurück, auf die das __Host-idp_ltx-Cookie verweist, einschließlich ihres Status und der Schritte, die als Nächstes ausgeführt werden können.
Verwenden Sie diesen Aufruf, um eine Anmeldeseite nach einem Neuladen fortzusetzen.
Anfrage
Header:
| Header | Pflicht | Beschreibung |
|---|---|---|
Idp-Client |
ja | SDK-Kennung, <package>/<version> (<runtime>/<version>). |
Das Transaktions-Cookie wird vom Browser automatisch gesendet.
Antwort
200 OK mit dem Transaktionsobjekt (schema_version, state, next_steps, csrf_token, expires_at). Jede Antwort
enthält Cache-Control: no-store.
Eine Transaktion, die den Benutzer auffordert, eine Unternehmensverbindung mit einem bestehenden Konto zu verknüpfen, enthält außerdem account_link
(connection_name, organization_name); siehe Anmeldeschritt ausführen. Die gehostete
Seite greift darauf mit resume=1 zu und setzt sie fort, anstatt eine neue Transaktion zu erstellen. Dasselbe gilt nach einer Unternehmensanmeldung, die noch einen zweiten Faktor (second_factor_pending) oder eine Registrierung (enrollment_pending) benötigt.
DPoP-gebundene Headless-Transaktionen
Für eine Transaktion, die mit einem DPoP-Header gestartet wurde, senden Sie einen neuen Nachweis mit demselben Schlüssel (htm GET, htu diese URL). Der
Server gibt die neueste nicht abgelaufene Transaktion zurück, die an diesen Schlüssel gebunden ist. Der Autorisierungscode wird hier nie zurückgegeben.
Fehler
| Status | Code | Wann |
|---|---|---|
| 400 | malformed_request |
Idp-Client fehlt. |
| 410 | transaction_expired |
Es gibt kein Cookie, das Cookie ist ungültig oder die Transaktion ist beendet. |
| 401 | invalid_dpop_proof |
Der DPoP-Nachweis ist ungültig oder wurde wiederverwendet. |
Beispiel
curl https://example.keenauth.app/fapi/v1/transactions/current \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Profil des Endnutzers. Personenbezogene Daten in den KeenAuth-APIs beschreibt, welche Daten gespeichert werden, wie lange sie aufbewahrt werden und wie sie gelöscht werden. Senden Sie keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in irgendeinem Feld.