
Rust 기반 HTTP 요청 스머글링 스캐너.
Rust로 구동되는 HTTP 요청 스머글링 스캐너.
SmuggleX는 웹 애플리케이션의 HTTP 요청 스머글링 취약점을 탐지하는 보안 테스트 도구입니다. CL.TE, TE.CL, TE.TE, H2C, H2 스머글링 공격을 테스트하며, 선택적으로 활성화할 수 있는 파서 불일치(parser-discrepancy), CL.0, 0.CL 감사 기능을 제공합니다. 또한 HTTPS 대상에서는 실제 HTTP/2(ALPN h2)로 통신하여 h2-downgrade 검사를 통해 HTTP/2→HTTP/1.1 다운그레이드 스머글링(H2.CL / H2.TE)을 탐지합니다.
자세한 문서는 smugglex.hahwul.com에서 확인하세요.
brew install hahwul/smugglex/smugglex
Rust 1.88 이상이 필요합니다:
git clone https://github.com/hahwul/smugglex
cd smugglex
cargo install --path .
다른 설치 방법은 설치 가이드를 참고하세요.
기본 스캔:
smugglex https://target.com
stdin에서 URL 읽기:
cat urls.txt | smugglex
캡처한 요청(예: Burp Suite에서 내보낸 요청)을 요청 템플릿으로 재전송:
smugglex --raw-request request.txt # 대상은 Host 헤더에서 가져옴
smugglex --raw-request request.txt --raw-request-proto http
smugglex --raw-request request.txt -H "X-Collab: abcd.oastify.com" # -H는 추가 방식
캡처된 요청 대상(request-target)은 정규화되지 않고 그대로 전송됩니다 — 점 세그먼트(dot-segment), 매트릭스 파라미터, #이 보존됩니다 — origin-form(POST /path ...)과 absolute-form(GET http://...) 요청 라인 모두에 적용되므로 경로 기반 페이로드가 유지됩니다. 모든 -H 헤더는 캡처된 헤더 위에 병합됩니다.
자세한 사용법과 옵션은 사용 가이드를 참고하세요.
smugglex https://target.com -v -o results.json
cat urls.txt | smugglex --exit-first
smugglex는 자동화된 사용에 친화적으로 설계되었습니다:
# 깔끔한 JSON 출력 (stdout에는 JSON만) + 적절한 종료 코드
smugglex --json https://target.com
echo $? # 0 = 정상, 1 = 취약점 발견
# 배치 + 구조화된 출력 (단일 유효 JSON 문서)
cat urls.txt | smugglex -f json -o report.json
# 파이프라인용 조용한 모드 + JSON
smugglex -q --json https://target.com | jq '.summary.vulnerable_targets'
종료 코드:
0 — 취약점 없음1 — 하나 이상의 취약점 발견2 — 사용법 / 입력 오류Unix에서 -o로 작성된 보고서는 프로세스 umask를 적용하기 전에 모드 0600으로 생성되며, 기존 보고서를 교체할 때도 마찬가지입니다.
자세한 내용은 파이프라인 가이드와 출력 형식을 참고하세요.
일반적인 문제와 해결 방법은 문제 해결 가이드에서 확인할 수 있습니다.