TEC-009 — Políticas de Contraseñas
· 3 min de lectura
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
| RF | Entregable |
|---|---|
| RF-TEC-009-01 | Complejidad configurable (longitud y clases de caracteres) y no reutilización de las últimas N contraseñas |
| RF-TEC-009-02 | Rotación obligatoria por período configurable, con bloqueo real de la operación |
| RF-TEC-009-03 | Bloqueo de la cuenta tras un número configurable de intentos fallidos, con liberación automática o manual |
| RF-TEC-009-04 | Configuració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ón035-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_*). PasswordsServiceconcentra 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) responde403 PASSWORD_VENCIDAen 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/passwordno 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 --noEmitEXIT 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
- El estado de rotación se cachea 60 s (se invalida al cambiar la contraseña o la política).
- La recuperación de contraseña sigue generando una temporal sin enviarla por correo y libera el bloqueo de la cuenta.
- El cambio de contraseña no invalida los tokens vivos (control de sesiones: TEC-010).
