Custom AI Agent

Burp Suiteと最新のAIをつなぐ架け橋。

名称についての注記: この拡張機能はCustom AI Agent（旧称 Burp AI Agent）として公開されています。PortSwiggerのBApp Storeの命名要件に準拠し、Burp Suiteに組み込まれているBurp AIプロバイダーとの混同を避けるために改名されました。GitHubリポジトリ（github.com/six2dez/burp-ai-agent）、ドキュメントサイト（burp-ai-agent.six2dez.com）、設定ディレクトリ（~/.burp-ai-agent/）は、継続性のためにburp-ai-agentという識別子を維持しています。

Custom AI Agent スクリーンショット

Custom AI Agentは、AIをセキュリティワークフローに統合するBurp Suite用の拡張機能です。ローカルモデルやクラウドプロバイダーを利用し、MCPを介して外部AIエージェントを接続し、パッシブ/アクティブスキャナーで脆弱性を発見させながら、手動テストに集中できます。

v0.9.0の新機能

ネイティブAnthropicバックエンド (CAP-01) — BurpのHTTPトランスポートを介したAnthropic Messages APIへの直接接続。すべてのトラフィックがProxy履歴に表示されます。
保存時シークレットのAES-256-GCM暗号化 (SEC-01) — 保存されたすべてのAPIキーとトークンは、javax.cryptoを使用してインストールごとのキーで暗号化されます。マスターキーは暗号文と並んでBurp Preferencesに保存されるため、これは設定ファイルを流し見することへの防御であり、ローカル攻撃者に対する防御ではありません — Privacy and Security Notesを参照してください。
真のHKDFによるホスト匿名化 (PRIV-01) — STRICTモードは、ホストの匿名化に（ソルト付きSHA-256ではなく）本物のHMAC-SHA256 extract/expandを使用するようになりました。
リクエスト/レスポンス本文の秘匿化 + カスタムパターン (PRIV-02) — 秘匿化パイプラインは、本文フィールドとReDoSに対して検証済みのユーザー設定可能な正規表現パターンを対象とします。
送信前シークレットトリップワイヤ (PRIV-03) — 高エントロピー値がBurpから出る前に警告します。許可リストによるアクションは監査ログに記録されます。
外部MCPサーバー (CAP-02) — 外部/カスタムMCPサーバー（SSEまたはstdio）に接続し、AIエージェントがBurpの組み込みツールと並んでそれらのツールを呼び出せるようにします。
セッションごとのトークンバジェットガードレール (CAP-04) — BudgetGuardはWARN/CAP/OFF状態でパッシブスキャナーの消費を制限します。パッシブスキャナーはハードキャップに達すると自動的に一時停止します。

主な特長

12のAIバックエンド — Burp AI（組み込み）、Anthropic、Ollama、LM Studio、NVIDIA NIM、Perplexity、汎用OpenAI互換、Gemini CLI、Claude CLI、Codex CLI、OpenCode CLI、Copilot CLI。
59のMCPツール — Claude Desktop（または任意のMCPクライアント）にBurpを自律的に操作させることができます（ストアビルドでは拡張機能ネイティブのAIツール8個、フルビルドでは全59個）。
スコープ制限付きMCPアクセス — 必要に応じてすべてのMCPツールをスコープ内ホストに限定できるため、外部AIクライアントがBurp経由でスコープ外のターゲットに到達することはできません。
62の脆弱性クラス — インジェクション、認証、暗号などに対応するパッシブ/アクティブAIスキャナー。パッシブスキャナーはBurpのPassiveScanCheck（Burp Pro）として動作します。
Releasesからのインストール — ReleasesからJARをダウンロードします。BApp Storeには未掲載：提出は2026年1月から未解決のままです。
テーマ対応UI — 内部デザインシステムが設定パネルをスタイリングし、Burpのライト/ダーク切り替えに合わせて自動的に再テーマリングします。
Burp Scanスキル — 好みのAIコーディングアシスタント（Claude Code、Gemini CLI、Codexなど）をMCP経由でスキャナーとして使用できます。
3つのプライバシーモード — STRICT / BALANCED / OFF。機密データをBurpから送信する前に秘匿化します。
カスタムプロンプトライブラリ — コンテキストごと（HTTPリクエストまたはスキャナーの問題）に自由形式のプロンプトを保存できます。右クリックメニューから起動するか、Custom…からアドホックなプロンプトを入力します。
監査ログ — コンプライアンス対応のためのSHA-256整合性ハッシュ付きJSONL。再現性のため、すべての起動にpromptSource / contextKindが刻印されます。

