Regenerar códigos de recuperación
POST /fapi/v1/me/recovery-codes:regenerate · llamado desde el host de inicio de sesión del entorno
Reemplaza los códigos de recuperación del usuario por otros nuevos; todos los códigos anteriores dejan de ser válidos. Los nuevos códigos se muestran solo una vez en esta respuesta y se envía una notificación de seguridad a las direcciones de correo electrónico del usuario. 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 a la API de front (Authorization: DPoP <token> con una prueba DPoP; consulte Token de acceso a la API de front).
Solicitud
Cabeceras:
| Cabecera | Obligatoria | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK. |
Origin |
sí | Debe ser exactamente https://<host de inicio de sesión>. |
Cuerpo:
{}
Respuesta
200 OK:
{"recovery_codes": ["…", "…"]}
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 la cabecera WWW-Authenticate. |
| 403 | origin_not_allowed |
Falta Origin o es incorrecta. |
| 404 | not_found |
Los códigos de recuperación están desactivados en el entorno. |
| 409 | conflict |
El usuario no tiene un segundo factor; no se generaron códigos de recuperación. |
Ejemplo
curl -X POST https://example.keenauth.app/fapi/v1/me/recovery-codes:regenerate \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-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.