Ciberseguridad ·

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).