クイックスタート

1. インストール

最新のJARをReleasesからダウンロードするか、ソースからビルドします（Java 21）：

git clone https://github.com/six2dez/burp-ai-agent.git
cd burp-ai-agent

# Full build (default, GitHub releases) — all 59 MCP tools
JAVA_HOME=/path/to/jdk-21 ./gradlew clean shadowJar
# Output: build/libs/Custom-AI-Agent-full-<version>.jar

# Store build (BApp Store submission) — 8 extension-native AI MCP tools only
JAVA_HOME=/path/to/jdk-21 ./gradlew clean shadowJar -PstoreBuild=true
# Output: build/libs/Custom-AI-Agent-<version>.jar

2. Burpへの読み込み

Burp Suite（CommunityまたはProfessional）を開きます。
Extensions > Installed > Addに移動します。
拡張機能のタイプとしてJavaを選択し、.jarファイルを選びます。

この拡張機能は、Burpの組み込みBurp AIプロバイダーと区別するため、BurpではCustom AI Agent（ExtensionsリストとSuiteタブに表示される名前）として登録されます。

拡張機能の読み込み

3. エージェントプロファイル

この拡張機能は、初回実行時にバンドルされたプロファイルを~/.burp-ai-agent/AGENTS/に自動インストールします。カスタムプロファイルを追加するには、そのディレクトリに追加の*.mdファイルを配置します。

4. バックエンドの設定

AI Agentタブを開き、Settingsに移動します。バックエンドを選択します：

バックエンド	タイプ	セットアップ
Burp AI（組み込み）	インプロセス	利用可能な場合はBurp Suite Proの組み込みAIを使用します。追加設定は不要です。
Ollama	ローカルHTTP	Ollamaをインストールし、`ollama serve`を実行して、モデルをプルします（`ollama pull llama3.1`）。
LM Studio	ローカルHTTP	LM Studioをインストールし、モデルを読み込んで、サーバーを起動します。
NVIDIA NIM	HTTP	デフォルトの`https://integrate.api.nvidia.com`エンドポイントを使用し、NVIDIA APIキーを設定して、`moonshotai/kimi-k2.5`などのモデルを選択します。
Perplexity	HTTP	デフォルトの`https://api.perplexity.ai`エンドポイントを使用し、`pplx-...` APIキーを設定して、`sonar`、`sonar-pro`、`sonar-reasoning`などのモデルを選択します。
汎用OpenAI互換	HTTP	OpenAI互換プロバイダー向けにベースURLとモデルを指定します。
Gemini CLI	クラウドCLI	`gemini`をインストールし、`gemini auth login`を実行します。
Claude CLI	クラウドCLI	`claude`をインストールし、`ANTHROPIC_API_KEY`を設定するか、`claude login`を実行します。
Codex CLI	クラウドCLI	`codex`をインストールし、`OPENAI_API_KEY`を設定します。
OpenCode CLI	クラウドCLI	`opencode`をインストールし、プロバイダーの認証情報を設定します。
Copilot CLI	クラウドCLI	`copilot`をインストールし、GitHubアカウントでサインインします。
Anthropic	クラウドAPI	SettingsでAnthropic APIキーを入力します。APIトラフィックはBurpのプロキシを経由します。docs/anthropic-backend.mdを参照してください。

