Dissocier une identité liée d'un utilisateur

DELETE /v1/users/{user_id}/identities/{identity_id} · autorisation users:write

Supprime une identité liée d'un utilisateur (mot de passe, réseau social, SAML, OIDC ou héritée). La suppression aboutit même lorsqu'une organisation à laquelle appartient l'utilisateur impose l'authentification unique via la connexion de cette identité : l'utilisateur ne peut pas supprimer une telle identité depuis le portail de compte (409 sso_enforced_by_organization), le client la supprime avec ce point de terminaison. La dernière méthode de premier facteur de l'utilisateur ne peut pas être supprimée (409 last_login_method). L'utilisateur est notifié à chaque adresse vérifiée, et l'action est enregistrée dans le journal d'audit de gestion, la clé API étant l'auteur.

Requête

Paramètre Dans Obligatoire Description
user_id path oui Identifiant de l'utilisateur, préfixé usr_.
identity_id path oui Identifiant de l'identité, préfixé idn_ (tel que renvoyé par GET /v1/users/{user_id}/identities).

La requête ne comporte aucun corps.

Réponse

204 No Content.

Erreurs

Toute erreur est un corps application/problem+json contenant un code stable.

HTTP code Quand
404 not_found L'utilisateur n'existe pas dans cet environnement, l'identité n'appartient pas à cet utilisateur ou est inconnue, ou un identifiant est mal formé.
409 last_login_method Cette identité est la dernière méthode de premier facteur de l'utilisateur ; ajoutez d'abord une autre méthode.
401 unauthenticated La clé API est absente, invalide ou révoquée.
403 insufficient_permissions La clé ne dispose pas de l'autorisation users:write.
429 rate_limited La limite de débit a été dépassée ; respectez Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez plus tard.

Exemple

curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/identities/idn_0a1b2c3d4e5f6g7h8j9k0m1n2r \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Données personnelles

Cet point de terminaison traite des données personnelles : identités liées. Données personnelles dans les API KeenAuth décrit les données stockées, leur durée de conservation et leur suppression. Ne transmettez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.