Supprimer une clé d'accès
DELETE /fapi/v1/me/passkeys/{authenticator_id} · appelé depuis l'hôte de connexion de l'environnement
Supprime un enregistrement de clé d'accès. La suppression est refusée si elle empêcherait l'utilisateur de se connecter à une application 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). Requiert 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 à la place envoyer 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 | Requis | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
Origin |
oui | Doit être exactement https://<hôte de connexion>. |
Aucun 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 |
Aucune clé d'accès ni clé de sécurité 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/passkeys/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
Cet endpoint traite des données personnelles : des identifiants. 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 pas de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.