Ключевые особенности

• 12 ИИ-бэкендов — Burp AI (встроенный), Anthropic, Ollama, LM Studio, NVIDIA NIM, Perplexity, Generic OpenAI-compatible, Gemini CLI, Claude CLI, Codex CLI, OpenCode CLI, Copilot CLI.
• 59 MCP-инструментов — Позволяет Claude Desktop (или любому MCP-клиенту) управлять Burp автономно (8 собственных ИИ-инструментов расширения в store-сборке, все 59 в полной сборке).
• MCP-доступ в рамках области — При желании можно ограничить каждый MCP-инструмент хостами, входящими в область, чтобы внешние ИИ-клиенты не могли обращаться через Burp к целям вне области.
• 62 класса уязвимостей — Пассивный и активный ИИ-сканеры для инъекций, аутентификации, криптографии и многого другого. Пассивный сканер работает как Burp PassiveScanCheck (Burp Pro).
• Установка из релизов — Скачайте JAR из Релизов. В BApp Store его нет: заявка открыта с января 2026 года.
• UI с учётом темы — Внутренняя дизайн-система оформляет панель настроек и автоматически меняет тему вместе с переключателем светлой/тёмной темы Burp.
• Burp Scan Skill — Используйте предпочитаемого ИИ-ассистента для кода (Claude Code, Gemini CLI, Codex и т.д.) в качестве сканера через MCP.
• 3 режима конфиденциальности — STRICT / BALANCED / OFF. Редактируйте конфиденциальные данные до того, как они покинут Burp.
• Библиотека пользовательских промптов — Сохраняйте свободные промпты для каждого контекста (HTTP-запрос или проблема сканера); запускайте их из контекстного меню или вводите разовые через Custom….
• Журнал аудита — JSONL с хэшированием целостности SHA-256 для соответствия требованиям; каждый запуск помечается promptSource / contextKind для воспроизводимости.

Быстрый старт

1. Установка

Скачайте последний JAR из Релизов или соберите из исходников (Java 21):

2. Загрузка в Burp

1. Откройте Burp Suite (Community или Professional).
2. Перейдите в Extensions > Installed > Add.
3. Выберите Java в качестве типа расширения и укажите .jar файл.

Расширение регистрируется в Burp как Custom AI Agent (имя в списке Extensions и на вкладке Suite), чтобы отличать его от встроенного провайдера Burp AI.

3. Профили агентов

При первом запуске расширение автоматически устанавливает встроенные профили в ~/.burp-ai-agent/AGENTS/. Добавьте дополнительные *.md файлы в этот каталог, чтобы создать собственные профили.

4. Настройка бэкенда

Откройте вкладку AI Agent и перейдите в Settings. Выберите бэкенд:

Для NVIDIA NIM бэкенд ожидает тот же поток в стиле chat-completions, что и размещённая конечная точка NVIDIA. Рабочая конфигурация:

Оставьте дополнительные заголовки пустыми, если этого не требует ваш шлюз. Расширение отправляет запросы на /v1/chat/completions и автоматически использует настроенный bearer-токен.

5. Запустите первый анализ

1. Просматривайте цель через Burp Proxy.
2. Щёлкните правой кнопкой мыши по любому запросу в Proxy > HTTP History.
3. Выберите Extensions > Custom AI Agent > Analyze this request.
4. Откроется чат-сессия с ИИ-анализом.

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

Требуется Node.js 18+. Если вы включите External Access, MCP-клиент должен отправлять Authorization: Bearer <token> в каждом запросе.

Вы также можете зарегистрировать внешние или пользовательские MCP-серверы в Settings > MCP > External Servers (транспорты SSE или stdio). Токены аутентификации внешних серверов хранятся в зашифрованном виде, с оговоркой, описанной в Примечаниях о конфиденциальности и безопасности. Подробности настройки и примечания по безопасности см. в docs/external-mcp-servers.md.

Burp Scan Skill (ИИ-сканирование из терминала)

Навык burp-scan позволяет использовать любого ИИ-ассистента для кода (Claude Code, Gemini CLI, Codex и т.д.) в качестве сканера Burp из вашего терминала. Вместо встроенного ИИ плагина ваш терминальный ИИ становится механизмом рассуждений, а Burp предоставляет инструменты через MCP.

Что он включает

• Справочник MCP-инструментов (до всех 59 инструментов в полной сборке), организованный по действиям сканирования
• Протокол пассивного анализа (анализ трафика без отправки запросов)
• Библиотека полезных нагрузок для активного тестирования (200+ нагрузок для 62 классов уязвимостей с паттернами обнаружения)
• Сквозной процесс сканирования (scope -> passive -> active -> OOB -> report)
• Протокол создания проблем с сопоставлением серьёзности/уверенности

Установка для Claude Code

Скопируйте навык в каталог навыков Claude Code:

