Délier une identité
DELETE /fapi/v1/me/identities/{identity_id} · appelé depuis l'hôte de connexion de l'environnement
Délie une identité sociale ou d'entreprise du compte de l'utilisateur authentifié. La dernière méthode de connexion de l'utilisateur ne peut pas être supprimée. Si l'organisation de l'utilisateur impose l'authentification unique sur cette liaison, l'identité ne peut être supprimée que via l'API de gestion client. Après une suppression réussie, une notification de sécurité est envoyée à toutes les adresses e-mail vérifiées de l'utilisateur. Le cookie __Host-idp_session de l'utilisateur authentifié est requis ; si le cookie est absent, expiré ou révoqué, la réponse est 401 unauthenticated. Une application de première partie située sur une autre origine peut à la place envoyer son jeton d'accès à la Front API (Authorization: DPoP <token> avec une preuve DPoP ; voir Jeton d'accès Front API).
La session doit avoir été vérifiée au cours des 5 dernières minutes. Si l'utilisateur dispose d'un second facteur, la session doit également avoir été ouverte avec un second facteur (urn:idp:acr:mfa).
Requête
En-têtes :
| En-tête | Requis | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
Origin |
oui | Doit être exactement https://<hôte de connexion>. |
identity_id : l'identifiant de l'identité liée, au format idn_….
Aucun corps.
Réponse
204 No Content.
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 401 | unauthenticated |
Aucun cookie de session valide. |
| 401 | step_up_required |
Session non vérifiée au cours des 5 dernières minutes ou second facteur requis ; reverifiez avec max_age=300 (et, le cas échéant, acr_values) dans l'en-tête WWW-Authenticate. |
| 403 | origin_not_allowed |
Origin est absent ou incorrect. |
| 404 | not_found |
Aucune identité de ce type pour cet utilisateur. |
| 409 | last_login_method |
Cette identité est la dernière méthode de connexion de l'utilisateur. |
| 409 | sso_enforced_by_organization |
L'organisation de l'utilisateur impose l'authentification unique sur cette liaison. |
Exemple
curl -X DELETE https://example.keenauth.app/fapi/v1/me/identities/idn_01j9zzzzzzzzzzzzzzzzzzzzzz \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
Données personnelles
Cet endpoint traite des données personnelles : identités liées. Données personnelles dans les API KeenAuth décrit ce qui est stocké, pendant combien de temps et comment elles sont supprimées. N'envoyez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.