six2dez/burp-ai-agentРасширение Burp Suite, которое добавляет встроенные инструменты MCP, анализ с помощью ИИ, контроль конфиденциальности, пассивное и активное сканирование и многое другое
# Custom AI Agent
**Мост между Burp Suite и современным ИИ.**
> **Примечание о названии:** Это расширение публикуется под названием **Custom AI Agent** (ранее *Burp AI Agent*). Оно было переименовано в соответствии с требованиями PortSwigger к именованию в BApp Store и во избежание путаницы со встроенным провайдером **Burp AI** в Burp Suite. Репозиторий GitHub (`github.com/six2dez/burp-ai-agent`), сайт документации (`burp-ai-agent.six2dez.com`) и каталог конфигурации (`~/.burp-ai-agent/`) сохраняют идентификатор `burp-ai-agent` для преемственности.
<!-- screenshot: main extension tab with chat and settings visible -->
Custom AI Agent — это расширение для Burp Suite, которое интегрирует ИИ в ваш рабочий процесс безопасности. Используйте локальные модели или облачных провайдеров, подключайте внешних ИИ-агентов через MCP и позволяйте пассивным/активным сканерам находить уязвимости, пока вы сосредоточены на ручном тестировании.
> [!IMPORTANT]
> **Если вы используете версию 1.0.0 или более раннюю, прочитайте [уведомления о безопасности](https://github.com/six2dez/burp-ai-agent/blob/main/SECURITY.md#security-advisories) и обновитесь до последней версии 1.1.0.**
> Файлы аудита, записанные при включённом журналировании аудита, могут содержать MCP-токен и полные промпты, а контекстное меню «send to AI» могло обходить режим приватности; в обоих уведомлениях указано, какие учётные данные следует сменить.
> Ни для одного из них не выпущен идентификатор CVE или GHSA.
## Что нового в v1.1.0
Две сборки из одного репозитория, созданные для повторной подачи в BApp Store. Подробности в
[CHANGELOG.md](https://github.com/six2dez/burp-ai-agent/blob/main/CHANGELOG.md).
- **Две сборки.** Сборка для BApp Store (`./gradlew bappJar`) содержит 8 встроенных MCP-инструментов расширения,
Burp AI и шесть HTTP-бэкендов. Полная сборка GitHub (`./gradlew fullJar`) содержит все 59 MCP-инструментов,
пять CLI-бэкендов, внешний MCP-клиент и опциональную автоочередь. Обе доступны в
[Releases](https://github.com/six2dez/burp-ai-agent/releases), каждая с файлом `.sha256`. Загружайте только
одну за раз; [Какую сборку выбрать?](https://burp-ai-agent.six2dez.com/getting-started/which-build)
сравнивает их.
- **ИИ-шлюз сборки для BApp Store.** Сборка для BApp Store работает на Burp Community и Burp Professional; она отправляет ИИ-запросы только когда в Burp включена настройка «Use AI» для расширения, а при её отключении расширение загружается и отклоняет каждый ИИ-запрос.
- **Пассивные сканирования ничего не отправляют на цель.** Пассивные находки, которые может проверить ИИ-активный сканер,
перечислены как предлагаемые цели в диалоге его очереди, в обеих сборках, и вы добавляете их в очередь вручную:
ничего не отправляется на цель до вашего подтверждения.
- **Чистая выгрузка.** Выгрузка не оставляет работающих потоков, таймеров или MCP-слушателя расширения и
не запускает новых запросов к ИИ-провайдеру.
- **Детали проблем HTML-кодируются.** Полезные нагрузки, значения, взятые из цели, и текст ИИ отображаются как
буквальный текст в представлении проблем Burp и в отчётах.
- **ИИ-сканеры запускаются ВЫКЛЮЧЕННЫМИ при каждой загрузке**, в обеих сборках; включение одного из них действует до тех пор, пока Burp
не выгрузит расширение.
## Что нового в v1.0.1
Хотфикс корректности и приватности для 1.0.0. Подробности в [CHANGELOG.md](https://github.com/six2dez/burp-ai-agent/blob/main/CHANGELOG.md) и
[SECURITY.md](https://github.com/six2dez/burp-ai-agent/blob/main/SECURITY.md#fixed-in-101).
- **Промпты с не-ASCII символами работают на каждом HTTP-бэкенде** (#84, #85, #86, #88). Тела запросов отправляются как
байты UTF-8; ранее не-ASCII символы повреждались, и текст цели мог изменить JSON-структуру
запроса.
- **Приватность:** контекстное меню по правому клику, настройки сканера, журналирование аудита и ссылки чата теперь учитывают
режим приватности и режим аудита только с хешами по умолчанию; ссылки чата открываются только после подтверждения.
- **Безопасность сканера:** запросы, изменяющие состояние, воспроизводятся только при уровне DANGEROUS; ИИ-проверки
Burp Scanner соблюдают пул ресурсов сканирования и переключатель ИИ-пассивного сканирования.
- **Надёжность:** NVIDIA NIM и Perplexity снова работают, последующие сообщения чата сохраняют свой контекст,
а редактирование больше не теряет содержимое на медленных или загруженных машинах.
- **Встроенные библиотеки:** Netty 4.1.138, Jackson 2.22.3.
## Что нового в v1.0.0
Первый стабильный релиз и веха в области корректности безопасности. Внешняя проверка `0.9.2` от
2026-08-05 подтвердила два эксплуатируемых дефекта путём **запуска** поставленного кода; этот релиз исправляет оба,
а также более широкий класс проблем, выявленных той же проверкой. Подробности в [CHANGELOG.md](https://github.com/six2dez/burp-ai-agent/blob/main/CHANGELOG.md).
**Исправлено и раскрыто:**
- **SEC-04 (критический)** — проверки контроля доступа MCP не выполнялись на разрешённых маршрутах. При включённом внешнем
доступе слушатель принимал **неаутентифицированные** вызовы инструментов; в локальном режиме проверки
Origin/Host/User-Agent и заголовки безопасности ответов не действовали на совпавших маршрутах. Решение
теперь принимается до маршрутизации. → [смените ваш токен MCP](https://github.com/six2dez/burp-ai-agent/blob/main/SECURITY.md#security-advisories)
- **PRIV-05 (высокий)** — сессионные cookie попадали в AI-бэкенды **без редактирования в режимах STRICT и BALANCED**. Пассивный
сканер выдавал cookie как голые `name=value`, отбрасывая префиксное редактирование, на которое опирался, и
перехватывалась только cookie с буквальным именем `session`. → [смените затронутые cookie](https://github.com/six2dez/burp-ai-agent/blob/main/SECURITY.md#security-advisories)
**Усилено:**
- **Вызовы инструментов, сгенерированные моделью, теперь требуют вашего одобрения** (SEC-06) — вызов инструмента, разобранный из *вывода
модели*, не доходит до Burp, пока вы не примете решение. Уровни работают по принципу отказа при сомнении: нераспознанное имя инструмента
требует подтверждения каждый раз и никогда не выполняется молча. См. [Privacy and Security Notes](#privacy-and-security-notes).
- **Токен MCP больше не раскрывается при перехвате порта** (SEC-07) — локальный процесс, занимающий
порт MCP и возвращающий заголовок идентификации, ранее мог собрать токен, дающий полный доступ к инструментам
MCP. Клиент перехвата теперь предъявляет HMAC-доказательство владения, а под TLS
закрепляет сертификат сервера за своим собственным хранилищем ключей.
- **`SsrfGuard` классифицирует альтернативные записи IP** (SEC-07) — `http://2852039166/` (десятичная запись для
`169.254.169.254`) больше не обходит предупреждение о приватном/link-local адресе только за счёт записи, и
классификация теперь вообще не выполняет разрешение имён.
- **Аргументы оболочки экранируются по белому списку** (QUAL-06) — закрыт путь от импорта настроек к выполнению команд
для значений, содержащих метасимволы без пробелов (`foo;id`, `$(cmd)`).
- **Изоляция EDT и устойчивость планировщика** — выполнение инструментов, HTTP-запросы к бэкенду и MCP `stop()` перенесены
из потока диспетчеризации событий Swing; повторяющиеся задачи защищены от гибели из-за исключения.
**Проверено:** набор тестов вырос с 660 до **1131 теста в 158 классах**, покрытие строк проекта
34% → **58%**, а базовый уровень detekt сократился с 1096 до 1040, а не вырос.
## Основные возможности
- **12 AI-бэкендов** — Burp AI (встроенный), Anthropic, Ollama, LM Studio, NVIDIA NIM, Perplexity, универсальный OpenAI-совместимый, Gemini CLI, Claude CLI, Codex CLI, OpenCode CLI, Copilot CLI. В сборке BApp Store доступно 7 (Burp AI и шесть HTTP-бэкендов); пять CLI-бэкендов присутствуют только в полной сборке.
- **59 инструментов MCP** — Позвольте Claude Desktop (или любому MCP-клиенту) автономно управлять Burp (8 собственных AI-инструментов расширения в сборке для магазина, все 59 в полной сборке).
- **Ограниченный доступ MCP** — Опционально ограничьте каждый инструмент MCP вашими хостами в области охвата, чтобы внешние AI-клиенты не могли через Burp обратиться к целям вне области охвата.
- **62 класса уязвимостей** — Пассивные и активные AI-сканеры по инъекциям, аутентификации, криптографии и другим категориям. Пассивный сканер работает как Burp `PassiveScanCheck` (Burp Pro).
- **Установка из Releases** — Скачайте любую сборку из [Releases](https://github.com/six2dez/burp-ai-agent/releases); [Which Build?](https://burp-ai-agent.six2dez.com/getting-started/which-build) объясняет их различия. Custom AI Agent пока не указан в BApp Store: сборка для BApp Store проходит проверку PortSwigger в [extension-portal#231](https://github.com/PortSwigger/extension-portal/issues/231).
- **Интерфейс с поддержкой тем** — Внутренняя система дизайна оформляет панель настроек и автоматически меняет тему вместе с переключателем светлой/тёмной темы Burp.
- **Навык сканирования Burp** — Используйте предпочитаемого AI-ассистента для программирования (Claude Code, Gemini CLI, Codex и т. д.) в качестве сканера через MCP.
- **Подтверждение вызовов инструментов** — Вызовы инструментов, которые создаёт AI, контролируются: ограниченные инструменты только для чтения выполняются молча, для всего остального сначала запрашивается подтверждение через карточку одобрения в чате. Неизвестные инструменты отклоняются по принципу fail-closed.
- **3 режима конфиденциальности** — STRICT / BALANCED / OFF. Редактирование конфиденциальных данных перед их выходом за пределы Burp.
- **Библиотека пользовательских промптов** — Сохраняйте свободные промпты для каждого контекста (HTTP-запрос или проблема сканера); запускайте их из контекстного меню или вводите разовые через `Custom…`.
- **Журналирование аудита** — Опциональный журнал JSONL с SHA-256 для каждой записи; промпты, контекст и ответы записываются как SHA-256 плюс длина, если не включён подробный аудит, а учётные данные никогда не записываются; каждый запуск помечается `promptSource` / `contextKind` для воспроизводимости.
## Быстрый старт
### 1. Установка
Скачайте последний JAR из [Releases](https://github.com/six2dez/burp-ai-agent/releases): каждый релиз содержит `Custom-AI-Agent-full-<version>.jar` (полная сборка GitHub) и `Custom-AI-Agent-bapp-<version>.jar` (сборка BApp Store), каждый с файлом `.sha256`. [Which Build?](https://burp-ai-agent.six2dez.com/getting-started/which-build) объясняет, какую выбрать. Или соберите из исходников (Java 21):
```bash
git clone https://github.com/six2dez/burp-ai-agent.git
cd burp-ai-agent
# Full build (GitHub releases) — all 59 MCP tools
JAVA_HOME=/path/to/jdk-21 ./gradlew clean fullJar
# 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 bappJar
# Output: build/libs/custom-ai-agent-bapp.jar
```
### 2. Загрузка в Burp
1. Откройте Burp Suite (Community или Professional).
2. Перейдите в **Extensions > Installed > Add**.
3. Выберите **Java** в качестве типа расширения и укажите файл `.jar`.
Расширение регистрируется в Burp как **Custom AI Agent** (это имя отображается в списке Extensions и на вкладке Suite), чтобы отличать его от встроенного провайдера **Burp AI**.
**Загружайте только одну сборку.** Полная сборка и сборка из BApp Store обе регистрируются как **Custom AI Agent**, поэтому в списке Extensions в Burp они выглядят одинаково. Если загрузить обе одновременно, вы получите две вкладки Custom AI Agent, два MCP-сервера, конкурирующих за один и тот же порт, и две копии, записывающие в общий каталог `~/.burp-ai-agent`. Выгрузите одну, прежде чем загружать другую.
**Редакция Burp и «Use AI».** Сборка из BApp Store работает в Burp Community и Burp Professional; она отправляет AI-запросы только пока для расширения включена настройка Burp «Use AI», а при выключенной — загружается и отклоняет каждый AI-запрос. PortSwigger описывает «Use AI» как флажок для каждого расширения, по умолчанию выключенный: **Extensions > Installed > Custom AI Agent > Use AI**.
<!-- screenshot: Burp Extensions > Add dialog with the JAR loaded -->
### 3. Профили агентов
При первом запуске расширение автоматически устанавливает встроенные профили в `~/.burp-ai-agent/AGENTS/`.
Добавляйте дополнительные файлы `*.md` в этот каталог, чтобы добавить пользовательские профили.
### 4. Настройка бэкенда
Откройте вкладку **AI Agent** и перейдите в **Settings**. Выберите бэкенд:
| Бэкенд | Тип | Настройка |
| :--- | :--- | :--- |
| **Burp AI (встроенный)** | В процессе | Использует встроенный AI Burp и требует, чтобы для расширения была включена настройка Burp «Use AI» (см. [Requirements](#requirements)); дополнительная настройка не требуется. |
| **Ollama** | Локальный HTTP | Установите [Ollama](https://ollama.com), запустите `ollama serve`, загрузите модель (`ollama pull llama3.1`). |
| **LM Studio** | Локальный HTTP | Установите [LM Studio](https://lmstudio.ai), загрузите модель, запустите сервер. |
| **NVIDIA NIM** | HTTP | Используйте эндпоинт по умолчанию `https://integrate.api.nvidia.com`, укажите свой ключ NVIDIA API и выберите модель, например `moonshotai/kimi-k2.5`. |
| **Perplexity** | HTTP | Используйте эндпоинт по умолчанию `https://api.perplexity.ai`, укажите свой ключ API `pplx-...` и выберите модель, например `sonar`, `sonar-pro` или `sonar-reasoning`. |
| **Универсальный OpenAI-совместимый** | HTTP | Укажите базовый URL и модель для любого OpenAI-совместимого провайдера. |
| **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 | Введите свой ключ Anthropic API в Settings. Трафик API проходит через прокси Burp. См. [docs/anthropic-backend.md](https://github.com/six2dez/burp-ai-agent/blob/main/docs/anthropic-backend.md). |
Для **NVIDIA NIM** бэкенд ожидает такой же поток в стиле chat-completions, как у размещённого эндпоинта NVIDIA. Рабочая конфигурация:
```text
Backend: NVIDIA NIM
Base URL: https://integrate.api.nvidia.com
Model: moonshotai/kimi-k2.5
API Key: <your nvapi token>
```
Оставьте дополнительные заголовки пустыми, если ваш шлюз их не требует. Расширение отправляет запросы на `/v1/chat/completions` и автоматически использует настроенный bearer-токен.
### 5. Запустите первый анализ
1. Просмотрите целевой сайт через Burp Proxy.
2. Щёлкните правой кнопкой мыши любой запрос в **Proxy > HTTP History**.
3. Выберите **Extensions > Custom AI Agent > Analyze this request**.
4. Откроется сессия чата с анализом от ИИ.
<!-- screenshot: right-click context menu showing Custom AI Agent actions -->
### 6. Подключите Claude Desktop через MCP (необязательно)
Включите MCP-сервер в **Settings > MCP Server** и добавьте следующее в конфигурацию Claude Desktop:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```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>` в каждом запросе.
**Только полная сборка.** Вы также можете зарегистрировать внешние или пользовательские MCP-серверы в **Settings > MCP Server > External MCP Servers** (транспорты SSE или stdio). Токены аутентификации внешних серверов хранятся в зашифрованном виде, с оговоркой, описанной в разделе [Privacy and Security Notes](#privacy-and-security-notes). Подробности настройки и примечания по безопасности см. в [docs/external-mcp-servers.md](https://github.com/six2dez/burp-ai-agent/blob/main/docs/external-mcp-servers.md).
## Навык Burp Scan (сканирование с помощью терминального ИИ)
Навык `burp-scan` позволяет использовать любого ИИ-ассистента для программирования (Claude Code, Gemini CLI, Codex и т. д.) в качестве сканера Burp прямо из терминала. Вместо встроенного ИИ плагина **ваш терминальный ИИ становится движком рассуждений**, а Burp предоставляет инструменты через MCP.
### Что он содержит
- Справочник по инструментам MCP (до всех 59 инструментов в полной сборке), организованный по действиям сканирования
- Протокол пассивного анализа (анализ трафика без отправки запросов)
- Библиотека полезных нагрузок для активного тестирования (200+ полезных нагрузок для 62 классов уязвимостей с шаблонами обнаружения)
- Сквозной рабочий процесс сканирования (scope -> passive -> active -> OOB -> report)
- Протокол создания проблем с сопоставлением серьёзности/уверенности
### Установка для Claude Code
Скопируйте навык в каталог навыков Claude Code:
```bash
# 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
```
Затем используйте `/burp-scan` в Claude Code или позвольте ему сработать автоматически, когда вы упомянете сканирование Burp.
### Установка для других AI-ассистентов
Навык представляет собой автономный Markdown-файл по адресу [`skills/burp-scan/SKILL.md`](https://github.com/six2dez/burp-ai-agent/blob/main/skills/burp-scan/SKILL.md). Вы можете использовать его с любым 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](https://burp-ai-agent.six2dez.com)**.
- [Установка](https://burp-ai-agent.six2dez.com/getting-started/installation)
- [Какую сборку выбрать?](https://burp-ai-agent.six2dez.com/getting-started/which-build)
- [Быстрый старт](https://burp-ai-agent.six2dez.com/getting-started/quick-start)
- [Обзор интерфейса](https://burp-ai-agent.six2dez.com/user-guide/ui-tour)
- [Профили агента](https://burp-ai-agent.six2dez.com/user-guide/agent-profiles)
- [Пассивный сканер](https://burp-ai-agent.six2dez.com/scanners/passive)
- [Активный сканер](https://burp-ai-agent.six2dez.com/scanners/active)
- [Обзор MCP](https://burp-ai-agent.six2dez.com/mcp/overview)
- [Режимы конфиденциальности](https://burp-ai-agent.six2dez.com/privacy/privacy-modes)
- [Справочник настроек](https://burp-ai-agent.six2dez.com/reference/settings-reference)
- [Уведомления о безопасности](https://burp-ai-agent.six2dez.com/security/advisories)
- [Устранение неполадок](https://burp-ai-agent.six2dez.com/reference/troubleshooting)
- [Навык Burp Scan](https://burp-ai-agent.six2dez.com/examples/burp-scan-skill)
## Руководства для операторов
- [Усиление защиты MCP](https://github.com/six2dez/burp-ai-agent/blob/main/docs/mcp-hardening.md)
- [Руководство по безопасности интерфейса](https://github.com/six2dez/burp-ai-agent/blob/main/docs/ui-safety-guide.md)
- [Устранение неполадок бэкенда](https://github.com/six2dez/burp-ai-agent/blob/main/docs/backend-troubleshooting.md)
- [Настройка бэкенда Anthropic](https://github.com/six2dez/burp-ai-agent/blob/main/docs/anthropic-backend.md)
- [Внешние MCP-серверы](https://github.com/six2dez/burp-ai-agent/blob/main/docs/external-mcp-servers.md)
### Замечания о конфиденциальности и безопасности
---
[Read more](https://github.com/six2dez/burp-ai-agent)