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 Screenshot

Custom AI Agent는 AI를 보안 워크플로에 통합하는 Burp Suite 확장 프로그램입니다. 로컬 모델이나 클라우드 제공자를 사용하고, MCP를 통해 외부 AI 에이전트를 연결하며, 수동 테스트에 집중하는 동안 수동/능동 스캐너가 취약점을 찾도록 하세요.

[!IMPORTANT] 1.0.0 이하 버전을 실행 중이라면 보안 권고문을 읽고 최신 릴리스인 1.1.0으로 업그레이드하세요. 감사 로깅이 켜진 상태에서 작성된 감사 파일에는 MCP 토큰과 전체 프롬프트가 포함될 수 있으며, 우클릭 "AI로 전송" 컨텍스트가 프라이버시 모드를 우회할 수 있습니다. 두 권고문 모두 어떤 자격 증명을 교체해야 하는지 명시하고 있습니다. 이들 중 어느 것에도 CVE 또는 GHSA 식별자는 발급되지 않았습니다.

v1.1.0의 새로운 기능

BApp Store 재제출을 위해 하나의 저장소에서 빌드된 두 가지 빌드입니다. 자세한 내용은 CHANGELOG.md를 참조하세요.

두 가지 빌드. BApp Store 빌드(./gradlew bappJar)에는 8개의 확장 프로그램 네이티브 MCP 도구, Burp AI 및 6개의 HTTP 백엔드가 포함됩니다. GitHub 전체 빌드(./gradlew fullJar)에는 59개의 MCP 도구, 5개의 CLI 백엔드, 외부 MCP 클라이언트 및 선택적 자동 큐가 포함됩니다. 둘 다 Releases에 있으며 각각 .sha256이 함께 제공됩니다. 한 번에 하나만 로드하세요. 어떤 빌드?에서 둘을 비교합니다.
BApp Store 빌드의 AI 게이트. BApp Store 빌드는 Burp Community 및 Burp Professional에서 실행됩니다. 확장 프로그램에 대해 Burp의 "Use AI" 설정이 활성화된 동안에만 AI 요청을 전송하며, 꺼져 있으면 로드되지만 모든 AI 요청을 거부합니다.
수동 스캔은 대상에 아무것도 전송하지 않습니다. AI Active Scanner가 테스트할 수 있는 수동 발견 항목은 두 빌드 모두에서 큐 대화 상자에 제안된 대상으로 나열되며, 직접 큐에 추가합니다. 확인하기 전에는 대상에 아무것도 전송되지 않습니다.
깔끔한 언로드. 언로드 시 확장 프로그램의 스레드, 타이머 또는 MCP 리스너가 실행 중인 상태로 남지 않으며 AI 제공자에 대한 새 요청도 시작되지 않습니다.
이슈 세부 정보는 HTML 인코딩됩니다. 페이로드, 대상에서 가져온 값 및 AI 텍스트는 Burp의 이슈 보기 및 보고서에서 리터럴 텍스트로 표시됩니다.
AI 스캐너는 두 빌드 모두에서 매번 로드 시 꺼진 상태로 시작됩니다. 하나를 켜면 Burp가 확장 프로그램을 언로드할 때까지 유지됩니다.

v1.0.1의 새로운 기능

1.0.0에 대한 정확성 및 프라이버시 핫픽스입니다. 자세한 내용은 CHANGELOG.md 및 SECURITY.md를 참조하세요.

