Dark-Moon

DarkMoon이란?

DarkMoon은 인공지능(AI) 보안 에이전트를 오케스트레이션하여 완전한 보안 평가를 수행하는 자동화된 침투 테스트 도구입니다. 오픈소스 사이버 보안 도구로 구축된 DarkMoon은 조직이 수동 개입 없이 전문가 수준의 취약점 평가를 실행할 수 있게 해줍니다.

DarkMoon은 침투 테스터를 대체하는 대신 자율 보안 테스트 시스템으로 작동합니다 — 통제된 실행 계층을 통해 실제 공격적 보안 작업을 수행하는 특화된 에이전트를 추론, 계획, 조정합니다.

DarkMoon 작동 영상 — 전체 자율 침투 테스트 데모

왜 DarkMoon인가?

기존의 침투 테스트는:

• ⏱️ 시간 소모적 — 수동 테스트는 몇 주가 걸림
• 💰 비용이 높음 — 전문 컨설턴트는 하루에 수천 달러
• 🔄 일관성 없음 — 결과가 테스터의 숙련도에 따라 달라짐
• 📊 확장이 어려움 — 인적 자원에 제한됨

DarkMoon은 AI 기반 침투 테스트로 이를 해결합니다:

• 🤖 AI 기반 침투 테스트 — 자율 에이전트가 보안 평가 전체를 처음부터 끝까지 수행
• 🛡️ 보안 설계(security by design) — AI는 도구를 직접 실행하지 않으며, 모든 작업은 통제된 MCP 인터페이스를 통해 흐름
• 🕶️ 프라이버시 게이트웨이(로컬 가역 토큰화) — AI는 실제 민감 값을 절대 볼 수 없습니다. IP, 호스트 이름, 도메인, URL, 이메일, 자격 증명 및 내부 경로는 결정적(deterministic) 플레이스홀더(IP_PRIVATE_001, …)로 대체되며, 실제 값은 도구가 실행되기 직전에 로컬에서 주입되고 모든 결과에서 다시 마스킹됩니다. 어떤 민감 데이터도 경계 밖의 LLM 제공자에게 유출되지 않습니다 — 엄격한 데이터 주권 제약 하에서 Claude의 성능을 활용하세요. 데이터 유출 시도는 차단됩니다.
• ♾️ CI/CD를 위한 침투 테스트 자동화 — 빌드 후 자동화된 보안 테스트를 실행하여 프로덕션 배포 전에 치명적인 취약점을 발견
• 🔧 50개 이상의 통합 도구 — 포괄적인 침투 테스트 도구 모음(Nuclei, NetExec, BloodHound, sqlmap, Naabu, httpx, ffuf 등)
• 📈 적응형 멀티 에이전트 방법론 — 웹, Active Directory, Kubernetes, 네트워크, CMS 등을 위한 특화 에이전트
• 📝 취약점 보고 자동화 — 구조화된 증거 기반 보고서를 자동 생성

보안 팀, DevSecOps 엔지니어, 윤리적 해킹 전문가 및 모든 규모의 조직에 적합합니다.

빠른 시작

사전 요구 사항

• Docker 및 Docker Compose
• LLM API 키(OpenRouter, Anthropic, OpenAI 또는 로컬 모델)

참고: GPU 구성, NVIDIA 드라이버 문제 해결 및 고급 환경 설정은 전체 문서 — GPU 문제 해결에서 다룹니다.

설치

1. 저장소 클론

git clone https://github.com/ASCIT31/Dark-Moon.git
cd Dark-Moon

2. LLM 제공자 구성

install.sh는 제공자 구성을 대화형으로 처리합니다 — docker-compose.yml을 편집할 필요가 없습니다:

./install.sh           # skip form if .opencode.env already configured
./install.sh --init    # force reconfiguration (cloud or local model)
./install.sh --help    # show usage

클라우드 제공자(Anthropic, OpenAI, OpenRouter…) 및 로컬 모델(Ollama, llama.cpp)을 지원합니다.

참고: 환경 변수 및 로컬 모델 설정에 대한 자세한 내용은 전체 문서 — 환경 변수를 참조하세요.

3. 빌드 및 실행

./install.sh  # Clean install with full stack reset

4. 첫 번째 평가 실행

./darkmoon.sh "TARGET: example.com"

5. 실시간 모니터링

./darkmoon.sh --log <session_id>

참고: 실시간 세션 로그에는 MCP 서버가 실행한 모든 명령이 표시됩니다. 자세한 내용은 전체 문서 — 세션 로그를 참조하세요.

작동 방식

DarkMoon은 ISO 27001, NIST SP 800-115 및 MITRE ATT&CK 방법론에 부합하는 전략적 AI 보안 에이전트 오케스트레이터로 작동합니다.

대상을 지정하면 플랫폼이 자동으로 다음을 수행합니다:

1. 🔍 대상 환경을 발견합니다(포트, 서비스, 프로토콜)
2. 🧠 기술 스택을 핑거프린팅합니다(프레임워크, CMS, API)
3. 🎯 공격 표면을 모델링합니다
4. 🚀 탐지된 기술에 따라 특화된 하위 에이전트를 배포합니다
5. 🔬 반응형 적응을 통해 지능형 취약점 스캐닝 루프를 실행합니다
6. ✅ 증거(요청, 페이로드, 응답)로 결과를 검증합니다
7. 📝 구조화된 감사 보고서를 생성합니다

하위 에이전트 오케스트레이션

DarkMoon은 탐지된 기술에 따라 특화된 에이전트를 동적으로 선택하여 파견합니다:

여러 에이전트는 하이브리드 아키텍처 전반에서 병렬로 실행될 수 있습니다.

참고: 전체 에이전트 목록, 구조, 수명 주기 및 사용자 지정 에이전트 생성 방법은 전체 문서 — AI 에이전트를 참조하세요.

아키텍처 개요

User ──> DarkmoonCLI ──> OpenCode (AI Brain) ──> MCP (Security Gatekeeper) ──> Docker Toolbox (Real Tools)

sequenceDiagram
  participant U as User
  participant O as OpenCode
  participant A as AI Agent
  participant M as MCP Darkmoon
  participant T as Docker Toolbox

  U->>O: User prompt
  O->>A: Delegate task
  A->>M: MCP function call
  M->>T: Execute real tool
  T-->>M: Results
  M-->>A: Structured output
  A-->>O: Next decision
  O-->>U: Summary / result

AI는 추론하고 계획을 세웁니다. MCP는 실행할 수 있는 작업을 통제합니다. 도구 상자는 Docker 내부에서 격리된 도구를 실행합니다. AI는 시스템에 절대 직접 접촉하지 않습니다 — 이것이 보안 설계(security by design) 입니다.

참고: 전체 아키텍처 분석(배포 다이어그램, 네트워크 흐름, 보안 경계)은 전체 문서 — 아키텍처를 참조하세요.

범위 정의

DarkMoon은 명령줄에서 직접 유연한 범위 정의를 지원합니다.

빠른 침투 테스트(설정 없음):

./darkmoon.sh "TARGET: http://172.19.0.3:3000"

버그 바운티 모드(플래그 자동 활성화):

./darkmoon.sh "TARGET: http://172.19.0.3:3000 PROGRAM=\"Juice Shop\" FOCUS=sqli,xss,idor NOISE=moderate FORMAT=h1"

주요 플래그로는 FOCUS, EXCLUDE, CREDS, TOKEN, NOISE, SEVERITY, FORMAT 등이 있으며, AI가 이를 모두 자연스럽게 해석합니다.

참고: 전체 플래그 참조, 자산 유형, EXCLUDE/FOCUS 자유 형식 구문 및 고급 다중 대상 범위 지정은 전체 문서 — 범위 정의를 참조하세요.

통합 도구 상자

DarkMoon에는 멀티 스테이지 빌드로 컴파일되고 최적화된 50개 이상의 보안 도구가 포함된 전용 Docker 이미지가 함께 제공됩니다:

모든 도구는 경로 구성 없이 직접 사용할 수 있습니다.

참고: 설치 세부 정보와 새 도구 추가 방법을 포함한 전체 도구 목록은 전체 문서 — 도구 상자를 참조하세요.

📖 문서 가이드

DarkMoon의 전체 문서는 플랫폼 운영에 필요한 모든 것을 다룹니다. 가장 중요한 섹션에 대한 빠른 참조는 다음과 같습니다:

사용 사례

DarkMoon은 다음과 같은 용도를 위한 다목적 보안 테스트 플랫폼으로 설계되었습니다:

• 🔒 보안 팀 — 인프라 전반에 걸쳐 지속적인 자동화된 침투 테스트 실행
• ⚙️ DevSecOps 파이프라인 — AI 기반 보안 연구를 CI/CD 워크플로에 통합
• 🎯 버그 바운티 헌터 — 자율 대상 분석으로 윤리적 해킹 가속화
• 🔬 보안 연구원 — 실시간으로 적응하는 AI 사이버 보안 플랫폼으로 공격 표면 탐색
• 🎓 훈련 및 교육 — 안내되는 재현 가능한 평가를 통해 공격 보안 학습

예시 프롬프트

# Web application pentest
./darkmoon.sh "TARGET: http://172.19.0.3:3000"

# Active Directory assessment
./darkmoon.sh "TARGET: 192.168.1.10"

# Bug bounty with specific focus
./darkmoon.sh "TARGET: https://app.example.com PROGRAM=\"Example BB\" FOCUS=sqli,rce,ssrf EXCLUDE=H1 FORMAT=h1"

참고: DVGA, Juice Shop 및 헤드리스 브라우저 시나리오를 포함한 더 많은 프롬프트 예시는 전체 문서 — 프롬프트 예시를 참조하세요.

기여하기

DarkMoon은 오픈소스이며 기여를 환영합니다. 새 에이전트를 추가하거나, 도구를 통합하거나, 워크플로를 만들거나, 문서를 개선하려면 CONTRIBUTING.md의 지침을 참조하세요.

라이선스

이 프로젝트는 GNU General Public License v3.0에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE를 참조하세요.