NVIDIA NIMの場合、バックエンドはNVIDIAのホスト型エンドポイントと同じchat-completionsスタイルのフローを想定しています。動作する設定例は次のとおりです：

Backend: NVIDIA NIM
Base URL: https://integrate.api.nvidia.com
Model: moonshotai/kimi-k2.5
API Key: <your nvapi token>

ゲートウェイが要求しない限り、追加のヘッダーは空のままにします。拡張機能は/v1/chat/completionsにリクエストを送信し、設定されたベアラートークンを自動的に使用します。

5. 最初の分析を実行する

Burp Proxyでターゲットを閲覧します。
Proxy > HTTP History内の任意のリクエストを右クリックします。
Extensions > Custom AI Agent > Analyze this requestを選択します。
AI分析を含むチャットセッションが開きます。

コンテキストメニュー

6. MCP経由でClaude Desktopを接続する（オプション）

Settings > MCP ServerでMCPサーバーを有効にし、これをClaude Desktopの設定に追加します：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "burp-ai-agent": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "http://127.0.0.1:9876/sse"
      ]
    }
  }
}

Node.js 18以降が必要です。External Accessを有効にする場合、MCPクライアントはすべてのリクエストでAuthorization: Bearer <token>を送信する必要があります。

また、Settings > MCP > External Servers（SSEまたはstdioトランスポート）で外部またはカスタムのMCPサーバーを登録することもできます。外部サーバーの認証トークンは保存時に暗号化されますが、Privacy and Security Notesで説明されている注意事項が適用されます。セットアップの詳細とセキュリティ上の注意については、docs/external-mcp-servers.mdを参照してください。

Burp Scanスキル（ターミナルAIスキャン）

burp-scanスキルを使用すると、ターミナルから任意のAIコーディングアシスタント（Claude Code、Gemini CLI、Codexなど）をBurpスキャナーとして使用できます。プラグインの組み込みAIの代わりに、ターミナルのAIが推論エンジンとなり、BurpはMCP経由でツールを提供します。

内容

スキャンアクションごとに整理されたMCPツールリファレンス（フルビルドでは最大全59ツール）
パッシブ分析プロトコル（リクエストを送信しないトラフィック分析）
アクティブテストペイロードライブラリ（検出パターン付き、62の脆弱性クラス向けの200以上のペイロード）
エンドツーエンドのスキャンワークフロー（スコープ -> パッシブ -> アクティブ -> OOB -> レポート）
重要度/信頼度マッピング付きの問題作成プロトコル

Claude Codeへのインストール

スキルをClaude Codeのスキルディレクトリにコピーします：

# Global (available in all projects)
cp -r skills/burp-scan ~/.claude/skills/burp-scan

# Or project-specific
cp -r skills/burp-scan .claude/skills/burp-scan

その後、Claude Codeで/burp-scanを使用するか、Burpスキャンについて言及したときに自動的にトリガーさせます。

他のAIアシスタントへのインストール

このスキルは、skills/burp-scan/SKILL.mdにあるスタンドアロンのMarkdownファイルです。システムプロンプトまたはコンテキストファイルをサポートする任意のAIアシスタントで使用できます：

Gemini CLI / Codex / OpenCode: コンテキストファイルとして追加するか、システムプロンプトに貼り付けます
カスタムMCPクライアント: MCP接続とともにスキルコンテンツをシステムコンテキストとして含めます
任意のLLM: ファイルは自己完結型です — MCPツール定義とともにコンテキストとして与えてください

使用例

You: Connect to Burp MCP at localhost:9876 and scan the proxy history for IDOR vulnerabilities

AI: [Uses proxy_http_history to pull traffic]
    [Identifies endpoints with numeric IDs]
    [Sends http1_request with ID+1, ID-1 payloads]
    [Compares responses for different user data]
    [Creates issue_create for confirmed IDOR]

