Eliminar un autenticador
DELETE /fapi/v1/me/authenticators/{authenticator_id} · llamado desde el host de inicio de sesión del entorno
Elimina un registro de autenticador. La eliminación se rechaza si impediría que el usuario inicie 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 expirado o ha sido revocada, devuelve 401 unauthenticated. Una aplicación de primera parte en otro origen puede enviar en su lugar su token de acceso a la API frontal (Authorization: DPoP <token> con una prueba DPoP; consulte Token de acceso a la API frontal).
Solicitud
Encabezados:
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK. |
Origin |
sí | Debe ser exactamente https://<sign-in host>. |
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 verificarla con max_age=300 en el encabezado WWW-Authenticate. |
| 403 | origin_not_allowed |
Falta Origin o es incorrecto. |
| 404 | not_found |
No existe ese autenticador para este usuario. |
| 409 | last_factor |
Eliminar este factor impediría que el usuario inicie sesión en al menos una aplicación. |
Ejemplo
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
Datos personales
Este endpoint maneja datos personales: credenciales. Datos personales en las API de KeenAuth describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe datos personales de categorías especiales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.