Authenticator eines Benutzers widerrufen
DELETE /v1/users/{user_id}/authenticators/{authenticator_id} · Berechtigung user-credentials:write
Widerruft einen Authenticator, einschließlich Passkeys. revoked_by wird zu admin:<actor> und revoke_reason wird zu admin_removed. Ist der Authenticator bereits widerrufen, ändert sich nichts und der Aufruf liefert weiterhin 204 zurück. Die Sitzungen des Benutzers werden nicht beendet. Der Benutzer wird benachrichtigt und die Aktion wird im Verwaltungs-Audit-Log protokolliert.
Anfrage
| Parameter | In | Pflicht | Beschreibung |
|---|---|---|---|
user_id |
path | ja | Benutzer-ID, Präfix usr_. |
authenticator_id |
path | ja | Authenticator-ID, Präfix cred_. |
Die Anfrage enthält keinen Body.
Antwort
204 No Content, auch wenn der Authenticator bereits widerrufen war.
Fehler
Jeder Fehler ist ein application/problem+json-Body mit einem stabilen code.
| HTTP | code |
Wann |
|---|---|---|
| 404 | not_found |
Der Benutzer oder der Authenticator existiert in dieser Umgebung nicht, der Authenticator gehört nicht zu diesem Benutzer oder eine ID ist fehlerhaft. |
| 401 | unauthenticated |
Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen. |
| 403 | insufficient_permissions |
Dem Schlüssel fehlt die Berechtigung user-credentials:write. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; beachten Sie Retry-After. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; versuchen Sie es später erneut. |
Beispiel
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/authenticators/cred_0a1b2c3d4e5f6g7h8j9k0m1n2p \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
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. Übermitteln Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).