このスキルとプラグインの組み込みスキャナーは補完関係にあります。プラグインは自動化されたバックグラウンドスキャンを実行し、スキルはターミナルから対話的でアナリスト主導のスキャンを可能にします。

ドキュメント

完全なドキュメントは**burp-ai-agent.six2dez.com**で入手できます。

オペレーター向けプレイブック

Privacy and Security Notes

保存時シークレット — 暗号化が保護するものと保護しないもの。 保存されたすべてのAPIキーとトークン（Anthropic、MCPベアラートークン、TLSキーストアのパスワードなど）は、インストールごとのランダムなマスターキー（SecretCipher）を使用したAES-256-GCMで暗号化されます。そのマスターキー自体も、保護対象の暗号文の隣に、Base64エンコードされた状態でBurp Preferencesに保存されます（preference secret.master.key.v1）。したがって、Burp Preferencesを読み取れる人なら誰でも、キーを読み取ってシークレットを復号できます。これはローカル攻撃者や、あなたのユーザー権限で実行される悪意のあるプロセスに対する防御ではありません。設定ファイルやエクスポートされたプロジェクトを流し見することへの難読化として扱ってください。その脅威モデルを乗り切らなければならない認証情報がある場合は、専用のシークレットストアに保管し、セッションごとに貼り付けてください。
モデルが生成したツール呼び出しにはあなたの承認が必要です。 拡張機能がモデル出力から解析したツール呼び出しは、あなたが判断するまでBurpに対して実行されません。すべてのツールには必須のセキュリティレベルがあります：自動実行（読み取り専用で出力量が制限）、Approve for sessionオプションでの確認、または呼び出しごとの確認です。カタログが認識しないツール名は、自動実行ではなく毎回確認に解決され、外部のext:名前空間を持つツールは常に毎回確認されます。この判断はモーダルダイアログではなく、チャットのトランスクリプト内にインラインのカードとして表示され、各判断は記録されます — 監査イベントとBurpのOutputタブへの1行です（監査ログはデフォルトでオフのため）。拒否すると、モデルにはエラーではなく「not authorised, do not retry」という中立的な結果が返されます。このレベルはUnsafe Modeスイッチとは独立しています：Unsafe Modeはツールが実行される可能性があるかどうかを制御し、レベルはモデルが尋ねずに実行できるかどうかを制御します。設計の根拠：DECISIONS.md ADR-15。オペレーター用ランブック：docs/ui-safety-guide.md。
STRICTプライバシーモードは、真のHKDF（HMAC-SHA256 extract/expand）を使用してホストを匿名化します。BALANCEDモードはCookie、トークン、認証ヘッダーを秘匿化します。OFFモードはトラフィックをそのまま送信します。
外部MCPサーバーの出力は、AIプロンプトに入る前にトラストバウンダリマーカーでラップされ、信頼できないサーバーレスポンスからのプロンプトインジェクションを防ぎます。

設定は内部的にスキーマバージョン管理され（settings.schema.version）、安全なアップグレードのために読み込み時に追加的に移行されます。

要件

Burp Suite CommunityまたはProfessional（2023.12以降）
Java 21（実行時は最新のBurpに同梱されています。ソースからのビルドには別途必要です）
少なくとも1つのAIバックエンドが設定されていること（上記の表を参照）

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。

免責事項

事前の同意なしにターゲットを攻撃するためのCustom AI Agentの使用は違法です。適用されるすべての法律を遵守する責任はユーザーにあります。開発者は、このツールの誤用またはそれによって生じた損害について一切の責任を負いません。責任を持って使用してください。

貢献

Issueとプルリクエストを歓迎します。開発環境のセットアップとガイドラインについてはCONTRIBUTING.mdを、アーキテクチャの詳細については開発者ドキュメントを参照してください。

burp-ai-agent v1.0.0

カテゴリ