Custom AI Agent

Die Brücke zwischen Burp Suite und moderner KI.

Hinweis zum Namen: Diese Erweiterung wird als Custom AI Agent veröffentlicht (ehemals Burp AI Agent). Sie wurde umbenannt, um den Namensanforderungen des PortSwigger BApp Store zu entsprechen und Verwechslungen mit dem integrierten Burp AI-Provider von Burp Suite zu vermeiden. Das GitHub-Repository (github.com/six2dez/burp-ai-agent), die Dokumentationsseite (burp-ai-agent.six2dez.com) und das Konfigurationsverzeichnis (~/.burp-ai-agent/) behalten die Kennung burp-ai-agent zur Kontinuität bei.

Custom AI Agent ist eine Erweiterung für Burp Suite, die KI in Ihren Sicherheits-Workflow integriert. Nutzen Sie lokale Modelle oder Cloud-Provider, verbinden Sie externe KI-Agenten über MCP und lassen Sie passive/aktive Scanner Schwachstellen finden, während Sie sich auf manuelle Tests konzentrieren.

Was ist neu in v0.9.0

• Natives Anthropic-Backend (CAP-01) — direkte Anthropic-Messages-API über Burps HTTP-Transport; der gesamte Datenverkehr erscheint im Proxy-Verlauf.
• AES-256-GCM-Geheimnisse im Ruhezustand (SEC-01) — alle gespeicherten API-Schlüssel und Token werden mit einem pro Installation vergebenen Schlüssel unter Verwendung von javax.crypto verschlüsselt. Der Hauptschlüssel liegt in den Burp-Einstellungen neben dem Chiffrat, sodass dies gegen das beiläufige Einsehen einer Einstellungsdatei schützt, nicht jedoch gegen einen lokalen Angreifer — siehe Hinweise zu Datenschutz und Sicherheit.
• Echte HKDF-Host-Anonymisierung (PRIV-01) — der STRICT-Modus verwendet nun echte HMAC-SHA256-Extrakt/Expand (nicht gesalzenes SHA-256) für die Host-Anonymisierung.
• Redaktion von Anforderungs-/Antwort-Textkörpern + benutzerdefinierte Muster (PRIV-02) — die Redaktions-Pipeline umfasst Textkörperfelder und benutzerkonfigurierbare Regex-Muster, die gegen ReDoS validiert werden.
• Pre-Send-Tripwire für Geheimnisse (PRIV-03) — warnt, bevor Werte mit hoher Entropie Burp verlassen; Allowlist-Aktionen werden im Audit-Log protokolliert.
• Externe MCP-Server (CAP-02) — Verbinden Sie sich mit externen/benutzerdefinierten MCP-Servern (SSE oder stdio), damit KI-Agenten deren Tools neben den integrierten Burp-Tools aufrufen können.
• Token-Budget-Schutzmechanismen pro Sitzung (CAP-04) — BudgetGuard begrenzt die Ausgaben des passiven Scanners mit den Zuständen WARN/CAP/OFF; der passive Scanner pausiert automatisch beim harten Limit.

Highlights

• 12 KI-Backends — Burp AI (integriert), Anthropic, Ollama, LM Studio, NVIDIA NIM, Perplexity, generisch OpenAI-kompatibel, Gemini CLI, Claude CLI, Codex CLI, OpenCode CLI, Copilot CLI.
• 59 MCP-Tools — Lassen Sie Claude Desktop (oder einen beliebigen MCP-Client) Burp autonom steuern (8 erweiterungsnative KI-Tools im Store-Build, alle 59 im vollständigen Build).
• Scope-begrenzter MCP-Zugriff — Begrenzen Sie optional jedes MCP-Tool auf Ihre In-Scope-Hosts, damit externe KI-Clients über Burp keine Out-of-Scope-Ziele erreichen können.
• 62 Schwachstellenklassen — Passive und aktive KI-Scanner für Injection, Authentifizierung, Kryptografie und mehr. Der passive Scanner läuft als Burp-PassiveScanCheck (Burp Pro).
• Installation über Releases — Laden Sie das JAR von Releases herunter. Nicht im BApp Store: Die Einreichung ist seit Januar 2026 offen.
• Theme-bewusste Benutzeroberfläche — Ein internes Designsystem gestaltet das Einstellungsfenster und passt das Theme automatisch an Burps Hell/Dunkel-Umschalter an.
• Burp-Scan-Skill — Verwenden Sie Ihren bevorzugten KI-Codierungsassistenten (Claude Code, Gemini CLI, Codex usw.) über MCP als Scanner.
• 3 Datenschutzmodi — STRICT / BALANCED / OFF. Redigieren Sie sensible Daten, bevor sie Burp verlassen.
• Benutzerdefinierte Prompt-Bibliothek — Speichern Sie frei formulierte Prompts pro Kontext (HTTP-Anforderung oder Scanner-Befund); starten Sie sie über das Kontextmenü oder geben Sie Ad-hoc-Prompts über Custom… ein.
• Audit-Protokollierung — JSONL mit SHA-256-Integritäts-Hashing für Compliance; jeder Start wird zur Reproduzierbarkeit mit promptSource / contextKind markiert.

