ascit31/dark-moon자율 AI 침투 테스트 엔진 — 웹, 클라우드, AD 및 Kubernetes 전반에 걸친 지속적인 공격적 보안. 에이전트 기반 추론 + 실제 익스플로잇 실행으로 증거 기반 취약점을 제공합니다. 프라이버시 게이트웨이: LLM은 실제 IP, 호스트, 자격 증명 또는 경로를 절대 볼 수 없으며(결정적 플레이스홀더는 로컬에서 복원됨), 어떤 정보도 경계 밖으로 유출되지 않습니다.
<div align="center"> <a href="https://github.com/ASCIT31/Dark-Moon"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/hero.png" alt="DarkMoon — 로컬 모델 기반 자율 AI 침투 테스트" width="100%" /> </a> # DarkMoon ### 오픈소스 자율 AI 침투 테스트 — 자체 인프라의 모든 취약점을 찾아내고 익스플로잇하며 검증합니다 <p> <a href="https://github.com/ASCIT31/Dark-Moon"><img src="https://img.shields.io/github/stars/ASCIT31/Dark-Moon?style=for-the-badge&logo=github&label=Star&color=2667FF&labelColor=0A2472" alt="GitHub stars"></a> <a href="https://github.com/ASCIT31/Dark-Moon/releases"><img src="https://img.shields.io/github/v/release/ASCIT31/Dark-Moon?style=for-the-badge&label=Release&color=2667FF&labelColor=0A2472" alt="Latest release"></a> <a href="https://www.gnu.org/licenses/gpl-3.0"><img src="https://img.shields.io/badge/License-GPLv3-2667FF?style=for-the-badge&labelColor=0A2472" alt="License GPLv3"></a> <a href="#quick-start"><img src="https://img.shields.io/badge/Runs%20on-Local%20LLM-87BFFF?style=for-the-badge&labelColor=0A2472" alt="Made with local LLM"></a> <a href="https://github.com/ASCIT31/Dark-Moon"><img src="https://img.shields.io/badge/Autonomous%20AI-Pentesting-DCEAF4?style=for-the-badge&labelColor=0A2472" alt="Autonomous AI pentesting"></a> </p> [**⭐ Star DarkMoon**](https://github.com/ASCIT31/Dark-Moon) · [**🚀 Quick Start**](#quick-start) · [**🧩 Integrations**](#-darkmoon-everywhere) · [**📊 Benchmark**](#-benchmark-57-real-vulnerabilities-on-owasp-juice-shop) · [**🔒 Darkmoon Pro**](#-darkmoon-pro--paid-edition-web-dashboard-and-automated-remediation) · [**▶️ Install & Run (OSS)**](https://youtu.be/3Qv1luvW99E) · [**▶️ Demo (Pro)**](https://youtu.be/zQE95bVLZgM) </div> **DarkMoon은 자체 인프라를 위한 자율 AI 침투 테스트입니다.** 권한이 부여된 대상에 지정하면 전체 평가를 스스로 수행한 뒤, 모든 발견 사항을 정확한 명령과 원시 출력과 함께 문서화합니다. - 🟢 **진정한 오픈 소스.** GPLv3 및 자체 호스팅 방식이며, 모든 에이전트의 방법론은 읽고, diff하고, 포크할 수 있는 평범한 Markdown입니다. - 🎯 **찾아내고 증명합니다.** 각 취약점은 정확한 명령과 원시 출력과 함께 제공되므로(익스플로잇은 에이전트가 주장하는 방식이며, Pro의 재검증 절차가 기계적으로 검증되는 단계입니다) 분류할 것이 거의 없습니다. - 🔒 **로컬 LLM + Privacy Gateway에서 실행됩니다.** 게이트웨이가 실제 IP, 호스트, 자격 증명을 로컬에서 토큰화하므로, 모델은 플레이스홀더를 기반으로 추론하고 실제 값은 사용자의 경계 내에 남습니다. - 🧩 **어디서든 빌드할 수 있습니다.** GitHub, GitLab, Jenkins, VS Code, JetBrains, n8n, Grafana 또는 Splunk에서 실행할 수 있으며, 오픈소스 에디션은 CLI 기반 환경에서 작동합니다. [통합 보기 ↓](#-darkmoon-everywhere) --- <div align="center"> ## 오픈 소스 엔진(CLI) 살펴보기 오픈 소스 Darkmoon은 명령줄 도구입니다. 저장소를 클론하면 이것을 얻을 수 있습니다. 명령줄에서 평가를 시작하고 모든 에이전트, 명령, 발견 사항이 실시간으로 스트리밍되는 것을 지켜봅니다. </div> <table> <tr> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/start-assesment.png" alt="단일 TARGET 줄로 명령줄에서 DarkMoon 평가를 시작하는 모습" /> <p align="center"><b>CLI에서 실행을 시작하세요.</b> <code>TARGET</code> 한 줄이면 DarkMoon이 전체 평가를 맡습니다.</p> </td> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/sub-agent-1.png" alt="터미널에서 CVE-2019-9978을 탐지하고 곧바로 익스플로잇으로 넘어가는 DarkMoon 서브 에이전트 상태 머신" /> <p align="center"><b>자율 에이전트가 터미널에서 실시간으로 추론하고 익스플로잇합니다.</b> 여기서는 서브 에이전트가 CVE-2019-9978을 표시하고 곧바로 익스플로잇으로 전환합니다.</p> </td> </tr> <tr> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/enumeration.png" alt="터미널에 출력된 DarkMoon 정찰 및 환경 모델 요약" /> <p align="center"><b>정찰 및 환경 모델.</b> DarkMoon은 공격 전에 스택을 핑거프린팅하고 공격 표면을 확인합니다.</p> </td> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/log.png" alt="타임스탬프가 찍힌 명령과 원시 응답이 포함된 터미널의 실시간 MCP 출력 스트림" /> <p align="center"><b>실시간 MCP 스트림.</b> 에이전트가 실행하는 모든 명령과 그 원시 출력을 <code>./darkmoon.sh --log <session></code>으로 타임스탬프와 함께 확인합니다.</p> </td> </tr> </table> <div align="center"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/matrix.png" alt="탐지된 기술을 DarkMoon이 파견하는 에이전트에 매핑하는 터미널의 신호 탐지 매트릭스" width="80%" /> <p><b>신호에서 에이전트 파견까지.</b> DarkMoon은 대상에서 탐지한 바로 그 내용을 바탕으로 어떤 전문 에이전트를 배치할지 결정합니다.</p> **소개된 매체** [Help Net Security](https://www.helpnetsecurity.com/2026/06/29/darkmoon-open-source-ai-pentesting-platform/) · [Cyber Security News](https://cybersecuritynews.com/darkmoon-penetration-testing-platform/) · [DevOps.com](https://devops.com/why-ci-cd-security-testing-is-going-autonomous-and-why-it-should-stay-local/) · [SecurityBrief](https://securitybrief.co.uk/story/asc-it-launches-darkmoon-for-private-ai-pentesting) · [LinuxLinks](https://www.linuxlinks.com/darkmoon-ai-powered-autonomous-penetration-testing-platform/) · [IT Brief](https://itbrief.co.uk/story/asc-it-launches-darkmoon-for-private-ai-pentesting) · [ChannelLife](https://channellife.co.uk/story/asc-it-launches-darkmoon-for-private-ai-pentesting) </div> --- ## Quick Start ```bash git clone https://github.com/ASCIT31/Dark-Moon.git cd Dark-Moon ./install.sh ``` `install.sh`는 LLM 제공자를 대화식으로 구성하고(`docker-compose.yml`을 편집할 필요 없음) 전체 스택을 빌드합니다: ```bash ./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)을 지원합니다. 그런 다음 첫 번째 평가를 실행하고 실시간으로 지켜보세요: ```bash ./darkmoon.sh "TARGET: example.com" ./darkmoon.sh --log <session_id> ``` **사전 요구 사항:** Docker 및 Docker Compose, 그리고 LLM API 키(또는 로컬 모델). GPU 설정, 환경 변수 및 전체 플래그 참조는 [전체 문서](https://github.com/ascit31/dark-moon/blob/master/docs/full.md)에 있습니다. --- ## 기능 그리드 | | | |---|---| | 🧠 **50개의 전문 에이전트** | 하나의 에이전트 시스템이 발견한 모든 표면에서 추론하고 계획하며 전문 에이전트를 파견합니다. | | 🌐 **모든 표면** | 웹, API, Active Directory, Kubernetes, 클라우드(AWS, Azure, GCP), CI/CD, 데이터베이스, IoT 펌웨어 및 AI/LLM 엔드포인트를 엔드 투 엔드로 연결합니다. | | 🔒 **프라이버시 게이트웨이** | 되돌릴 수 있는 로컬 토큰화가 실제 IP, 호스트, URL 및 자격 증명을 결정적 플레이스홀더로 변환하고, 도구가 실행되는 순간에만 로컬에서 복원합니다. | | 🏠 **로컬 모델** | 로컬 LLM(Ollama, llama.cpp)에서 전체 평가를 실행하여 인프라 값을 자체 경계 내에 유지합니다. | | 🧾 **점수가 아닌 증거** | 모든 발견 사항에는 정확한 명령과 원시 출력이 함께 제공되며, Pro 재테스트는 익스플로잇을 다시 실행하여 수정을 확인합니다. | | 🛡️ **설계 단계부터 보안** | AI는 명령을 직접 실행하지 않으며, 모든 작업은 통제되고 기록되는 MCP 인터페이스를 통해 흐릅니다. | | 🤖 **AI도 펜테스트** | 전용 LLM 에이전트가 garak 기반 프로브로 OWASP LLM Top 10에 대해 AI/LLM 추론 엔드포인트를 조사합니다. | | ♾️ **CI/CD 네이티브** | 파이프라인에서 펜테스트를 트리거하고 발견 사항을 아티팩트로 받아보세요. | | 🔌 **MCP** | MCP를 통해 140개 이상의 공격 도구를 오케스트레이션합니다. | | 🔧 **수정하기 (Pro)** | 유료 Pro 티어는 발견 사항을 사람이 검토하는 풀 리퀘스트로 전환하고, 원래 익스플로잇에 대해 재테스트합니다. | **보안 팀**, **DevSecOps 엔지니어**, **레드 팀원** 및 **윤리적 해킹** 전문가를 위해 만들어졌습니다. --- ## 🧩 어디에나 있는 DarkMoon <p align="center"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/integrations.svg" alt="DarkMoon integrations: GitHub, GitLab, Jenkins, VS Code, JetBrains, n8n, Grafana, Splunk — OSS + Pro" width="100%" /> </p> 이미 구축한 곳에서 DarkMoon을 실행하세요 — CI/CD, IDE, 자동화 및 SecOps에서. **OSS + Pro**로 표시된 통합은 오픈 소스 에디션(로컬 CLI + JSON)에서 작동하며, Pro 전용 통합은 [DarkMoon Pro](#-darkmoon-pro--paid-edition-web-dashboard-and-automated-remediation) REST API(라이브 대시보드, 리메디에이션→PR)를 사용합니다. | 플랫폼 | 기능 | 받기 | 에디션 | 튜토리얼 | |---|---|---|---|---| | **GitHub Actions** | 심각도별 발견 사항으로 파이프라인 실패 처리 | [GitHub Marketplace](https://github.com/marketplace/actions/darkmoon-pentest) | OSS + Pro | [▶ 시청](https://youtu.be/e67klNk79vg) | | **GitLab CI/CD** | 발견 사항을 Code Quality + SAST 보고서로 제공 | [CI/CD Catalog](https://gitlab.com/explore/catalog/Dark-Moon-X/darkmoon-scan) | OSS + Pro | [▶ 시청](https://youtu.be/ui7NHD41cMM) | | **Jenkins** | 발견 사항을 빌드의 Warnings-NG 이슈로 제공 | [플러그인 `.hpi` (Releases)](https://github.com/ASCIT31/darkmoon-jenkins/releases) | OSS + Pro | [▶ 시청](https://youtu.be/G0TgyGpVLZ8) | | **VS Code** | 에디터에서 평가를 탐색하고 실행 | [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Darkmoon.darkmoon-vscode) | OSS + Pro | [▶ 시청](https://youtu.be/GY7YOnYpteQ) | | **JetBrains** | IDE 도구 창에서 발견 사항 확인 | [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/34497-darkmoon) | OSS + Pro | [▶ 시청](https://youtu.be/obUUrbTN3Jg) | | **n8n** | 캠페인, 재테스트 및 알림 자동화 | [npm `n8n-nodes-darkmoon`](https://www.npmjs.com/package/n8n-nodes-darkmoon) | Pro | [▶ 시청](https://youtu.be/3htg8kh7Dr8) | | **Grafana** | 보안 태세 대시보드 | [셀프 호스팅 (Releases)](https://github.com/ASCIT31/darkmoon-grafana/releases) | Pro | [▶ 시청](https://youtu.be/L7K-y0HPudk) | | **Splunk** | SOC 수집(HEC) + "Send to Darkmoon" 알림 액션 | [앱 (Releases)](https://github.com/ASCIT31/darkmoon-splunk/releases) — Splunkbase 대기 중 | OSS + Pro | [▶ 시청](https://youtu.be/8w2i8nEBdQQ) | | **SDK / CLI** | 공유 계약 위에 자체 통합 구축 | [npm `@darkmoon_ai/client`](https://www.npmjs.com/package/@darkmoon_ai/client) | OSS + Pro | [▶ 시청](https://youtu.be/jMIMvV8yEK8) | 모든 통합은 **안전한 메타데이터만**(심각도, 상태, MITRE, ID) 내보내며 — 증거, 비밀 또는 토큰은 절대 내보내지 않습니다. 전체 가이드는 [docs.dark-moon.org](https://docs.dark-moon.org)에서, 소스는 [ASCIT31](https://github.com/ASCIT31)에서 확인하세요. --- ## 🔒 Darkmoon Pro — 유료 에디션: 웹 대시보드 및 자동화된 리메디에이션 > 🔒 **이것들은 Darkmoon Pro 기능(유료)입니다.** 오픈 소스 에디션은 위에 표시된 CLI이며, 웹 대시보드와 풀 리퀘스트로의 자동화된 리메디에이션은 오픈 소스 빌드에 포함되어 있지 않습니다. 아래 스크린샷은 **유료 Darkmoon Pro** 웹 대시보드입니다. 이는 클론하는 오픈 소스 저장소의 일부가 **아닙니다**. 오픈 소스 에디션은 위 섹션에 표시된 명령줄 도구입니다. <table> <tr> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/dashboard.png" alt="Darkmoon Pro web dashboard showing projects, targets, campaigns and vulnerabilities by severity" /> <p align="center"><b>Pro: 라이브 웹 대시보드.</b> 프로젝트, 대상 및 캠페인을 한눈에 확인하고, 모든 발견 사항을 심각도별로 분류합니다.</p> </td> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/vulnerability-1.png" alt="Darkmoon Pro finding detail with CVSS, MITRE ATT&CK and ISO 27001 mapping and EXPLOITED status" /> <p align="center"><b>Pro: CVSS 및 ATT&CK 매핑이 포함된 발견 사항.</b> 각 발견 사항에는 CVSS, MITRE ATT&CK 및 ISO 27001 매핑이 포함되며, 실제 익스플로잇으로 뒷받침되는 <code>EXPLOITED</code> 상태가 표시됩니다.</p> </td> </tr> <tr> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/markdown-report-1.png" alt="Darkmoon Pro structured web report with management summary, exportable to Markdown and PDF" /> <p align="center"><b>Pro: 내보낼 수 있는 웹 보고서.</b> 쉬운 언어로 된 경영진 요약과 전체 기술 세부 정보를 제공하며, Markdown 및 PDF로 내보낼 수 있습니다.</p> </td> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/infra-orbital.gif" alt="Darkmoon Pro orbital attack-surface map: an animated infrastructure graph with exposure rings, per-node vulnerability badges and the MITRE attack path racing from the internet-facing entry to the database" /> <p align="center"><b>Pro: 궤도형 공격 표면 맵.</b> 노드, 연결 및 노드별 취약점의 라이브 3D 그래프로, 전체 대상에 걸쳐 MITRE 공격 경로를 따라가며, **모든 발견 사항이 검토된 풀 리퀘스트로 제안된 리메디에이션과 연결됩니다**. 브라우저와 VR에서 렌더링됩니다.</p> </td> </tr> <tr> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/scheduler.png" alt="Darkmoon Pro campaign scheduler for recurring automated pentest campaigns with focus, severity and recurrence" /> <p align="center"><b>Pro: 예약된 반복 실행.</b> FOCUS, 심각도 및 반복이 웹 대시보드에 내장된 반복 자동화 캠페인.</p> </td> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/campaign.png" alt="Darkmoon Pro campaign view listing the 57 vulnerabilities with severity and status" /> <p align="center"><b>Pro: 캠페인 보기.</b> 캠페인의 모든 취약점과 그 심각도 및 확인 상태.</p> </td> </tr> </table> ### 🔒 Pro: 발견에서 수정까지 (자동화된 리메디에이션, 유료) > 🔒 **유료 Pro 기능.** 오픈 소스 엔진은 취약점을 찾아 증명합니다. 풀 리퀘스트로의 자동화된 리메디에이션은 Darkmoon Pro에서만 사용할 수 있습니다. 유료 Pro 티어에서는 모든 발견 사항이 _발견 → 샌드박스 검증 수정 → **사람이 검토하는 풀 리퀘스트, 원래 익스플로잇에 대해 재테스트**_로 흐르며, 자동 병합되지 않습니다. OWASP Juice Shop 데모 실행에서 Pro 리메디에이션 에이전트는 **깨끗한 라이브 익스플로잇 재테스트로 발견 사항을 엔드 투 엔드로 수정**했습니다(수정은 원래 익스플로잇이 다시 실행되어 해결이 확인된 경우에만 인정됩니다). [리메디에이션 벤치마크](https://dark-moon.org/remediation-benchmark/), [리메디에이션 에이전트 문서](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) 및 [ASCIT31/juice-shop의 57개 오픈 PR](https://github.com/ASCIT31/juice-shop/pulls)을 참조하세요. <div align="center"> <a href="https://youtu.be/zQE95bVLZgM"> <img src="https://assets.kitploit.com/production/public/readmes/42241/95a4689eb8c0d2931c09f243615e0a57071b7d7698d88e2d0c6477a477b2d6c5.png" alt="Watch the demo of the Darkmoon Pro web dashboard running a full autonomous penetration test" width="70%" /> </a> **▶️ 데모 시청 (Darkmoon Pro 웹 대시보드 시연)** </div> ### 🔒 Pro: 박스도, 마켓플레이스도 없이 클릭 한 번으로 모든 클라우드에 배포 > 🔒 **유료 Pro 기능.** 오픈 소스 에디션은 위에 표시된 CLI입니다. 원클릭 클라우드 프로비저닝은 Darkmoon Pro와 함께 제공되며(유효한 Pro 라이선스 키 필요), 오픈 소스 빌드에는 포함되지 않습니다. <div align="center"> <a href="https://github.com/ASCIT31/darkmoon-cloud-deploy/blob/master/docs/aws.md"><img src="https://www.vectorlogo.zone/logos/amazon_aws/amazon_aws-icon.svg" alt="AWS" height="42" /></a> <a href="https://github.com/ASCIT31/darkmoon-cloud-deploy/blob/master/docs/gcp.md"><img src="https://www.vectorlogo.zone/logos/google_cloud/google_cloud-icon.svg" alt="Google Cloud" height="42" /></a> <a href="https://github.com/ASCIT31/darkmoon-cloud-deploy/blob/master/docs/azure.md"><img src="https://www.vectorlogo.zone/logos/microsoft_azure/microsoft_azure-icon.svg" alt="Azure" height="42" /></a> <a href="https://github.com/ASCIT31/darkmoon-cloud-deploy/blob/master/docs/ovh.md"><img src="https://cdn.simpleicons.org/ovh/123F6D" alt="OVHcloud" height="36" /></a> </div> <p align="center">"하드웨어 박스를 판매하나요?" <b>아니요.</b> 명령 하나로 모든 클라우드 VM을 자체 테넌시 내의 전용 Darkmoon <b>Pro</b> 어플라이언스로 전환합니다 — 머신을 생성하고, 대시보드 포트를 열고, 모든 것을 대신 설치합니다. <b>독점 하드웨어 없음, 클라우드 마켓플레이스 없음, 종속 없음</b> — 동일한 패키징된 Docker 이미지가 모든 클라우드와 자체 베어 메탈에서 실행됩니다.</p> ```bash # one command, from your cloud's browser shell (AWS / GCP / Azure / OVH) curl -fsSL https://portal.dark-moon.org/deploy | bash -s -- aws --license <KEY> --api-key <LLM_KEY> ``` <div align="center"> **[클라우드 배포 가이드 →](https://github.com/ASCIT31/darkmoon-cloud-deploy)** · [문서](https://docs.dark-moon.org/#cloud-deployment) · [어플라이언스](https://dark-moon.org/appliance) </div> --- ## DarkMoon이란? DarkMoon은 **오픈소스 AI 침투 테스트** 플랫폼입니다. 테스트 권한이 있는 대상에 지정하면 전체 평가를 스스로 수행합니다. 추론하고, 계획하고, **50개의 전문 에이전트**를 파견하여 통제된 MCP 계층을 통해 실제 공격 작업을 실행한 다음, 정확한 명령, 원시 출력, 그 뒤에 있는 증거와 함께 모든 취약점을 보고합니다. 이것은 침투 테스터를 대체하지 않습니다. 증거와 함께 평가의 반복적인 부분을 처리하여, 전문가가 단순 작업이 아닌 판단에 시간을 쓸 수 있게 합니다. --- ## 📊 벤치마크: OWASP Juice Shop에서 57개의 실제 취약점 **클라우드 프론티어 모델(Anthropic Claude)**을 사용한 OWASP Juice Shop에 대한 실제 재현 가능한 **블랙박스** 실행입니다. DarkMoon은 Privacy Gateway 뒤에서 **완전 로컬**(Ollama / llama.cpp)로도 실행되므로 인프라를 벗어나는 데이터가 없습니다. 로컬 모델 커버리지는 실행하는 모델에 따라 다릅니다. | 지표 | 결과 | |---|---| | 발견된 취약점 | **57** (심각 8 / 높음 24 / 중간 21 / 낮음 4) | | 실제 소요 시간 | **28.5분** | | 익스플로잇 증명 | 발견 사항별 명령 + 원시 출력 | | LLM | Anthropic Claude (클라우드 프론티어); 로컬 모델 지원 | 직접 재현하고 도구를 비교해 보세요: **[ASCIT31/Darkmoon-Benchmarks](https://github.com/ASCIT31/Darkmoon-Benchmarks)**. ## 🆚 DarkMoon 비교 | | **DarkMoon** | strix | shannon | PentAGI | |---|:--:|:--:|:--:|:--:| | **로컬 LLM**에서 실행 (데이터가 외부로 나가지 않음) | ✅ | ❌ 클라우드 | ❌ 클라우드 | 부분적 | | Privacy Gateway (로컬 토큰화) | ✅ | ❌ | ❌ | ❌ | | Active Directory + Kubernetes | ✅ | ❌ | ❌ | 부분적 | | 익스플로잇 증명 | ✅ | ✅ | ✅ | ✅ | | 오픈소스 | ✅ GPL-3.0 | ✅ | ✅ | ✅ | *공개 저장소/문서에서 정리 (2026-08); 수정 사항은 PR로 환영합니다.* --- ## 작동 방식 DarkMoon은 ISO 27001, NIST SP 800-115, MITRE ATT&CK 방법론에 부합하는 전략적 **AI 보안 에이전트** 오케스트레이터로 작동합니다. 대상을 제공하면 플랫폼이 자동으로: 1. 🔍 대상 환경을 **탐색**합니다 (포트, 서비스, 프로토콜) 2. 🧠 기술 스택을 **핑거프린팅**합니다 (프레임워크, CMS, API) 3. 🎯 공격 표면을 **모델링**합니다 4. 🚀 탐지된 기술에 따라 특화된 하위 에이전트를 **배포**합니다 5. 🔬 반응형 적응을 갖춘 **지능형 취약점 스캐닝** 루프를 **실행**합니다 6. ✅ 증거(요청, 페이로드, 응답)로 발견 사항을 **검증**합니다 7. 📝 구조화된 감사 보고서를 **생성**합니다 ### 하위 에이전트 오케스트레이션 DarkMoon은 탐지된 기술에 따라 특화된 에이전트를 동적으로 선택하고 파견합니다: | 탐지된 기술 | 트리거되는 에이전트 | |---|---| | WordPress, Drupal, Joomla, Magento, PrestaShop, Moodle | CMS 전용 에이전트 | | PHP, Node.js, Flask, ASP.NET, Spring Boot, Ruby on Rails, Go | 스택 전용 에이전트 | | GraphQL | GraphQL 에이전트 | | LLM / AI 추론 엔드포인트 (OpenAI 호환, Ollama, vLLM, TGI) | LLM 에이전트 | | Active Directory | AD 에이전트 | | Kubernetes | Kubernetes 에이전트 | | AWS, Azure, GCP | 클라우드 제공자 에이전트 | | Entra ID (Microsoft 아이덴티티) | 아이덴티티 에이전트 | | GitHub, GitLab, Jenkins | SCM & CI/CD 에이전트 | | Terraform, Ansible | Infrastructure-as-Code 에이전트 | | Docker, 컨테이너 레지스트리 | 컨테이너 에이전트 | | HashiCorp Vault | 시크릿 에이전트 | | PostgreSQL, MySQL, MSSQL, Oracle | 데이터베이스 에이전트 | | Redis, RabbitMQ, Kafka, MQTT | 메시징 & 캐시 에이전트 | | 펌웨어 / IoT 이미지 | 펌웨어 에이전트 | | 헤드리스 브라우저 필요 | 헤드리스 브라우저 에이전트 | 여러 에이전트가 하이브리드 아키텍처 전반에서 **병렬로** 실행될 수 있습니다. 자격 증명이 있어야 의미가 있는 영역(클라우드 계정, CI/CD, 시크릿 저장소, 데이터베이스, Active Directory, Kubernetes)은 **추론만으로는 절대 파견되지 않습니다**. 구체적인 아티팩트(키, 토큰, 접근 가능한 메타데이터 엔드포인트)가 발견되거나 명시적으로 권한을 부여한 경우에만 실행되며, 그렇지 않으면 보고서에 플래그가 지정됩니다. > **참고:** 에이전트의 전체 목록, 구조, 수명 주기, 사용자 정의 에이전트 생성 방법은 [전체 문서, AI 에이전트](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents)를 참조하세요. ### 아키텍처 개요 ``` User ──> DarkmoonCLI ──> OpenCode (AI Brain) ──> MCP (Security Gatekeeper) ──> Docker Toolbox (Real Tools) ``` ```mermaid 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는 무엇이 실행될 수 있는지 제어합니다. Toolbox는 Docker 내부에서 격리된 도구들을 실행합니다. **AI는 시스템에 직접 접근하지 않습니다**, 이것이 **설계에 의한 보안**입니다. > **참고:** 전체 아키텍처 분석(배포 다이어그램, 네트워크 흐름, 보안 경계)은 [전체 문서, 아키텍처](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture)를 참조하세요. --- ## 범위 정의 DarkMoon은 명령줄에서 직접 유연한 범위 정의를 지원합니다. **빠른 침투 테스트(제로 구성):** ```bash ./darkmoon.sh "TARGET: http://172.19.0.3:3000" ``` **버그 바운티 모드(플래그가 자동으로 활성화됨):** ```bash ./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 자유 형식 구문, 고급 다중 대상 스코핑에 대해서는 [전체 문서, 범위 정의](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console)를 참조하세요. --- ## 통합 툴박스 DarkMoon은 다단계 빌드에서 컴파일 및 최적화된 **140개 이상의 보안 도구**를 포함하는 전용 Docker 이미지와 함께 제공됩니다: | 카테고리 | 도구 (예시) | |---|---| | 포트 스캐닝 | Naabu (탐색), nmap (대상 서비스 프로브) | | 웹 스캐닝 | Nuclei, ffuf, dirb, sqlmap, Arjun, wafw00f | | 정찰 및 크롤링 | Subfinder, Katana, Waybackurls, httpx | | CMS | WPScan, CMSeeK, WhatWeb | | Active Directory | NetExec, BloodHound, Impacket (30개 이상의 스크립트) | | Kubernetes | kubectl, Kubescape, Kubeletctl, kube-bench, rbac-police | | 클라우드 CLI | aws, az, gcloud, gsutil, bq | | 데이터베이스 및 캐시 | psql, mysql, redis-cli, sqlite3 | | 펌웨어 / IoT | binwalk, unsquashfs, sasquatch, firmwalker | | 크래킹 | hashcat, john, 7z2john | | 네트워크 | Hydra, curl, dig, SNMP 도구 | | 브라우저 | Lightpanda (헤드리스) | 모든 도구는 경로 설정 없이 바로 접근할 수 있습니다. > **참고:** 설치 세부 정보와 새 도구 추가 방법을 포함한 전체 도구 목록은 [전체 문서, 툴박스](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox)를 참조하세요. --- ## 📖 문서 가이드 DarkMoon의 [전체 문서](https://github.com/ascit31/dark-moon/blob/master/docs/full.md)는 플랫폼 운영에 필요한 모든 내용을 다룹니다. 다음은 가장 중요한 섹션에 대한 빠른 참조입니다: | 주제 | 확인할 수 있는 내용 | 링크 | |---|---|---| | **GPU 및 드라이버 설정** | Docker, WSL, 네이티브 Linux용 NVIDIA 문제 해결 | [GPU 가이드](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii2--darkmoon--gpu-troubleshooting-guide-official) | | **환경 변수** | LLM 제공자 구성, API 키, 모델 선택 | [환경 구성](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii3-configuration-of-environment-variables-in-docker-compose) | | **시작 및 빌드** | install.sh 동작, docker compose build, 스택 관리 | [빌드 및 실행](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii6-build-and-launch-darkmoon) | | **범위 및 플래그** | TARGET 구문, 버그 바운티 모드, FOCUS/EXCLUDE, 자격 증명 | [범위 정의](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console) | | **평가 워크플로** | 단계별: 탐색, 핑거프린팅, 에이전트, 보고 | [평가 엔진](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7d-how-to-use-the-darkmoon-assessment-engine) | | **실시간 세션 로그** | MCP 서버가 실행하는 명령을 실시간으로 모니터링 | [세션 로그](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7e-step-1--start-an-assessment) | | **AI 에이전트** | 에이전트 구조, 수명 주기, 에이전트 생성 또는 수정 방법 | [AI 에이전트](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents) | | **아키텍처** | 배포 다이어그램, 보안 경계, 실행 흐름 | [아키텍처](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture) | | **툴박스** | 전체 도구 목록, 도구 추가, Docker 이미지 내부 구조 | [툴박스](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox) | | **MCP 워크플로** | 워크플로 구조, 사용자 정의 워크플로 생성, 모범 사례 | [MCP 워크플로](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vii-mcp-workflows) | | **사용 가능한 도구 목록** | 경로와 출처를 포함한 142개 보안 도구의 전체 표 | [도구 목록](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi10-toolbox-list) | | **교육용 랩** | DarkMoon 훈련에 권장되는 취약 랩 | [펜테스터 랩](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi11-bonus-pentester-lab-to-train-darkmoon) | | **교정 에이전트** (Pro) | 발견 사항 → 샌드박스 검증 수정 → 사람 검토용 풀 리퀘스트 (병합되지 않음) | [교정 에이전트](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) | | **n8n** (Pro) | n8n 워크플로에서 펜테스트를 트리거하고, 발견 사항을 가져오고, 수정 PR을 검토하는 커뮤니티 노드 | [n8n 노드](https://github.com/ascit31/dark-moon/blob/master/docs/n8n-integration.md) | --- ## 사용 사례 DarkMoon은 다음과 같은 용도를 위한 다재다능한 **보안 테스트 플랫폼**으로 설계되었습니다: - 🔒 **보안 팀**, 인프라 전반에 걸쳐 지속적인 **자동화된 침투 테스트** 실행 - ⚙️ **DevSecOps 파이프라인**, CI/CD 워크플로에 **AI 기반 보안 연구** 통합 - 🎯 **버그 바운티 헌터**, 자율적인 대상 분석으로 **윤리적 해킹** 가속화 - 🔬 **보안 연구원**, 실시간으로 적응하는 **AI 사이버보안 플랫폼**으로 공격 표면 탐색 - 🎓 **교육 및 훈련**, 가이드가 제공되는 재현 가능한 평가로 오펜시브 보안 학습 --- ## 예시 프롬프트 ```bash # 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, 헤드리스 브라우저 시나리오를 포함한 더 많은 프롬프트 예시는 [전체 문서, 프롬프트 예시](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iii-uses)를 참조하세요. --- ## 기여 DarkMoon은 오픈 소스이며 기여를 환영합니다. 새로운 에이전트 추가, 도구 통합, 워크플로 생성 또는 문서 개선을 원하신다면 가이드라인은 [CONTRIBUTING.md](https://github.com/ascit31/dark-moon/blob/master/CONTRIBUTING.md)를 참조하세요. --- ## 라이선스 이 프로젝트는 **GNU General Public License v3.0**에 따라 라이선스가 부여됩니다. 자세한 내용은 [LICENSE](https://github.com/ascit31/dark-moon/blob/master/LICENSE)를 참조하세요. --- <div align="center"> **전 세계 보안 커뮤니티를 위해 ASC-IT가 💚를 담아 제작했습니다** 🔒 오픈 소스 · 🤖 AI 기반 · 🇫🇷 프랑스 제작 --- [Read more](https://github.com/ascit31/dark-moon)
