Passkey entfernen
DELETE /fapi/v1/me/passkeys/{authenticator_id} · wird vom Sign-in-Host der Umgebung aufgerufen
Entfernt einen Passkey-Datensatz. Das Entfernen wird abgelehnt, wenn der Benutzer dadurch nicht mehr in eine Anwendung der Umgebung angemeldet werden könnte. Nach erfolgreichem Entfernen wird eine Sicherheitsbenachrichtigung an die verifizierten E-Mail-Adressen des Benutzers gesendet (gemäß der Sicherheitsbenachrichtigungseinstellung der Umgebung). Erforderlich ist das Cookie __Host-idp_session des angemeldeten Benutzers. Fehlt das Cookie, ist es abgelaufen oder widerrufen, gibt der Endpunkt 401 unauthenticated zurück. 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 exakt https://<sign-in host> sein. |
Kein Body.
Antwort
204 No Content.
Fehler
| Status | Code | Wann |
|---|---|---|
| 401 | unauthenticated |
Kein gültiges Sitzungs-Cookie. |
| 401 | step_up_required |
Die Sitzung wurde in den letzten 5 Minuten nicht verifiziert; verifizieren Sie erneut mit max_age=300 aus dem Header WWW-Authenticate. |
| 403 | origin_not_allowed |
Origin fehlt oder ist falsch. |
| 404 | not_found |
Für diesen Benutzer gibt es keinen solchen Passkey oder Sicherheitsschlüssel. |
| 409 | last_factor |
Das Entfernen dieses Faktors würde verhindern, dass sich der Benutzer in mindestens eine Anwendung anmelden kann. |
Beispiel
curl -X DELETE https://example.keenauth.app/fapi/v1/me/passkeys/cred_01j9zzzzzzzzzzzzzzzzzzzzzz \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Anmeldedaten. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in einem Feld.