Saltar al contenido principal

Restablecer contraseña

Logto proporciona una funcionalidad integral de restablecimiento de contraseña que permite a los usuarios recuperar de forma segura el acceso a sus cuentas cuando olvidan sus contraseñas o desean cambiarlas. Esta función admite múltiples métodos de verificación, incluidos correo electrónico y SMS, asegurando que los usuarios puedan recuperar el acceso a través de su canal de comunicación preferido.

Olvidé mi contraseña para recuperación de cuenta​

Configuración​

Para habilitar la funcionalidad de "olvidé mi contraseña":

  1. Configura conectores: Configura los conectores de correo electrónico o conectores de SMS en Consola > Conectores > Conectores de correo electrónico y SMS

  2. Recopila la información de contacto del usuario: Asegúrate de que los usuarios tengan correo electrónico / teléfono registrado durante el registro o mediante configuración de cuenta

  3. Habilita métodos de verificación:

  4. Guarda y prueba: Guarda los cambios y prueba usando Vista previa en vivo

Flujo de experiencia del usuario​

Una vez habilitada la función de restablecimiento de contraseña, se mostrará un botón de enlace "¿Olvidaste tu contraseña?" debajo del formulario de inicio de sesión. Los usuarios pueden hacer clic en el enlace "¿Olvidaste tu contraseña?" para iniciar el proceso de restablecimiento.

  1. Visitar la página de inicio de sesión: El usuario visita la página de inicio de sesión.
  2. Hacer clic en el enlace de Olvidé mi contraseña: El usuario hace clic en el enlace "¿Olvidaste tu contraseña?".
  3. Ingresar correo electrónico / teléfono: Tras hacer clic en el enlace, el usuario será redirigido a una nueva página donde podrá ingresar su correo electrónico o número de teléfono registrado.
  4. Enviar código de verificación: Logto enviará un código de verificación al correo electrónico o número de teléfono proporcionado y redirigirá a la página de verificación de código.
  5. Ingresar código de verificación: El usuario ingresa el código recibido en su correo electrónico o teléfono. Logto verificará el código y la identidad del usuario asociada al correo electrónico o número de teléfono.
  6. Ingresar nueva contraseña: Se solicitará al usuario que ingrese una nueva contraseña una vez que el código haya sido verificado correctamente.
  7. Restablecimiento de contraseña exitoso: Si la contraseña proporcionada cumple con los requisitos de la política de contraseñas, la contraseña se actualizará correctamente.
  8. Redirigir a la página de inicio de sesión: El usuario será redirigido a la página de inicio de sesión para ingresar con la nueva contraseña.
Flujo de restablecimiento de contraseña

Actualizar contraseña después de iniciar sesión​

Los usuarios autenticados pueden cambiar (o establecer inicialmente) su contraseña a través de la experiencia de configuración de cuenta dentro de tu aplicación. Consulta Configuración de cuenta para saber cómo construir esto con la Account API.

Verificar si el usuario tiene una contraseña​

Los datos del usuario exponen un campo booleano hasPassword que indica si el usuario tiene actualmente una credencial de contraseña almacenada.

Puedes obtener hasPassword mediante:

  • Management API: por ejemplo, GET /api/users/:id (incluido en el objeto de usuario)
  • Reclamos personalizados de token: Inyecta hasPassword en los tokens de ID / acceso (para que tu frontend pueda adaptar la interfaz sin una llamada API adicional)

Luego llama al endpoint de la Account API para establecer o actualizar la contraseña (consulta la guía de configuración de cuenta para detalles de la solicitud). Para los usuarios que nunca han tenido una contraseña, NO necesitas (y no debes requerir) el campo de contraseña antigua.

tip:

Incluso si tus métodos de registro requieren "Establecer una contraseña" para registros por correo electrónico / teléfono / nombre de usuario, los usuarios creados mediante inicio de sesión social puro omiten la creación de contraseña por defecto para reducir la fricción. Estos usuarios tendrán hasPassword = false hasta que establezcan una explícitamente más adelante. Evita forzar la configuración inmediata de contraseña justo después del registro social a menos que tu modelo de seguridad lo requiera; los avisos contextuales y diferidos suelen convertir mejor.

Política de contraseña personalizada​

Personaliza la longitud de la contraseña, los requisitos de caracteres y las restricciones de palabras para satisfacer las necesidades de seguridad de tu empresa mientras ofreces una buena experiencia de usuario. Estas configuraciones pueden ajustarse en la sección Seguridad > Política de contraseñas. Consulta la documentación de la política de contraseñas para saber más.

Preguntas frecuentes​

¿Cómo cerrar la sesión de un usuario después de un restablecimiento de contraseña exitoso?​

Suscríbete al evento de webhook PostResetPassword para recibir una notificación cuando un usuario restablezca su contraseña con éxito. Luego puedes activar una acción de cerrar sesión para invalidar la sesión actual del usuario y redirigirlo a la página de inicio de sesión.

¿Cómo implementar el flujo de restablecimiento de contraseña en mi interfaz personalizada?​

Puedes implementar tu propio flujo de restablecimiento de contraseña utilizando la Management API y la Account API de Logto. Consulta configuración de cuenta para más detalles.

Puedes crear un endpoint de restablecimiento de contraseña autoalojado y utilizar el SDK de Logto para iniciar una solicitud de inicio de sesión con first_screen configurado en reset-password. Esto redirigirá al usuario sin problemas a la página de restablecimiento de contraseña.