cskwork/scopeweaver

ScopeWeaver – AI 기반 멀티 에이전트 모의 해킹 플랫폼

소개

• 대규모 언어 모델(LLMs)이 자율적인 보안 테스트 에이전트로 작동할 수 있게 하는 오픈 소스 시스템입니다. Go 백엔드, Next.js 프론트엔드, PostgreSQL 저장소를 결합했습니다.
• ARTEX 프로젝트(업스트림 커밋 160fe13)의 포크로 구축되었으며, 리브랜딩 및 영어, 한국어, 중국어 간체 번역이 적용되었습니다.

주요 기능

• LLM 기반 에이전트: 플래너가 공격 단계를 생성하고 워커가 이를 실행(예: nmap, curl, 커스텀 스크립트 실행)하며, "메인 에이전트"를 통해 사람이 개입할 수 있습니다.
• 2-그래프 데이터 모델: 자산 그래프(대상, 도메인, IP)와 탐색 그래프(발견된 노드, 활동)가 있으며, 에이전트는 LLM이 노출하는 도구를 통해 쿼리할 수 있습니다.
• 승인 워크플로우: 잠재적으로 위험한 작업(예: 익스플로잇 실행)은 "인터셉션 승인" UI 구성 요소에 의해 제어되며, AegisHook 디자인을 재사용합니다.
• 자산 동기화: 동반 서비스인 ScopeSentry에서 직접 범위를 가져올 수 있습니다.
• LLM 공급자 유연성: 구성 가능한 API 키를 통해 Anthropic, OpenAI 및 Z‑AI의 GLM‑5.3을 지원합니다.
• 코딩 에이전트 통합: Claude Code, Codex 또는 Pi가 제공된 어댑터를 통해 작업을 생성하고, 진행 상황을 읽고, 에이전트를 제어할 수 있습니다.
• 실시간 이벤트 스트리밍: 작업은 Server‑Sent Events (SSE) 또는 스트리밍 가능한 HTTP를 통해 진행 상황을 출력하여 실시간 대시보드를 구현합니다.

설치 옵션

방법	기능
원클릭 스크립트 (./install.sh)	Docker를 감지하고, Docker에서 모든 것을 실행하거나 로컬 바이너리를 빌드하며, .env를 생성하고 http://localhost:8787에서 서비스를 시작합니다.
Docker Compose (수동)	이미지를 로컬에서 빌드하고, PostgreSQL 컨테이너를 시작하며, ./skills 및 ./data를 마운트합니다.
사전 빌드된 바이너리 (Releases)	OS용 zip을 다운로드하고 ./start.sh(업데이트를 관리하는 슈퍼바이저)를 실행합니다.
소스에서 빌드	Go 백엔드를 컴파일하고 Next.js 정적 파일을 직접 임베드합니다.
크로스 플랫폼 릴리스 빌더 (./build.sh --release)	Linux, macOS 및 Windows용 독립형 zip 아카이브를 생성합니다.

시스템 실행

1. PostgreSQL 인스턴스에 연결할 수 있는지 확인합니다(기본 DB 이름 artex).
2. LLM API 키(ANTHROPIC_API_KEY 또는 OPENAI_API_KEY)를 환경 변수나 UI를 통해 제공합니다.
3. 웹 UI http://localhost:8787을 엽니다. 첫 방문 시 관리자 비밀번호 설정 과정을 안내합니다.
4. LLM → New 양식을 사용하여 모의 해킹 작업을 생성하고, 모델을 선택한 후 에이전트가 가져온 자산 범위를 탐색하게 합니다.
5. 플래그가 지정된 작업은 Approval records 뷰에서 승인합니다. 결과는 Findings 페이지에 나타납니다.

업데이트

• 앱 내 원클릭 업데이트는 GitHub 릴리스를 확인하고, SHA‑256 체크섬을 검증하며, 바이너리 스모크 테스트를 수행하고 원자적으로 교체합니다. 반복적인 실패 시 자동으로 롤백됩니다.
• CLI 스크립트(./update.sh 또는 Docker‑compose 재빌드)를 통해 수동으로 업데이트할 수 있습니다.

구성 하이라이트

• config.json 또는 ARTEX_PG_DSN 환경 변수를 통한 데이터베이스 연결.
• LLM 공급자 설정(ARTEX_LLM_PROVIDER, ARTEX_LLM_MODEL 등)은 작업별로 재정의할 수 있습니다.
• 동시성(작업당 워커 에이전트 수)은 System settings에서 조정 가능합니다(기본값 3).
• 트래픽 캡처 프록시는 8788 포트에서 실행되며, 에이전트가 MITM 검사를 위해 액세스할 수 있습니다.

개발

• ./dev.sh는 백엔드, 프록시 및 핫 리로드가 포함된 Next.js 개발 서버를 시작합니다.
• 테스트는 go test ./...로 실행합니다.
• 코드베이스는 에이전트, 도구 및 메모리에 대한 norma SDK 규칙을 따릅니다.

라이선스 및 면책 조항

• AGPL‑3.0에 따라 배포됩니다(업스트림 ARTEX와 동일). README는 이 도구가 승인된 보안 테스트 전용이며 오용이 금지되어 있음을 강조합니다.

대상 사용자

• 수동 모의 해킹을 LLM 기반 자동화로 보강하려는 보안 팀.
• 자율적인 공격 체인 생성을 연구하는 연구원.
• Go 언어로 된 LLM 멀티 에이전트 오케스트레이션의 참조 구현을 찾는 개발자.

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 외부 가정은 추가되지 않았습니다.