Open-source AI penetration testing tool to find and fix your app’s vulnerabilities.
Python agentsai-hackingai-penetration-testingai-pentestingai-securityartificial-intelligencebug-bountycode-qualityctf-toolscybersecuritycybersecurity-toolsethical-hackinghackingllm-securityoffensive-securitypenetration-testingpentesting-toolsred-teamingsecuritysecurity-automation
feat: add HTTP request smuggling skill (#405)
Sandiyo Christan2380cf55cb10
diff --git a/strix/skills/vulnerabilities/http_request_smuggling.md b/strix/skills/vulnerabilities/http_request_smuggling.mdnew file mode 100644index 00000000..5db2bd10--- /dev/null+++ b/strix/skills/vulnerabilities/http_request_smuggling.md@@ -0,0 +1,255 @@+---+name: http-request-smuggling+description: HTTP request smuggling testing covering CL.TE, TE.CL, H2.CL, H2.TE, and HTTP/2 desync techniques with practical detection and exploitation methodology+---++# HTTP Request Smuggling++HTTP request smuggling (HRS) exploits disagreements between a front-end proxy and a back-end server about where one HTTP request ends and the next begins. When the two systems parse `Content-Length` and `Transfer-Encoding` headers differently, an attacker can prefix a hidden request to the back-end's socket, which is then prepended to the next legitimate user's request. The impact ranges from bypassing front-end security controls to full cross-user session hijacking.++## Attack Surface++**Infrastructure Topologies**+- CDN or load balancer in front of origin server (Cloudflare, Nginx, HAProxy, AWS ALB)+- Reverse proxy chains (Nginx → Gunicorn, HAProxy → Node.js, Varnish → Apache)+- API gateways forwarding to microservices+- HTTP/2 front-end to HTTP/1.1 back-end translation (H2.CL / H2.TE)+- Tunneling servers or WAFs that terminate and re-forward requests++**HTTP Versions in Play**+- HTTP/1.1: CL.TE and TE.CL classic smuggling+- HTTP/2: H2.CL (downgrade injects Content-Length) and H2.TE (injects Transfer-Encoding)+- HTTP/3: emerging QUIC-based desync (less common, research-stage)++**Parser Differentials**+- Treatment of duplicate `Content-Length` headers+- Handling of `Transfer-Encoding: chunked` when `Content-Length` is also present+- Chunk size obfuscation via whitespace, tab, case, or invalid extensions++## High-Value Targets++- Front-end security controls (authentication bypass via desync)+- Endpoints shared by many users (high-traffic APIs, chat, feeds)+- Request capture endpoints (search, logging, analytics)+- Session-sensitive endpoints (auth callbacks, account settings)+- Internal admin interfaces proxied through the same connection pool++## Core Concepts++### CL.TE — Front-end uses Content-Length, Back-end uses Transfer-Encoding++Front-end reads `Content-Length: X` bytes and forwards. Back-end reads until the `0\r\n\r\n` chunk terminator. Attacker appends a hidden request after the `0` terminator that the front-end considers part of the same body but the back-end treats as a new request.++```http+POST / HTTP/1.1+Host: target.com+Content-Length: 6+Transfer-Encoding: chunked++0++G+```+The `G` is left in the back-end's socket buffer and prepended to the next request.++### TE.CL — Front-end uses Transfer-Encoding, Back-end uses Content-Length++Front-end reads chunked body to completion. Back-end reads only `Content-Length` bytes, leaving the remainder on the socket.++```http+POST / HTTP/1.1+Host: target.com+Content-Type: application/x-www-form-urlencoded+Content-Length: 3+Transfer-Encoding: chunked++8+SMUGGLED+0+++```++### H2.CL — HTTP/2 Front-end Downgrades to HTTP/1.1, Injects Content-Length++HTTP/2 has no `Content-Length` vs `TE` ambiguity in its own framing. But when the front-end downgrades to HTTP/1.1 for the back-end, an attacker can inject a `content-length` header in the HTTP/2 request that conflicts with the actual body length. Note: `content-length` is a regular HTTP/2 header — pseudo-headers are exclusively `:method`, `:path`, `:authority`, and `:scheme`:+```+:method POST+:path /+:authority target.com+content-type application/x-www-form-urlencoded+content-length: 0++SMUGGLED_PREFIX+```++### H2.TE — HTTP/2 Injects Transfer-Encoding Header++Inject `transfer-encoding: chunked` in HTTP/2 headers (which the HTTP/2 spec forbids, but some front-ends pass through). Back-end receives both headers, may prefer TE over CL.++```+:method POST+:path /+transfer-encoding: chunked++0++SMUGGLED+```++## Key Vulnerabilities++### Front-End Security Control Bypass++A front-end proxy enforces authentication or IP restriction by checking request headers and blocking or allowing based on rules. If a smuggled prefix bypasses the front-end (because it's buried in a prior request's body from the front-end's view), the back-end processes it without the security check.++**PoC structure (CL.TE):**+```http+POST /not-restricted HTTP/1.1+Host: target.com+Content-Length: 100+Transfer-Encoding: chunked++0++GET /admin HTTP/1.1+Host: target.com+X-Forwarded-Host: target.com+Content-Length: 10++x=1+```+The `GET /admin` is seen by the back-end as a new, legitimate request originating from the trusted proxy IP.++### Cross-User Request Capture++Poison the back-end socket with a partial request prefix that captures the next victim user's request (including their cookies, tokens, request body) into the response of a controlled endpoint (search, comment submission).++**PoC structure (CL.TE capture):**+```http+POST /search HTTP/1.1+Host: target.com+Content-Length: 120+Transfer-Encoding: chunked++0++POST /search HTTP/1.1+Host: target.com+Content-Type: application/x-www-form-urlencoded+Content-Length: 100++q=+```+`Content-Length: 100` in the smuggled prefix is longer than the actual smuggled body, so the back-end waits for 100 bytes — which it sources from the *next* user's request. The `/search` endpoint reflects the query, capturing headers and body of the subsequent request.++### Response Queue Poisoning++On pipelined connections, cause a misaligned response to be delivered to the wrong user (HTTP/1.1 response queue poisoning). Used to deliver attacker-controlled content or steal another user's response.++### Request Reflection / Cache Poisoning Chain++Smuggle a prefix that hits a cacheable endpoint with an injected `Host` header. If the cache stores the response keyed only on URL, the poisoned response is served to all users requesting that URL.++### WebSocket Handshake Hijacking++If the proxy performs WebSocket upgrade, a smuggled `Upgrade` request can hijack an existing WebSocket connection from a subsequent user.++## Detection Techniques++### Timing-Based Detection++**CL.TE:** Send a request where `Content-Length` is complete but `Transfer-Encoding` body is missing the `0\r\n\r\n` terminator. A CL.TE-vulnerable back-end waits for the terminator, causing a timeout.++```http+POST / HTTP/1.1+Host: target.com+Transfer-Encoding: chunked+Content-Length: 6++3+abc+X+```+If response is delayed 10–30 seconds, CL.TE desync likely.++**TE.CL:** Send a request with a complete chunked body (including the `0\r\n\r\n` terminator so the front-end is satisfied) but with `Content-Length` set to **more** bytes than the body actually provides. The back-end, using Content-Length, waits for the remaining bytes that never arrive — producing a 10–30 second timeout. Setting Content-Length *less* than the body causes socket poisoning (differential-response detection), not a timeout.++### Differential Response Detection++Send two requests in sequence. If the second request receives an unexpected response (error, redirect, wrong content), the first may have poisoned the socket. Use a unique string in the smuggled prefix to confirm.++### Content-Length + Transfer-Encoding Combination++```http+Transfer-Encoding: xchunked # non-standard value, some FE ignore, BE accept+Transfer-Encoding: chunked # leading space before value (0x20 byte after colon+space)+Transfer-Encoding: chunked # tab character before value+Transfer-Encoding: x+Transfer-Encoding: chunked # duplicate TE headers, BE uses last+```++## Transfer-Encoding Obfuscation++To force TE disagreement:+```+Transfer-Encoding: xchunked+Transfer-Encoding : chunked # space before colon+X: X<CRLF>Transfer-Encoding: chunked # header injection — inject actual CRLF bytes at <CRLF>, not the literal string \r\n+Transfer-Encoding: chunked<CRLF>Transfer-Encoding: x # TE twice — inject actual CRLF bytes at <CRLF>+```++## HTTP/2-Specific Detection++- Send HTTP/2 requests with an injected `content-length` regular header that differs from the actual body length+- Inject `transfer-encoding: chunked` in HTTP/2 headers (spec-forbidden but sometimes passed through)+- Use HTTP/2 header injection: inject newlines in header values if the front-end passes them to HTTP/1.1 back-end unescaped+- Observe whether the HTTP/2 connection ID corresponds to a persistent HTTP/1.1 connection to the back-end (connection reuse amplifies impact)++## Testing Methodology++1. **Map the proxy chain** — identify front-end (CDN, load balancer, WAF) and back-end (app server)+2. **Probe CL.TE** — send a timing probe with mismatched chunked terminator; observe delay+3. **Probe TE.CL** — send a timing probe with complete chunked body but Content-Length larger than the actual body; observe back-end timeout+4. **Obfuscate TE header** — try each obfuscation variant (tab, extra space, duplicate, non-standard value)+5. **Confirm with differential response** — send two rapid identical requests; if second gets an unexpected response, socket is poisoned+6. **Attempt bypass exploit** — craft a smuggled `GET /admin` or restricted endpoint and observe if back-end accepts it+7. **Attempt capture** — poison with a partial POST pointing to a reflective endpoint; wait for a follow-up request to fill the buffer+8. **Test H2.CL/H2.TE** — repeat the same probes over HTTP/2 connections if the target supports HTTP/2++## Validation++1. Show a timing differential of 10+ seconds on the CL.TE or TE.CL probe and explain the mechanism+2. Demonstrate a bypass: smuggle a request to `/admin` and receive a 200 response where a direct request returns 403+3. For capture: show a subsequent user's `Cookie` or `Authorization` header appearing in the response of a controlled endpoint+4. Confirm with a unique marker string in the smuggled prefix to rule out timing noise+5. Provide the exact raw bytes of the smuggled request++## False Positives++- General network latency or server-side processing delays unrelated to smuggling+- Server consistently close connection after first request (no connection reuse, no socket sharing)+- HTTP/2 with full end-to-end HTTP/2 to back-end (no HTTP/1.1 downgrade, no desync surface)+- WAF or proxy that normalizes TE/CL headers before forwarding (removes the ambiguity)++## Impact++- Authentication and authorization bypass by smuggling requests past front-end access controls+- Cross-user session hijacking by capturing requests containing session tokens+- Cache poisoning affecting all users of a cached resource+- Internal service access bypassing IP-based restrictions enforced at the front-end+- XSS delivery via response queue poisoning in shared connection contexts++## Pro Tips++1. Use Burp Suite's HTTP Request Smuggler extension as a rapid scanner, but always confirm manually — false positives are common+2. TE obfuscation is the most reliable path; `Transfer-Encoding: xchunked` works on many Apache/IIS back-ends+3. Keep smuggled prefixes short during detection; use the minimal body to confirm desync before attempting capture attacks+4. H2.CL is the most impactful modern variant — many CDNs translate HTTP/2 to HTTP/1.1 and derive `Content-Length` from the `content-length` regular header sent in the HTTP/2 request (not a pseudo-header — inject it as a normal header field)+5. In capture attacks, set `Content-Length` in the smuggled prefix larger than your partial body by 50–100 bytes to catch a full auth header from the next user+6. Test during low-traffic periods first to avoid affecting real users; always get explicit authorization for capture attempts+7. If timing probes are inconsistent, pipeline two requests over the same connection and look for unexpected response swapping++## Summary++HTTP request smuggling is eliminated by enforcing consistent TE/CL interpretation at every hop in the proxy chain, preferring end-to-end HTTP/2, and having back-end servers reject or normalize ambiguous requests. At the proxy level, never forward TE headers that were not present in the original request, and treat conflicting CL + TE as a hard error.