웹, API, LLM 애플리케이션 보안을 위한 로컬 우선 AI 레드팀. 공격자 스타일 추론, 증거 기반 발견, AI 코딩 에이전트를 위한 스킬.
당신의 로컬 AI 레드 팀.
웹, API, LLM 애플리케이션 보안을 위한 공격자 관점의 추론.
프로젝트 웹사이트 · 빠른 시작 · 에이전트 스킬 · 평가 모델 · 아키텍처 · 문서 · 스타 기록
OpenHunterAI는 범위, 스캔 활동, 발견 사항, 그리고 수정 조치를 하나의 로컬 워크스페이스로 통합합니다. 계정 없이 시작하고, 모델 제공자를 연결한 뒤, 소유하거나 테스트 권한이 있는 검증된 공개 애플리케이션을 평가하세요.
공개 랜딩 페이지에서 프로젝트를 소개하며, 운영 워크스페이스는 로컬에서 실행됩니다. 공개 빌드와 로컬 빌드를 참고하세요.
| 기능 | 제공 내용 |
|---|---|
| 로컬 워크스페이스 | 가입 불필요; 프로젝트와 스캔 기록이 로컬 데이터베이스에 저장됨 |
| 명시적 범위 | 도메인 검증, 결정론적 계획, 사람 승인 게이트 |
| 다양한 신호 소스 | 브라우저 검사, 정찰, ZAP, 그리고 Nuclei 어댑터 |
| AI 지원 조사 | OpenHack/Strix 어댑터 경계; 자체 런타임 사용 |
| 증거 및 수정 조치 | 정제된 발견 사항, 커버리지 격차, 수정 가이드, 수동 재테스트 |
| 이식 가능한 워크플로 | Codex, Claude Code, Gemini CLI, Grok Build, OMP를 위한 스킬 |
알파. 통합 커버리지는 구성된 런타임에 따라 달라집니다. 워크스페이스가 정상이거나 보고서가 비어 있다고 해서 대상이 안전하다는 것이 증명되지는 않습니다.
OpenHunterAI는 48bf9036 기술 요구사항의 유용한 핵심을 유지합니다: 공격자의 관점에서 외부에서 관찰 가능한 동작을 평가합니다. 소스 코드는 필요하지 않습니다. 모든 실행은 검증된 공개 대상과 승인된 범위로 제한됩니다.
flowchart LR
S["1. Lock scope"] --> M["2. Map surface"]
M --> B["3. Establish baseline"]
B --> H["4. Test bounded hypotheses"]
H --> E["5. Gate evidence"]
E --> R["6. Report and retest"]
| 단계 | 출력 | 제어 |
|---|---|---|
| 범위 고정 | 검증된 호스트, 승인된 경로, 스캔 계획 | 작업 시작 전 승인 |
| 표면 매핑 | 브라우저 및 정찰 신호 | 공개된 범위 내 표면만 |
| 기준선 | 정상 응답 및 커버리지 컨텍스트 | 제한된 워커 및 어댑터 정책 |
| 가설 검증 | 후보 보안 신호 | 파괴적 행위 금지, 민감한 검증은 승인 필요 |
| 증거 게이트 | 정제되고 재현 가능한 발견 사항 | 관찰된 신호와 분석가 판단 분리 |
| 보고 및 재테스트 | 수정 지침, 한계, 수동 확인 | 영향 결정과 종료는 사람이 담당 |
OpenAPI/Swagger 설명, Postman 예제, 정제된 HTTP 캡처, 전용 테스트 계정은 합의된 테스트 표면을 정의하는 데 도움이 될 수 있습니다. 원시 민감 트래픽의 자동 가져오기 또는 보존은 보장된 기능이 아닙니다.
Git, Node.js 22+, Docker(Compose v2 포함) 가 필요합니다.
git clone https://github.com/LumosLab-Innovation/OpenHunterAI.git
cd OpenHunterAI
node ops/local.mjs start
**localhost:3001**을 엽니다. 최초 시작 시 이미지가 빌드되고, 데이터베이스 마이그레이션이 적용되며, 생성된 시크릿이 포함된 비공개 .env.local이 생성됩니다.
.env.local에 프로바이더 키와 모델 ID를 설정한 후 node ops/local.mjs restart를 실행합니다.| 명령 | 용도 |
|---|---|
node ops/local.mjs status | 서비스 상태 확인 |
node ops/local.mjs logs public-api | API 오류 진단 |
node ops/local.mjs stop | 중지; 데이터베이스 볼륨 유지 |
포함됨: 브라우저 검사, ZAP, 정찰(recon), Nuclei 어댑터.
별도 준비: OpenHack 및 Strix 런타임.
선택적 대화형 target-login 캡처: node ops/local.mjs start --with-browser.
스캔하기 전에 Nuclei 템플릿 정책 차단 항목을 해결하십시오. 어댑터는 패키징되어 있지만, 검토된 템플릿 번들은 아직 제공되지 않습니다.
로컬이란 워크스페이스가 사용자의 머신에서 실행된다는 의미이며, localhost/사설 네트워크를 스캔할 권한을 뜻하는 것이 아닙니다. 포트는 루프백에 유지하십시오. 설정, 모델 구성 및 문제 해결 →
에이전트가 평가하기를 원하는 애플리케이션 저장소에서 실행하십시오:
npx --yes skills add LumosLab-Innovation/OpenHunterAI --skill openhunter --agent codex claude-code gemini-cli grok --yes
코딩 에이전트를 다시 로드한 다음, 다음과 같이 요청하세요:
OpenHunter를 사용하여 내 워크스페이스를 확인하고 범위가 지정된 보안 평가를 준비해 줘. 스캔을 시작하기 전에 내 승인을 기다려 줘.
OMP는 Agents provider를 통해 공유된 .agents/skills 설치를 발견합니다. 이 스킬에는 읽기 전용 API 헬퍼가 포함되어 있으며, 설치는 스캔을 시작하지 않습니다. 클라이언트 호환성 →
flowchart LR
UI["Local workspace<br/>React + Vite"] --> API["Public API<br/>Scope + scan plan"]
API --> BUS["NATS<br/>Orchestrator + workers"]
BUS --> EVIDENCE["Internal API<br/>Findings + reporting"]
EVIDENCE --> DB[("Postgres")]
API <--> DB
API -->|"Activity + reports"| UI
공개 API가 계획을 수립하고, Go 워커가 제한된 어댑터를 통해 이를 실행합니다. 시그널은 보고서에 들어가기 전에 파인딩 정책을 통과합니다. 보고는 별도의 스캔 워커가 아닌 백엔드 서비스입니다.
런타임 및 데이터 흐름 · 워커 매핑 · 통합 설정
| 여기서 시작하세요 | 더 깊이 알아보기 |
|---|---|
| 로컬 설정 | 아키텍처 및 데이터 모델 |
| 제품 개요 | 제품 요구사항 |
| 에이전트 워크플로 | LLM 라우팅 |
| 보안 가드레일 | 승인 및 릴리스 게이트 |
버그 신고, 개선 사항 제안, 또는 문서 명확화에 도움을 주세요. 먼저 기여 규칙을 읽어 주세요. 취약점은 자격 증명이나 원본 대상 데이터 없이 비공개로 공개해 주세요.
PolyForm Noncommercial 1.0.0에 따라 소스 공개 방식으로 제공됩니다. 상업적 라이선싱: LICENSING.md. 업스트림 도구 및 출처 표기는 자체 고지를 유지합니다.