Buscar en la documentación

Restablecer MFA o acceso

Qué hace el Super admin cuando alguien pierde su teléfono o su contraseña, siempre con su propio código y cerrando las sesiones de la persona.

Módulo users1 min de lecturaVer en GitHub

Dos acciones para cuando una persona no puede entrar. Por defecto son solo del Super admin (users.mfa.reset y users.access.reset), salvo que se concedan a alguien en particular. Las dos piden el código de la aplicación de quien las hace, cierran todas las sesiones de la persona y le avisan por correo.

  • Restablecer MFA: quita su factor y sus códigos de recuperación. En el siguiente ingreso lo configura de nuevo.
  • Restablecer acceso: su contraseña deja de servir (se reemplaza por una aleatoria) y debe crear una nueva con “¿Olvidaste tu contraseña?”.
Diagrama5 carriles · 7 pasos · 2 salidas de error
SíNoSíNoPulsa RestablecerMFA o Restableceracceso1Pide su código yenvía la acción2¿Tiene elpermiso y lasupera ennivel?3Responde 403 o409¿Su código esválido?4Responde 422 o423Quita el MFA o lacontraseña y cierrasesiones5Sus pantallasabiertas se cierran6Recibe el correo yvuelve a entrar7
Los números coinciden con el paso a paso. En pantallas pequeñas el diagrama se desliza de lado.

Paso a paso

  1. Super adminPulsa Restablecer MFA o Restablecer acceso
  2. NavegadorPide su código y envía la acción

    DELETE /users/{id}/mfa o POST /users/{id}/access-reset, con mfa_code.

  3. API¿Tiene el permiso y la supera en nivel?

    Para restablecer el MFA, la persona además debe tenerlo activo.

  4. API¿Su código es válido?

    Sin repetición; cinco incorrectos en un minuto bloquean la reautenticación.

  5. Base de datosQuita el MFA o la contraseña y cierra sesiones

    En una transacción: user_mfa_factors y user_recovery_codes borrados, o contraseña aleatoria; todos sus tokens revocados; admin_actions (user_mfa_reset o user_access_reset).

  6. Persona afectadaSus pantallas abiertas se cierran

    Por session.changed en su canal personal.

  7. Persona afectadaRecibe el correo y vuelve a entrar

    Con MFA restablecido: ingresa con su contraseña y configura el MFA. Con acceso restablecido: crea su contraseña desde /recuperar (su MFA sigue activo, así que lo pide al final).

Qué ve la persona en cada error

CódigoHTTPCuándoMensaje en pantalla
USER_MFA_NOT_ENABLED409La persona no tiene MFA activoEsta persona no tiene activa la verificación en dos pasos, así que no hay nada que restablecer.
MFA_CODE_INVALID422El código de quien administra no es correctoEl código no es correcto. Escribe el que muestra ahora tu aplicación de autenticación.
REAUTHENTICATION_LOCKED423Cinco códigos incorrectos en un minutoEscribiste varios códigos incorrectos seguidos. Espera {wait} y vuelve a intentarlo.
USER_OUTRANKED403La persona tiene su mismo nivel o uno mayorEsta persona tiene un rol de tu mismo nivel o superior, así que no puedes cambiar su cuenta.
USER_SELF_MANAGEMENT403Intenta restablecer lo suyoTu propio rol, tus permisos, tu estado y tu acceso los cambia otra persona que administre Trazo.

Dónde está en el código