Motor autónomo de pentesting con IA, seguridad ofensiva continua en web, cloud, AD y Kubernetes. Razonamiento agéntico + ejecución real de exploits ofrecen vulnerabilidades basadas en pruebas. Pasarela de privacidad: el LLM nunca ve tus IPs, hosts, credenciales o rutas reales (marcadores de posición deterministas rehidratados localmente), nada sale de tu 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 — pruebas de penetración autónomas con IA sobre un modelo local" width="100%" /> </a> # DarkMoon ### Pruebas de penetración autónomas con IA de código abierto — encuentra, explota y cualifica cada vulnerabilidad en tu propia infraestructura <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 son pruebas de penetración autónomas con IA para tu propia infraestructura.** Apúntalo a un objetivo autorizado y ejecuta toda la evaluación por sí solo, luego documenta cada hallazgo con el comando exacto y la salida en bruto. - 🟢 **Verdaderamente de código abierto.** GPLv3 y autoalojado, la metodología de cada agente es Markdown plano que puedes leer, comparar y bifurcar. - 🎯 **Encuentra Y demuestra.** Cada vulnerabilidad se entrega con el comando exacto y la salida en bruto (la explotación es afirmada por el agente; la remediación con reintento de Pro es el paso verificado por máquina), así que casi no hay nada que clasificar. - 🔒 **Se ejecuta sobre un LLM local + Privacy Gateway.** La pasarela tokeniza tus IPs, hosts y credenciales reales localmente, de modo que el modelo razona sobre marcadores de posición mientras los valores reales permanecen en tu perímetro. - 🧩 **Dondequiera que construyas.** Ejecútalo desde GitHub, GitLab, Jenkins, VS Code, JetBrains, n8n, Grafana o Splunk — la edición de código abierto funciona con los basados en CLI. [Ver las integraciones ↓](#-darkmoon-everywhere) --- <div align="center"> ## Conoce el motor de código abierto (CLI) El Darkmoon de código abierto es una herramienta de línea de comandos. Esto es lo que obtienes al clonar el repositorio. Lanzas una evaluación desde la línea de comandos y observas cada agente, comando y hallazgo fluir en tiempo 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>Inicia una ejecución desde la CLI.</b> Una línea <code>TARGET</code> y DarkMoon se hace cargo de toda la evaluación.</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>Los agentes autónomos razonan y explotan, en vivo en tu terminal.</b> Aquí un subagente marca CVE-2019-9978 y pivota directamente a la explotación.</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>Reconocimiento y modelo del entorno.</b> DarkMoon identifica la pila y confirma la superficie 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>Flujo MCP en vivo.</b> Cada comando que ejecuta el agente y su salida en bruto, con marca de tiempo, con <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>De señal a despacho de agente.</b> DarkMoon decide qué agentes especialistas desplegar a partir de exactamente lo que detecta en el objetivo.</p> **Destacado en** [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 tu proveedor de LLM de forma interactiva (no es necesario editar `docker-compose.yml`) y construye la pila 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 ``` Admite **proveedores en la nube** (Anthropic, OpenAI, OpenRouter…) y **modelos locales** (Ollama, llama.cpp). Luego ejecuta tu primera evaluación y obsérvala en vivo: ```bash ./darkmoon.sh "TARGET: example.com" ./darkmoon.sh --log <session_id> ``` **Requisitos previos:** Docker y Docker Compose, y una clave de API de LLM (o un modelo local). La configuración de GPU, las variables de entorno y la referencia completa de flags están en la [Documentación completa](https://github.com/ascit31/dark-moon/blob/master/docs/full.md). --- ## Cuadrícula de características | | | |---|---| | 🧠 **50 agentes especialistas** | Un sistema agéntico razona, planifica y despacha agentes especialistas por cada superficie que descubre. | | 🌐 **Todas las superficies** | Web, APIs, Active Directory, Kubernetes, cloud (AWS, Azure, GCP), CI/CD, bases de datos, firmware IoT y endpoints de IA/LLM, encadenados de extremo a extremo. | | 🔒 **Privacy Gateway** | La tokenización local reversible convierte IPs, hosts, URLs y credenciales reales en marcadores de posición deterministas, rehidratados solo localmente en el momento en que se ejecuta una herramienta. | | 🏠 **Modelo local** | Ejecuta toda la evaluación en un LLM local (Ollama, llama.cpp) para que los valores de tu infraestructura permanezcan en tu propio perímetro. | | 🧾 **Evidencia, no puntuaciones** | Cada hallazgo se entrega con el comando exacto y la salida sin procesar; el retest de Pro vuelve a ejecutar el exploit para confirmar una corrección. | | 🛡️ **Seguridad por diseño** | La IA nunca ejecuta un comando directamente, cada acción fluye a través de una interfaz MCP controlada y registrada. | | 🤖 **Pentests también para tu IA** | Un agente LLM dedicado sondea endpoints de inferencia de IA/LLM para el OWASP LLM Top 10 con sondas respaldadas por garak. | | ♾️ **Nativo de CI/CD** | Dispara un pentest en el pipeline y recibe los hallazgos como artefactos. | | 🔌 **MCP** | Orquesta más de 140 herramientas ofensivas a través de MCP. | | 🔧 **Corrígelo (Pro)** | El nivel Pro de pago convierte los hallazgos en pull requests revisados por humanos, re-testeados contra el exploit original. | Diseñado para **equipos de seguridad**, **ingenieros DevSecOps**, **red teamers** y profesionales del **ethical hacking**. --- ## 🧩 DarkMoon en todas partes <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> Ejecuta DarkMoon donde ya construyes — en CI/CD, tu IDE, automatización y SecOps. Las integraciones marcadas como **OSS + Pro** funcionan con la edición de código abierto (CLI local + JSON); las exclusivas de Pro consumen la API REST de [DarkMoon Pro](#-darkmoon-pro--paid-edition-web-dashboard-and-automated-remediation) (panel en vivo, remediación→PR). | Plataforma | Qué hace | Consíguelo | Edición | Tutorial | |---|---|---|---|---| | **GitHub Actions** | Falla el pipeline según los hallazgos por severidad | [GitHub Marketplace](https://github.com/marketplace/actions/darkmoon-pentest) | OSS + Pro | [▶ Ver](https://youtu.be/e67klNk79vg) | | **GitLab CI/CD** | Hallazgos como informes de Code Quality + SAST | [Catálogo CI/CD](https://gitlab.com/explore/catalog/Dark-Moon-X/darkmoon-scan) | OSS + Pro | [▶ Ver](https://youtu.be/ui7NHD41cMM) | | **Jenkins** | Hallazgos como issues de Warnings-NG en la build | [Plugin `.hpi` (Releases)](https://github.com/ASCIT31/darkmoon-jenkins/releases) | OSS + Pro | [▶ Ver](https://youtu.be/G0TgyGpVLZ8) | | **VS Code** | Explora y lanza evaluaciones desde el editor | [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Darkmoon.darkmoon-vscode) | OSS + Pro | [▶ Ver](https://youtu.be/GY7YOnYpteQ) | | **JetBrains** | Hallazgos en una ventana de herramientas del IDE | [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/34497-darkmoon) | OSS + Pro | [▶ Ver](https://youtu.be/obUUrbTN3Jg) | | **n8n** | Automatiza campañas, retests y alertas | [npm `n8n-nodes-darkmoon`](https://www.npmjs.com/package/n8n-nodes-darkmoon) | Pro | [▶ Ver](https://youtu.be/3htg8kh7Dr8) | | **Grafana** | Paneles de postura de seguridad | [Autoalojado (Releases)](https://github.com/ASCIT31/darkmoon-grafana/releases) | Pro | [▶ Ver](https://youtu.be/L7K-y0HPudk) | | **Splunk** | Ingesta en el SOC (HEC) + acción de alerta "Send to Darkmoon" | [App (Releases)](https://github.com/ASCIT31/darkmoon-splunk/releases) — Splunkbase pendiente | OSS + Pro | [▶ Ver](https://youtu.be/8w2i8nEBdQQ) | | **SDK / CLI** | Construye tu propia integración sobre el contrato compartido | [npm `@darkmoon_ai/client`](https://www.npmjs.com/package/@darkmoon_ai/client) | OSS + Pro | [▶ Ver](https://youtu.be/jMIMvV8yEK8) | Cada integración emite **solo metadatos seguros** (severidad, estado, MITRE, ids) — nunca evidencia, secretos ni tokens. Guías completas en [docs.dark-moon.org](https://docs.dark-moon.org); código fuente en [ASCIT31](https://github.com/ASCIT31). --- ## 🔒 Darkmoon Pro — edición de pago: panel web y remediación automatizada > 🔒 **Estas son características de Darkmoon Pro (de pago).** La edición de código abierto es la CLI mostrada arriba; el panel web y la remediación automatizada a pull requests no están en la build de código abierto. Las capturas de pantalla a continuación son el panel web de **Darkmoon Pro de pago**. **No** forman parte del repositorio de código abierto que clonas. La edición de código abierto es la herramienta de línea de comandos mostrada en la sección anterior. <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: panel web en vivo.</b> Proyectos, objetivos y campañas de un vistazo, con cada hallazgo clasificado por severidad.</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: hallazgos con mapeo CVSS y ATT&CK.</b> Cada hallazgo lleva mapeo de CVSS, MITRE ATT&CK e ISO 27001 con un estado <code>EXPLOITED</code> respaldado por un 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: informes web exportables.</b> Un resumen ejecutivo en lenguaje claro más el detalle técnico completo, exportable a Markdown y 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 de superficie de ataque.</b> Un grafo 3D en vivo de nodos, conexiones y vulnerabilidades por nodo, con la ruta de ataque MITRE recorriendo todo el objetivo, y **cada hallazgo vinculado a su remediación propuesta como un pull request revisado**. Se renderiza en el navegador y en 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: ejecuciones recurrentes programadas.</b> Campañas automatizadas recurrentes con FOCUS, severidad y recurrencia integrados en el panel 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 campaña.</b> Cada vulnerabilidad en una campaña con su severidad y estado de confirmación.</p> </td> </tr> </table> ### 🔒 Pro: del hallazgo a la corrección (remediación automatizada, de pago) > 🔒 **Característica Pro de pago.** El motor de código abierto encuentra y demuestra vulnerabilidades. La remediación automatizada a pull requests solo está disponible en Darkmoon Pro. En el nivel Pro de pago, cada hallazgo fluye _hallazgo → corrección validada en sandbox → **pull request revisado por humanos, re-testeado contra el exploit original**_, y nunca se fusiona automáticamente. En nuestra ejecución de demostración con OWASP Juice Shop, el agente de remediación de Pro **corrigió hallazgos de extremo a extremo con un retest limpio del exploit en vivo** (una corrección solo cuenta cuando el exploit original se vuelve a ejecutar y se confirma cerrado). Consulta el [benchmark de remediación](https://dark-moon.org/remediation-benchmark/), la [documentación del agente de remediación](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) y los [57 PRs abiertos en 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> **▶️ Ver la demo (muestra el panel web de Darkmoon Pro)** </div> ### 🔒 Pro: despliega en cualquier cloud con un clic — sin caja, sin marketplace > 🔒 **Característica Pro de pago.** La edición de código abierto es la CLI mostrada arriba. El aprovisionamiento cloud con un clic viene con Darkmoon Pro (se requiere una clave de licencia Pro válida) y no forma parte de la build de código abierto. <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">"¿Venden una caja de hardware?" <b>No.</b> Un comando convierte cualquier VM en la nube en un appliance dedicado de Darkmoon <b>Pro</b> en tu propio tenancy — crea la máquina, abre el puerto del panel e instala todo por ti. <b>Sin hardware propietario, sin marketplace cloud, sin lock-in</b> — las mismas imágenes Docker empaquetadas se ejecutan en todas las nubes y en tu propio 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"> **[Guía de despliegue en la nube →](https://github.com/ASCIT31/darkmoon-cloud-deploy)** · [Docs](https://docs.dark-moon.org/#cloud-deployment) · [Appliance](https://dark-moon.org/appliance) </div> --- ## ¿Qué es DarkMoon? DarkMoon es una plataforma **open-source de pruebas de penetración con IA**. Apúntala a un objetivo que estés autorizado a probar y ejecuta toda la evaluación por sí sola: razona, planifica y despliega **50 agentes especialistas** que ejecutan operaciones ofensivas reales a través de una capa MCP controlada, y luego reporta cada vulnerabilidad con el comando exacto, la salida en bruto y la prueba que la respalda. No reemplaza al pentester. Elimina la parte repetitiva de una evaluación con evidencia, para que tus expertos dediquen su tiempo al criterio, no al trabajo mecánico. --- ## 📊 Benchmark: 57 vulnerabilidades reales en OWASP Juice Shop Ejecución **black-box** real y reproducible contra OWASP Juice Shop con un **modelo frontera en la nube (Anthropic Claude)**. DarkMoon también se ejecuta **totalmente en local** (Ollama / llama.cpp) detrás del Privacy Gateway — así nada sale de tu infraestructura; la cobertura con modelos locales depende del modelo que ejecutes. | Métrica | Resultado | |---|---| | Vulnerabilidades encontradas | **57** (8 críticas / 24 altas / 21 medias / 4 bajas) | | Tiempo real transcurrido | **28,5 min** | | Prueba de explotación | comando + salida en bruto por hallazgo | | LLM | Anthropic Claude (frontera en la nube); modelos locales soportados | Reprodúcelo y compara herramientas tú mismo: **[ASCIT31/Darkmoon-Benchmarks](https://github.com/ASCIT31/Darkmoon-Benchmarks)**. ## 🆚 Cómo se compara DarkMoon | | **DarkMoon** | strix | shannon | PentAGI | |---|:--:|:--:|:--:|:--:| | Se ejecuta con **LLM local** (los datos nunca salen) | ✅ | ❌ nube | ❌ nube | parcial | | Privacy Gateway (tokenización local) | ✅ | ❌ | ❌ | ❌ | | Active Directory + Kubernetes | ✅ | ❌ | ❌ | parcial | | Prueba de explotación | ✅ | ✅ | ✅ | ✅ | | Código abierto | ✅ GPL-3.0 | ✅ | ✅ | ✅ | *Recopilado de repositorios/docs públicos (2026-08); correcciones bienvenidas vía PR.* --- ## Cómo funciona DarkMoon opera como un orquestador estratégico de **agente de seguridad con IA** alineado con las metodologías ISO 27001, NIST SP 800-115 y MITRE ATT&CK. Cuando proporcionas un objetivo, la plataforma automáticamente: 1. 🔍 **Descubre** el entorno objetivo (puertos, servicios, protocolos) 2. 🧠 **Huella** la pila tecnológica (frameworks, CMS, APIs) 3. 🎯 **Modela** la superficie de ataque 4. 🚀 **Despliega** subagentes especializados según las tecnologías detectadas 5. 🔬 **Ejecuta** un bucle de **escaneo inteligente de vulnerabilidades** con adaptación reactiva 6. ✅ **Valida** los hallazgos con evidencia (peticiones, payloads, respuestas) 7. 📝 **Genera** un informe de auditoría estructurado ### Orquestación de subagentes DarkMoon selecciona y despliega dinámicamente agentes especializados según las tecnologías descubiertas: | Tecnología detectada | Agente activado | |---|---| | 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 inferencia LLM / IA (compatible con OpenAI, Ollama, vLLM, TGI) | Agente LLM | | Active Directory | Agente AD | | Kubernetes | Agente Kubernetes | | AWS, Azure, GCP | Agente de proveedor cloud | | Entra ID (identidad de Microsoft) | Agente de identidad | | GitHub, GitLab, Jenkins | Agente de SCM y CI/CD | | Terraform, Ansible | Agente de Infrastructure-as-Code | | Docker, registros de contenedores | Agente de contenedores | | HashiCorp Vault | Agente de secretos | | PostgreSQL, MySQL, MSSQL, Oracle | Agente de bases de datos | | Redis, RabbitMQ, Kafka, MQTT | Agente de mensajería y caché | | Firmware / imágenes IoT | Agente de firmware | | Navegador headless requerido | Agente de navegador headless | Múltiples agentes pueden ejecutarse **en paralelo** en arquitecturas híbridas. Los planos que requieren credenciales para ser significativos (cuentas cloud, CI/CD, almacenes de secretos, bases de datos, Active Directory, Kubernetes) **nunca se despliegan por inferencia**. Solo se activan cuando se encuentra un artefacto concreto (una clave, un token, un endpoint de metadatos accesible) o cuando los autorizas explícitamente, y en caso contrario se señalan en el informe. > **Nota:** Para la lista completa de agentes, su estructura, ciclo de vida y cómo crear agentes personalizados, consulta [Documentación completa, Agentes de IA](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents). ### Descripción general de la arquitectura ``` 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 ``` La IA razona y planifica. El MCP controla lo que se puede ejecutar. La Toolbox ejecuta herramientas aisladas dentro de Docker. **La IA nunca toca directamente el sistema**, esto es **seguridad por diseño**. > **Nota:** Para el desglose completo de la arquitectura (diagramas de despliegue, flujos de red, límites de seguridad), consulta [Documentación completa, Arquitectura](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture). --- ## Definición del alcance DarkMoon admite una definición flexible del alcance directamente desde la línea de comandos. **Pentest rápido (sin configuración):** ```bash ./darkmoon.sh "TARGET: http://172.19.0.3:3000" ``` **Modo bug bounty (los flags se activan automáticamente):** ```bash ./darkmoon.sh "TARGET: http://172.19.0.3:3000 PROGRAM=\"Juice Shop\" FOCUS=sqli,xss,idor NOISE=moderate FORMAT=h1" ``` Las flags clave incluyen `FOCUS`, `EXCLUDE`, `CREDS`, `TOKEN`, `NOISE`, `SEVERITY`, `FORMAT` y más, todas interpretadas de forma natural por la IA. > **Nota:** Para la referencia completa de flags, tipos de activos, sintaxis libre de EXCLUDE/FOCUS y alcance avanzado multiobjetivo, consulta [Documentación completa, Definición de alcance](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console). --- ## Caja de herramientas integrada DarkMoon incluye una imagen Docker creada específicamente que contiene **más de 140 herramientas de seguridad** compiladas y optimizadas en una compilación multietapa: | Categoría | Herramientas (ejemplos) | |---|---| | Escaneo de puertos | Naabu (descubrimiento), nmap (sondeos de servicios dirigidos) | | Escaneo web | Nuclei, ffuf, dirb, sqlmap, Arjun, wafw00f | | Reconocimiento y rastreo | Subfinder, Katana, Waybackurls, httpx | | CMS | WPScan, CMSeeK, WhatWeb | | Active Directory | NetExec, BloodHound, Impacket (más de 30 scripts) | | Kubernetes | kubectl, Kubescape, Kubeletctl, kube-bench, rbac-police | | CLIs de nube | aws, az, gcloud, gsutil, bq | | Bases de datos y caché | psql, mysql, redis-cli, sqlite3 | | Firmware / IoT | binwalk, unsquashfs, sasquatch, firmwalker | | Cracking | hashcat, john, 7z2john | | Red | Hydra, curl, dig, herramientas SNMP | | Navegador | Lightpanda (headless) | Todas las herramientas son accesibles directamente, sin necesidad de configurar rutas. > **Nota:** Para la lista completa de herramientas con detalles de instalación y cómo añadir nuevas herramientas, consulta [Documentación completa, Caja de herramientas](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox). --- ## 📖 Guía de documentación La [Documentación completa](https://github.com/ascit31/dark-moon/blob/master/docs/full.md) de DarkMoon cubre todo lo que necesitas para operar la plataforma. Aquí tienes una referencia rápida a las secciones más importantes: | Tema | Qué encontrarás | Enlace | |---|---|---| | **Configuración de GPU y controladores** | Solución de problemas de NVIDIA para Docker, WSL y Linux nativo | [Guía de GPU](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii2--darkmoon--gpu-troubleshooting-guide-official) | | **Variables de entorno** | Configuración del proveedor de LLM, claves de API, selección de modelo | [Configuración de entorno](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii3-configuration-of-environment-variables-in-docker-compose) | | **Inicio y compilación** | Comportamiento de install.sh, docker compose build, gestión del stack | [Compilación y lanzamiento](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii6-build-and-launch-darkmoon) | | **Alcance y flags** | Sintaxis de TARGET, modo bug bounty, FOCUS/EXCLUDE, credenciales | [Definición de alcance](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console) | | **Flujo de trabajo de evaluación** | Paso a paso: descubrimiento, fingerprinting, agentes, informes | [Motor de evaluación](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7d-how-to-use-the-darkmoon-assessment-engine) | | **Registros de sesión en tiempo real** | Supervisa en vivo los comandos ejecutados por el servidor MCP | [Registros de sesión](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7e-step-1--start-an-assessment) | | **Agentes de IA** | Estructura de los agentes, ciclo de vida, cómo crear o modificar agentes | [Agentes de IA](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents) | | **Arquitectura** | Diagramas de despliegue, límites de seguridad, flujo de ejecución | [Arquitectura](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture) | | **Caja de herramientas** | Lista completa de herramientas, cómo añadir herramientas, interioridades de la imagen Docker | [Caja de herramientas](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox) | | **Flujos de trabajo MCP** | Estructura de los flujos de trabajo, creación de flujos personalizados, buenas prácticas | [Flujos de trabajo MCP](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vii-mcp-workflows) | | **Lista de herramientas disponibles** | Tabla completa de 142 herramientas de seguridad con rutas y fuentes | [Lista de herramientas](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi10-toolbox-list) | | **Laboratorios de entrenamiento** | Laboratorios vulnerables recomendados para entrenar a DarkMoon | [Laboratorios de pentesting](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi11-bonus-pentester-lab-to-train-darkmoon) | | **Agente de remediación** (Pro) | Hallazgos → corrección validada en sandbox → pull request para revisión humana (nunca fusionado) | [Agente de remediación](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) | | **n8n (Pro)** | Nodo de la comunidad para lanzar un pentest, obtener hallazgos y revisar PRs de corrección desde un flujo de trabajo de n8n | [Nodo n8n](https://github.com/ascit31/dark-moon/blob/master/docs/n8n-integration.md) | --- ## Casos de uso DarkMoon está diseñado como una **plataforma versátil de pruebas de seguridad** para: - 🔒 **Equipos de seguridad**, ejecuta **pruebas de penetración automatizadas** continuas en toda tu infraestructura - ⚙️ **Pipelines de DevSecOps**, integra la **investigación de seguridad impulsada por IA** en flujos de trabajo CI/CD - 🎯 **Cazadores de bug bounty**, acelera el **hacking ético** con análisis autónomo de objetivos - 🔬 **Investigadores de seguridad**, explora superficies de ataque con una **plataforma de ciberseguridad con IA** que se adapta en tiempo real - 🎓 **Formación y educación**, aprende seguridad ofensiva con evaluaciones guiadas y reproducibles --- ## Ejemplos 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 más ejemplos de prompts, incluidos DVGA, Juice Shop y escenarios de navegador sin interfaz, consulta [Documentación completa, Ejemplos de prompts](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iii-uses). --- ## Contribuir DarkMoon es de código abierto y acepta contribuciones. Ya sea que quieras añadir nuevos agentes, integrar herramientas, crear flujos de trabajo o mejorar la documentación, consulta [CONTRIBUTING.md](https://github.com/ascit31/dark-moon/blob/master/CONTRIBUTING.md) para obtener las directrices. --- ## Licencia Este proyecto está licenciado bajo la **GNU General Public License v3.0**. Consulta [LICENSE](https://github.com/ascit31/dark-moon/blob/master/LICENSE) para más detalles. --- <div align="center"> **Creado por ASC-IT con 💚 para la comunidad global de seguridad** 🔒 Código abierto · 🤖 Impulsado por IA · 🇫🇷 Hecho en Francia [⭐ Danos una estrella en GitHub](https://github.com/ASCIT31/Dark-Moon) · [📖 Documentación completa](https://github.com/ascit31/dark-moon/blob/master/docs/full.md) · [▶️ Ver la demo (panel Pro)](https://youtu.be/zQE95bVLZgM) </div>
