chunkloris: bandit
on this page
part of the chunkloris per-chunk amplification survey. this page is the per-server record for bandit under http/1.1 chunked transfer encoding.
at a glance
- server: bandit
1.11.1 - runtime: erlang-otp-27.1.2 / elixir-1.17.3
- ecosystem: beam
- concurrency model: actor
- parser: Bandit.HTTP1.Socket (hand-rolled, pure Elixir)
- delivery granularity:
per-chunk - chunk-limit helper: none exposed by the framework
- verdict: per-chunk β the parser/dispatcher boundary delivers one event per wire chunk. cpu cost under paced mode b is measurable per chunk.
- scaling exponent (mode a): 1.16 (wall time vs N, log-log slope across common cells)
- scaling exponent (mode b): 0.98
measurements
all cells run on a 1-vcpu docker container. cpu cost is derived from the target containerβs cgroup v2 cpu.stat usage_usec delta around each cell.
| mode | N | wall (s) | server cpu % | Β΅s / chunk | basis | ok |
|---|---|---|---|---|---|---|
A-bridge-coalesced | 50,000 | 2.602 | 101.5 | 52.807 | server-cpu-cgroup | β |
A-bridge-coalesced | 100,000 | 5.634 | 100.5 | 56.642 | server-cpu-cgroup | β |
A-bridge-coalesced | 250,000 | 16.764 | 100.1 | 67.130 | server-cpu-cgroup | β |
B-paced-100us | 50,000 | 5.704 | 69.0 | 78.666 | server-cpu-cgroup | β |
B-paced-100us | 100,000 | 10.745 | 65.8 | 70.746 | server-cpu-cgroup | β |
B-paced-100us | 250,000 | 27.639 | 74.3 | 82.171 | server-cpu-cgroup | β |
parser path β source citations
- decoder β
bandit lib/bandit/http1/socket.ex do_read_chunk!/4 + do_read_chunk_size!/3β source - iodata-flatten note β
issue #4 'Improve use of iodata'β source
what this means
the parser/dispatcher path on this server delivers one event per chunked-transfer-encoding chunk, so an attacker who sends a body as N one-byte chunks consumes roughly N Γ (mode-b Β΅s/chunk) of server cpu on a single core. amplification scales linearly with N until the frameworkβs max_request_body_size (or equivalent) is hit.
what to do today
- if this server runs as an origin behind nginx with the default
proxy_request_buffering on, the per-chunk attack shape does not reach this server β nginx delivers one content-length-framed body to the upstream in a singlerecv(). - if deployed direct-exposed, behind haproxy with default streaming, or behind any reverse proxy with
proxy_request_buffering off, the per-chunk cost reaches this server. - there is no framework-level chunk-count limit in the default config; use a frontend buffer, transport-layer rate limiting, or a wrapping middleware that imposes a chunk-count cap before draining the body.
reproducer
the full reproducer for this server is in the paper repo. the docker container pins bandit 1.11.1 and constrains the test container to a single cpu (--cpus=1). the prober script implements mode a (bridge-coalesced) and mode b (paced 100 Β΅s) per the methodology section.
see the draft pdf for the full per-framework discussion.