Schnellstart

1. Installation

Laden Sie das neueste JAR von Releases herunter oder erstellen Sie es aus dem Quellcode (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. In Burp laden

1. Öffnen Sie Burp Suite (Community oder Professional).
2. Gehen Sie zu Erweiterungen > Installiert > Hinzufügen.
3. Wählen Sie Java als Erweiterungstyp und die .jar-Datei aus.

Die Erweiterung registriert sich in Burp als Custom AI Agent (der Name in der Erweiterungsliste und im Suite-Tab), um sie vom integrierten Burp AI-Provider von Burp Suite zu unterscheiden.

3. Agent-Profile

Die Erweiterung installiert beim ersten Start automatisch die gebündelten Profile in ~/.burp-ai-agent/AGENTS/. Legen Sie zusätzliche *.md-Dateien in diesem Verzeichnis ab, um benutzerdefinierte Profile hinzuzufügen.

4. Ein Backend konfigurieren

Öffnen Sie den Tab AI Agent und gehen Sie zu Einstellungen. Wählen Sie ein Backend:

Für NVIDIA NIM erwartet das Backend denselben Chat-Completions-Ablauf wie der gehostete NVIDIA-Endpunkt. Eine funktionierende Konfiguration ist:

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

Lassen Sie zusätzliche Header leer, es sei denn, Ihr Gateway erfordert sie. Die Erweiterung sendet Anforderungen an /v1/chat/completions und verwendet automatisch den konfigurierten Bearer-Token.

5. Führen Sie Ihre erste Analyse aus

1. Durchsuchen Sie ein Ziel über den Burp-Proxy.
2. Klicken Sie in Proxy > HTTP-Verlauf mit der rechten Maustaste auf eine beliebige Anforderung.
3. Wählen Sie Erweiterungen > Custom AI Agent > Diese Anforderung analysieren.
4. Es öffnet sich eine Chat-Sitzung mit der KI-Analyse.

6. Claude Desktop über MCP verbinden (optional)

Aktivieren Sie den MCP-Server in Einstellungen > MCP-Server und fügen Sie dies zu Ihrer Claude-Desktop-Konfiguration hinzu:

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"
      ]
    }
  }
}

Erfordert Node.js 18+. Wenn Sie Externen Zugriff aktivieren, muss der MCP-Client bei jeder Anforderung Authorization: Bearer <token> senden.

Sie können auch externe oder benutzerdefinierte MCP-Server in Einstellungen > MCP > Externe Server registrieren (SSE- oder stdio-Transporte). Authentifizierungstoken externer Server werden im Ruhezustand verschlüsselt gespeichert, mit dem unter Hinweise zu Datenschutz und Sicherheit beschriebenen Vorbehalt. Einzelheiten zur Einrichtung und Sicherheitshinweise finden Sie unter docs/external-mcp-servers.md.

Burp-Scan-Skill (KI-Scanning über das Terminal)

Die burp-scan-Skill ermöglicht es Ihnen, jeden KI-Codierungsassistenten (Claude Code, Gemini CLI, Codex usw.) von Ihrem Terminal aus als Burp-Scanner zu verwenden. Anstelle der integrierten KI des Plugins wird Ihre Terminal-KI zur Reasoning-Engine, während Burp die Tools über MCP bereitstellt.

Was die Skill enthält

• MCP-Tool-Referenz (bis zu allen 59 Tools im vollständigen Build), organisiert nach Scan-Aktion
• Passives Analyseprotokoll (Datenverkehrsanalyse ohne Senden von Anforderungen)
• Payload-Bibliothek für aktive Tests (200+ Payloads für 62 Schwachstellenklassen mit Erkennungsmustern)
• End-to-End-Scan-Workflow (Scope -> passiv -> aktiv -> OOB -> Bericht)
• Issue-Erstellungsprotokoll mit Schweregrad-/Konfidenz-Zuordnung

Installation für Claude Code

Kopieren Sie die Skill in das Skills-Verzeichnis von 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

Verwenden Sie dann /burp-scan in Claude Code oder lassen Sie sie automatisch auslösen, wenn Sie Burp-Scanning erwähnen.

Installation für andere KI-Assistenten

Die Skill ist eine eigenständige Markdown-Datei unter skills/burp-scan/SKILL.md. Sie können sie mit jedem KI-Assistenten verwenden, der Systemprompts oder Kontextdateien unterstützt:

• Gemini CLI / Codex / OpenCode: Als Kontextdatei hinzufügen oder in Ihren Systemprompt einfügen
• Benutzerdefinierte MCP-Clients: Den Inhalt der Skill als Systemkontext zusammen mit Ihrer MCP-Verbindung einbeziehen
• Beliebiges LLM: Die Datei ist in sich geschlossen — geben Sie sie zusammen mit Ihren MCP-Tool-Definitionen als Kontext an

Verwendungsbeispiel

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]

Die Skill und der integrierte Scanner des Plugins ergänzen sich gegenseitig: Das Plugin führt automatische Hintergrund-Scans aus, während die Skill interaktives, analystengeführtes Scannen von Ihrem Terminal aus ermöglicht.

