Verknüpfte Identität von einem Benutzer trennen
DELETE /v1/users/{user_id}/identities/{identity_id} · Berechtigung users:write
Entfernt eine verknüpfte Identität eines Benutzers (Passwort, Social, SAML, OIDC oder Legacy). Die Entfernung wird auch dann ausgeführt, wenn eine Organisation, der der Benutzer angehört, SSO über die Verbindung dieser Identität erzwingt: Der Benutzer kann eine solche Identität nicht im Kontoportal entfernen (409 sso_enforced_by_organization), der Kunde entfernt sie über diesen Endpunkt. Die letzte Erstfaktor-Methode des Benutzers kann nicht entfernt werden (409 last_login_method). Der Benutzer wird an jeder verifizierten Adresse benachrichtigt, und die Aktion wird mit dem API-Schlüssel als Akteur im Verwaltungs-Auditprotokoll erfasst.
Anfrage
| Parameter | In | Erforderlich | Beschreibung |
|---|---|---|---|
user_id |
path | ja | Benutzer-ID, Präfix usr_. |
identity_id |
path | ja | Identitäts-ID, Präfix idn_ (wie von GET /v1/users/{user_id}/identities zurückgegeben). |
Die Anfrage enthält keinen Body.
Antwort
204 No Content.
Fehler
Jeder Fehler ist ein application/problem+json-Body mit einem stabilen code.
| HTTP | code |
Wann |
|---|---|---|
| 404 | not_found |
Der Benutzer existiert in dieser Umgebung nicht, die Identität gehört nicht zu diesem Benutzer oder ist unbekannt, oder eine ID ist fehlerhaft. |
| 409 | last_login_method |
Diese Identität ist die letzte Erstfaktor-Methode des Benutzers; fügen Sie zuerst eine andere Methode hinzu. |
| 401 | unauthenticated |
Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen. |
| 403 | insufficient_permissions |
Dem Schlüssel fehlt die Berechtigung users: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/identities/idn_0a1b2c3d4e5f6g7h8j9k0m1n2r \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: verknüpfte Identitäten. Personenbezogene Daten in den KeenAuth-APIs beschreibt, welche Daten gespeichert werden, wie lange sie aufbewahrt und wie sie gelöscht werden. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).