Saltar al contenido principal

TEC-009 — Políticas de Contraseñas

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Implementación de la mejora TEC-009 (Políticas de Contraseñas), dentro de 6.2 Seguridad. El sistema pasa de aceptar cualquier contraseña a exigir una política configurable, con rotación obligatoria y bloqueo temporal de la cuenta por intentos fallidos.


📋 Alcance​

RFEntregable
RF-TEC-009-01Complejidad configurable (longitud y clases de caracteres) y no reutilización de las últimas N contraseñas
RF-TEC-009-02Rotación obligatoria por período configurable, con bloqueo real de la operación
RF-TEC-009-03Bloqueo de la cuenta tras un número configurable de intentos fallidos, con liberación automática o manual
RF-TEC-009-04Configuración de todos los parámetros por el administrador, con estado de las cuentas

⚙️ Cómo funciona​

  • Política de fila única configuracion_password (migración 035-create-politicas-password) con complejidad, días de rotación, intentos y minutos de bloqueo e historial; los valores por defecto se pueden fijar por .env (PASSWORD_*).
  • PasswordsService concentra las reglas: valida la contraseña candidata (devuelve todas las reglas incumplidas), impide reutilizar las últimas N (comparando hashes con bcrypt), gestiona el historial, la fecha de actualización y el contador de bloqueo.
  • Todos los puntos de entrada pasan por la política: alta de usuario, edición por el administrador, cambio propio y recuperación (que ahora genera una temporal que cumple).
  • Rotación obligatoria: PasswordRotacionGuard (global) responde 403 PASSWORD_VENCIDA en todo salvo cambiar contraseña, cerrar sesión, renovar el token, completar el 2FA y consultar el estado. El login avisa y la web lleva a /cambiar-password.
  • Bloqueo temporal: al alcanzar el máximo de intentos, 423 CUENTA_BLOQUEADA (con los minutos restantes). Se comprueba antes de validar la contraseña, se libera solo al expirar y el administrador puede desbloquear cuando quiera.
  • Pantalla /politicas-password (Configuración, solo Administrador): formulario de la política con sus rangos, vista previa de las reglas y tabla de cuentas (bloqueadas, vencidas, intentos) con Desbloquear.
  • Auditoría (TEC-008): los cambios de contraseña, los intentos fallidos de cambio y el bloqueo de cuenta quedan como eventos con usuario, IP, fecha y resultado; la configuración de la política se registra como acción privilegiada.

🗄️ Base de datos​

Migración 035-create-politicas-password: configuracion_password (fila única con CHECKs de rango), historial_passwords (hashes por usuario, ON DELETE CASCADE) y tres columnas en usuarios (password_actualizado, intentos_fallidos, bloqueado_hasta) con índice sobre el bloqueo. Un password_actualizado nulo se interpreta como la fecha de creación: nadie queda vencido de golpe.

🔐 Seguridad​

  • Las contraseñas nunca se guardan en claro: solo hashes bcrypt, y el historial guarda hashes para impedir la reutilización.
  • Hallazgo corregido en esta mejora: PATCH /api/usuarios/:id/password no exigía rol, así que cualquier usuario autenticado podía restablecer la contraseña de otro (incluido un administrador). Ahora exige Administrador y queda auditado.
  • El guard de rotación falla abierto: si no puede evaluar el vencimiento, no bloquea a nadie (una avería de lectura no puede tumbar el servicio).

✅ Verificación​

  • Suites en verde: API (808+ pruebas) y web (74 pruebas), 0 fallos; tsc --noEmit EXIT 0.
  • Integración real (scripts/verificar-politicas-password.ts) contra la API y la base reales: 34/34 comprobaciones OK, con la política previa restaurada y los usuarios, historial y auditoría temporales eliminados.

📚 Documentación​

  • Especificación: docs/mejoras/tec-009-politicas-password.md
  • Manual de usuario: docs/manuales/seguridad/politicas-password.md

⚠️ Limitaciones conocidas​

  1. El estado de rotación se cachea 60 s (se invalida al cambiar la contraseña o la política).
  2. La recuperación de contraseña sigue generando una temporal sin enviarla por correo y libera el bloqueo de la cuenta.
  3. El cambio de contraseña no invalida los tokens vivos (control de sesiones: TEC-010).