
ファイアウォールベンダーを検出し、19の攻撃カテゴリを高度な回避ペイロードでテストし、CLI、Cloudflare Worker、Dockerを介して色分けされたバイパス分析を提供する自動WAF評価ツール。
このプロジェクトは、Web Application Firewall(WAF)が一般的なWeb攻撃から製品をどれだけ保護できているかを確認するのに役立ちます。Cloudflare Worker(インタラクティブなWeb 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)を、Paranoiaレベル(PL1-PL4)とともに監査します。Retry-Afterを抽出します。--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。@waf_patch_*) とCEL式 (expression {http.request.uri.query}.matches(...)) および respond 403。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リクエストスマグリング、Webキャッシュポイズニング、UTF8/Unicodeバイパス、WAF検査制限バイパス (パディング)。
X-HTTP-Method-Overrideなど)。--compare / --fail-on-regression)--fail-on-regression)であり、結果リスト全体では失敗しません — マネージドルールセットのドリフトを検出するのに最適です。このプロジェクトはNPM Workspacesモノレポとして構成されています:
packages/core/: コアセキュリティテストライブラリ、ペイロード定義、WAFフィンガープリンティングシグネチャ、および難読化エンコーダー。packages/worker/: 静的HTML/JS Web UIとJSON APIエンドポイントを提供するCloudflare Workerパッケージ。packages/cli/: ターミナルから直接監査を実行するためのNode.jsコマンドラインインターフェースツール。ルートディレクトリから、依存関係をインストールし、すべてのワークスペースをビルドします:
npm install
npm run build
Worker の開発サーバーをローカルで実行するには (Wrangler が必要):
npm run dev:worker
Web 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 ではデフォルトで有効)を伴うスキャンページ 1 つ、またはリダイレクトを追跡する場合、それを超えてしまいます。
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