Saltar al contenido principal

TEC-005 — Rate Limiting Granular

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

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​

RFEntregable
RF-TEC-005-01Límites de tasa por usuario y por endpoint
RF-TEC-005-02Límites configurables según el tipo de usuario (rol)
RF-TEC-005-03429 con Retry-After y X-RateLimit-*
RF-TEC-005-04Registro de los excesos en la auditoría + monitoreo

🩹 Defectos corregidos​

  • El ThrottlerGuard no estaba registrado (ni APP_GUARD ni @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 ThrottlerExceptionFilter forzaba Retry-After: 60 sobre 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 loggers como AUDIT (accion = RATE_LIMIT_EXCEDIDO) y se consulta en GET /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.