TEC-005 — Rate Limiting Granular
· 2 min de lectura
Implementación de la mejora TEC-005 (Rate Limiting Granular), dentro de 6.2 Seguridad. El sistema pasa de no aplicar límite de tasa alguno a limitar por usuario y por endpoint, con límites por tipo de usuario, cabeceras estándar y registro de los excesos.
📋 Alcance
| RF | Entregable |
|---|---|
| RF-TEC-005-01 | Límites de tasa por usuario y por endpoint |
| RF-TEC-005-02 | Límites configurables según el tipo de usuario (rol) |
| RF-TEC-005-03 | 429 con Retry-After y X-RateLimit-* |
| RF-TEC-005-04 | Registro de los excesos en la auditoría + monitoreo |
🩹 Defectos corregidos
- El
ThrottlerGuardno estaba registrado (niAPP_GUARDni@UseGuards): no protegía nada. - Su lista de rutas exentas era
['/api', …]y toda la API empieza por/api: lo habría eximido completo. - El
ThrottlerExceptionFilterforzabaRetry-After: 60sobre el valor real del guard.
⚙️ Cómo funciona
- Tracker:
usuario:{id}si hay sesión;ip:{ip}si no. La clave del guard añade controlador+método → contador por endpoint. - Límites por rol (por 60 s): anónimo 20, Usuario Interno 60, Auditor 60, Auxiliar
inventario 100, Almacenista 150, Administrador 300. Configurables con
THROTTLE_LIMIT_*. - Endpoints sensibles con
@Throttle: login y 2FA 10/min, recuperar contraseña 5/min, cambiar contraseña 10/min. - 429 con
Retry-After,X-RateLimit-Limit/Remaining/Reset. - RF-04: cada exceso se guarda en
loggerscomo AUDIT (accion = RATE_LIMIT_EXCEDIDO) y se consulta enGET /api/throttler/{eventos,resumen,configuracion}. - Página
/rate-limit(Configuración, solo Administrador): límites por rol, resumen por ruta/IP/día, filtros y tabla de eventos con «Cargar más».
✅ Verificación
- 25 pruebas nuevas en el API y 3 en el frontend.
- Suite API en verde (619 pruebas) y web (48 pruebas, 12 suites);
tsc, ESLint y builds limpios. - Verificación real 8/8 OK: límite por usuario (Auditor, 60), límite por endpoint (login, 10),
cabeceras del 429, contador independiente por endpoint y eventos registrados en
loggers.
Nota: con varias instancias, los contadores son por instancia (storage en memoria); migrar a
un storage compartido (Redis) es el trabajo futuro natural. Las peticiones que fallan la
autenticación (401) no se cuentan porque el guard corre tras JwtAuthGuard.
