jiwoochris/artex-global

ARTEX – 글로벌 에디션

개요 – 대규모 언어 모델(LLM) 에이전트가 정찰부터 데이터 유출까지 전체 보안 평가를 실행할 수 있는 오픈소스 자율 침투 테스트 플랫폼입니다. 시스템은 단일 Go 바이너리로 구축되어 Next.js 웹 UI를 포함하고 모든 결과를 PostgreSQL에 저장합니다.

주요 기능

• LLM 기반 다중 에이전트 워크플로우 – 플래너가 테스트 목표를 하위 작업으로 분해하고, 여러 워커 에이전트가 실제 도구(nmap, curl 등)를 실행하며, 리포터가 결과를 자산 및 취약점 그래프로 집계합니다.
• 인간 개입 채팅 – 운영자는 실행 중에 개입하거나 힌트를 제공하거나 요약을 요청할 수 있습니다.
• 다국어 출력 – 사용자 대상 결과, 보고서, 채팅 응답은 영어, 한국어, 중국어 또는 스페인어로 표시할 수 있습니다. 내부 추론 프롬프트는 모델 성능을 유지하기 위해 원래 언어로 유지됩니다.
• 구성 가능한 LLM 백엔드 – Anthropic, OpenAI 또는 OpenAI 호환 엔드포인트와 작동합니다. 모델 및 토큰 제한은 UI 또는 환경 변수를 통해 조정할 수 있습니다.
• 내장 도구 – Docker 이미지에는 일반적인 보안 유틸리티(nmap, ripgrep, curl 등)와 모든 명령 출력을 캡처하여 나중에 강화할 수 있는 트래픽 기록 MITM 프록시가 포함되어 있습니다.
• 방어 리소스 – 저장소에는 서명, 강화 체크리스트, 자율 AI 공격 탐지 권장 사항이 포함된 "방어 및 탐지 가이드"가 포함되어 있습니다.

아키텍처 개요

프론트엔드(Next.js) ←임베디드→ Go 서버 ←→ PostgreSQL
   │                         │                │
   └─ REST API + SSE        └─ 엔진(플래너 + N 워커)
                              │
                              └─ norma SDK 에이전트(목표 분해, 실행)

• UI는 작업, 자산, 커버리지 그래프 및 활동 스트림을 시각화합니다.
• 엔진은 플래너 루프와 워커 고루틴을 스케줄링하고 모든 데이터를 두 그래프에 저장합니다: 자산 그래프(대상, 발견된 서비스) 및 탐색 그래프(수행된 단계, 도구 출력).
• 지원 하위 시스템은 트래픽 프록시, 도구 승인 보호, DNS/HTTP 강화 및 확장 가능한 "스킬" 모듈을 처리합니다.

시작하기

1. 저장소를 클론하고 .env.example을 .env로 복사합니다.
2. PostgreSQL 비밀번호를 제공하고 선택적으로 Anthropic 또는 OpenAI API 키를 제공합니다.
3. docker compose up -d를 실행합니다 – artex 컨테이너와 PostgreSQL 인스턴스가 시작됩니다.
4. http://localhost:8787을 열고 표시된 설정 토큰을 사용하여 일회성 관리자 설정을 완료한 후 작업 생성을 시작합니다.

대체 설치 – 설치 스크립트, 사전 컴파일된 바이너리 또는 수동 go build -tags embedui도 작동합니다.

안전 공지 – 이 도구는 의도적으로 강력합니다. 실제 익스플로잇을 수행할 수 있습니다. 저장소에는 눈에 띄는 오용 경고가 포함되어 있으며 AGPL‑3.0 라이선스로 배포되고 승인된 테스트만 허용하는 추가 사용 제한 조항이 포함됩니다. 저자는 이 소프트웨어가 방어자가 자율 AI 공격을 이해하고 탐지하기 위한 것임을 강조합니다.

기술 스택

• 백엔드: Go(net/http, go:embed) 및 LLM 에이전트용 norma SDK.
• 프론트엔드: Next.js(정적 빌드)를 바이너리에 번들.
• 데이터베이스: PostgreSQL.
• 컨테이너화: Docker + Docker‑Compose.
• LLM 통합: Anthropic 또는 OpenAI 호환 API(환경 변수 또는 UI로 구성 가능).
• 번들 도구: nmap, curl, ripgrep, vim, npm 및 사용자 정의 "스킬" 스크립트.

라이선스 – AGPL‑3.0 및 승인된 환경에서만 사용을 제한하고 악의적 악용을 금지하는 추가 면책 조항.

---

이 요약은 저장소의 README에만 기반합니다. 외부 정보는 추가되지 않았습니다.