Wiederherstellungscodes neu generieren
POST /fapi/v1/me/recovery-codes:regenerate · wird vom Anmelde-Host der Umgebung aufgerufen
Ersetzt die Wiederherstellungscodes des Benutzers durch neue; alle alten Codes werden ungültig. Die neuen Codes werden in dieser Antwort nur einmal angezeigt, und eine Sicherheitsbenachrichtigung wird an die E-Mail-Adressen des Benutzers gesendet. Erforderlich ist das Cookie __Host-idp_session des authentifizierten Benutzers; fehlt das Cookie, ist es abgelaufen oder widerrufen, wird 401 unauthenticated zurückgegeben. Eine First-Party-Anwendung auf einem anderen Origin kann stattdessen ihr Front-API-Zugriffstoken senden (Authorization: DPoP <token> mit einem DPoP-Proof; siehe Front-API-Zugriffstoken).
Anfrage
Header:
| Header | Erforderlich | Beschreibung |
|---|---|---|
Idp-Client |
ja | SDK-Kennung. |
Origin |
ja | Muss genau https://<sign-in host> sein. |
Body:
{}
Antwort
200 OK:
{"recovery_codes": ["…", "…"]}
Fehler
| Status | Code | Wann |
|---|---|---|
| 401 | unauthenticated |
Kein gültiges Sitzungs-Cookie. |
| 401 | step_up_required |
Die Sitzung wurde nicht in den letzten 5 Minuten verifiziert; verifizieren Sie erneut mit max_age=300 im Header WWW-Authenticate. |
| 403 | origin_not_allowed |
Origin fehlt oder ist falsch. |
| 404 | not_found |
Wiederherstellungscodes sind in der Umgebung deaktiviert. |
| 409 | conflict |
Der Benutzer hat keinen zweiten Faktor; Wiederherstellungscodes wurden nicht erzeugt. |
Beispiel
curl -X POST https://example.keenauth.app/fapi/v1/me/recovery-codes:regenerate \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-b cookies.txt
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Zugangsdaten. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).