AIが自動でハッキングテストを実行！ソースコード解析×実攻撃で脆弱性を証明する完全自律型ペンテスター — shannon

アーキテクチャ・仕組み

ShannonはAnthropicのClaude Agent SDKを推論エンジンとして使用するマルチエージェントアーキテクチャで構成されています。各スキャンはエフェメラル（使い捨て）のDockerコンテナ内で実行され、並行スキャンが可能です。

5段階のパイプライン

1. Pre-Reconnaissance（事前偵察）: nmap、subfinder、whatwebで対象のインフラを調査し、同時にソースコードからフレームワークやエントリーポイントを特定
2. Reconnaissance（偵察）: ブラウザ自動操作で実際のアプリケーションを探索し、攻撃対象マップを作成
3. Vulnerability Analysis（脆弱性分析）: 5つのカテゴリ（Injection、XSS、Auth、Authz、SSRF）の専門エージェントが並列で脆弱性を探索
4. Exploitation（攻撃実行）: 発見した脆弱性に対して実際の攻撃を実行。「攻撃成功しなければ報告しない」 ポリシーを厳守
5. Reporting（レポート生成）: 再現可能なPoC（概念実証）付きの最終レポートを生成

対応環境・プラットフォーム

• macOS: Docker Desktopがあればそのまま動作
• Linux: ネイティブDocker対応（sudoが必要な場合あり）
• Windows: Git Bash（ネイティブ）またはWSL2（推奨）で動作
• Node.js: 18以上が必要
• Docker: 必須（npxモードでも約1GBのワーカーイメージを使用）

AIプロバイダー対応

3つのモデル階層を使用：small（claude-haiku-4-5）=要約、medium（claude-sonnet-4-6）=セキュリティ分析、large（claude-opus-4-6）=深い推論

パフォーマンス・ベンチマーク

• XBOWベンチマーク: 96.15%（104件中100件の攻撃成功）
• OWASP Juice Shop: 20以上の脆弱性を発見（SQLインジェクション、認証バイパス、SSRF等）
• 実行時間: 1回のフルテストで約1〜1.5時間
• コスト: Claude 4.5 Sonnet使用時で約50ドル（アプリの複雑さにより変動）

対象とする脆弱性カテゴリ

• Broken Authentication & Authorization（認証・認可の不備）
• Injection（SQLインジェクション等）
• Cross-Site Scripting（XSS）
• Server-Side Request Forgery（SSRF）

主要な機能

• 2FA/TOTP自動処理: 二要素認証（SSO含む）のログインを自動で処理
• ワークスペース機能: 中断した診断をgitコミットベースのチェックポイントから再開可能
• 設定ファイル（YAML）: 認証情報、テスト対象パスの指定、除外パスの設定が可能
• 並列処理: 脆弱性分析と攻撃実行を5カテゴリ同時並行で処理
• Temporal Web UI: http://localhost:8233 でリアルタイム進捗監視が可能

制約・注意点

• ホワイトボックス専用: ソースコードへのアクセスが必須
• 本番環境での使用は厳禁: データ作成・変更・削除など破壊的な操作を伴う
• LLMの限界: レポートにハルシネーション（AI の誤った出力）が含まれる可能性があるため、人間の検証が必要
• プロンプトインジェクションリスク: 信頼できないコードベースのスキャンは非推奨

Lite版 vs Pro版の違い

ライセンス

AGPL-3.0。内部セキュリティテストは自由に利用可能。SaaSとして提供する場合は変更のオープンソース化が必要。

クイックスタート（npxを使う方法・推奨）

Docker と Node.js 18以上が必要です。

# 1. 初期設定（対話形式のウィザード・初回のみ）
npx @keygraph/shannon setup

# または環境変数を直接設定
export ANTHROPIC_API_KEY=your-api-key

# 2. ペネトレーションテストを実行
npx @keygraph/shannon start -u https://your-app.com -r /path/to/your-repo

ローカルビルドで使う方法

# 1. リポジトリをクローン
git clone https://github.com/KeygraphHQ/shannon.git
cd shannon

# 2. APIキーを設定（.envファイルを作成）
cat > .env << 'EOF'
ANTHROPIC_API_KEY=your-api-key
CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000
EOF

# 3. 依存関係のインストールとビルド
pnpm install
pnpm build

# 4. ペネトレーションテストを実行
./shannon start -u https://your-app.com -r /path/to/your-repo

ローカルアプリをテストする場合は localhost の代わりに host.docker.internal を使用してください。