Autonome KI-Pentesting-Engine für kontinuierliche offensive Sicherheit über Web, Cloud, AD und Kubernetes. Agentisches Denken + echte Exploit-Ausführung liefern beweisbasierte Schwachstellen. Privacy-Gateway: Das LLM sieht nie Ihre echten IPs, Hosts, Zugangsdaten oder Pfade (deterministische Platzhalter werden lokal wiederhergestellt), nichts verlässt Ihre Umgebung.
<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 — autonomes KI-Penetrationstesting auf einem lokalen Modell" width="100%" /> </a> # DarkMoon ### Open-Source autonomes KI-Penetrationstesting — findet, exploitet und qualifiziert jede Schwachstelle in deiner eigenen Infrastruktur <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 ist autonomes KI-Penetrationstesting für deine eigene Infrastruktur.** Richte es auf ein autorisiertes Ziel und es führt die gesamte Bewertung selbstständig durch und dokumentiert anschließend jeden Fund mit dem exakten Befehl und der Rohausgabe. - 🟢 **Wirklich Open Source.** GPLv3 und selbst gehostet, die Methodik jedes Agenten ist reines Markdown, das du lesen, diffen und forken kannst. - 🎯 **Findet UND beweist.** Jede Schwachstelle wird mit dem exakten Befehl und der Rohausgabe geliefert (die Ausnutzung wird vom Agenten behauptet; der Pro-Remediation-Retest ist der maschinell verifizierte Schritt), sodass es fast nichts zu triagieren gibt. - 🔒 **Läuft auf einem lokalen LLM + Privacy Gateway.** Das Gateway tokenisiert deine echten IPs, Hosts und Zugangsdaten lokal, sodass das Modell auf Platzhaltern arbeitet, während die echten Werte in deinem Perimeter bleiben. - 🧩 **Überall, wo du baust.** Führe es aus GitHub, GitLab, Jenkins, VS Code, JetBrains, n8n, Grafana oder Splunk aus — die Open-Source-Edition funktioniert mit den CLI-basierten. [Siehe die Integrationen ↓](#-darkmoon-everywhere) --- <div align="center"> ## Sieh dir die Open-Source-Engine an (CLI) Das Open-Source-Darkmoon ist ein Kommandozeilenwerkzeug. Das bekommst du, wenn du das Repo klonst. Du startest eine Bewertung von der Kommandozeile aus und siehst jeden Agenten, jeden Befehl und jeden Fund in Echtzeit vorbeiströmen. </div> <table> <tr> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/start-assesment.png" alt="Starten einer DarkMoon-Bewertung von der Kommandozeile mit einer einzigen TARGET-Zeile" /> <p align="center"><b>Starte einen Lauf von der CLI.</b> Eine <code>TARGET</code>-Zeile und DarkMoon übernimmt die gesamte Bewertung.</p> </td> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/sub-agent-1.png" alt="Eine DarkMoon-Sub-Agent-Zustandsmaschine im Terminal, die CVE-2019-9978 erkennt und direkt zur Ausnutzung übergeht" /> <p align="center"><b>Autonome Agenten argumentieren und exploiten, live in deinem Terminal.</b> Hier markiert ein Sub-Agent CVE-2019-9978 und schwenkt direkt zur Ausnutzung.</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- und Umgebungsmodell-Zusammenfassung im Terminal" /> <p align="center"><b>Recon und Umgebungsmodell.</b> DarkMoon fingerprintet den Stack und bestätigt die Angriffsfläche, bevor es zuschlägt.</p> </td> <td width="50%" valign="top"> <img src="https://raw.githubusercontent.com/ascit31/dark-moon/master/docs/pics/log.png" alt="Live-MCP-Ausgabestream im Terminal mit zeitgestempelten Befehlen und Rohantworten" /> <p align="center"><b>Live-MCP-Stream.</b> Jeder Befehl, den der Agent ausführt, und seine Rohausgabe, zeitgestempelt, mit <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="Signalerkennungsmatrix im Terminal, die erkannte Technologien den von DarkMoon entsandten Agenten zuordnet" width="80%" /> <p><b>Signal-zu-Agent-Dispatch.</b> DarkMoon entscheidet anhand dessen, was es genau auf dem Ziel erkennt, welche Spezialisten-Agenten es einsetzt.</p> **Vorgestellt 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` konfiguriert Ihren LLM-Anbieter interaktiv (keine Bearbeitung von `docker-compose.yml` erforderlich) und erstellt den vollständigen 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 ``` Unterstützt **Cloud-Anbieter** (Anthropic, OpenAI, OpenRouter…) und **lokale Modelle** (Ollama, llama.cpp). Führe dann deine erste Bewertung durch und beobachte sie live: ```bash ./darkmoon.sh "TARGET: example.com" ./darkmoon.sh --log <session_id> ``` **Voraussetzungen:** Docker & Docker Compose und ein LLM-API-Schlüssel (oder ein lokales Modell). GPU-Setup, Umgebungsvariablen und die vollständige Flags-Referenz findest du in der [Vollständigen Dokumentation](https://github.com/ascit31/dark-moon/blob/master/docs/full.md). --- ## Funktionsübersicht | | | |---|---| | 🧠 **50 Spezialagenten** | Ein agentisches System analysiert, plant und entsendet Spezialagenten über jede Oberfläche, die es entdeckt. | | 🌐 **Jede Oberfläche** | Web, APIs, Active Directory, Kubernetes, Cloud (AWS, Azure, GCP), CI/CD, Datenbanken, IoT-Firmware und KI/LLM-Endpunkte, Ende-zu-Ende verkettet. | | 🔒 **Privacy Gateway** | Reversible lokale Tokenisierung verwandelt echte IPs, Hosts, URLs und Zugangsdaten in deterministische Platzhalter, die nur lokal in dem Moment rehydriert werden, in dem ein Tool ausgeführt wird. | | 🏠 **Lokales Modell** | Führe die gesamte Bewertung auf einem lokalen LLM (Ollama, llama.cpp) aus, damit deine Infrastrukturwerte innerhalb deines eigenen Perimeters bleiben. | | 🧾 **Belege, keine Scores** | Jeder Fund wird mit dem exakten Befehl und der Rohausgabe geliefert; der Pro-Retest führt den Exploit erneut aus, um einen Fix zu bestätigen. | | 🛡️ **Security by Design** | Die KI führt niemals direkt einen Befehl aus, jede Aktion läuft über eine kontrollierte, protokollierte MCP-Schnittstelle. | | 🤖 **Pentestet auch deine KI** | Ein dedizierter LLM-Agent prüft KI/LLM-Inferenz-Endpunkte auf die OWASP LLM Top 10 mit garak-gestützten Probes. | | ♾️ **CI/CD-nativ** | Löse einen Pentest in der Pipeline aus und erhalte die Funde als Artefakte zurück. | | 🔌 **MCP** | Orchestriere über 140 offensive Tools über MCP. | | 🔧 **Behebe es (Pro)** | Die kostenpflichtige Pro-Stufe verwandelt Funde in von Menschen geprüfte Pull Requests, die gegen den ursprünglichen Exploit erneut getestet werden. | Gebaut für **Security-Teams**, **DevSecOps-Ingenieure**, **Red Teamer** und **Ethical-Hacking**-Profis. --- ## 🧩 DarkMoon überall <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> Betreibe DarkMoon dort, wo du bereits baust — in CI/CD, deiner IDE, Automatisierung und SecOps. Integrationen, die mit **OSS + Pro** markiert sind, funktionieren mit der Open-Source-Edition (lokale CLI + JSON); die reinen Pro-Integrationen nutzen die [DarkMoon Pro](#-darkmoon-pro--paid-edition-web-dashboard-and-automated-remediation) REST-API (Live-Dashboard, Remediation→PR). | Plattform | Was es tut | Bezug | Edition | Tutorial | |---|---|---|---|---| | **GitHub Actions** | Pipeline bei Funden nach Schweregrad fehlschlagen lassen | [GitHub Marketplace](https://github.com/marketplace/actions/darkmoon-pentest) | OSS + Pro | [▶ Ansehen](https://youtu.be/e67klNk79vg) | | **GitLab CI/CD** | Funde als Code Quality + SAST-Berichte | [CI/CD Catalog](https://gitlab.com/explore/catalog/Dark-Moon-X/darkmoon-scan) | OSS + Pro | [▶ Ansehen](https://youtu.be/ui7NHD41cMM) | | **Jenkins** | Funde als Warnings-NG-Issues im Build | [Plugin `.hpi` (Releases)](https://github.com/ASCIT31/darkmoon-jenkins/releases) | OSS + Pro | [▶ Ansehen](https://youtu.be/G0TgyGpVLZ8) | | **VS Code** | Bewertungen aus dem Editor durchsuchen und starten | [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Darkmoon.darkmoon-vscode) | OSS + Pro | [▶ Ansehen](https://youtu.be/GY7YOnYpteQ) | | **JetBrains** | Funde in einem IDE-Tool-Fenster | [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/34497-darkmoon) | OSS + Pro | [▶ Ansehen](https://youtu.be/obUUrbTN3Jg) | | **n8n** | Kampagnen, Retests und Alarme automatisieren | [npm `n8n-nodes-darkmoon`](https://www.npmjs.com/package/n8n-nodes-darkmoon) | Pro | [▶ Ansehen](https://youtu.be/3htg8kh7Dr8) | | **Grafana** | Security-Posture-Dashboards | [Self-host (Releases)](https://github.com/ASCIT31/darkmoon-grafana/releases) | Pro | [▶ Ansehen](https://youtu.be/L7K-y0HPudk) | | **Splunk** | SOC-Ingestion (HEC) + „Send to Darkmoon"-Alarmaktion | [App (Releases)](https://github.com/ASCIT31/darkmoon-splunk/releases) — Splunkbase ausstehend | OSS + Pro | [▶ Ansehen](https://youtu.be/8w2i8nEBdQQ) | | **SDK / CLI** | Baue deine eigene Integration auf dem gemeinsamen Vertrag | [npm `@darkmoon_ai/client`](https://www.npmjs.com/package/@darkmoon_ai/client) | OSS + Pro | [▶ Ansehen](https://youtu.be/jMIMvV8yEK8) | Jede Integration sendet **nur sichere Metadaten** (Schweregrad, Status, MITRE, IDs) — niemals Belege, Secrets oder Tokens. Vollständige Anleitungen auf [docs.dark-moon.org](https://docs.dark-moon.org); Quellcode unter [ASCIT31](https://github.com/ASCIT31). --- ## 🔒 Darkmoon Pro — kostenpflichtige Edition: Web-Dashboard und automatisierte Remediation > 🔒 **Dies sind Darkmoon Pro-Funktionen (kostenpflichtig).** Die Open-Source-Edition ist die oben gezeigte CLI; das Web-Dashboard und die automatisierte Remediation zu Pull Requests sind nicht im Open-Source-Build enthalten. Die folgenden Screenshots zeigen das **kostenpflichtige Darkmoon Pro**-Web-Dashboard. Sie sind **nicht** Teil des Open-Source-Repositorys, das du klonst. Die Open-Source-Edition ist das im obigen Abschnitt gezeigte Kommandozeilen-Tool. <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: Live-Web-Dashboard.</b> Projekte, Ziele und Kampagnen auf einen Blick, mit jedem Fund nach Schweregrad gruppiert.</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: Funde mit CVSS- und ATT&CK-Mapping.</b> Jeder Fund trägt CVSS-, MITRE ATT&CK- und ISO 27001-Mapping mit einem <code>EXPLOITED</code>-Status, gestützt auf einen echten Exploit.</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: exportierbare Web-Berichte.</b> Eine Management-Zusammenfassung in klarer Sprache plus vollständige technische Details, exportierbar nach Markdown und 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: orbitale Angriffsflächen-Karte.</b> Ein lebendiger 3D-Graph aus Knoten, Verbindungen und Schwachstellen pro Knoten, mit dem MITRE-Angriffspfad, der über das gesamte Ziel hinweg durchlaufen wird, und **jedem Fund, der mit seiner vorgeschlagenen Remediation als geprüfter Pull Request verknüpft ist**. Wird im Browser und in VR gerendert.</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: geplante wiederkehrende Läufe.</b> Wiederkehrende automatisierte Kampagnen mit FOCUS, Schweregrad und Wiederholung direkt im Web-Dashboard.</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: Kampagnenansicht.</b> Jede Schwachstelle in einer Kampagne mit ihrem Schweregrad und Bestätigungsstatus.</p> </td> </tr> </table> ### 🔒 Pro: vom Fund zum Fix (automatisierte Remediation, kostenpflichtig) > 🔒 **Kostenpflichtige Pro-Funktion.** Die Open-Source-Engine findet und beweist Schwachstellen. Die automatisierte Remediation in Pull Requests ist nur in Darkmoon Pro verfügbar. In der kostenpflichtigen Pro-Stufe durchläuft jeder Fund _Fund → sandbox-validierter Fix → **von Menschen geprüfter Pull Request, erneut getestet gegen den ursprünglichen Exploit**_ und wird niemals automatisch gemergt. In unserem OWASP Juice Shop-Demolauf hat der Pro-Remediation-Agent **Funde Ende-zu-Ende mit einem sauberen Live-Exploit-Retest behoben** (ein Fix zählt nur, wenn der ursprüngliche Exploit erneut ausgeführt und als geschlossen bestätigt wird). Siehe den [Remediation-Benchmark](https://dark-moon.org/remediation-benchmark/), die [Remediation-Agent-Dokumentation](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) und die [57 offenen PRs auf 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> **▶️ Sieh dir die Demo an (zeigt das Darkmoon Pro-Web-Dashboard)** </div> ### 🔒 Pro: In jeder Cloud mit einem Klick bereitstellen — keine Box, kein Marketplace > 🔒 **Kostenpflichtige Pro-Funktion.** Die Open-Source-Edition ist die oben gezeigte CLI. Die Ein-Klick-Cloud-Bereitstellung ist Teil von Darkmoon Pro (ein gültiger Pro-Lizenzschlüssel ist erforderlich) und nicht Teil des Open-Source-Builds. <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">„Verkauft ihr eine Hardware-Box?" <b>Nein.</b> Ein Befehl verwandelt jede Cloud-VM in eine dedizierte Darkmoon <b>Pro</b>-Appliance in deinem eigenen Tenancy — er erstellt die Maschine, öffnet den Dashboard-Port und installiert alles für dich. <b>Keine proprietäre Hardware, kein Cloud-Marketplace, kein Lock-in</b> — dieselben paketierten Docker-Images laufen auf jeder Cloud und auf deiner eigenen Bare-Metal-Hardware.</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"> **[Cloud-Deployment-Anleitung →](https://github.com/ASCIT31/darkmoon-cloud-deploy)** · [Docs](https://docs.dark-moon.org/#cloud-deployment) · [Appliance](https://dark-moon.org/appliance) </div> --- ## Was ist DarkMoon? DarkMoon ist eine **Open-Source-Plattform für KI-gestütztes Penetration Testing**. Richte sie auf ein Ziel aus, das du testen darfst, und sie führt die gesamte Bewertung eigenständig durch: Sie analysiert, plant und entsendet **50 spezialisierte Agenten**, die echte offensive Operationen über eine kontrollierte MCP-Schicht ausführen, und meldet anschließend jede Schwachstelle mit dem exakten Befehl, der Rohausgabe und dem dahinterstehenden Nachweis. Sie ersetzt nicht den Pentester. Sie übernimmt den repetitiven Teil einer Bewertung mit Belegen, damit deine Experten ihre Zeit für Urteilsvermögen statt für Routinearbeit aufwenden. --- ## 📊 Benchmark: 57 echte Schwachstellen in OWASP Juice Shop Echter, reproduzierbarer **Black-Box**-Lauf gegen OWASP Juice Shop mit einem **Cloud-Frontier-Modell (Anthropic Claude)**. DarkMoon läuft auch **vollständig lokal** (Ollama / llama.cpp) hinter dem Privacy Gateway — so verlässt nichts deine Infrastruktur; die Abdeckung durch lokale Modelle hängt vom verwendeten Modell ab. | Metrik | Ergebnis | |---|---| | Gefundene Schwachstellen | **57** (8 kritisch / 24 hoch / 21 mittel / 4 niedrig) | | Wanduhrzeit | **28,5 min** | | Ausnutzungsnachweis | Befehl + Rohausgabe pro Fund | | LLM | Anthropic Claude (Cloud-Frontier); lokale Modelle unterstützt | Reproduziere es und vergleiche Tools selbst: **[ASCIT31/Darkmoon-Benchmarks](https://github.com/ASCIT31/Darkmoon-Benchmarks)**. ## 🆚 Wie DarkMoon abschneidet | | **DarkMoon** | strix | shannon | PentAGI | |---|:--:|:--:|:--:|:--:| | Läuft auf **lokalem LLM** (Daten verlassen nie das System) | ✅ | ❌ Cloud | ❌ Cloud | teilweise | | Privacy Gateway (lokale Tokenisierung) | ✅ | ❌ | ❌ | ❌ | | Active Directory + Kubernetes | ✅ | ❌ | ❌ | teilweise | | Ausnutzungsnachweis | ✅ | ✅ | ✅ | ✅ | | Open Source | ✅ GPL-3.0 | ✅ | ✅ | ✅ | *Zusammengestellt aus öffentlichen Repos/Dokumentationen (2026-08); Korrekturen willkommen via PR.* --- ## Wie es funktioniert DarkMoon arbeitet als strategischer Orchestrator für **KI-Sicherheitsagenten**, ausgerichtet an ISO 27001, NIST SP 800-115 und MITRE ATT&CK-Methodologien. Wenn du ein Ziel angibst, führt die Plattform automatisch Folgendes aus: 1. 🔍 **Erkundet** die Zielumgebung (Ports, Dienste, Protokolle) 2. 🧠 **Fingerprintet** den Technologie-Stack (Frameworks, CMS, APIs) 3. 🎯 **Modelliert** die Angriffsfläche 4. 🚀 **Entsendet** spezialisierte Sub-Agenten basierend auf erkannten Technologien 5. 🔬 **Führt** eine Schleife zur **intelligenten Schwachstellensuche** mit reaktiver Anpassung aus 6. ✅ **Validiert** Funde mit Belegen (Requests, Payloads, Responses) 7. 📝 **Erstellt** einen strukturierten Audit-Bericht ### Sub-Agent-Orchestrierung DarkMoon wählt dynamisch spezialisierte Agenten aus und entsendet sie je nach den entdeckten Technologien: | Erkannte Technologie | Ausgelöster Agent | |---|---| | WordPress, Drupal, Joomla, Magento, PrestaShop, Moodle | CMS-spezifischer Agent | | PHP, Node.js, Flask, ASP.NET, Spring Boot, Ruby on Rails, Go | Stack-spezifischer Agent | | GraphQL | GraphQL-Agent | | LLM / KI-Inferenz-Endpunkt (OpenAI-kompatibel, Ollama, vLLM, TGI) | LLM-Agent | | Active Directory | AD-Agent | | Kubernetes | Kubernetes-Agent | | AWS, Azure, GCP | Cloud-Provider-Agent | | Entra ID (Microsoft-Identität) | Identity-Agent | | GitHub, GitLab, Jenkins | SCM- & CI/CD-Agent | | Terraform, Ansible | Infrastructure-as-Code-Agent | | Docker, Container-Registries | Container-Agent | | HashiCorp Vault | Secrets-Agent | | PostgreSQL, MySQL, MSSQL, Oracle | Datenbank-Agent | | Redis, RabbitMQ, Kafka, MQTT | Messaging- & Cache-Agent | | Firmware / IoT-Images | Firmware-Agent | | Headless-Browser erforderlich | Headless-Browser-Agent | Mehrere Agenten können **parallel** über hybride Architekturen hinweg ausgeführt werden. Ebenen, die Zugangsdaten benötigen, um aussagekräftig zu sein (Cloud-Konten, CI/CD, Secret Stores, Datenbanken, Active Directory, Kubernetes), werden **niemals auf Verdacht entsendet**. Sie werden nur aktiviert, wenn ein konkretes Artefakt gefunden wird (ein Schlüssel, ein Token, ein erreichbarer Metadaten-Endpunkt) oder wenn du sie explizit autorisierst, und werden andernfalls im Bericht gekennzeichnet. > **Hinweis:** Die vollständige Liste der Agenten, ihre Struktur, ihr Lebenszyklus und wie du benutzerdefinierte Agenten erstellst, findest du in der [vollständigen Dokumentation, KI-Agenten](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents). ### Architekturübersicht ``` 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 ``` Die KI analysiert und plant. Das MCP kontrolliert, was ausgeführt werden darf. Die Toolbox führt isolierte Tools innerhalb von Docker aus. **Die KI berührt das System niemals direkt**, das ist **Security by Design**. > **Hinweis:** Eine vollständige Aufschlüsselung der Architektur (Deployment-Diagramme, Netzwerkflüsse, Sicherheitsgrenzen) finden Sie unter [Full Documentation, Architecture](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture). --- ## Scope-Definition DarkMoon unterstützt eine flexible Scope-Definition direkt über die Kommandozeile. **Schneller Pentest (Zero Config):** ```bash ./darkmoon.sh "TARGET: http://172.19.0.3:3000" ``` **Bug-Bounty-Modus (Flags werden automatisch aktiviert):** ```bash ./darkmoon.sh "TARGET: http://172.19.0.3:3000 PROGRAM=\"Juice Shop\" FOCUS=sqli,xss,idor NOISE=moderate FORMAT=h1" ``` Zu den wichtigsten Flags gehören `FOCUS`, `EXCLUDE`, `CREDS`, `TOKEN`, `NOISE`, `SEVERITY`, `FORMAT` und weitere, die alle von der KI natürlich interpretiert werden. > **Hinweis:** Die vollständige Flag-Referenz, Asset-Typen, die freie EXCLUDE/FOCUS-Syntax und erweitertes Multi-Target-Scoping finden Sie in der [Full Documentation, Scope Definition](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console). --- ## Integrierte Toolbox DarkMoon wird mit einem zweckgebauten Docker-Image ausgeliefert, das **über 140 Sicherheitstools** enthält, die in einem mehrstufigen Build kompiliert und optimiert wurden: | Kategorie | Tools (Beispiele) | |---|---| | Port-Scanning | Naabu (Discovery), nmap (gezielte Service-Probes) | | Web-Scanning | Nuclei, ffuf, dirb, sqlmap, Arjun, wafw00f | | Recon & Crawling | Subfinder, Katana, Waybackurls, httpx | | CMS | WPScan, CMSeeK, WhatWeb | | Active Directory | NetExec, BloodHound, Impacket (über 30 Skripte) | | Kubernetes | kubectl, Kubescape, Kubeletctl, kube-bench, rbac-police | | Cloud-CLIs | aws, az, gcloud, gsutil, bq | | Datenbanken & Cache | psql, mysql, redis-cli, sqlite3 | | Firmware / IoT | binwalk, unsquashfs, sasquatch, firmwalker | | Cracking | hashcat, john, 7z2john | | Netzwerk | Hydra, curl, dig, SNMP-Tools | | Browser | Lightpanda (headless) | Alle Tools sind direkt zugänglich, keine Pfadkonfiguration erforderlich. > **Hinweis:** Die vollständige Tool-Liste mit Installationsdetails und Informationen zum Hinzufügen neuer Tools finden Sie in der [Full Documentation, Toolbox](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox). --- ## 📖 Dokumentationsleitfaden Die [Full Documentation](https://github.com/ascit31/dark-moon/blob/master/docs/full.md) von DarkMoon deckt alles ab, was Sie für den Betrieb der Plattform benötigen. Hier ist eine Kurzreferenz zu den wichtigsten Abschnitten: | Thema | Was Sie finden | Link | |---|---|---| | **GPU- & Treiber-Setup** | NVIDIA-Fehlerbehebung für Docker, WSL und natives Linux | [GPU Guide](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii2--darkmoon--gpu-troubleshooting-guide-official) | | **Umgebungsvariablen** | LLM-Provider-Konfiguration, API-Schlüssel, Modellauswahl | [Environment Config](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii3-configuration-of-environment-variables-in-docker-compose) | | **Start & Build** | Verhalten von install.sh, docker compose build, Stack-Verwaltung | [Build & Launch](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii6-build-and-launch-darkmoon) | | **Scope & Flags** | TARGET-Syntax, Bug-Bounty-Modus, FOCUS/EXCLUDE, Anmeldedaten | [Scope Definition](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7c-launch-darkmoon-with-tui-console) | | **Assessment-Workflow** | Schritt für Schritt: Discovery, Fingerprinting, Agents, Reporting | [Assessment Engine](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7d-how-to-use-the-darkmoon-assessment-engine) | | **Echtzeit-Sitzungsprotokolle** | Vom MCP-Server ausgeführte Befehle live überwachen | [Session Logs](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#ii7e-step-1--start-an-assessment) | | **KI-Agents** | Agent-Struktur, Lebenszyklus, Erstellen oder Ändern von Agents | [AI Agents](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#v-ai-agents) | | **Architektur** | Deployment-Diagramme, Sicherheitsgrenzen, Ausführungsablauf | [Architecture](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iv-architecture) | | **Toolbox** | Vollständige Tool-Liste, Hinzufügen von Tools, Docker-Image-Interna | [Toolbox](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi-toolbox) | | **MCP-Workflows** | Workflow-Struktur, Erstellen benutzerdefinierter Workflows, Best Practices | [MCP Workflows](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vii-mcp-workflows) | | **Liste der verfügbaren Tools** | Vollständige Tabelle mit 142 Sicherheitstools inklusive Pfaden und Quellen | [Tools List](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi10-toolbox-list) | | **Trainings-Labs** | Empfohlene verwundbare Labs zum Trainieren von DarkMoon | [Pentester Labs](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#vi11-bonus-pentester-lab-to-train-darkmoon) | | **Remediation Agent** (Pro) | Findings → sandbox-validierter Fix → Pull Request zur menschlichen Überprüfung (wird nie gemergt) | [Remediation Agent](https://github.com/ascit31/dark-moon/blob/master/docs/remediation-agent.md) | | **n8n (Pro)** | Community-Node zum Auslösen eines Pentests, Abrufen von Findings und Überprüfen von Fix-PRs aus einem n8n-Workflow | [n8n Node](https://github.com/ascit31/dark-moon/blob/master/docs/n8n-integration.md) | --- ## Anwendungsfälle DarkMoon ist als vielseitige **Sicherheitstestplattform** konzipiert für: - 🔒 **Sicherheitsteams**, führen Sie kontinuierliche **automatisierte Penetrationstests** über Ihre Infrastruktur hinweg durch - ⚙️ **DevSecOps-Pipelines**, integrieren Sie **KI-gestützte Sicherheitsforschung** in CI/CD-Workflows - 🎯 **Bug-Bounty-Jäger**, beschleunigen Sie **ethisches Hacking** mit autonomer Zielanalyse - 🔬 **Sicherheitsforscher**, erkunden Sie Angriffsflächen mit einer **KI-Cybersicherheitsplattform**, die sich in Echtzeit anpasst - 🎓 **Training & Ausbildung**, lernen Sie Offensive Security mit geführten, reproduzierbaren Assessments --- ## Beispiel-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" ``` > **Hinweis:** Weitere Prompt-Beispiele, einschließlich DVGA, Juice Shop und Headless-Browser-Szenarien, finden Sie in [Vollständige Dokumentation, Prompt-Beispiele](https://github.com/ascit31/dark-moon/blob/master/docs/full.md#iii-uses). --- ## Mitwirken DarkMoon ist Open Source und freut sich über Beiträge. Ob Sie neue Agents hinzufügen, Tools integrieren, Workflows erstellen oder die Dokumentation verbessern möchten – Richtlinien finden Sie in [CONTRIBUTING.md](https://github.com/ascit31/dark-moon/blob/master/CONTRIBUTING.md). --- ## Lizenz Dieses Projekt ist unter der **GNU General Public License v3.0** lizenziert. Details finden Sie in [LICENSE](https://github.com/ascit31/dark-moon/blob/master/LICENSE). --- <div align="center"> **Entwickelt von ASC-IT mit 💚 für die globale Sicherheitscommunity** 🔒 Open Source · 🤖 KI-gestützt · 🇫🇷 Made in France [⭐ Starren Sie uns auf GitHub](https://github.com/ASCIT31/Dark-Moon) · [📖 Vollständige Dokumentation](https://github.com/ascit31/dark-moon/blob/master/docs/full.md) · [▶️ Demo ansehen (Pro-Dashboard)](https://youtu.be/zQE95bVLZgM) </div>
