Buscar en la documentación

Cambiar la contraseña

Cambio desde Mi cuenta con la contraseña actual, la misma política que la recuperación y el cierre de las demás sesiones.

Módulo auth1 min de lecturaVer en GitHub

Desde Mi cuenta, la persona cambia su contraseña escribiendo primero la actual. La sesión desde la que hace el cambio sigue abierta; las demás se cierran.

Diagrama5 carriles · 9 pasos · 4 salidas de error
SíNoSíNoSíNoSíNoEscribe la actual,la nueva y laconfirmación1Envía PUT/auth/password2¿Menos de 5intentos en elminuto?3Responde 429¿La nuevacumple lapolítica?4Responde 422 porcampo¿La actual escorrecta?5Responde 422¿Es distintade la actual?6Responde 422Guarda la nueva ycierra las demássesiones7Aviso de contraseñacambiada8Sigue en Mi cuentacon el aviso9
Los números coinciden con el paso a paso. En pantallas pequeñas el diagrama se desliza de lado.

Paso a paso

  1. PersonaEscribe la actual, la nueva y la confirmación

    En el diálogo "Cambiar contraseña" de Mi cuenta, que muestra los requisitos de la nueva.

  2. NavegadorEnvía PUT /auth/password
  3. API¿Menos de 5 intentos en el minuto?

    Límite password-change: 5 por minuto por persona, porque se puede probar la contraseña actual.

  4. API¿La nueva cumple la política?

    La misma regla de la recuperación (NewPassword). Aquí también rechaza el nombre de la persona, además del correo.

  5. Base de datos¿La actual es correcta?
  6. API¿Es distinta de la actual?
  7. Base de datosGuarda la nueva y cierra las demás sesiones

    Con Argon2id. Avisa por el canal personal: las pantallas abiertas en otros equipos se cierran al instante; esta sigue abierta.

  8. CorreoAviso de contraseña cambiada
  9. NavegadorSigue en Mi cuenta con el aviso

    "Tu contraseña cambió. Cerramos tus sesiones en otros equipos."

Qué ve la persona en cada error

CódigoHTTPCuándoMensaje en pantalla
TOO_MANY_REQUESTS429Más de 5 intentos en un minutoHiciste demasiados intentos seguidos. Espera {wait} y vuelve a intentarlo.
CURRENT_PASSWORD_INVALID422La contraseña actual no coincideLa contraseña actual no es correcta.
PASSWORD_SAME_AS_CURRENT422La nueva es igual a la actualLa contraseña nueva debe ser distinta de la actual.
PASSWORD_BREACHED, PASSWORD_REPETITIVE, PASSWORD_SEQUENTIAL, PASSWORD_PERSONAL422La nueva no cumple la políticaLos mismos mensajes de Recuperar la contraseña.

Dónde está en el código