GHSA-gh4c-6fx4-qh6g: Pip/urllib3 vulnerability
Impact
urllib3's streaming API is designed for the efficient handling of large HTTP responses by reading content in chunks instead of loading the entire response body into memory at once.
urllib3 can decompress response bodies according to the HTTP Content-Encoding header. When streaming a compressed, chunked response, urllib3 first consumes data already buffered by the decoder before reading the next HTTP chunk.
However, urllib3 versions from 2.6.2 through 2.7.0 could enter an infinite loop when a chunked response contained bytes after the end of the Deflate stream. If the decompressed body exceeded the requested streaming chunk size, Python's zlib implementation could retain the trailing bytes as unconsumed input after reaching the end of the compressed stream. urllib3 would repeatedly attempt to decode those same bytes without making progress or reading more data from the network.
A malicious server could exploit this behavior to cause excessive CPU usage and prevent the affected request from completing on the client. Network read timeouts would not interrupt the loop because no further socket operation was required.
Affected usages
Applications and libraries using urllib3 versions 2.6.2 through 2.7.0 may be affected when all of the following conditions are met:
1. Compressed responses from an untrusted source are streamed using HTTPResponse.stream(amt=N) or HTTPResponse.readchunked(amt=N) with a positive, finite chunk size. 2. Content decoding is enabled. 3. The response uses both Transfer-Encoding: chunked and Content-Encoding: deflate. 4. The decoded body exceeds the requested chunk size and the encoded body contains bytes after the end of the Deflate stream.
HTTPResponse.stream() uses a finite chunk size by default and is therefore affected when the other conditions are met.
Remediation
Upgrade to urllib3 2.8.0, in which the Deflate decoder stops accepting input after reaching the end of the compressed stream and no longer reports trailing bytes as data that can produce more decoded output.
If upgrading is not immediately possible, disable automatic content decoding for responses from untrusted sources by setting decodecontent=False, or reject streamed responses using the Deflate content encoding. Applications that disable automatic decoding must handle the compressed response safely at another layer.
Affected Software
Remediation
Recommended actions to resolve this vulnerability, in priority order.
- Upgrade
Upgrade
pip/urllib3to a version that resolves this vulnerability.Fixed in 2.8.0 - Upgrade
Upgrade
urllib3to a version that resolves this vulnerability.Fixed in 2.8.0 - Configuration
Disable automatic content decoding for responses from untrusted sources by setting decode_content=False.
urllib3 decode_content = False - Compensating control
Reject streamed responses using the Deflate content encoding when automatic decoding cannot be safely performed.
Event History
Frequently Asked Questions
Which deployments are exposed?
Applications and libraries using urllib3 versions 2.6.2 through 2.7.0 are affected when they stream compressed, chunked HTTP responses that are decompressed according to the Content-Encoding header.
What does an attacker need to control to trigger the issue?
An attacker needs to operate or control a server that can return a chunked Deflate-compressed response containing bytes after the end of the Deflate stream. The decompressed body must also exceed the streaming chunk size requested by the client.
Will network read timeouts stop an affected request?
No. Once the loop is triggered, urllib3 repeatedly processes already buffered decoder input without performing another socket read, so network read timeouts do not interrupt it.
What is the practical impact on an affected client?
A malicious response can cause excessive CPU usage and prevent the affected request from completing.