Supprimer un authentificateur
DELETE /fapi/v1/me/authenticators/{authenticator_id} · appelé depuis l'hôte de connexion de l'environnement
Supprime un enregistrement d'authentificateur. La suppression est refusée si elle empêcherait l'utilisateur de se connecter à une application quelconque de l'environnement. Après une suppression réussie, une notification de sécurité est envoyée aux adresses e-mail vérifiées de l'utilisateur (selon le paramètre de notification de sécurité de l'environnement). Nécessite le cookie __Host-idp_session de l'utilisateur authentifié ; si le cookie est absent, expiré ou révoqué, renvoie 401 unauthenticated. Une application de première partie sur une autre origine peut envoyer à la place son jeton d'accès à l'API front (Authorization: DPoP <token> avec une preuve DPoP ; voir Jeton d'accès à l'API front).
Requête
En-têtes :
| En-tête | Obligatoire | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
Origin |
oui | Doit être exactement https://<hôte de connexion>. |
Pas de corps.
Réponse
204 No Content.
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 401 | unauthenticated |
Aucun cookie de session valide. |
| 401 | step_up_required |
La session n'a pas été vérifiée au cours des 5 dernières minutes ; vérifiez à nouveau avec max_age=300 dans l'en-tête WWW-Authenticate. |
| 403 | origin_not_allowed |
Origin est absent ou incorrect. |
| 404 | not_found |
Aucun authentificateur de ce type pour cet utilisateur. |
| 409 | last_factor |
Supprimer ce facteur empêcherait l'utilisateur de se connecter à au moins une application. |
Exemple
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
Données personnelles
Ce point de terminaison traite des données personnelles : des identifiants. Données personnelles dans les API KeenAuth décrit ce qui est stocké, pendant combien de temps les données sont conservées et comment elles sont supprimées. Ne transmettez dans aucun champ de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle).