Eliminar una clave de acceso
DELETE /fapi/v1/me/passkeys/{authenticator_id} · llamado desde el host de inicio de sesión del entorno
Elimina un registro de clave de acceso. La eliminación se rechaza si impediría al usuario iniciar sesión en cualquier aplicación del entorno. Tras una eliminación correcta, se envía una notificación de seguridad a las direcciones de correo electrónico verificadas del usuario (según la configuración de notificaciones de seguridad del entorno). Requiere la cookie __Host-idp_session del usuario autenticado; si la cookie falta, ha caducado o ha sido revocada, devuelve 401 unauthenticated. Una aplicación propia en otro origen puede enviar en su lugar su token de acceso de la API frontal (Authorization: DPoP <token> con una prueba DPoP; consulte Token de acceso de la API frontal).
Solicitud
Encabezados:
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK. |
Origin |
sí | Debe ser exactamente https://<host de inicio de sesión>. |
Sin cuerpo.
Respuesta
204 No Content.
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 401 | unauthenticated |
No hay una cookie de sesión válida. |
| 401 | step_up_required |
La sesión no se verificó en los últimos 5 minutos; vuelva a verificar con max_age=300 en el encabezado WWW-Authenticate. |
| 403 | origin_not_allowed |
Origin falta o es incorrecto. |
| 404 | not_found |
No existe una clave de acceso o clave de seguridad de este usuario. |
| 409 | last_factor |
Eliminar este factor impediría al usuario iniciar sesión en al menos una aplicación. |
Ejemplo
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
Datos personales
Este endpoint contiene datos personales: credenciales. Datos personales en las API de KeenAuth describe qué se almacena, cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.