Motor autônomo de pentest com IA, segurança ofensiva contínua em web, nuvem, AD e Kubernetes. Raciocínio agêntico + execução real de exploits geram vulnerabilidades baseadas em provas. Gateway de privacidade: o LLM nunca vê seus IPs, hosts, credenciais ou caminhos reais (placeholders determinísticos reidratados localmente), nada sai do seu perímetro.
<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 — autonomous AI penetration testing on a local model" width="100%" /> </a> # DarkMoon ### Open-source autonomous AI penetration testing — finds, exploits and qualifies every vulnerability on your own infrastructure <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 é um teste de penetração autônomo com IA para a sua própria infraestrutura.** Aponte-o para um alvo autorizado e ele executa toda a avaliação sozinho, documentando cada descoberta com o comando exato e a saída bruta. - 🟢 **Verdadeiramente open source.** GPLv3 e auto-hospedado, a metodologia de cada agente é Markdown puro que você pode ler, comparar e bifurcar. - 🎯 **Encontra E prova.** Cada vulnerabilidade vem com o comando exato e a saída bruta (a exploração é declarada pelo agente; o reteste de remediação do Pro é a etapa verificada por máquina), então quase não há nada para triagem. - 🔒 **Roda em um LLM local + Privacy Gateway.** O gateway tokeniza seus IPs, hosts e credenciais reais localmente, então o modelo raciocina sobre placeholders enquanto os valores reais permanecem no seu perímetro. - 🧩 **Em todo lugar onde você constrói.** Execute-o a partir do GitHub, GitLab, Jenkins, VS Code, JetBrains, n8n, Grafana ou Splunk — a edição open source funciona com os baseados em CLI. [Veja as integrações ↓](#-darkmoon-everywhere) --- <div align="center"> ## Veja o motor open source (CLI) O Darkmoon open source é uma ferramenta de linha de comando. Isto é o que você obtém ao clonar o repositório. Você inicia uma avaliação pela linha de comando e assiste cada agente, comando e descoberta fluir em tempo real. </div> <table> <tr> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/start-assesment.png" alt="Launching a DarkMoon assessment from the command line with a single TARGET line" /> <p align="center"><b>Inicie uma execução pela CLI.</b> Uma linha <code>TARGET</code> e o DarkMoon assume toda a avaliação.</p> </td> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/sub-agent-1.png" alt="A DarkMoon sub-agent state machine in the terminal detecting CVE-2019-9978 and moving straight to exploitation" /> <p align="center"><b>Agentes autônomos raciocinam e exploram, ao vivo no seu terminal.</b> Aqui um sub-agente sinaliza CVE-2019-9978 e parte direto para a exploração.</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 recon and environment model summary printed in the terminal" /> <p align="center"><b>Reconhecimento e modelo de ambiente.</b> O DarkMoon faz fingerprint da stack e confirma a superfície de ataque antes de atacar.</p> </td> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/log.png" alt="Live MCP output stream in the terminal with timestamped commands and raw responses" /> <p align="center"><b>Fluxo MCP ao vivo.</b> Cada comando que o agente executa e sua saída bruta, com timestamp, via <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="Signal detection matrix in the terminal mapping detected technologies to the agents DarkMoon dispatches" width="80%" /> <p><b>Do sinal ao despacho de agentes.</b> O DarkMoon decide quais agentes especialistas implantar a partir exatamente do que detecta no alvo.</p> **Destacado em** [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` configura seu provedor de LLM interativamente (sem necessidade de editar `docker-compose.yml`) e constrói a stack completa: ```bash ./install.sh # skip form if .opencode.env already configured ./install.sh --init # force reconfiguration (cloud or local model) ./install.sh --help # show usage ``` Suporta **provedores de nuvem** (Anthropic, OpenAI, OpenRouter…) e **modelos locais** (Ollama, llama.cpp). Em seguida, execute sua primeira avaliação e acompanhe ao vivo: ```bash ./darkmoon.sh "TARGET: example.com" ./darkmoon.sh --log <session_id> ``` **Pré-requisitos:** Docker & Docker Compose, e uma chave de API de LLM (ou um modelo local). Configuração de GPU, variáveis de ambiente e a referência completa de flags estão na [Documentação Completa](https://github.com/ascit31/dark-moon/blob/master/docs/full.md). --- ## Grelha de funcionalidades | | | |---|---| | 🧠 **50 agentes especialistas** | Um sistema agêntico raciocina, planeia e despacha agentes especialistas por todas as superfícies que descobre. | | 🌐 **Todas as superfícies** | Web, APIs, Active Directory, Kubernetes, cloud (AWS, Azure, GCP), CI/CD, bases de dados, firmware IoT e endpoints AI/LLM, encadeados de ponta a ponta. | | 🔒 **Privacy Gateway** | A tokenização local reversível transforma IPs, hosts, URLs e credenciais reais em placeholders determinísticos, reidratados apenas localmente no momento em que uma ferramenta é executada. | | 🏠 **Modelo local** | Execute toda a avaliação num LLM local (Ollama, llama.cpp) para que os valores da sua infraestrutura permaneçam no seu próprio perímetro. | | 🧾 **Evidência, não pontuações** | Cada descoberta vem com o comando exato e a saída em bruto; o reteste Pro volta a executar o exploit para confirmar a correção. | | 🛡️ **Segurança por design** | A IA nunca executa um comando diretamente, cada ação flui através de uma interface MCP controlada e registada. | | 🤖 **Faz pentest à sua IA também** | Um agente LLM dedicado sonda endpoints de inferência AI/LLM para o OWASP LLM Top 10 com sondas suportadas por garak. | | ♾️ **Nativo em CI/CD** | Acione um pentest no pipeline e receba as descobertas como artefactos. | | 🔌 **MCP** | Orquestre mais de 140 ferramentas ofensivas via MCP. | | 🔧 **Corrija (Pro)** | O nível Pro pago transforma descobertas em pull requests revistos por humanos, retestados contra o exploit original. | Construído para **equipas de segurança**, **engenheiros DevSecOps**, **red teamers** e profissionais de **ethical hacking**. --- ## 🧩 DarkMoon em todo o lado <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> Execute o DarkMoon onde já constrói — em CI/CD, no seu IDE, automação e SecOps. As integrações marcadas **OSS + Pro** funcionam com a edição open-source (CLI local + JSON); as exclusivas Pro consomem a API REST do [DarkMoon Pro](#-darkmoon-pro--paid-edition-web-dashboard-and-automated-remediation) (dashboard em tempo real, remediação→PR). | Plataforma | O que faz | Obter | Edição | Tutorial | |---|---|---|---|---| | **GitHub Actions** | Falha o pipeline consoante a severidade das descobertas | [GitHub Marketplace](https://github.com/marketplace/actions/darkmoon-pentest) | OSS + Pro | [▶ Ver](https://youtu.be/e67klNk79vg) | | **GitLab CI/CD** | Descobertas como relatórios Code Quality + SAST | [CI/CD Catalog](https://gitlab.com/explore/catalog/Dark-Moon-X/darkmoon-scan) | OSS + Pro | [▶ Ver](https://youtu.be/ui7NHD41cMM) | | **Jenkins** | Descobertas como problemas Warnings-NG na build | [Plugin `.hpi` (Releases)](https://github.com/ASCIT31/darkmoon-jenkins/releases) | OSS + Pro | [▶ Ver](https://youtu.be/G0TgyGpVLZ8) | | **VS Code** | Navegue e lance avaliações a partir do editor | [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Darkmoon.darkmoon-vscode) | OSS + Pro | [▶ Ver](https://youtu.be/GY7YOnYpteQ) | | **JetBrains** | Descobertas numa janela de ferramentas do IDE | [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/34497-darkmoon) | OSS + Pro | [▶ Ver](https://youtu.be/obUUrbTN3Jg) | | **n8n** | Automatize campanhas, retestes e alertas | [npm `n8n-nodes-darkmoon`](https://www.npmjs.com/package/n8n-nodes-darkmoon) | Pro | [▶ Ver](https://youtu.be/3htg8kh7Dr8) | | **Grafana** | Dashboards de postura de segurança | [Self-host (Releases)](https://github.com/ASCIT31/darkmoon-grafana/releases) | Pro | [▶ Ver](https://youtu.be/L7K-y0HPudk) | | **Splunk** | Ingestão SOC (HEC) + ação de alerta "Send to Darkmoon" | [App (Releases)](https://github.com/ASCIT31/darkmoon-splunk/releases) — Splunkbase pendente | OSS + Pro | [▶ Ver](https://youtu.be/8w2i8nEBdQQ) | | **SDK / CLI** | Construa a sua própria integração sobre o contrato partilhado | [npm `@darkmoon_ai/client`](https://www.npmjs.com/package/@darkmoon_ai/client) | OSS + Pro | [▶ Ver](https://youtu.be/jMIMvV8yEK8) | Cada integração emite **apenas metadados seguros** (severidade, estado, MITRE, ids) — nunca evidências, segredos ou tokens. Guias completos em [docs.dark-moon.org](https://docs.dark-moon.org); código-fonte em [ASCIT31](https://github.com/ASCIT31). --- ## 🔒 Darkmoon Pro — edição paga: dashboard web e remediação automatizada > 🔒 **Estas são funcionalidades do Darkmoon Pro (pago).** A edição open source é a CLI mostrada acima; o dashboard web e a remediação automatizada para pull requests não estão na build open source. As capturas de ecrã abaixo são o dashboard web do **Darkmoon Pro pago**. **Não** fazem parte do repositório open source que clona. A edição open source é a ferramenta de linha de comandos mostrada na secção acima. <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: dashboard web em tempo real.</b> Projetos, alvos e campanhas num relance, com cada descoberta agrupada por severidade.</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: descobertas com mapeamento CVSS e ATT&CK.</b> Cada descoberta inclui mapeamento CVSS, MITRE ATT&CK e ISO 27001 com um estado <code>EXPLOITED</code> suportado por um exploit real.</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: relatórios web exportáveis.</b> Um resumo de gestão em linguagem simples mais detalhe técnico completo, exportável para Markdown e 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: mapa orbital da superfície de ataque.</b> Um grafo 3D em tempo real de nós, ligações e vulnerabilidades por nó, com o caminho de ataque MITRE percorrido por todo o alvo, e **cada descoberta ligada à sua remediação proposta como um pull request revisto**. Renderiza no navegador e em 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: execuções recorrentes agendadas.</b> Campanhas automatizadas recorrentes com FOCUS, severidade e recorrência integrados no dashboard web.</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: vista de campanha.</b> Cada vulnerabilidade numa campanha com a sua severidade e estado de confirmação.</p> </td> </tr> </table> ### 🔒 Pro: da descoberta à correção (remediação automatizada, paga) > 🔒 **Funcionalidade Pro paga.** O motor open source encontra e prova vulnerabilidades. A remediação automatizada em pull requests está disponível apenas no Darkmoon Pro. No nível Pro pago, cada descoberta flui _descoberta → correção validada em sandbox → **pull request revisto por humanos, retestado contra o exploit original**_, e nunca é auto-merged. Na nossa execução de demonstração do OWASP Juice Shop, o agente de remediação Pro **corrigiu descobertas de ponta a ponta com um reteste de exploit ao vivo limpo** (uma correção só conta quando o exploit original é reexecutado e confirmado como fechado). Veja o [benchmark de remediação](https://dark-moon.org/remediation-benchmark/), a [documentação do agente de remediação](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) e os [57 PRs abertos em ASCIT31/juice-shop](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> **▶️ Veja a demonstração (mostra o dashboard web do Darkmoon Pro)** </div> ### 🔒 Pro: implemente em qualquer cloud com um clique — sem box, sem marketplace > 🔒 **Funcionalidade Pro paga.** A edição open source é a CLI mostrada acima. O aprovisionamento cloud com um clique vem com o Darkmoon Pro (é necessária uma chave de licença Pro válida) e não faz parte da build open source. <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">"Vendem uma box de hardware?" <b>Não.</b> Um comando transforma qualquer VM cloud numa appliance Darkmoon <b>Pro</b> dedicada no seu próprio tenancy — cria a máquina, abre a porta do dashboard e instala tudo por si. <b>Sem hardware proprietário, sem marketplace cloud, sem lock-in</b> — as mesmas imagens Docker empacotadas correm em todas as clouds e no seu próprio bare metal.</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"> **[Guia de implantação em nuvem →](https://github.com/ASCIT31/darkmoon-cloud-deploy)** · [Docs](https://docs.dark-moon.org/#cloud-deployment) · [Appliance](https://dark-moon.org/appliance) </div> --- ## O que é o DarkMoon? DarkMoon é uma plataforma **open-source de testes de intrusão com IA**. Aponte-a para um alvo que você está autorizado a testar, e ela executa toda a avaliação por conta própria: raciocina, planeja e despacha **50 agentes especialistas** que executam operações ofensivas reais através de uma camada MCP controlada, e depois reporta cada vulnerabilidade com o comando exato, a saída bruta e a prova por trás dela. Ela não substitui o pentester. Ela elimina a parte repetitiva de uma avaliação com evidências, para que seus especialistas gastem seu tempo com julgamento, não com trabalho braçal. --- ## 📊 Benchmark: 57 vulnerabilidades reais no OWASP Juice Shop Execução **black-box** real e reproduzível contra o OWASP Juice Shop com um **modelo de fronteira em nuvem (Anthropic Claude)**. O DarkMoon também roda **totalmente local** (Ollama / llama.cpp) atrás do Privacy Gateway — então nada sai da sua infraestrutura; a cobertura de modelos locais depende do modelo que você executa. | Métrica | Resultado | |---|---| | Vulnerabilidades encontradas | **57** (8 críticas / 24 altas / 21 médias / 4 baixas) | | Tempo de execução | **28,5 min** | | Prova de exploração | comando + saída bruta por achado | | LLM | Anthropic Claude (fronteira em nuvem); modelos locais suportados | Reproduza e compare ferramentas você mesmo: **[ASCIT31/Darkmoon-Benchmarks](https://github.com/ASCIT31/Darkmoon-Benchmarks)**. ## 🆚 Como o DarkMoon se compara | | **DarkMoon** | strix | shannon | PentAGI | |---|:--:|:--:|:--:|:--:| | Roda em **LLM local** (dados nunca saem) | ✅ | ❌ nuvem | ❌ nuvem | parcial | | Privacy Gateway (tokenização local) | ✅ | ❌ | ❌ | ❌ | | Active Directory + Kubernetes | ✅ | ❌ | ❌ | parcial | | Prova de exploração | ✅ | ✅ | ✅ | ✅ | | Código aberto | ✅ GPL-3.0 | ✅ | ✅ | ✅ | *Compilado de repositórios/docs públicos (2026-08); correções são bem-vindas via PR.* --- ## Como Funciona O DarkMoon opera como um orquestrador estratégico de **agente de segurança com IA** alinhado às metodologias ISO 27001, NIST SP 800-115 e MITRE ATT&CK. Quando você fornece um alvo, a plataforma automaticamente: 1. 🔍 **Descobre** o ambiente alvo (portas, serviços, protocolos) 2. 🧠 **Identifica** a stack tecnológica (frameworks, CMS, APIs) 3. 🎯 **Modela** a superfície de ataque 4. 🚀 **Implanta** subagentes especializados com base nas tecnologias detectadas 5. 🔬 **Executa** um loop de **varredura inteligente de vulnerabilidades** com adaptação reativa 6. ✅ **Valida** os achados com evidências (requisições, payloads, respostas) 7. 📝 **Gera** um relatório de auditoria estruturado ### Orquestração de Subagentes O DarkMoon seleciona e despacha dinamicamente agentes especializados dependendo das tecnologias descobertas: | Tecnologia Detectada | Agente Acionado | |---|---| | WordPress, Drupal, Joomla, Magento, PrestaShop, Moodle | Agente específico de CMS | | PHP, Node.js, Flask, ASP.NET, Spring Boot, Ruby on Rails, Go | Agente específico de stack | | GraphQL | Agente GraphQL | | Endpoint de inferência LLM / IA (compatível com OpenAI, Ollama, vLLM, TGI) | Agente LLM | | Active Directory | Agente AD | | Kubernetes | Agente Kubernetes | | AWS, Azure, GCP | Agente de provedor de nuvem | | Entra ID (identidade Microsoft) | Agente de identidade | | GitHub, GitLab, Jenkins | Agente de SCM e CI/CD | | Terraform, Ansible | Agente de Infrastructure-as-Code | | Docker, registries de contêineres | Agente de contêineres | | HashiCorp Vault | Agente de segredos | | PostgreSQL, MySQL, MSSQL, Oracle | Agente de banco de dados | | Redis, RabbitMQ, Kafka, MQTT | Agente de mensageria e cache | | Firmware / imagens de IoT | Agente de firmware | | Navegador headless necessário | Agente de navegador headless | Múltiplos agentes podem executar **em paralelo** através de arquiteturas híbridas. Planos que exigem credenciais para serem significativos (contas de nuvem, CI/CD, cofres de segredos, bancos de dados, Active Directory, Kubernetes) **nunca são despachados por inferência**. Eles disparam apenas quando um artefato concreto é encontrado (uma chave, um token, um endpoint de metadados acessível) ou quando você os autoriza explicitamente, e caso contrário são sinalizados no relatório. > **Nota:** Para a lista completa de agentes, sua estrutura, ciclo de vida e como criar agentes personalizados, consulte [Documentação Completa, Agentes de IA](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents). ### Visão Geral da Arquitetura ``` 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 ``` A IA raciocina e planeja. O MCP controla o que pode ser executado. A Toolbox executa ferramentas isoladas dentro do Docker. **A IA nunca toca diretamente o sistema**, isto é **segurança por design**. > **Nota:** Para a análise completa da arquitetura (diagramas de implantação, fluxos de rede, limites de segurança), consulte [Documentação Completa, Arquitetura](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture). --- ## Definição de Escopo O DarkMoon suporta definição flexível de escopo diretamente pela linha de comando. **Pentest rápido (zero configuração):** ```bash ./darkmoon.sh "TARGET: http://172.19.0.3:3000" ``` **Modo bug bounty (as flags são ativadas automaticamente):** ```bash ./darkmoon.sh "TARGET: http://172.19.0.3:3000 PROGRAM=\"Juice Shop\" FOCUS=sqli,xss,idor NOISE=moderate FORMAT=h1" ``` Flags principais incluem `FOCUS`, `EXCLUDE`, `CREDS`, `TOKEN`, `NOISE`, `SEVERITY`, `FORMAT`, e mais, todos interpretados naturalmente pela IA. > **Nota:** Para a referência completa de flags, tipos de assets, sintaxe livre de EXCLUDE/FOCUS e escopo avançado multi-alvo, consulte [Documentação Completa, Definição de Escopo](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console). --- ## Caixa de Ferramentas Integrada O DarkMoon vem com uma imagem Docker criada especificamente, contendo **mais de 140 ferramentas de segurança** compiladas e otimizadas em um build multi-stage: | Categoria | Ferramentas (exemplos) | |---|---| | Varredura de portas | Naabu (descoberta), nmap (sondagens de serviço direcionadas) | | Varredura web | Nuclei, ffuf, dirb, sqlmap, Arjun, wafw00f | | Reconhecimento e crawling | Subfinder, Katana, Waybackurls, httpx | | CMS | WPScan, CMSeeK, WhatWeb | | Active Directory | NetExec, BloodHound, Impacket (mais de 30 scripts) | | Kubernetes | kubectl, Kubescape, Kubeletctl, kube-bench, rbac-police | | CLIs de nuvem | aws, az, gcloud, gsutil, bq | | Bancos de dados e cache | psql, mysql, redis-cli, sqlite3 | | Firmware / IoT | binwalk, unsquashfs, sasquatch, firmwalker | | Quebra de hashes | hashcat, john, 7z2john | | Rede | Hydra, curl, dig, ferramentas SNMP | | Navegador | Lightpanda (headless) | Todas as ferramentas são diretamente acessíveis, sem necessidade de configuração de path. > **Nota:** Para a lista completa de ferramentas com detalhes de instalação e como adicionar novas ferramentas, consulte [Documentação Completa, Caixa de Ferramentas](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox). --- ## 📖 Guia de Documentação A [Documentação Completa](https://github.com/ascit31/dark-moon/blob/master/docs/full.md) do DarkMoon cobre tudo o que você precisa para operar a plataforma. Aqui está uma referência rápida para as seções mais importantes: | Tópico | O Que Você Encontrará | Link | |---|---|---| | **Configuração de GPU e Driver** | Solução de problemas NVIDIA para Docker, WSL e Linux nativo | [Guia de GPU](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii2--darkmoon--gpu-troubleshooting-guide-official) | | **Variáveis de Ambiente** | Configuração de provedor LLM, chaves de API, seleção de modelo | [Configuração de Ambiente](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii3-configuration-of-environment-variables-in-docker-compose) | | **Inicialização e Build** | Comportamento do install.sh, docker compose build, gerenciamento da stack | [Build e Lançamento](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii6-build-and-launch-darkmoon) | | **Escopo e Flags** | Sintaxe de TARGET, modo bug bounty, FOCUS/EXCLUDE, credenciais | [Definição de Escopo](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console) | | **Fluxo de Avaliação** | Passo a passo: descoberta, fingerprinting, agentes, relatórios | [Motor de Avaliação](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7d-how-to-use-the-darkmoon-assessment-engine) | | **Logs de Sessão em Tempo Real** | Monitore ao vivo os comandos executados pelo servidor MCP | [Logs de Sessão](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7e-step-1--start-an-assessment) | | **Agentes de IA** | Estrutura dos agentes, ciclo de vida, como criar ou modificar agentes | [Agentes de IA](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents) | | **Arquitetura** | Diagramas de implantação, limites de segurança, fluxo de execução | [Arquitetura](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture) | | **Caixa de Ferramentas** | Lista completa de ferramentas, adicionar ferramentas, detalhes internos da imagem Docker | [Caixa de Ferramentas](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox) | | **Fluxos de Trabalho MCP** | Estrutura de workflows, criação de workflows personalizados, boas práticas | [Fluxos de Trabalho MCP](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vii-mcp-workflows) | | **Lista de Ferramentas Disponíveis** | Tabela completa das 142 ferramentas de segurança com paths e fontes | [Lista de Ferramentas](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi10-toolbox-list) | | **Laboratórios de Treinamento** | Labs vulneráveis recomendados para treinar o DarkMoon | [Labs para Pentesters](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi11-bonus-pentester-lab-to-train-darkmoon) | | **Agente de Remediação** (Pro) | Achados → correção validada em sandbox → pull request para revisão humana (nunca mesclado) | [Agente de Remediação](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) | | **n8n (Pro)** | Nó da comunidade para disparar um pentest, obter achados e revisar PRs de correção a partir de um workflow n8n | [Nó n8n](https://github.com/ascit31/dark-moon/blob/master/docs/n8n-integration.md) | --- ## Casos de Uso O DarkMoon foi projetado como uma **plataforma versátil de testes de segurança** para: - 🔒 **Equipes de segurança**, execute **testes de penetração automatizados** contínuos em toda a sua infraestrutura - ⚙️ **Pipelines DevSecOps**, integre **pesquisa de segurança orientada por IA** em fluxos de trabalho CI/CD - 🎯 **Caçadores de bug bounty**, acelere o **hacking ético** com análise autônoma de alvos - 🔬 **Pesquisadores de segurança**, explore superfícies de ataque com uma **plataforma de cibersegurança com IA** que se adapta em tempo real - 🎓 **Treinamento e educação**, aprenda segurança ofensiva com avaliações guiadas e reproduzíveis --- ## Exemplos de Prompts ```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" ``` > **Nota:** Para mais exemplos de prompts, incluindo DVGA, Juice Shop e cenários de navegador headless, consulte [Documentação Completa, Exemplos de Prompts](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iii-uses). --- ## Contribuição O DarkMoon é open source e aceita contribuições. Se você deseja adicionar novos agentes, integrar ferramentas, criar fluxos de trabalho ou melhorar a documentação, consulte [CONTRIBUTING.md](https://github.com/ascit31/dark-moon/blob/master/CONTRIBUTING.md) para obter as diretrizes. --- ## Licença Este projeto está licenciado sob a **GNU General Public License v3.0**. Consulte [LICENSE](https://github.com/ascit31/dark-moon/blob/master/LICENSE) para obter detalhes. --- <div align="center"> **Desenvolvido pela ASC-IT com 💚 para a comunidade global de segurança** 🔒 Open Source · 🤖 Com IA · 🇫🇷 Feito na França [⭐ Dê-nos uma estrela no GitHub](https://github.com/ASCIT31/Dark-Moon) · [📖 Documentação Completa](https://github.com/ascit31/dark-moon/blob/master/docs/full.md) · [▶️ Assista à Demonstração (painel Pro)](https://youtu.be/zQE95bVLZgM) </div>