비ASCII 프롬프트가 모든 HTTP 백엔드에서 작동합니다(#84, #85, #86, #88). 요청 본문이 UTF-8 바이트로 전송됩니다. 이전에는 비ASCII 문자가 손상되었고 대상 텍스트가 요청의 JSON 구조를 변경할 수 있었습니다.
프라이버시: 우클릭 컨텍스트, 스캐너 설정, 감사 로깅 및 채팅 링크가 이제 프라이버시 모드와 해시 전용 감사 기본값을 준수합니다. 채팅 링크는 확인 후에만 열립니다.
스캐너 안전성: 상태를 변경하는 요청은 DANGEROUS에서만 재생됩니다. Burp Scanner AI 검사는 스캔의 리소스 풀과 AI 수동 스위치를 준수합니다.
신뢰성: NVIDIA NIM과 Perplexity가 다시 작동하며, 후속 채팅 메시지가 컨텍스트를 유지하고, 느리거나 바쁜 머신에서도 리댁션이 더 이상 콘텐츠를 누락시키지 않습니다.
번들 라이브러리: Netty 4.1.138, Jackson 2.22.3.

v1.0.0의 새로운 기능

첫 안정 릴리스이자 보안 정확성 이정표입니다. 2026-08-05에 0.9.2에 대한 외부 검토에서 출시된 코드를 실행하여 두 가지 악용 가능한 결함을 확인했으며, 이 릴리스는 두 결함과 함께 동일한 검토에서 드러난 더 광범위한 문제 부류를 수정합니다. 자세한 내용은 CHANGELOG.md를 참조하세요.

수정 및 공개된 사항:

SEC-04 (치명적) — MCP 접근 제어 검사가 확인된 라우트에서 실행되지 않았습니다. 외부 접근이 활성화된 경우 리스너가 인증되지 않은 도구 호출을 수락했습니다. 로컬 모드에서는 일치하는 라우트에서 Origin/Host/User-Agent 검사와 보안 응답 헤더가 무효였습니다. 이제 결정은 라우팅보다 먼저 실행됩니다. → MCP 토큰을 교체하세요
PRIV-05 (높음) — 세션 쿠키가 STRICT 및 BALANCED에서 마스킹되지 않은 채 AI 백엔드에 도달했습니다. 수동 스캐너가 쿠키를 접두사 마스킹의 기준이 되는 접두사 없이 name=value 형태로 내보냈고, 이름이 정확히 session인 쿠키만 포착되었습니다. → 영향받은 쿠키를 교체하세요

강화된 사항:

모델이 생성한 도구 호출에 이제 승인이 필요합니다 (SEC-06) — 모델 출력에서 파싱된 도구 호출은 사용자가 결정하기 전까지 Burp에 도달하지 않습니다. 등급은 안전하게 실패합니다. 인식되지 않는 도구 이름은 매번 확인을 요구하며, 절대 조용히 실행되지 않습니다. 개인정보 및 보안 노트를 참조하세요.
포트 탈취 중 MCP 토큰이 더 이상 노출되지 않습니다 (SEC-07) — MCP 포트를 점유하고 신원 헤더를 에코하는 로컬 프로세스가 이전에는 전체 MCP 도구 접근 권한을 부여하는 토큰을 수집할 수 있었습니다. 이제 탈취 클라이언트는 대신 소유 증명으로서 HMAC 증명을 제시하며, TLS 환경에서는 서버 인증서를 자체 키스토어에 고정합니다.
SsrfGuard가 대체 IP 표기법을 분류합니다 (SEC-07) — http://2852039166/(169.254.169.254의 10진수 표기)이 더 이상 표기법만으로 사설/링크 로컬 경고를 우회하지 않으며, 분류 시 이제 이름 확인을 전혀 수행하지 않습니다.
셸 인자는 허용 목록에 따라 인용됩니다 (QUAL-06) — 공백 없이 메타문자를 포함하는 값(foo;id, $(cmd))에 대한 설정 가져오기에서 명령 실행으로 이어지는 경로를 차단합니다.
EDT 격리 및 스케줄러 견고성 — 도구 실행, 백엔드 HTTP 및 MCP stop()이 Swing 이벤트 디스패치 스레드에서 벗어났으며, 반복 작업은 예외로 인한 종료로부터 보호됩니다.

검증됨: 테스트 스위트가 660개에서 158개 클래스에 걸쳐 1131개 테스트로 증가했고, 프로젝트 라인 커버리지는 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 및 6개 HTTP 백엔드)가 포함되며, 5개 CLI 백엔드는 전체 빌드에만 포함됩니다.
59개 MCP 도구 — Claude Desktop(또는 모든 MCP 클라이언트)이 Burp를 자율적으로 구동할 수 있습니다(스토어 빌드에는 8개의 확장 네이티브 AI 도구, 전체 빌드에는 59개 모두 포함).
범위 지정 MCP 액세스 — 선택적으로 모든 MCP 도구를 범위 내 호스트로 제한하여, 외부 AI 클라이언트가 Burp를 통해 범위 밖 대상에 접근할 수 없도록 합니다.
62개 취약점 클래스 — 인젝션, 인증, 암호화 등에 걸친 수동 및 능동 AI 스캐너. 수동 스캐너는 Burp PassiveScanCheck(Burp Pro)로 실행됩니다.
Releases에서 설치 — Releases에서 두 빌드 중 하나를 다운로드하세요. 어떤 빌드를 선택할까요?에서 두 빌드의 차이를 설명합니다. Custom AI Agent는 아직 BApp Store에 등록되지 않았습니다. BApp Store 빌드는 extension-portal#231에서 PortSwigger의 검토를 진행 중입니다.
테마 인식 UI — 내부 디자인 시스템이 설정 패널의 스타일을 지정하며 Burp의 라이트/다크 전환에 맞춰 자동으로 테마가 변경됩니다.
Burp Scan Skill — 선호하는 AI 코딩 어시스턴트(Claude Code, Gemini CLI, Codex 등)를 MCP를 통해 스캐너로 사용하세요.
도구 호출 확인 — AI가 실행하는 도구 호출은 제어됩니다. 읽기 전용의 범위가 제한된 도구는 조용히 실행되고, 그 외의 모든 도구는 채팅의 승인 카드로 먼저 확인을 요청합니다. 알 수 없는 도구는 안전하게 실패(fail closed)합니다.
3가지 프라이버시 모드 — STRICT / BALANCED / OFF. 민감한 데이터가 Burp를 떠나기 전에 마스킹합니다.
사용자 지정 프롬프트 라이브러리 — 컨텍스트(HTTP 요청 또는 스캐너 이슈)별로 자유 형식 프롬프트를 저장하고, 우클릭 메뉴에서 실행하거나 Custom…을 통해 즉석에서 입력할 수 있습니다.
감사 로깅 — 선택적 JSONL 로그에 레코드별 SHA-256을 기록합니다. 프롬프트, 컨텍스트, 응답은 Verbose 감사가 켜져 있지 않은 한 SHA-256과 길이로 기록되며, 자격 증명은 절대 기록되지 않습니다. 모든 실행에는 재현성을 위해 promptSource / contextKind가 표시됩니다.

