Laboratorio Docker reproducible para CVE-2026-59248: un DoS por agotamiento de memoria en el decodificador de enteros HPACK/QPACK en cowlib, con cliente de explotación, servidor Cowboy y métricas de Grafana.
Una vulnerabilidad de limitación de recursos en ninenines cowlib (≥ 2.0.0, < 2.19.0) permite que un par remoto HTTP/2 o HTTP/3 no autenticado agote la memoria en el servidor (o cliente) vulnerable y provoque una denegación de servicio.
El decodificador de enteros con prefijo HPACK y QPACK
cow_hpack_common:dec_big_int/3 (src/cow_hpack_common.hrl, invocado desde
cow_hpack:decode/2 y cow_qpack:decode_field_section/3) lee
octetos de continuación hasta encontrar uno cuyo bit alto esté a cero, evaluando
Int + (Value bsl M) en cada paso con el desplazamiento M creciendo en 7 por
octeto. No hay límite en el número de octetos de continuación, en el
ancho de bits resultante ni en el valor — el decodificador consume cualquier longitud
codificada que el par proporcione. Dado que los enteros de Erlang son inmutables, cada
Value bsl M intermedio y cada actualización del acumulador asignan un nuevo
bignum cuyo ancho de dígitos crece linealmente con los octetos procesados hasta el momento;
sumado a lo largo de toda la decodificación, la asignación transitoria es O(n²) en la
longitud codificada.
Una única representación indexada HPACK máxima transportada en un par de tramas
HEADERS + CONTINUATION de HTTP/2 — dentro del
max_frame_size_received predeterminado de Cowboy — puede forzar cientos de megabytes
de asignación transitoria y agitación del recolector de basura antes de que el índice
resultante de la tabla de cabeceras sea rechazado como inválido. Las conexiones repetidas o concurrentes multiplican
la presión y pueden llevar a la VM de Erlang al agotamiento de memoria.
Cowlib es el analizador HTTP utilizado por Cowboy, el plugin de gestión de RabbitMQ y otros servidores y clientes HTTP/2 y HTTP/3 de Erlang/Elixir, por lo que cualquier endpoint expuesto que acepte HPACK o QPACK de un par no confiable es alcanzable.
Corrección: cowlib 2.19.0 añade una guarda when M < 32 a dec_big_int/3,
rechazando enteros sobredimensionados tras unos pocos octetos.
Este laboratorio reproduce el ataque (prefacio → SETTINGS → HEADERS → CONTINUATION
con un entero HPACK 0xFF… sobredimensionado) contra un servidor Cowboy real y
captura el pico de memoria de la BEAM en Prometheus/Grafana — antes y después
de aplicar el parche.
exploit-client ──HTTP/2 (h2c)──▶ cowboy-server (cowboy 2.17.0 / cowlib 2.18.0, :8080)
│ /metrics (same listener)
▼
prometheus (:9090) ──scrape 2s──▶ grafana (:3000)
Cowboy fija una versión exacta de cowlib: cowboy 2.17.0 incluye la versión vulnerable
cowlib 2.18.0 (cowboy 2.18.0 incluye la versión corregida cowlib 2.19.0). Este laboratorio
fuerza cowlib con override: true para que la demostración vuln→fix sea un
cambio de una sola línea en server/mix.exs.
| Servicio | URL |
|---|---|
| Servidor Cowboy | http://localhost:8080/ (HTTP/1.1 + HTTP/2 h2c) |
| Servidor /metrics | http://localhost:8080/metrics |
| Prometheus | http://localhost:9090/targets |
| Grafana | http://localhost:3000 (admin / admin) |
El panel de Grafana "cowlib 2.18.0 HPACK memory DoS" se aprovisiona automáticamente (sin configuración manual de la fuente de datos ni de los paneles).
# 1. Build images and start the server + observability stack
docker compose build
docker compose up -d cowboy-server prometheus grafana
# 2. Sanity checks
curl http://localhost:8080/ # -> OK
curl http://localhost:8080/metrics | grep erlang_vm_memory_processes_bytes_total
# 3. Let ~15s of baseline accumulate, then launch the concurrent exploit
# (default: 5 concurrent connections, each with a ~200KB HPACK bomb)
docker compose run --rm exploit-client
# 4. Watch the spike (the server stays up after the attack)
docker stats cowboy-server # live CLI view — memory + CPU
# Grafana: open http://localhost:3000 (admin/admin) — dashboard auto-provisioned.
# Panel 1 "ERLANG VM: Process memory" = BEAM process heaps only (the decoder)
# Panel 2 "ERLANG VM: Total memory" = system + processes allocator memory
# Panel 3 "CONTAINER: cgroup memory" = cowboy_container_memory_{used,peak,limit}
# NOTE: the first two panels only see the BEAM's own accounting, which peaks at
# ~150-200 MiB. `docker stats` shows the whole cgroup (allocator carriers, code,
# binaries, page cache), which reaches ~1 GiB — panel 3 reports that exact
# number, so it tracks `docker stats` one-for-one.
# Observed spike (100 conn × 512KB): processes_used 16 → 153 MiB (9×),
# container memory 87 → 256 MiB.
# To push the server to full OOM denial of service:
docker compose run --rm -e NUM_CONCURRENT=800 exploit-client
# (NUM_CONCURRENT=1500 drives container memory to the 1g limit even faster)
# Server is killed (exit 137) in ~10 seconds; restart with:
docker compose up -d cowboy-server
# If the server has already died, Prometheus simply stops getting scrapes, so
# Grafana's lines end at the crash. Set the dashboard time range to "Last 15
# minutes" to see the recorded climb; the peak is also kept in
# cowboy_container_memory_peak_bytes until the container restarts.
# The exploit service has `profiles: ["attack"]`, so `docker compose up -d`
# never auto-launches the attack.
# 5. Verify the fix: in server/mix.exs change
# {:cowlib, "2.18.0", override: true}
# to
# {:cowlib, "2.19.0", override: true}
# then rebuild and restart just the server (the memory line stays flat):
# docker compose build cowboy-server && docker compose up -d cowboy-server
# docker compose run --rm exploit-client
# 6. Tear down (the -v flag removes volumes, incl. Grafana dashboards)
docker compose down -v
Puertos: el stack publica en el host
8080(Cowboy),9090(Prometheus),3000(Grafana). Asegúrate de que estén libres antes de iniciar, y vuelve a ejecutar el cliente de explotación condocker compose run --rmcada vez — el servicio de Compose se ejecuta una vez y termina.
| Variable | Predeterminado | Efecto |
|---|---|---|
PAYLOAD_CONTINUATIONS | 524288 | número de octetos 0xFF en el entero HPACK (bomba de 512 KB; el max_fragmented_header_block_size del servidor permite hasta 1 MB). |
NUM_CONCURRENT | 100 | conexiones asíncronas concurrentes — cada una permanece activa decodificando durante ATTACK_KEEPALIVE_SECS. Auméntalo a 200+ para provocar de forma fiable un OOM (superar 1g) en el contenedor del servidor. |
SOCKET_TIMEOUT | 15 | segundos para cada handshake de conexión |
ATTACK_KEEPALIVE_SECS | 60 | cuánto tiempo permanece activa cada conexión tras el envío |
SERVER_HOST / SERVER_PORT | cowboy-server / 8080 | objetivo |