ShannonはDocker Hubからワーカーイメージを取得し、必要なローカルインフラを起動し、対象リポジトリを読み取り専用で一時的なワーカーコンテナ内にマウントし、結果をローカルワークスペースに書き込みます。

ソースビルド、認証付きスキャン、プロバイダー固有のセットアップ、およびプラットフォームに関する注意事項については、[ドキュメント](#documentation)を参照してください。

> [!TIP]
> **APIクレジットの代わりにサブスクリプションを利用したいですか？**
>
> - **OpenAI Codex:** 最新バージョンのShannonはChatGPT PlusおよびProサブスクリプションをサポートしています。[OpenAI Codexサブスクリプション設定ガイド](https://github.com/keygraphhq/shannon/blob/main/docs/ai-providers.md#openai-codex-chatgpt-pluspro-subscription)に従って開始してください。
> - **Claude Code:** 最新バージョンのShannonはClaude Codeサブスクリプションをサポートしていません。[Claude Codeサブスクリプション設定ガイド](https://github.com/keygraphhq/shannon/blob/main/docs/ai-providers.md#claude-code-subscription)に従って、Claude Agent SDK上に構築された最終リリースであるバージョン`1.9.0`を使用してください。

## 主な機能

- **実証による証明レポート**: Shannonは、推測的な警告ではなく、再現可能な概念実証手順を伴う検証済みの調査結果を報告します。
- **ホワイトボックス攻撃計画**: Shannonはソースコード分析を使用して動的テストをガイドし、現実的な攻撃経路に焦点を当てます。
- **自律実行**: Shannonは単一のコマンドから偵察、脆弱性分析、悪用、レポート生成を開始します。
- **認証付きテスト**: 設定ファイルでログインフロー、テスト認証情報、TOTP、メールベースのログインフロー、重点領域、および攻撃ルールを記述できます。
- **OWASP重視のカバレッジ**: Shannonは悪用可能なInjection、XSS、SSRF、Broken Authentication、およびBroken Authorizationの問題を対象とします。
- **再開可能なワークスペース**: Shannonは完了したエージェントを再実行せずに中断された実行を再開できます。
- **機械可読な出力**: Shannonは調査結果を構造化JSONとして出力し、エクスプロイトモードのスキャンではデフォルトでSARIF 2.1.0としても出力します（`report.sarif: "false"`でオプトアウト）。SARIFは静的解析結果のOASIS標準であり、調査結果はそれを読み取るあらゆるコードスキャンサービス、脆弱性管理プラットフォーム、セキュリティダッシュボード、またはCI/CDパイプラインに流れ込みます。
- **独自キー持ち込み、プロバイダー非依存**: ShannonはAnthropic、OpenAI、xAI、AWS Bedrock、およびAnthropic Messages APIまたはOpenAI Chat Completions / Responses APIを話す任意のエンドポイントで動作します。これには、Ollama、vLLM、LM Studioを通じて提供されるセルフホストモデルや、OpenRouterやLiteLLMなどのゲートウェイも含まれます。認証情報はお客様が提供するため、ソースコードとモデルトラフィックはお客様のインフラ内に留まります。ローカルおよびセルフホストモデルは技術的にはサポートされていますが推奨されません。フロンティアモデルほどShannonの指示やツール使用制約に確実に従わない可能性があるため、選択したモデルの動作を理解している場合にのみその経路を選択してください。

## エディション

Shannonは2つの方法で提供されます。**Shannon Open Source**（自分で実行するペンテスター）と、**Keygraphプラットフォーム**（Shannonを継続的に実行し、その周囲で完全なAppSecライフサイクルを閉じる商用ペンテスティング製品）です。

**Shannon Open Source**（このリポジトリ）はスタンドアロンのペンテスターです。所有またはテストを許可されたWebアプリケーションとAPIのホワイトボックス、実証による証明テストのためのCLIエージェントです。ソースを読み取り、攻撃を計画し、実際のエクスプロイトを実行し、証明できるものだけを報告します。オンデマンドで実行され、その領域では完全です。ターゲットを指定すると、ペンテストを実行し、レポートを出力します。

**Keygraphプラットフォーム**は、Shannonを搭載したエンタープライズ対応の継続的ペンテスティング製品です。Keygraphプラットフォームでは、強化されたShannonビルドが、Keygraphの完全なコード解析スタックによって供給される堅牢化されたオーケストレーション環境で継続的に実行されます。そのエンジンの周囲で、プラットフォームは分析から検証済みの修正まで、脆弱性ライフサイクル全体を閉じます。

- **分析**: Code Property Graph SAST、到達可能性を備えたSCA、シークレット、IaC、コンテナスキャン。それ自体が第一級の検出機能であり、Shannonの攻撃を研ぎ澄ますコンテキストでもあります。
- **証明**: 自律型ブラックボックスおよびソース認識型ホワイトボックスペンテストにより、候補となる調査結果を推測的なアラートではなく、証明された悪用された脆弱性に変えます。
- **管理**: リポジトリごとの脆弱性ごとに正規のレコードを1つ保持し、すべてのソースにわたって重複排除し、所有権、ステータス、SLA追跡、ダッシュボード、双方向Jira同期を備えます。
- **修正と検証**: パッチは自動的に作成され、配信前にパッチ適用済みコードに対して再テストされ、自動適用ではなく既存のレビューワークフローに取り込まれます。
- **デプロイ**: セルフホストおよびエアギャップ環境、厳格な独自キー持ち込みモデルアクセス、顧客管理のLLMゲートウェイパターンにより、ソース、結果、モデルトラフィックがお客様の境界内に留まります。

ShannonはKeygraphプラットフォームの中心にある証明エンジンです。Shannon Open Sourceは、そのエンジンを自分で実行できるように提供します。Keygraphプラットフォームは、継続的な分析、調査結果管理、修正、検証、エンタープライズデプロイでShannonを囲みます。

| AppSecライフサイクル段階 | Shannon Open Source | Keygraphプラットフォーム |
| --- | --- | --- |
| 分析 | 攻撃計画のためのソースの基本的なLLMパススルー | 実際のコードベース解析に加え、Code Property Graph、SAST、到達可能性を備えたSCA、シークレット、IaC、コンテナ |
| ペンテストと証明 | ホワイトボックスのみ、実証による証明 | 強化されたホワイトボックスに加え、ブラックボックスおよびグレーボックスモードを継続的に実行 |
| 調査結果の管理 | ローカルMarkdownレポート | 正規の調査結果システム: ソース間の重複排除、所有権、SLA、ダッシュボード、Jira同期、プロフェッショナルなペンテストグレードのPDFレポート |
| 修正と検証 | レポートから手動で修正し、完全なスキャンを再実行して検証 | 自動修正: 修正を含むPRを開き、完全なスキャンを再実行せずにポイント再テストで検証 |
| デプロイと運用 | ローカルCLIおよびDockerワーカー | セルフホスト、エアギャップ、BYOK、継続的、エンタープライズ統合 |
| ライセンスとサポート | AGPL-3.0、コミュニティ | 商用、サポート付き |

詳細は[Keygraphウェブサイト](https://keygraph.io)で確認するか、[Keygraphプラットフォーム技術概要](https://github.com/keygraphhq/shannon/blob/main/docs/keygraph-platform.md)を読むか、無料トライアルを開始するか[デモ](https://cal.com/team/keygraph/shannon-pro)を予約するか、[[email protected]](mailto:[email protected])までお問い合わせください。

## アーキテクチャ

Shannonは、ソースコード分析とライブエクスプロイトを組み合わせたマルチエージェントワークフローを使用します。```text
        ┌──────────────────────┐
        │   Pre-Reconnaissance │
        │   (source code scan) │
        └──────────┬───────────┘
                   │
                   ▼
        ┌──────────────────────┐
        │   Reconnaissance     │
        │  (attack surface     │
        │   mapping)           │
        └──────────┬───────────┘
                   │
                   ▼
        ┌──────────┴───────────┐
        │          │           │
        ▼          ▼           ▼
  ┌───────────┐ ┌───────────┐ ┌───────────┐
  │ Vuln      │ │ Vuln      │ │   ...     │
  │(Injection)│ │  (XSS)    │ │           │
  └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
        │              │             │
        ▼              ▼             ▼
  ┌───────────┐ ┌───────────┐ ┌───────────┐
  │ Exploit   │ │ Exploit   │ │   ...     │
  │(Injection)│ │  (XSS)    │ │           │
  └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
        │              │             │
        └──────┬───────┴─────────────┘
               │
               ▼
        ┌──────────────────────┐
        │      Reporting       │
        └──────────────────────┘