빠른 시작

1. 설치

Releases에서 최신 JAR을 다운로드하세요. 각 릴리스에는 Custom-AI-Agent-full-<version>.jar(GitHub 전체 빌드)와 Custom-AI-Agent-bapp-<version>.jar(BApp Store 빌드)가 각각 .sha256과 함께 포함되어 있습니다. 어떤 빌드를 선택할까요?에서 어떤 것을 선택할지 설명합니다. 또는 소스에서 빌드할 수도 있습니다(Java 21):

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에 로드

Burp Suite(Community 또는 Professional)를 엽니다.
Extensions > Installed > Add로 이동합니다.
확장 유형으로 Java를 선택하고 .jar 파일을 선택합니다.

이 확장은 Burp에 Custom AI Agent로 등록되어(Extensions 목록과 Suite 탭에 표시되는 이름) Burp의 기본 제공 Burp AI 제공자와 구별됩니다.

하나의 빌드만 로드하세요. 전체 빌드와 BApp Store 빌드는 모두 Custom AI Agent로 등록되므로 Burp의 Extensions 목록에서 동일하게 보입니다. 둘 다 동시에 로드하면 Custom AI Agent 탭이 두 개 생기고, 두 개의 MCP 서버가 같은 포트를 두고 경쟁하며, 두 개의 복사본이 공유 ~/.burp-ai-agent 디렉터리에 쓰기를 수행합니다. 하나를 로드하기 전에 다른 하나를 언로드하세요.

burp-ai-agent v1.0.0