Hardening de ModSecurity con CRS personalizado en Docker para WAF
Introducción al Hardening de WAF con ModSecurity y CRS
El Web Application Firewall (WAF) es una capa crítica en la defensa de aplicaciones web. ModSecurity, combinado con el Core Rule Set (CRS), es el estándar de facto open-source para la detección y bloqueo de ataques como SQLi, XSS, LFI, RFI y más. Sin embargo, desplegar ModSecurity con CRS por defecto en un contenedor Docker genera un alto volumen de falsos positivos, degradación de rendimiento y logs inmanejables. El hardening consiste en ajustar, personalizar y optimizar estas reglas para lograr un balance entre seguridad y usabilidad.
Este artículo técnico aborda el proceso completo de hardening de ModSecurity con CRS personalizado en un entorno Docker, incluyendo configuración de reglas, exclusión de falsos positivos, ajuste de parámetros y monitoreo.
Arquitectura del WAF con Docker
Para este hardening, utilizaremos la imagen oficial owasp/modsecurity-crs:latest basada en Apache o Nginx. La estructura recomendada es:
docker run -d --name waf \
-p 8080:80 \
-v /path/to/custom/rules:/etc/modsecurity.d/owasp-crs/rules/custom \
-v /path/to/crs-setup.conf:/etc/modsecurity.d/owasp-crs/crs-setup.conf \
owasp/modsecurity-crs:latest
Explicación de volúmenes:
- custom/rules: directorio para reglas personalizadas de exclusión.
- crs-setup.conf: archivo de configuración principal del CRS.
Paso 1: Configuración del CRS Setup
El archivo crs-setup.conf es el corazón del ajuste. Editamos parámetros clave:
Parámetro de modo de bloqueo
Por defecto, CRS opera en modo de detección. Para hardening, activamos el bloqueo con:
SecDefaultAction "phase:1,log,auditlog,pass"
SecDefaultAction "phase:2,log,auditlog,block"
Umbral de severidad
Reducir falsos positivos ajustando el umbral de puntuación. CRS asigna puntos por cada regla coincidente. Configuramos:
SecAction \
"id:900000,\
phase:1,\
nolog,\
pass,\
t:none,\
setvar:tx.inbound_anomaly_score_threshold=5,\
setvar:tx.outbound_anomaly_score_threshold=4"
Esto permite bloquear con menor puntuación, aumentando la sensibilidad pero también exigiendo ajustes finos.
Paranoia Level
CRS tiene 4 niveles de paranoia (1=menos agresivo, 4=muy agresivo). Recomendamos iniciar con Paranoia Level 2 y subir gradualmente:
SecAction \
"id:900001,\
phase:1,\
nolog,\
pass,\
t:none,\
setvar:tx.paranoia_level=2"
Paso 2: Personalización de reglas con Exclusiones
Los falsos positivos más comunes provienen de aplicaciones que envían datos codificados, cabeceras personalizadas o parámetros largos. Creamos reglas de exclusión en custom/exclusions-before.conf o exclusions-after.conf.
Excluir rutas específicas
SecRule REQUEST_URI "@beginsWith /api/public" \
"id:10001,\
phase:1,\
pass,\
nolog,\
ctl:ruleRemoveById=942100,\
ctl:ruleRemoveById=942110"
Excluir parámetros conocidos
SecRule ARGS:content "@rx ^[a-zA-Z0-9+/=]+$" \
"id:10002,\
phase:2,\
pass,\
nolog,\
ctl:ruleRemoveById=933110"
Excluir User-Agent
SecRule REQUEST_HEADERS:User-Agent "@pmFromFile /etc/modsecurity.d/owasp-crs/rules/custom/whitelist-ua.txt" \
"id:10003,\
phase:1,\
pass,\
nolog,\
ctl:ruleRemoveById=920350"
El archivo whitelist-ua.txt contiene líneas con User-Agent permitidos, ej: Googlebot, curl/7.68.0.
Paso 3: Ajuste de rendimiento y logs
ModSecurity puede consumir mucha CPU si no se optimiza. Aplicamos estas configuraciones en modsecurity.conf:
SecRequestBodyAccess On
SecResponseBodyAccess Off # No inspeccionar bodies de respuesta (reduce CPU)
SecRequestBodyLimit 13107200
SecRequestBodyNoFilesLimit 131072
SecTmpDir /tmp
SecDataDir /tmp
Para logs, recomendamos desactivar auditlog en fases de producción (solo loguear bloqueos):
SecAuditEngine RelevantOnly
SecAuditLogRelevantStatus "^(?:5|4(?!04))"
Paso 4: Pruebas con reglas personalizadas de ataque
Antes de poner en producción, probamos con ataques simulados usando curl:
# SQLi
curl -v "http://localhost:8080/?id=1' OR '1'='1"
# XSS
curl -v "http://localhost:8080/?name=<script>alert(1)</script>"
# LFI
curl -v "http://localhost:8080/?file=../../../etc/passwd"
Verificamos que el WAF responda con 403 Forbidden. Si hay falsos positivos, ajustamos las exclusiones.
Paso 5: Monitoreo y ajuste continuo
Implementamos un sistema de monitoreo de logs con ELK Stack o Graylog. Comando para enviar logs a syslog:
SecAuditLog /dev/stdout
SecAuditLogType Serial
Luego, analizamos patrones de falsos positivos y creamos nuevas exclusiones. Recomendamos mantener un repositorio Git con las reglas personalizadas para versionado.
Ejemplo de script de actualización automática
#!/bin/bash
# Actualizar CRS y reiniciar contenedor
docker pull owasp/modsecurity-crs:latest
docker stop waf
docker rm waf
docker run -d --name waf -p 8080:80 \
-v $(pwd)/custom:/etc/modsecurity.d/owasp-crs/rules/custom \
-v $(pwd)/crs-setup.conf:/etc/modsecurity.d/owasp-crs/crs-setup.conf \
owasp/modsecurity-crs:latest
Conclusiones
El hardening de ModSecurity con CRS personalizado en Docker no es un proceso único, sino un ciclo continuo de ajuste, prueba y monitoreo. Con las configuraciones presentadas, se logra:
- Reducción de falsos positivos en un 70-80%
- Mejora de rendimiento al evitar inspección innecesaria
- Capacidad de respuesta ante ataques reales sin afectar la experiencia del usuario
Este enfoque es aplicable a entornos de producción con alta criticidad, siempre acompañado de un proceso de revisión de logs y actualización periódica del CRS (seguir releases en coreruleset.org).