Dark-Moon

¿Qué es DarkMoon?

DarkMoon es una herramienta automatizada de pruebas de penetración que orquesta evaluaciones de seguridad completas mediante agentes de seguridad de inteligencia artificial. Construida como una herramienta de ciberseguridad de código abierto, permite a las organizaciones ejecutar evaluaciones de vulnerabilidades de nivel profesional sin intervención manual.

En lugar de reemplazar al pentester, DarkMoon actúa como un sistema autónomo de pruebas de seguridad — razona, planifica y coordina agentes especializados que ejecutan operaciones reales de seguridad ofensiva a través de una capa de ejecución controlada.

Mira DarkMoon en acción — Demo completa de prueba de penetración autónoma

¿Por qué DarkMoon?

Las pruebas de penetración tradicionales son:

• ⏱️ Requieren mucho tiempo — las pruebas manuales tardan semanas
• 💰 Costosas — los consultores expertos cuestan miles al día
• 🔄 Inconsistentes — los resultados varían según la experiencia del evaluador
• 📊 Difíciles de escalar — limitadas por los recursos humanos

DarkMoon resuelve esto con pruebas de penetración con IA:

• 🤖 Pentesting impulsado por IA — agentes autónomos realizan evaluaciones de seguridad completas de principio a fin
• 🛡️ Seguridad por diseño — la IA nunca ejecuta herramientas directamente; todas las acciones fluyen a través de una interfaz MCP controlada
• 🕶️ Pasarela de privacidad (tokenización local reversible) — la IA nunca ve tus valores sensibles reales. Las IPs, nombres de host, dominios, URLs, correos electrónicos, credenciales y rutas internas se reemplazan por placeholders deterministas (IP_PRIVATE_001, …); los valores reales se inyectan localmente, justo antes de que se ejecute una herramienta, y se enmascaran de nuevo en cada resultado. Ningún dato sensible sale jamás de tu perímetro hacia el proveedor de LLM — usa el poder de Claude bajo estrictas restricciones de soberanía de datos. Los intentos de exfiltración se bloquean.
• ♾️ Automatización de pentesting para CI/CD — ejecuta pruebas de seguridad automatizadas después del build para detectar vulnerabilidades críticas antes de producción
• 🔧 Más de 50 herramientas integradas — un completo conjunto de herramientas de pruebas de penetración (Nuclei, NetExec, BloodHound, sqlmap, Naabu, httpx, ffuf, y más)
• 📈 Metodología multiagente adaptativa — agentes especializados para Web, Active Directory, Kubernetes, Red, CMS, y más
• 📝 Automatización de informes de vulnerabilidades — informes estructurados basados en evidencia generados automáticamente

Perfecto para equipos de seguridad, ingenieros DevSecOps, profesionales del hacking ético y organizaciones de todos los tamaños.

Inicio rápido

Requisitos previos

• Docker y Docker Compose
• Una clave de API de LLM (OpenRouter, Anthropic, OpenAI, o modelos locales)

Nota: La configuración de GPU, la resolución de problemas de los controladores NVIDIA y la configuración avanzada del entorno se cubren en la Documentación completa — Solución de problemas de GPU.

Instalación

1. Clona el repositorio

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

2. Configura tu proveedor de LLM

install.sh gestiona la configuración del proveedor de forma interactiva — no es necesario editar 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

Compatibilidad con proveedores en la nube (Anthropic, OpenAI, OpenRouter…) y modelos locales (Ollama, llama.cpp).

Nota: Para obtener detalles completos sobre las variables de entorno y la configuración de modelos locales, consulta la Documentación completa — Variables de entorno.

3. Compila e inicia

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

4. Ejecuta tu primera evaluación

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

5. Supervisa en tiempo real

./darkmoon.sh --log <session_id>

Nota: Los registros de sesión en tiempo real muestran cada comando ejecutado por el servidor MCP. Consulta Documentación completa — Registros de sesión para obtener más detalles.

Cómo funciona

DarkMoon opera como un orquestador estratégico de agentes 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 del objetivo (puertos, servicios, protocolos)
2. 🧠 Identifica 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 despacha dinámicamente agentes especializados según las tecnologías descubiertas:

Múltiples agentes pueden ejecutarse en paralelo en arquitecturas híbridas.

Nota: Para obtener la lista completa de agentes, su estructura, ciclo de vida y cómo crear agentes personalizados, consulta Documentación completa — Agentes de IA.

Descripción general de la arquitectura

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

La IA razona y planifica. El MCP controla qué se puede ejecutar. El Toolbox ejecuta herramientas aisladas dentro de Docker. La IA nunca toca el sistema directamente — 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.

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):

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

Modo bug bounty (las flags se activan automáticamente):

./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 el alcance avanzado multiobjetivo, consulta Documentación completa — Definición del alcance.

Toolbox integrado

DarkMoon incluye una imagen Docker creada a medida que contiene más de 50 herramientas de seguridad compiladas y optimizadas mediante un build de múltiples etapas:

Todas las herramientas son directamente accesibles — no se necesita configuración de rutas.

Nota: Para la lista completa de herramientas con detalles de instalación y cómo añadir nuevas herramientas, consulta Documentación completa — Toolbox.

📖 Guía de documentación

La Documentación completa de DarkMoon cubre todo lo que necesitas para operar la plataforma. Aquí tienes una referencia rápida a las secciones más importantes:

Casos de uso

DarkMoon está diseñado como una versátil plataforma de pruebas de seguridad para:

• 🔒 Equipos de seguridad — ejecuta pruebas de penetración automatizadas continuas en toda tu infraestructura
• ⚙️ Pipelines DevSecOps — integra investigación de seguridad impulsada por IA en los flujos de trabajo de 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

# 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 con navegador headless, consulta Documentación completa — Ejemplos de prompts.

Contribuciones

DarkMoon es de código abierto y agradece las contribuciones. Ya sea que quieras añadir nuevos agentes, integrar herramientas, crear flujos de trabajo o mejorar la documentación — consulta CONTRIBUTING.md para conocer las directrices.

Licencia

Este proyecto está licenciado bajo la GNU General Public License v3.0. Consulta LICENSE para más detalles.