Ein Authentifizierungsmittel entfernen
DELETE /fapi/v1/me/authenticators/{authenticator_id} · wird vom Anmelde-Host der Umgebung aufgerufen
Entfernt einen Eintrag für ein Authentifizierungsmittel. Die Entfernung wird abgelehnt, wenn der Benutzer dadurch daran gehindert würde, sich bei einer Anwendung in der Umgebung anzumelden. Nach erfolgreicher Entfernung wird den verifizierten E-Mail-Adressen des Benutzers eine Sicherheitsbenachrichtigung gesendet (gemäß der Einstellung für Sicherheitsbenachrichtigungen der Umgebung). 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 Zugriffstoken für die Front API senden (Authorization: DPoP <token> mit einem DPoP-Proof; siehe Zugriffstoken für die Front API).
Anfrage
Header:
| Header | Pflicht | 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 im Header WWW-Authenticate. |
| 403 | origin_not_allowed |
Origin fehlt oder ist falsch. |
| 404 | not_found |
Für diesen Benutzer existiert kein solches Authentifizierungsmittel. |
| 409 | last_factor |
Das Entfernen dieses Faktors würde den Benutzer daran hindern, sich bei mindestens einer Anwendung anzumelden. |
Beispiel
curl -X DELETE https://example.keenauth.app/fapi/v1/me/authenticators/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: Berechtigungsnachweise. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Übermitteln Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).