Cierra el requerimiento REQ-SEC-09 (Seguridad, prioridad Alta) de la sección 6.2 Seguridad.
El sistema ya parametrizaba todo el SQL y React ya escapaba la salida; TEC-016 añade la capa
activa que bloquea los intentos y las cabeceras de seguridad que faltaban, en el API y en la web.
📋 Alcance
| RF | Entregable |
|---|
| RF-TEC-016-01 | SanitizacionInterceptor global que bloquea con 400 la inyección SQL |
| RF-TEC-016-02 | El mismo interceptor bloquea el contenido ejecutable (JavaScript/XSS) |
| RF-TEC-016-03 | Cabeceras de seguridad en el API y CSP enforcing + hardening en la web |
| RF-TEC-016-04 | DTOs validados (oficinas, subida de imagen) y neutralización de fórmulas en CSV |
⚙️ Cómo funciona
- Toda petición HTTP pasa por el
SanitizacionInterceptor (registrado como primer APP_INTERCEPTOR,
antes del ValidationPipe).
- Si el cuerpo, la consulta o los parámetros contienen un patrón de inyección SQL o de contenido
ejecutable, la petición se rechaza con 400 y se registra un
WARN (método, ruta, IP).
- El resto de textos se sanean (nulos, controles,
<script>/<style>, esquemas peligrosos).
- El middleware
crearMiddlewareSeguridad() fija las cabeceras en todas las respuestas del API.
POST /api/productos { "nombreProducto": "x' OR '1'='1" } → 400 Entrada bloqueada
POST /api/productos { "descripcion": "<script>alert(1)" } → 400 Entrada bloqueada
POST /api/productos { "nombreProducto": "Guante quirúrgico" } → 200 (se guarda)
🔐 Decisiones de seguridad
| Decisión | Por qué |
|---|
| Bloquear (400) y no solo sanear | Es lo que exige el criterio «la aplicación bloquea» |
| Patrones conservadores | Evitar falsos positivos en el texto libre del almacén |
| Sin dependencias nuevas | Se apoya en NestJS/Express; mismo enfoque que common/compresion |
| React sigue siendo el escape de salida | El saneo es defensa en profundidad, no el mecanismo primario |
🖥️ API y Web
- API:
src/common/seguridad/ (constantes, configuración, servicio, interceptor, middleware,
módulo) + montaje en main.ts y app.module.ts. Cabeceras: nosniff, X-Frame-Options,
Referrer-Policy, Permissions-Policy, CORP/COOP, Strict-Transport-Security y CSP estricta
(sin aplicar a Swagger).
- Web:
next.config.js (headers() con CSP enforcing) y web.config para IIS.
- Configuración:
SEGURIDAD_SANITIZACION, SEGURIDAD_DETECTAR_SQL, SEGURIDAD_DETECTAR_XSS,
SEGURIDAD_HSTS, SEGURIDAD_HSTS_MAX_AGE.
🧪 Verificación
| Prueba | Resultado |
|---|
npx tsc --noEmit (API) | EXIT 0 |
npx jest src/common/seguridad --runInBand | 40/40 verde (3 suites) |
POST con x' OR '1'='1 | 400 |
POST con <script>alert(1)</script> | 400 |
curl -I al API y a la web | Cabeceras presentes |
📎 Documentación