Dokumentation

Die vollständige Dokumentation ist unter burp-ai-agent.six2dez.com verfügbar.

• Installation
• Schnellstart
• UI-Tour
• Agent-Profile
• Passiver Scanner
• Aktiver Scanner
• MCP-Überblick
• Datenschutzmodi
• Einstellungsreferenz
• Fehlerbehebung
• Burp-Scan-Skill

Operator-Playbooks

• MCP-Härtung
• UI-Sicherheitsleitfaden
• Backend-Fehlerbehebung
• Anthropic-Backend-Einrichtung
• Externe MCP-Server

Hinweise zu Datenschutz und Sicherheit

• Geheimnisse im Ruhezustand — was die Verschlüsselung leistet und was nicht. Alle gespeicherten API-Schlüssel und Token (Anthropic, MCP-Bearer-Token, TLS-Keystore-Passwort usw.) werden mit AES-256-GCM unter Verwendung eines pro Installation zufällig generierten Hauptschlüssels (SecretCipher) verschlüsselt. Dieser Hauptschlüssel selbst wird in den Burp-Einstellungen Base64-kodiert neben dem Chiffrat gespeichert, das er schützt (Einstellung secret.master.key.v1). Jeder, der Ihre Burp-Einstellungen lesen kann, kann daher auch den Schlüssel lesen und die Geheimnisse entschlüsseln. Es schützt nicht gegen einen lokalen Angreifer oder einen bösartigen Prozess, der unter Ihrem Benutzerkonto läuft; betrachten Sie es als Verschleierung gegen das beiläufige Einsehen einer Einstellungsdatei oder eines exportierten Projekts. Wenn eine Anmeldeinformation diesem Bedrohungsmodell standhalten muss, bewahren Sie sie in einem dedizierten Geheimnisspeicher auf und fügen Sie sie pro Sitzung ein.
• Vom Modell ausgegebene Tool-Aufrufe benötigen Ihre Genehmigung. Ein Tool-Aufruf, den die Erweiterung aus der Modellausgabe extrahiert, wird erst nach Ihrer Entscheidung gegen Burp ausgeführt. Jedes Tool trägt eine erforderliche Sicherheitsstufe: automatisch ausführen (nur lesend und mit begrenzter Ausgabe), mit einer Option Für Sitzung genehmigen bestätigen oder bei jedem einzelnen Aufruf bestätigen. Ein Toolname, den der Katalog nicht erkennt, wird immer als „bei jedem Aufruf bestätigen" aufgelöst, niemals als automatisch, und externe Tools mit ext:-Namespace bestätigen immer jeden Aufruf. Die Entscheidung erscheint als Karte inline im Chat-Transkript und nicht als modaler Dialog, und jede Entscheidung wird aufgezeichnet — ein Audit-Ereignis plus eine Zeile im Output-Tab von Burp, da die Audit-Protokollierung standardmäßig deaktiviert ist. Bei Verweigerung erhält das Modell ein neutrales Ergebnis „nicht autorisiert, nicht erneut versuchen" statt eines Fehlers. Diese Stufe ist unabhängig vom Unsafe Mode-Schalter: Der Unsafe Mode bestimmt, ob ein Tool jemals ausgeführt werden darf, die Stufe bestimmt, ob das Modell es ohne Nachfragen ausführen darf. Designbegründung: DECISIONS.md ADR-15. Operator-Runbook: docs/ui-safety-guide.md.
• Der STRICT-Datenschutzmodus anonymisiert Hosts mithilfe von echtem HKDF (HMAC-SHA256-Extrakt/Expand). Der BALANCED-Modus redigiert Cookies, Token und Auth-Header. Der OFF-Modus sendet Datenverkehr unverändert.
• Ausgaben externer MCP-Server werden vor dem Eintritt in den KI-Prompt in eine Vertrauensgrenzen-Markierung gehüllt, um Prompt-Injection durch nicht vertrauenswürdige Serverantworten zu verhindern.

Die Einstellungen sind intern schemaversioniert (settings.schema.version) und werden beim Laden additiv migriert, um sichere Upgrades zu gewährleisten.

Anforderungen

• Burp Suite Community oder Professional (2023.12+)
• Java 21 (bei modernem Burp für die Laufzeit enthalten; für das Erstellen aus dem Quellcode separat erforderlich)
• Mindestens ein konfiguriertes KI-Backend (siehe Tabelle oben)

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Haftungsausschluss

Die Verwendung von Custom AI Agent zum Angreifen von Zielen ohne vorherige Zustimmung ist illegal. Es liegt in der Verantwortung des Benutzers, alle geltenden Gesetze einzuhalten. Die Entwickler übernehmen keine Haftung für Missbrauch oder Schäden, die durch dieses Tool verursacht werden. Verwenden Sie es verantwortungsvoll.

Mitwirken

Issues und Pull Requests sind willkommen. Siehe CONTRIBUTING.md für Entwicklungseinrichtung und Richtlinien oder die Entwicklerdokumentation für Architekturdetails.