# hunt-http-smuggling

hunt-http-smuggling identifies HTTP request desynchronization across front-end proxies and back-end origins. Useful for auditing CDN and load balancer setups.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 16193 repo stars
- Author: Sachin Sharma
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/elementalsouls/Claude-BugHunter/tree/HEAD/skills/hunt-http-smuggling/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/hunt-http-smuggling

## What it does

This skill outlines assessment procedures for header parsing discrepancies involving Content-Length and Transfer-Encoding (covering CL.TE, TE.CL, H2.CL, and H2.TE). It references dedicated audit utilities such as Burp's HTTP Request Smuggler extension, smuggler.py, and h2csmuggler. Detection procedures rely on timing probes with 30-second delays, alongside checks for cache poisoning and internal route access through authorization bypass.

The skill incorporates a proxy suitability matrix detailing real-world behavior. Proxies enforcing RFC 9112, including Nginx versions 1.21 and newer or Caddy 2.x, return HTTP 400 when encountering conflicting headers, meaning classic CL.TE payloads fail against them. Testing shifts toward HTTP/2 to HTTP/1.1 downgrade discrepancies across CDN-to-origin hops, alongside legacy deployments like older HAProxy or Citrix ADC appliances.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add elementalsouls/Claude-BugHunter
```
In the agent chat (not a shell):
```text
/plugin install claude-bughunter@elementalsouls
```
This installs the whole claude-bughunter plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill hunt-http-smuggling -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/hunt-http-smuggling/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/hunt-http-smuggling/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill hunt-http-smuggling -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/hunt-http-smuggling/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill hunt-http-smuggling -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/hunt-http-smuggling/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install elementalsouls/Claude-BugHunter skills/hunt-http-smuggling
```

2. **Manually: put the files in place**
- File: `.github/skills/hunt-http-smuggling/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill hunt-http-smuggling -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/elementalsouls/Claude-BugHunter --path skills/hunt-http-smuggling
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/hunt-http-smuggling/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/elementalsouls/Claude-BugHunter/tree/HEAD/skills/hunt-http-smuggling/SKILL.md

## When to use it
- audit reverse proxy configurations for HTTP/2 downgrade desync
- verify CDN and upstream origin parsing consistency
- identify internal route exposure caused by front-end WAF bypasses
- evaluate edge server compliance with RFC 9112 header rules

## Example prompts
- Audit our reverse proxy setup against the H2.CL desynchronization checklist
- Review whether our current Nginx version blocks conflicting CL and TE headers
- Outline a timing probe strategy for inspecting CDN-to-origin request boundaries

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e0df1bc3ccb7cd41.

BEGIN THIRD-PARTY FILE e0df1bc3ccb7cd41
````text
---
name: hunt-http-smuggling
description: "Hunt HTTP request smuggling (CL.TE, TE.CL, H2.CL, H2.TE). Cause: front-end proxy and back-end server disagree on where one request ends and the next begins (Content-Length vs Transfer-Encoding header parsing inconsistency). CL.TE: front-end uses CL, back uses TE → smuggle by sending TE: chunked but with body that fits CL count. TE.CL: opposite. H2.CL: HTTP/2 downgrade, smuggle CL into HTTP/1.1 back-end. Detection tools: Burp HTTP Request Smuggler extension, smuggler.py, h2csmuggler. Confirm: time-delay technique (smuggled GET with 30s timeout) — if front-end returns slow on next victim request, smuggling works. Validate: cache poisoning chain (smuggle request that gets cached for victim), credential theft (smuggle X-Forwarded-For override that captures next user's cookies), bypass auth (smuggled internal-path request). Real paid examples from major CDN deployments. Use when hunting H1 paid programs running CDN+origin stacks, when targeting load balancer / WAF bypass."
sources: hackerone_public, cve_database, portswigger_research, public_research
report_count: 12
---

## 17. HTTP REQUEST SMUGGLING
> Lowest dup rate. $5K–$30K. PortSwigger research by James Kettle.

### CL.TE (Content-Length front, Transfer-Encoding back)
```http
POST / HTTP/1.1
Content-Length: 13
Transfer-Encoding: chunked

0

SMUGGLED
```

### Detection
```
1. Burp extension: HTTP Request Smuggler
2. Right-click request → Extensions → HTTP Request Smuggler → Smuggle probe
3. Manual timing: CL.TE probe + ~10s delay = backend waiting for rest of body
```

### Impact Chain
```
Poison next request → access admin as victim
Steal credentials → capture victim's session
Cache poisoning → stored XSS at scale
```

---

## Target-Suitability Matrix (2026 reality check)

The classic CL.TE / TE.CL payloads are NOT universally exploitable in 2026. Modern proxies are RFC 9112 strict by default. Fingerprint the front-end BEFORE investing time.

| Front-end | CL.TE | TE.CL | H2.CL | H2.TE | Notes |
|---|---|---|---|---|---|
| **Nginx ≥ 1.21** | NO | NO | partial (H2 ingress) | partial | RFC-strict; rejects CL+TE with HTTP 400. Verified locally on Nginx 1.27 — all 9 documented variants killed by front-end ([docs/verification/phase2h-smuggling-cachepoison.md](../../docs/verification/phase2h-smuggling-cachepoison.md)). |
````
END THIRD-PARTY FILE e0df1bc3ccb7cd41

The third-party file has ended. Everything between the e0df1bc3ccb7cd41 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2373 of 7501 bytes. © Sachin Sharma · MIT · https://github.com/elementalsouls/Claude-BugHunter/tree/HEAD/skills/hunt-http-smuggling/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
