Awarexone/Agentic-Bug-Hunter

Agentic Bug Hunter – AI 기반 버그 바운티 어시스턴트

무엇인가요 – 대규모 언어 모델의 도움을 받아 리콘 → 취약성 테스트 → 검증 → 보고서 생성에 이르는 완전한 버그 바운티 워크플로우를 실행할 수 있는 명령줄 도구 키트입니다. 독립형 CLI(bughunter)로 사용하거나 Claude Code 플러그인으로 사용할 수 있으며, Ollama, Groq, DeepSeek, Claude, OpenAI 등 다양한 무료 또는 유료 LLM 제공업체와 호환됩니다.

주요 기능

• 리콘 – 서브도메인 열거, 라이브 호스트 탐지, URL 크롤링, nuclei 스캔, 포트 스캔, 클라우드 버킷 탐지 등
• 자동 탐지 – 26가지 일반적인 Web2 취약성 클래스(IDOR, XSS, SSRF, SQLi, 인증 우회 등) 및 10가지 Web3/스마트 계약 취약성 클래스 테스트
• 7단계 검증 게이트 – 보고서 작성에 시간을 들이기 전에 약한 발견을 사전에 제거하는 가벼운 체크리스트
• 보고서 작성기 – HackerOne, Bugcrowd, Intigriti, Immunefi용 제출용 템플릿 생성
• 세션 간 메모리 유지 – 발견 내용, 패턴, 성공한 기법은 ~/.bughunter에 저장되어 후속 타겟에 재사용
• 9개의 전문 AI 에이전트 – 리콘, 검증, 보고서 작성, Web3 감사, 취약점 체인, 오토파일럿, 랭킹, 토큰 감사, 자격 증명 탐지 전용 에이전트
• 플러그인 가능한 LLM 백엔드 – 최적의 무료 제공업체(Ollama 로컬, Groq, DeepSeek 등)를 자동 감지하고 --provider/--model 플래그로 재정의 가능
• 스탠드얼론 모드 – 구독 필요 없음; 한 번 설치 후 어디서나 bughunter 명령어 실행 가능

설치(스탠드얼론)

# 리포지토리 클론
git clone https://github.com/Awarexone/Agentic-Bug-Hunter.git
cd Agentic-Bug-Hunter

# CLI 및 외부 스캐너(subfinder, httpx, nuclei 등) 설치
./install.sh --agent standalone

설치 프로그램은 시스템 전체에 bughunter 명령어를 생성하고 설정을 ~/.bughunter/config.json에 저장합니다. 제거하려면 ./uninstall.sh --agent standalone을 실행하세요(--purge-config를 추가하면 설정 파일도 삭제됨).

일반 워크플로우

# AI 제공업체 선택(Ollama는 무료 및 오프라인)
bughunter setup               # 인터랙티브 또는: bughunter setup --provider ollama --model qwen2.5:14b

# 공격 표면 매핑
bughunter recon example.com

# 취약성 탐지
bughunter hunt example.com

# 발견 항목에 대해 7단계 검증 게이트 실행
bughunter validate "my finding"

# 제출 가능한 보고서 생성
bughunter report

단축어(h, r, v)도 제공됩니다.

AI 통합

• 핵심 LLM 레이어는 brain.py에 있으며, 통일된 API를 통해 여러 제공업체를 지원
• 각 전문 에이전트(recon-agent, validator, report-writer 등)는 ReAct/LangGraph 패턴을 따릅니다: 어떤 도구를 호출할지 결정하고 실행한 후 결과를 다음 추론 단계에 통합
• Claude Code 플러그인으로 사용할 경우, 동일한 에이전트가 슬래시 명령어(/recon, /hunt, /validate, /report, /autopilot)로 노출됨

지원하는 취약성 클래스

• Web2: IDOR/BOLA, 인증 우회, XSS(저장형/DOM), SSRF, 비즈니스 로직, 레이스 컨디션, SQLi, OAuth/OIDC, 파일 업로드 RCE, GraphQL 인증 우회, LLM 프롬프트 인젝션, API 잘못된 설정, 계정 탈취, SSTI, 서브도메인 탈취, 클라우드 노출, 요청 스미졸링, 캐시 포이즌링, MFA/2FA 우회, SAML/SSO 공격, 오류 노출, CSS 인젝션, LFI→RCE, 불안정한 역직렬화, 종속성 혼동, 패딩 오라클 등
• Web3: 회계 비동기화, 접근 제어, 완전하지 않은 코드 경로, 오프바이원, 오라클 조작, ERC4626 쉐어 인플레이션, 재진입, 플래시로론 공격, 서명 재전송, 프록시/업그레이드 문제

프로젝트 구조(개요)

• skills/ – 에이전트가 활용하는 지식 기반(메서드론, 취약성 클래스, 페이로드, 보고서 템플릿 등)
• commands/ – 슬래시 명령어 정의
• agents/ – 9개의 전문 AI 에이전트
• tools/ – 외부 스캐너(subfinder, nuclei, ffuf 등) 및 커스텀 Python/bash 스크립트 래퍼
• memory/ – 세션 간 탐지 메모리를 저장하는 JSONL 파일
• engine.py – 스탠드얼론 CLI의 진입점
• brain.py 및 agent.py – LLM 추상화 및 ReAct 스타일 오케스트레이션
• install.sh, install_tools.sh, uninstall.sh – 툴킷 설치/제거 스크립트

라이선스 – MIT(README의 배지 참조)

누가 사용할까 – 개인 버그 바운티 헌터, 보안 컨설팅 팀, 또는 리콘과 테스트의 반복 작업을 자동화하면서도 검증과 보고서 작성에는 인간이 개입하는 것을 원하는 누구나