
자동화된 WAF 평가 도구로, 방화벽 벤더를 탐지하고, 19가지 공격 카테고리를 고급 우회 페이로드로 테스트하며, CLI, Cloudflare Worker 또는 Docker를 통해 색상으로 구분된 우회 분석을 제공합니다.
이 프로젝트는 웹 애플리케이션 방화벽(WAF)이 제품을 일반적인 웹 공격으로부터 얼마나 잘 보호하는지 확인하는 데 도움을 줍니다. Cloudflare Worker(내장 대화형 웹 UI 포함)로 실행하거나 독립형 Node.js CLI 도구로 실행할 수 있습니다.
모든 패키지는 자동화된 단위, 통합, 속성 기반(fast-check 퍼징), 네트워크 복원력 및 리버스 엔지니어링 테스트 스위트(100% SSRF 안전 규정 준수, 프로토콜 회피 기법, 보고서 포매터)로 철저히 테스트됩니다:
| 패키지 | 라인 커버리지 | 문장 | 함수 | 테스트 스위트 |
|---|---|---|---|---|
@waf-checker/core | 93.0% 🟢 | 92.6% | 96.4% | 🟢 282개 통과 |
@waf-checker/cli | 93.5% 🟢 | 92.8% | 96.7% | 🟢 54개 통과 |
@waf-checker/worker | 통과 🟢 | — | — | 🟢 30개 통과 |
| 모노레포 전체 스위트 | 93.2% | 92.7% | 96.6% | 🟢 366개 테스트 통과 |
--reverse)920xxx, 921xxx, 930xxx, 931xxx, 932xxx, 933xxx, 934xxx, 941xxx, 942xxx, 943xxx, 944xxx)를 감사합니다.Retry-After를 추출하면서 최대 30 req/s까지 안전하게 점진적으로 증가시킵니다.--patch / patch 명령)http.request.uri.query contains ... / matches ...) 및 cloudflare_ruleset Terraform HCL.ByteMatchStatement, RegexPatternSet, OrStatement) 및 aws_wafv2_rule_group Terraform HCL.request.path.matches(...), request.headers[...]), gcloud compute security-policies CLI 명령 및 Terraform google_compute_security_policy.az network front-door waf-policy CLI 명령 및 Terraform azurerm_cdn_frontdoor_firewall_policy.@pm 토큰 축약을 사용하는 OWASP CRS 호환 SecRule 지시문(SecLang). --patch modsecurity 또는 --patch coraza로 지원됩니다.location ~* \.(ext)$ { return 403; }, location ~ /\.(git|svn) 및 map 구성 블록.path_end -i, path_beg -i, query -m sub -i, req.hdr())과 http-request deny deny_status 403.expression {http.request.uri.query}.matches(...))과 respond 403을 사용하는 관용적 Caddyfile 명명 매처(@waf_patch_*).httpd.conf, <VirtualHost> 또는 .htaccess용 mod_rewrite 규칙(RewriteCond %{QUERY_STRING} / %{REQUEST_URI} / %{HTTP_USER_AGENT} + RewriteRule ^ - [F,L]). --patch apache로 지원됩니다.safe_regex로 :path/헤더를 매칭하고 direct_response: 403(또는 시뮬레이션 모드에서 전달 후 태깅)을 사용하는 라우트 항목. --patch envoy로 지원됩니다.nginx.ingress.kubernetes.io/server-snippet 어노테이션이 포함된 프로덕션 준비 완료 kind: Ingress YAML 매니페스트.SQL 인젝션, XSS, 명령 인젝션, 경로 순회, SSRF, 로컬 파일 포함, 민감 파일, 오픈 리다이렉트, SSTI, XXE, NoSQL 인젝션, GraphQL 인젝션, JWT 공격 (헤더), JWT 공격 (파라미터), 프로토타입 오염 (JSON 본문), 프로토타입 오염 (URL/파라미터), LDAP 인젝션, XPath 인젝션, 스프레드시트 수식 인젝션, Log4Shell (JNDI), CRLF 인젝션, HTTP 파라미터 오염, User-Agent, IP 우회, HTTP 요청 스머글링, 웹 캐시 포이즈닝, UTF8/유니코드 우회, WAF 검사 한도 우회 (패딩).
X-HTTP-Method-Override 등).--compare / --fail-on-regression)--fail-on-regression)로, 전체 결과 목록에서는 실패하지 않습니다 — 관리형 규칙셋의 드리프트를 포착하는 데 이상적입니다.이 프로젝트는 NPM Workspaces 모노레포로 구성되어 있습니다:
packages/core/: 핵심 보안 테스트 라이브러리, 페이로드 정의, WAF 핑거프린팅 시그니처, 그리고 난독화 인코더입니다.packages/worker/: 정적 HTML/JS 웹 UI와 JSON API 엔드포인트를 제공하는 Cloudflare Worker 패키지입니다.packages/cli/: 터미널에서 직접 감사를 실행하기 위한 Node.js 명령줄 인터페이스 도구입니다.루트 디렉터리에서 의존성을 설치하고 모든 워크스페이스를 빌드합니다:
npm install
npm run build
Worker 개발 서버를 로컬에서 실행하려면 (Wrangler 필요):
npm run dev:worker
웹 UI는 http://localhost:8787에서 접속할 수 있습니다(8787이 사용 중인 경우 다른 포트 사용).
Worker를 Cloudflare에 배포하려면:
npx wrangler deploy --workspace=packages/worker
Worker에는 Workers Paid 플랜이 필요합니다. 스캔 및 감사 페이지는 요청당 10,000개의 서브리퀘스트에 맞게 크기가 설정되어 있습니다(wrangler.toml의 [limits] subrequests, packages/core/src/check.ts의 WORKER_SUBREQUEST_LIMIT). Free 플랜은 요청당 외부 서브리퀘스트를 50개만 허용하므로, User-Agent 우회 테스트(UI에서 기본 활성화)가 포함된 스캔 페이지 하나 또는 리다이렉트를 따라가는 경우에는 이 한도를 초과합니다.
waf-checker 명령으로 설치 (권장)리포지토리 루트에서 npm install && npm run build를 실행한 후, CLI를 링크하여 어떤 디렉터리에서든 실행할 수 있게 합니다. 리포지토리로 cd할 필요도, 긴 node .../dist 경로를 사용할 필요도 없습니다:
# Expose `waf-checker` on your PATH from the built workspace
npm link --workspace @waf-checker/cli
# …now, from anywhere:
waf-checker --help
waf-checker check https://example.com
# Uninstall later with:
npm rm -g @waf-checker/cli
게시된 패키지는 코드를 번들로 포함하므로, 저장소 없이도 패키징된 빌드를 전역으로 설치할 수 있습니다: npm pack --workspace @waf-checker/cli를 실행한 다음 npm i -g ./waf-checker-cli-*.tgz를 실행하세요.
waf-checker completion <shell>은 자동 완성 스크립트를 출력합니다(<shell>을 생략하면 $SHELL에서 자동 감지):
# bash
waf-checker completion bash | sudo tee /etc/bash_completion.d/waf-checker
# or, without root: echo 'source <(waf-checker completion bash)' >> ~/.bashrc
# zsh (into a directory on your $fpath)
waf-checker completion zsh > "${fpath[1]}/_waf-checker"
# fish
waf-checker completion fish > ~/.config/fish/completions/waf-checker.fish
빌드된 진입점을 항상 직접 호출할 수 있습니다:
# Print general CLI help and usage
node packages/cli/dist/index.js --help
# Print check command help (lists all methods, categories, and WAF vendors)
node packages/cli/dist/index.js check --help