Motore di pentesting AI autonomo, sicurezza offensiva continua su web, cloud, AD e Kubernetes. Ragionamento agentico + esecuzione reale di exploit producono vulnerabilità basate su prove. Gateway di privacy: l'LLM non vede mai i tuoi IP, host, credenziali o percorsi reali (segnaposto deterministici reidratati localmente), nulla esce dal tuo perimetro.
<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 è il penetration testing autonomo basato su AI per la tua infrastruttura.** Puntalo verso un target autorizzato e conduce l'intera valutazione da solo, poi documenta ogni risultato con il comando esatto e l'output grezzo. - 🟢 **Davvero open source.** GPLv3 e self-hosted, la metodologia di ogni agente è semplice Markdown che puoi leggere, confrontare e forkare. - 🎯 **Trova E dimostra.** Ogni vulnerabilità è accompagnata dal comando esatto e dall'output grezzo (lo sfruttamento è asserito dall'agente; il retest di remediation di Pro è il passo verificato dalla macchina), quindi non c'è quasi nulla da triage. - 🔒 **Funziona su un LLM locale + Privacy Gateway.** Il gateway tokenizza localmente i tuoi IP, host e credenziali reali, così il modello ragiona su segnaposto mentre i valori reali restano nel tuo perimetro. - 🧩 **Ovunque tu sviluppi.** Eseguilo da GitHub, GitLab, Jenkins, VS Code, JetBrains, n8n, Grafana o Splunk — l'edizione open source funziona con quelli basati su CLI. [Vedi le integrazioni ↓](#-darkmoon-everywhere) --- <div align="center"> ## Guarda il motore open source (CLI) Darkmoon open source è uno strumento da riga di comando. Questo è ciò che ottieni clonando il repository. Avvii una valutazione dalla riga di comando e osservi ogni agente, comando e risultato scorrere in tempo reale. </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>Avvia un'esecuzione dalla CLI.</b> Una riga <code>TARGET</code> e DarkMoon si assume l'intera valutazione.</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>Gli agenti autonomi ragionano e sfruttano, in diretta nel tuo terminale.</b> Qui un sotto-agente segnala CVE-2019-9978 e passa direttamente allo sfruttamento.</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>Recon e modello dell'ambiente.</b> DarkMoon identifica lo stack e conferma la superficie d'attacco prima di colpire.</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>Stream MCP in diretta.</b> Ogni comando eseguito dall'agente e il suo output grezzo, con timestamp, tramite <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>Dal segnale all'invio dell'agente.</b> DarkMoon decide quali agenti specialistici impiegare in base esattamente a ciò che rileva sul target.</p> **Come riportato in** [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 il tuo provider LLM in modo interattivo (non è necessario modificare `docker-compose.yml`) e compila l'intero stack: ```bash ./install.sh # skip form if .opencode.env already configured ./install.sh --init # force reconfiguration (cloud or local model) ./install.sh --help # show usage ``` Supporta **provider cloud** (Anthropic, OpenAI, OpenRouter…) e **modelli locali** (Ollama, llama.cpp). Poi avvia la tua prima valutazione e guardala in tempo reale: ```bash ./darkmoon.sh "TARGET: example.com" ./darkmoon.sh --log <session_id> ``` **Prerequisiti:** Docker e Docker Compose, e una chiave API LLM (o un modello locale). Configurazione GPU, variabili d'ambiente e il riferimento completo dei flag sono disponibili nella [Documentazione Completa](https://github.com/ascit31/dark-moon/blob/master/docs/full.md). --- ## Griglia delle funzionalità | | | |---|---| | 🧠 **50 agenti specializzati** | Un sistema agentico ragiona, pianifica e invia agenti specializzati su ogni superficie che scopre. | | 🌐 **Ogni superficie** | Web, API, Active Directory, Kubernetes, cloud (AWS, Azure, GCP), CI/CD, database, firmware IoT ed endpoint AI/LLM, concatenati end to end. | | 🔒 **Privacy Gateway** | La tokenizzazione locale reversibile trasforma IP, host, URL e credenziali reali in segnaposto deterministici, reidratati solo localmente nel momento in cui uno strumento viene eseguito. | | 🏠 **Modello locale** | Esegui l'intera valutazione su un LLM locale (Ollama, llama.cpp) così i valori della tua infrastruttura restano nel tuo perimetro. | | 🧾 **Evidenze, non punteggi** | Ogni finding viene fornito con il comando esatto e l'output grezzo; il retest Pro riesegue l'exploit per confermare la correzione. | | 🛡️ **Sicurezza by design** | L'AI non esegue mai un comando direttamente, ogni azione passa attraverso un'interfaccia MCP controllata e registrata. | | 🤖 **Pentest anche della tua AI** | Un agente LLM dedicato sonda gli endpoint di inferenza AI/LLM per l'OWASP LLM Top 10 con probe basati su garak. | | ♾️ **CI/CD nativo** | Attiva un pentest nella pipeline e ricevi i finding come artefatti. | | 🔌 **MCP** | Orchestra oltre 140 strumenti offensivi tramite MCP. | | 🔧 **Correggi (Pro)** | Il livello Pro a pagamento trasforma i finding in pull request revisionate da esseri umani, ritestate contro l'exploit originale. | Progettato per **team di sicurezza**, **ingegneri DevSecOps**, **red teamer** e professionisti dell'**ethical hacking**. --- ## 🧩 DarkMoon ovunque <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> Esegui DarkMoon dove già costruisci — in CI/CD, nel tuo IDE, nell'automazione e nel SecOps. Le integrazioni contrassegnate **OSS + Pro** funzionano con l'edizione open source (CLI locale + JSON); quelle solo Pro consumano l'API REST di [DarkMoon Pro](#-darkmoon-pro--paid-edition-web-dashboard-and-automated-remediation) (dashboard live, remediation→PR). | Piattaforma | Cosa fa | Ottienila | Edizione | Tutorial | |---|---|---|---|---| | **GitHub Actions** | Fa fallire la pipeline sui finding per severità | [GitHub Marketplace](https://github.com/marketplace/actions/darkmoon-pentest) | OSS + Pro | [▶ Guarda](https://youtu.be/e67klNk79vg) | | **GitLab CI/CD** | Finding come report Code Quality + SAST | [CI/CD Catalog](https://gitlab.com/explore/catalog/Dark-Moon-X/darkmoon-scan) | OSS + Pro | [▶ Guarda](https://youtu.be/ui7NHD41cMM) | | **Jenkins** | Finding come issue Warnings-NG nella build | [Plugin `.hpi` (Releases)](https://github.com/ASCIT31/darkmoon-jenkins/releases) | OSS + Pro | [▶ Guarda](https://youtu.be/G0TgyGpVLZ8) | | **VS Code** | Sfoglia e avvia valutazioni dall'editor | [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Darkmoon.darkmoon-vscode) | OSS + Pro | [▶ Guarda](https://youtu.be/GY7YOnYpteQ) | | **JetBrains** | Finding in una finestra strumenti dell'IDE | [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/34497-darkmoon) | OSS + Pro | [▶ Guarda](https://youtu.be/obUUrbTN3Jg) | | **n8n** | Automatizza campagne, retest e avvisi | [npm `n8n-nodes-darkmoon`](https://www.npmjs.com/package/n8n-nodes-darkmoon) | Pro | [▶ Guarda](https://youtu.be/3htg8kh7Dr8) | | **Grafana** | Dashboard di postura di sicurezza | [Self-host (Releases)](https://github.com/ASCIT31/darkmoon-grafana/releases) | Pro | [▶ Guarda](https://youtu.be/L7K-y0HPudk) | | **Splunk** | Ingestione SOC (HEC) + azione di avviso "Send to Darkmoon" | [App (Releases)](https://github.com/ASCIT31/darkmoon-splunk/releases) — Splunkbase in attesa | OSS + Pro | [▶ Guarda](https://youtu.be/8w2i8nEBdQQ) | | **SDK / CLI** | Costruisci la tua integrazione sul contratto condiviso | [npm `@darkmoon_ai/client`](https://www.npmjs.com/package/@darkmoon_ai/client) | OSS + Pro | [▶ Guarda](https://youtu.be/jMIMvV8yEK8) | Ogni integrazione emette **solo metadati sicuri** (severità, stato, MITRE, id) — mai evidenze, segreti o token. Guide complete su [docs.dark-moon.org](https://docs.dark-moon.org); sorgente sotto [ASCIT31](https://github.com/ASCIT31). --- ## 🔒 Darkmoon Pro — edizione a pagamento: dashboard web e remediation automatizzata > 🔒 **Queste sono funzionalità di Darkmoon Pro (a pagamento).** L'edizione open source è la CLI mostrata sopra; la dashboard web e la remediation automatizzata in pull request non sono nella build open source. Gli screenshot seguenti sono la dashboard web di **Darkmoon Pro a pagamento**. **Non** fanno parte del repository open source che cloni. L'edizione open source è lo strumento da riga di comando mostrato nella sezione precedente. <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 live.</b> Progetti, target e campagne a colpo d'occhio, con ogni finding suddiviso per severità.</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: finding con mappatura CVSS e ATT&CK.</b> Ogni finding porta con sé la mappatura CVSS, MITRE ATT&CK e ISO 27001 con uno stato <code>EXPLOITED</code> supportato da un exploit reale.</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: report web esportabili.</b> Un riepilogo gestionale in linguaggio semplice più dettagli tecnici completi, esportabile in 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: mappa orbitale della superficie d'attacco.</b> Un grafo 3D live di nodi, connessioni e vulnerabilità per nodo, con il percorso d'attacco MITRE attraversato su tutto il target, e **ogni finding collegato alla sua remediation proposta come pull request revisionata**. Renderizzato nel browser e in 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: esecuzioni ricorrenti pianificate.</b> Campagne automatizzate ricorrenti con FOCUS, severità e ricorrenza integrate nella 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 campagna.</b> Ogni vulnerabilità in una campagna con la sua severità e stato di conferma.</p> </td> </tr> </table> ### 🔒 Pro: dal finding alla correzione (remediation automatizzata, a pagamento) > 🔒 **Funzionalità Pro a pagamento.** Il motore open source trova e prova le vulnerabilità. La remediation automatizzata in pull request è disponibile solo in Darkmoon Pro. Nel livello Pro a pagamento, ogni finding segue il flusso _finding → fix validato in sandbox → **pull request revisionata da esseri umani, ritestata contro l'exploit originale**_, e non viene mai unita automaticamente. Nella nostra esecuzione demo su OWASP Juice Shop, l'agente di remediation Pro **ha corretto i finding end-to-end con un retest dell'exploit live pulito** (una correzione conta solo quando l'exploit originale viene rieseguito e confermato chiuso). Vedi il [benchmark di remediation](https://dark-moon.org/remediation-benchmark/), la [documentazione dell'agente di remediation](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) e le [57 PR aperte su 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> **▶️ Guarda la demo (mostra la dashboard web di Darkmoon Pro)** </div> ### 🔒 Pro: distribuisci su qualsiasi cloud con un clic — nessun box, nessun marketplace > 🔒 **Funzionalità Pro a pagamento.** L'edizione open source è la CLI mostrata sopra. Il provisioning cloud con un clic è incluso in Darkmoon Pro (è richiesta una chiave di licenza Pro valida) e non fa parte della 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">"Vendete un box hardware?" <b>No.</b> Un comando trasforma qualsiasi VM cloud in un'appliance Darkmoon <b>Pro</b> dedicata nel tuo tenant — crea la macchina, apre la porta della dashboard e installa tutto per te. <b>Nessun hardware proprietario, nessun cloud marketplace, nessun lock-in</b> — le stesse immagini Docker pacchettizzate girano su ogni cloud e sul tuo 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"> **[Guida al deployment su cloud →](https://github.com/ASCIT31/darkmoon-cloud-deploy)** · [Docs](https://docs.dark-moon.org/#cloud-deployment) · [Appliance](https://dark-moon.org/appliance) </div> --- ## Cos'è DarkMoon? DarkMoon è una piattaforma **open-source di AI penetration testing**. Puntala verso un target che sei autorizzato a testare e conduce l'intera valutazione in autonomia: ragiona, pianifica e invia **50 agenti specializzati** che eseguono reali operazioni offensive attraverso un livello MCP controllato, per poi riportare ogni vulnerabilità con il comando esatto, l'output grezzo e la prova a supporto. Non sostituisce il pentester. Elimina la parte ripetitiva di una valutazione con evidenze, così i tuoi esperti dedicano il loro tempo al giudizio, non alla fatica. --- ## 📊 Benchmark: 57 vulnerabilità reali su OWASP Juice Shop Esecuzione **black-box** reale e riproducibile contro OWASP Juice Shop con un **modello frontier cloud (Anthropic Claude)**. DarkMoon funziona anche **completamente in locale** (Ollama / llama.cpp) dietro il Privacy Gateway — così nulla esce dalla tua infrastruttura; la copertura con modelli locali dipende dal modello che esegui. | Metrica | Risultato | |---|---| | Vulnerabilità trovate | **57** (8 critiche / 24 alte / 21 medie / 4 basse) | | Tempo effettivo | **28,5 min** | | Proof-of-exploitation | comando + output grezzo per ogni finding | | LLM | Anthropic Claude (frontier cloud); modelli locali supportati | Riproducilo e confronta gli strumenti tu stesso: **[ASCIT31/Darkmoon-Benchmarks](https://github.com/ASCIT31/Darkmoon-Benchmarks)**. ## 🆚 Confronto tra DarkMoon e gli altri | | **DarkMoon** | strix | shannon | PentAGI | |---|:--:|:--:|:--:|:--:| | Funziona su **LLM locale** (i dati non escono mai) | ✅ | ❌ cloud | ❌ cloud | parziale | | Privacy Gateway (tokenizzazione locale) | ✅ | ❌ | ❌ | ❌ | | Active Directory + Kubernetes | ✅ | ❌ | ❌ | parziale | | Proof-of-exploitation | ✅ | ✅ | ✅ | ✅ | | Open source | ✅ GPL-3.0 | ✅ | ✅ | ✅ | *Compilato da repo/docs pubblici (2026-08); correzioni benvenute tramite PR.* --- ## Come funziona DarkMoon opera come orchestratore strategico di **AI security agent** allineato alle metodologie ISO 27001, NIST SP 800-115 e MITRE ATT&CK. Quando fornisci un target, la piattaforma automaticamente: 1. 🔍 **Scopre** l'ambiente target (porte, servizi, protocolli) 2. 🧠 **Identifica** lo stack tecnologico (framework, CMS, API) 3. 🎯 **Modella** la superficie d'attacco 4. 🚀 **Schiera** sotto-agenti specializzati in base alle tecnologie rilevate 5. 🔬 **Esegue** un ciclo di **scansione intelligente delle vulnerabilità** con adattamento reattivo 6. ✅ **Convalida** i risultati con evidenze (richieste, payload, risposte) 7. 📝 **Genera** un report di audit strutturato ### Orchestrazione dei sotto-agenti DarkMoon seleziona e invia dinamicamente agenti specializzati in base alle tecnologie rilevate: | Tecnologia rilevata | Agente attivato | |---|---| | WordPress, Drupal, Joomla, Magento, PrestaShop, Moodle | Agente specifico per CMS | | PHP, Node.js, Flask, ASP.NET, Spring Boot, Ruby on Rails, Go | Agente specifico per stack | | GraphQL | Agente GraphQL | | Endpoint LLM / inferenza AI (compatibile OpenAI, Ollama, vLLM, TGI) | Agente LLM | | Active Directory | Agente AD | | Kubernetes | Agente Kubernetes | | AWS, Azure, GCP | Agente cloud-provider | | Entra ID (identità Microsoft) | Agente Identity | | GitHub, GitLab, Jenkins | Agente SCM & CI/CD | | Terraform, Ansible | Agente Infrastructure-as-Code | | Docker, registry di container | Agente Container | | HashiCorp Vault | Agente Secrets | | PostgreSQL, MySQL, MSSQL, Oracle | Agente Database | | Redis, RabbitMQ, Kafka, MQTT | Agente Messaging & cache | | Firmware / immagini IoT | Agente Firmware | | Browser headless richiesto | Agente Headless browser | Più agenti possono essere eseguiti **in parallelo** su architetture ibride. I piani che richiedono credenziali per essere significativi (account cloud, CI/CD, secret store, database, Active Directory, Kubernetes) **non vengono mai inviati per inferenza**. Si attivano solo quando viene trovato un artefatto concreto (una chiave, un token, un endpoint di metadata raggiungibile) o quando li autorizzi esplicitamente, e in caso contrario vengono segnalati nel report. > **Nota:** Per l'elenco completo degli agenti, la loro struttura, il ciclo di vita e come creare agenti personalizzati, consulta [Full Documentation, AI Agents](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents). ### Panoramica dell'architettura ``` 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 ``` L'IA ragiona e pianifica. L'MCP controlla ciò che può essere eseguito. La Toolbox esegue strumenti isolati all'interno di Docker. **L'IA non tocca mai direttamente il sistema**, questa è **sicurezza by design**. > **Nota:** Per l'analisi completa dell'architettura (diagrammi di deployment, flussi di rete, confini di sicurezza), consulta [Documentazione completa, Architettura](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture). --- ## Definizione dello Scope DarkMoon supporta una definizione flessibile dello scope direttamente dalla riga di comando. **Pentest rapido (zero config):** ```bash ./darkmoon.sh "TARGET: http://172.19.0.3:3000" ``` **Modalità bug bounty (i flag si attivano automaticamente):** ```bash ./darkmoon.sh "TARGET: http://172.19.0.3:3000 PROGRAM=\"Juice Shop\" FOCUS=sqli,xss,idor NOISE=moderate FORMAT=h1" ``` I flag principali includono `FOCUS`, `EXCLUDE`, `CREDS`, `TOKEN`, `NOISE`, `SEVERITY`, `FORMAT` e altri, tutti interpretati naturalmente dall'IA. > **Nota:** Per il riferimento completo dei flag, i tipi di asset, la sintassi libera di EXCLUDE/FOCUS e lo scoping avanzato multi-target, consulta [Documentazione Completa, Definizione dello Scope](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console). --- ## Toolbox Integrata DarkMoon viene distribuito con un'immagine Docker appositamente creata che contiene **oltre 140 strumenti di sicurezza** compilati e ottimizzati in una build multi-stage: | Categoria | Strumenti (esempi) | |---|---| | Scansione porte | Naabu (discovery), nmap (sonde di servizio mirate) | | Scansione web | Nuclei, ffuf, dirb, sqlmap, Arjun, wafw00f | | Recon & crawling | Subfinder, Katana, Waybackurls, httpx | | CMS | WPScan, CMSeeK, WhatWeb | | Active Directory | NetExec, BloodHound, Impacket (oltre 30 script) | | Kubernetes | kubectl, Kubescape, Kubeletctl, kube-bench, rbac-police | | CLI cloud | aws, az, gcloud, gsutil, bq | | Database & cache | psql, mysql, redis-cli, sqlite3 | | Firmware / IoT | binwalk, unsquashfs, sasquatch, firmwalker | | Cracking | hashcat, john, 7z2john | | Rete | Hydra, curl, dig, strumenti SNMP | | Browser | Lightpanda (headless) | Tutti gli strumenti sono direttamente accessibili, senza necessità di configurare i path. > **Nota:** Per l'elenco completo degli strumenti con i dettagli di installazione e come aggiungere nuovi strumenti, consulta [Documentazione Completa, Toolbox](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox). --- ## 📖 Guida alla Documentazione La [Documentazione Completa](https://github.com/ascit31/dark-moon/blob/master/docs/full.md) di DarkMoon copre tutto ciò che serve per utilizzare la piattaforma. Ecco un riferimento rapido alle sezioni più importanti: | Argomento | Cosa Troverai | Link | |---|---|---| | **Configurazione GPU & Driver** | Risoluzione dei problemi NVIDIA per Docker, WSL e Linux nativo | [Guida GPU](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii2--darkmoon--gpu-troubleshooting-guide-official) | | **Variabili d'Ambiente** | Configurazione del provider LLM, chiavi API, selezione del modello | [Configurazione Ambiente](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii3-configuration-of-environment-variables-in-docker-compose) | | **Avvio & Build** | Comportamento di install.sh, docker compose build, gestione dello stack | [Build & Avvio](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii6-build-and-launch-darkmoon) | | **Scope & Flag** | Sintassi TARGET, modalità bug bounty, FOCUS/EXCLUDE, credenziali | [Definizione dello Scope](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console) | | **Flusso di Assessment** | Passo dopo passo: discovery, fingerprinting, agenti, reporting | [Motore di Assessment](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7d-how-to-use-the-darkmoon-assessment-engine) | | **Log di Sessione in Tempo Reale** | Monitora in diretta i comandi eseguiti dal server MCP | [Log di Sessione](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7e-step-1--start-an-assessment) | | **Agenti IA** | Struttura degli agenti, ciclo di vita, come creare o modificare agenti | [Agenti IA](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents) | | **Architettura** | Diagrammi di deployment, confini di sicurezza, flusso di esecuzione | [Architettura](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture) | | **Toolbox** | Elenco completo degli strumenti, aggiunta di strumenti, interni dell'immagine Docker | [Toolbox](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox) | | **Workflow MCP** | Struttura dei workflow, creazione di workflow personalizzati, best practice | [Workflow MCP](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vii-mcp-workflows) | | **Elenco Strumenti Disponibili** | Tabella completa dei 142 strumenti di sicurezza con path e sorgenti | [Elenco Strumenti](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi10-toolbox-list) | | **Laboratori di Formazione** | Laboratori vulnerabili consigliati per addestrare DarkMoon | [Laboratori Pentester](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi11-bonus-pentester-lab-to-train-darkmoon) | | **Agente di Remediation** (Pro) | Risultati → fix validato in sandbox → pull request per revisione umana (mai unita) | [Agente di Remediation](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) | | **n8n (Pro)** | Nodo community per avviare un pentest, recuperare i risultati e revisionare le PR di fix da un workflow n8n | [Nodo n8n](https://github.com/ascit31/dark-moon/blob/master/docs/n8n-integration.md) | --- ## Casi d'Uso DarkMoon è progettato come una versatile **piattaforma di security testing** per: - 🔒 **Team di sicurezza**, esegui **penetration testing automatizzato** continuo sulla tua infrastruttura - ⚙️ **Pipeline DevSecOps**, integra la **ricerca di sicurezza guidata dall'IA** nei workflow CI/CD - 🎯 **Bug bounty hunter**, accelera l'**ethical hacking** con l'analisi autonoma dei target - 🔬 **Ricercatori di sicurezza**, esplora le superfici di attacco con una **piattaforma di cybersecurity IA** che si adatta in tempo reale - 🎓 **Formazione & didattica**, impara la sicurezza offensiva con assessment guidati e riproducibili --- ## Prompt di Esempio ```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:** Per ulteriori esempi di prompt, inclusi DVGA, Juice Shop e scenari con browser headless, consulta [Documentazione completa, Esempi di prompt](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iii-uses). --- ## Contribuire DarkMoon è open source e accoglie contributi. Che tu voglia aggiungere nuovi agenti, integrare strumenti, creare workflow o migliorare la documentazione, consulta [CONTRIBUTING.md](https://github.com/ascit31/dark-moon/blob/master/CONTRIBUTING.md) per le linee guida. --- ## Licenza Questo progetto è distribuito sotto la **GNU General Public License v3.0**. Consulta [LICENSE](https://github.com/ascit31/dark-moon/blob/master/LICENSE) per i dettagli. --- <div align="center"> **Creato da ASC-IT con 💚 per la comunità globale della sicurezza** 🔒 Open Source · 🤖 Basato su AI · 🇫🇷 Made in France [⭐ Mettici una stella su GitHub](https://github.com/ASCIT31/Dark-Moon) · [📖 Documentazione completa](https://github.com/ascit31/dark-moon/blob/master/docs/full.md) · [▶️ Guarda la demo (dashboard Pro)](https://youtu.be/zQE95bVLZgM) </div>