Затем используйте /burp-scan в Claude Code или позвольте ему запускаться автоматически, когда вы упоминаете сканирование Burp.

Установка для других ИИ-ассистентов

Навык — это отдельный Markdown-файл в skills/burp-scan/SKILL.md. Вы можете использовать его с любым ИИ-ассистентом, поддерживающим системные промпты или файлы контекста:

• Gemini CLI / Codex / OpenCode: добавьте как файл контекста или вставьте в системный промпт
• Пользовательские MCP-клиенты: включите содержимое навыка как системный контекст вместе с вашим MCP-подключением
• Любая LLM: файл самодостаточен — передайте его как контекст вместе с определениями ваших MCP-инструментов

Пример использования

Навык и встроенный сканер плагина дополняют друг друга: плагин выполняет автоматическое фоновое сканирование, а навык обеспечивает интерактивное сканирование под руководством аналитика из вашего терминала.

Документация

Полная документация доступна на burp-ai-agent.six2dez.com.

• Установка
• Быстрый старт
• Обзор интерфейса
• Профили агентов
• Пассивный сканер
• Активный сканер
• Обзор MCP
• Режимы конфиденциальности
• Справочник настроек
• Устранение неполадок
• Burp Scan Skill

Операционные руководства

• Усиление безопасности MCP
• Руководство по безопасности UI
• Устранение неполадок бэкенда
• Настройка бэкенда Anthropic
• Внешние MCP-серверы

Примечания о конфиденциальности и безопасности

• Секреты в состоянии покоя — что шифрование делает, а что нет. Все хранящиеся API-ключи и токены (Anthropic, MCP bearer-токен, пароль TLS-хранилища ключей и т.д.) шифруются с помощью AES-256-GCM с использованием случайного главного ключа для каждой установки (SecretCipher). Этот главный ключ сам хранится в Burp Preferences в кодировке Base64 рядом с защищаемым им шифротекстом (настройка secret.master.key.v1). Любой, кто может прочитать ваши Burp Preferences, следовательно, также может прочитать ключ и расшифровать секреты. Это не защищает от локального злоумышленника или вредоносного процесса, работающего от вашего имени; рассматривайте это как обфускацию от случайного просмотра файла настроек или экспортированного проекта. Если учётные данные должны пережить эту модель угроз, храните их в выделенном хранилище секретов и вводите на каждый сеанс.
• Вызовы инструментов, сгенерированные моделью, требуют вашего одобрения. Вызов инструмента, который расширение извлекает из вывода модели, не выполняется в Burp, пока вы не решите. Каждый инструмент имеет обязательный уровень безопасности: автоматический запуск (только чтение и ограниченный вывод), подтверждение с опцией Approve for session или подтверждение при каждом вызове. Имя инструмента, которое каталог не распознаёт, по умолчанию требует подтверждения каждый раз и никогда не выполняется автоматически, а внешние инструменты с пространством имён ext: всегда требуют подтверждения каждого вызова. Решение отображается как карточка прямо в расшифровке чата, а не как модальный диалог, и каждое решение записывается — событие аудита плюс строка на вкладке Output в Burp, поскольку журнал аудита по умолчанию отключён. При отказе модели возвращается нейтральный результат «не авторизовано, не повторять», а не ошибка. Этот уровень независим от переключателя Unsafe Mode: Unsafe Mode определяет, может ли инструмент вообще запускаться, а уровень — может ли модель запускать его без запроса. Обоснование решения: DECISIONS.md ADR-15. Операционное руководство: docs/ui-safety-guide.md.
• Режим конфиденциальности STRICT анонимизирует хосты с помощью настоящего HKDF (HMAC-SHA256 extract/expand). Режим BALANCED редактирует файлы cookie, токены и заголовки аутентификации. Режим OFF отправляет трафик как есть.
• Выходные данные внешних MCP-серверов оборачиваются в маркер границы доверия перед попаданием в ИИ-промпт, предотвращая prompt-инъекции из недоверенных ответов серверов.

Настройки внутренне версионируются схемой (settings.schema.version) и при загрузке аддитивно мигрируются для безопасных обновлений.

Требования

• Burp Suite Community или Professional (2023.12+)
• Java 21 (входит в современный Burp для выполнения; требуется отдельно для сборки из исходников)
• Настроен хотя бы один ИИ-бэкенд (см. таблицу выше)

Лицензия

Этот проект распространяется под лицензией MIT.

Отказ от ответственности

Использование Custom AI Agent для атак на цели без предварительного согласия незаконно. Пользователь несёт ответственность за соблюдение всех применимых законов. Разработчики не несут ответственности за неправильное использование или ущерб, причинённый этим инструментом. Используйте ответственно.

Участие в разработке

Приветствуются issue и pull request. Информацию о настройке разработки и рекомендациях см. в CONTRIBUTING.md, а подробности архитектуры — в Документации для разработчиков.