Plattform-Showcase • Warum ARES? • Wettbewerbsmatrix • Architektur • MITRE-Matrix • Quickstart • Zero-Trust-Sicherheit • Dokumentation

⚡ Zusammenfassung

Traditionelles Penetrationstesting ist grundlegend fehlerhaft: Es ist teuer, episodisch, punktuell und lässt Organisationen blind gegenüber neu eingeführten Fehlkonfigurationen und aufkommender gegnerischer Vorgehensweise zurück. Gleichzeitig überfluten automatisierte Schwachstellenscanner SOC-Teams mit Tausenden hypothetischer CVEs, ohne die Ausnutzbarkeit oder mehrstufige laterale Angriffspfade nachzuweisen.

ARES schließt diese Lücke. Von Grund auf für moderne Unternehmensinfrastruktur entwickelt, liefert ARES eine autonome, zielgerichtete Red-Team-Engagement-Plattform, die reale Bedrohungsakteure modelliert. Durch die Kombination von Firewalls auf Kernel-Ebene für den Geltungsbereich, adaptivem OPSEC-Rauschprofiling, einem interaktiven gerichteten azyklischen Graphen (DAG) als Angriffs-Solver und über 60 weaponisierten Techniken, die auf MITRE ATT&CK abgebildet sind, ermöglicht ARES Sicherheitsteams, die Ausnutzbarkeit von Schwachstellen zu beweisen, die kürzesten Kompromittierungspfade zu Active-Directory-Kronjuwelen zu finden und führungsreife Ergebnisse ohne Betriebsausfall zu erstellen.

🎯 Warum Unternehmen ARES wählen```

┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐ │ STRICT SCOPE ENCLAVE │ │ AUTONOMOUS DAG ENGINE │ │ ZERO-TRUST ARCHITECTURE │ │ Hard kernel CIDR egress │ │ Computes shortest paths │ │ Memory-only JWT tokens, │ │ whitelisting prevents │───│ to Domain Admins & Crown│───│ AES-256 encrypted vault,│ │ any collateral impact. │ │ Jewels deterministically│ │ strict HMAC-CSRF checks.│ └─────────────────────────┘ └─────────────────────────┘ └─────────────────────────┘ │ ▼ ┌─────────────────────────┐ │ INSTANT EXECUTIVE SUITE │ │ Branded PDF, HTML, JSON │ │ deliverables with zero │ │ native GTK dependencies │ └─────────────────────────┘

1. 🛡️ Operator-Enklave & Zero-Trust-Gateway

Autonome Eintrittsbarriere, die speziell für autorisierte offensive Operatoren und Sicherheitspersonal entwickelt wurde.

• Das gelöste Problem: Eliminiert unbefugten Operator-Zugriff, Token-Replay-Angriffe und Token-Leakage in den lokalen Browserspeicher.
• Kernfähigkeiten:
  • Karmesinrotes Feuer-Signatur-Interaktion: Echtzeit-HTML5-Canvas-Partikelfeuersystem umhüllt die Anmelden-Schaltfläche bei Hover (kontinuierlich), Klick (Burst) und Enter-Taste (Burst ohne Zeiger) — physikbasierte Partikel mit Auftrieb, Turbulenz und radialem Glühen mittels requestAnimationFrame.
  • ARES Cyber Dragon Ambient-Maskottchen: Integriertes Marken-Maskottchen-Wasserzeichen auf dem Telemetrie-Bereich mit kalibrierter Deckkraft und karmesinrotem Hintergrundglühen, harmonisiert mit den Umgebungsspezifikationen aus Milchglas.
  • Live Dynamic Architectural Grid Canvas: Ressourcenschonende, hardwarebeschleunigte 60-FPS-HTML5-Leinwand mit Echtzeit-Datenimpulsen und Beleuchtung bei Cursor-Nähe.
  • Nur-Speicher-Token-Isolierung: Kurzlebige JWTs verbleiben ausschließlich im Speicher; Refresh-Anmeldedaten verwenden host-only, HttpOnly-Cookies mit einmaliger Rotation.
  • Enterprise-Multi-Tenant-SSO (SAML 2.0 & OIDC): SP-initiierte föderierte Authentifizierung mit Okta, Azure AD und Google Workspace. Bietet App-Level-Fernet-Anmeldedaten-Verschlüsselung, einmaligen Replay-Schutz (InResponseTo/nonce), JIT-Rollenzuordnung und strikte lokale Passwortsperre für föderierte Identitäten. (Siehe SSO-Einrichtungsanleitung).
  • HMAC-Double-Submit-CSRF-Schutz: Konstantzeit-Verifizierung bei allen zustandsändernden Anfragen (X-ARES-CSRF).
  • Kryptografischer Brute-Force-Schutz: Erzwingt exponentielles Backoff und IP-basierte Ratenbegrenzung bei Authentifizierungsversuchen.

2. 📊 Executive Command Center & Telemetrie

Echtzeit-Operationskonsole, die sofortige Lageübersicht über aktive Kampagnen bietet.

• Das gelöste Problem: Aggregiert verstreute offensive Metriken in einem einzigen Echtzeit-Operationsbereich, ohne manuelle Statusabfragen zu erfordern.
• Kernfähigkeiten:
  • Operatives Design-System: Entwickelt mit hochdichter visueller Hierarchie (inspiriert von Grafana, Linear und Sentry) — mit subtilen linksakzentuierten kontextuellen Panels (panel-subtle), dynamischen reaktiven Topbar-Gesundheitsindikatoren und ausgeprägten gestrichelten Fortschrittsbalken für nicht initialisierte Metrik-Basislinien.
  • Umsetzbare Engagement-Erkenntnisse: Ersetzt redundante Rohzählungen durch kontextuelle Sicherheitslage-Erkenntnisse:
    • Engagement-Lage: Klare Zustandsabgrenzung (Staged, Executing oder Standby), die abgegrenzte Ziele von ausführenden Kampagnen unterscheidet.
    • Ausführungsgesundheit: Echtzeit-Überwachung von Pipeline-Anomalien, Modulausführungsfehlern und Enklaven-Stabilität.
    • Angriffsfläche: Live-Verfolgung entdeckter Hosts, Credential-Pivots und Netzwerk-Penetrationstiefe.
  • Telemetrie- & Pipeline-Ingestion: Echtzeit-Worker-Pool-Durchsatz, P95-Aufgabendauer und Live-Event-Ingestion-Indikatoren.
  • Taktischer Fresh-Install-Hero: Automatischer Empty-State-Fallback mit zentriertem Initialisierungs-CTA und minimaler Bereitschaftsleiste beim Start ohne Kampagnen.

3. 🎯 Scoped Campaign & Zielgrenzen-Verwaltung

Zero-Collateral-Ziel-Governance mit harten CIDR-Whitelist-Grenzen und verschlüsselter Beweis-Isolierung.

• Das gelöste Problem: Verhindert katastrophales Out-of-Scope-Scanning und eliminiert unverschlüsselte Credential-Dateien auf Operator-Laptops.
• Kernfähigkeiten:
  • Persistente Operator-Führung: Persistente <label>-Definitionen über alle Kampagnen-Auswahlen und Parametereingaben hinweg, die Operator-Mehrdeutigkeit bei schnellen Engagements verhindern.
  • Harte CIDR-Whitelists: Durchsetzung von Grenzen auf Netzwerkebene. Die Engine fängt jede Anfrage an nicht genehmigte IP-Adressen oder Subnetze ab und verwirft sie.
  • Rauschprofile & Jitter: Konfigurierbare Engagement-Drosselungsstufen (Stealth, Normal, Aggressive) mit randomisierten Verzögerungsverteilungen.
  • AES-256-verschlüsselter Enklaven-Tresor: Gesammelte NTLM-Hashes, Kerberos-Tickets und Service-Credentials werden im Ruhezustand mit AES-256-GCM verschlüsselt.
  • Saubere Teardown-Workflows: Ein-Klick-Kampagnenlöschung, die alle zugehörigen Datenbankzeilen, Graph-Knoten und temporären Artefakte sicher bereinigt.

4. ⚡ Modulare Adversary-Orchestrierung (60+ Module)

Umfangreicher Katalog weaponisierter Adversary-Techniken, ausgerichtet an der MITRE-ATT&CK-Enterprise-Matrix.

• Das gelöste Problem: Ersetzt unvalidierte, unzuverlässige GitHub-Skripte durch typisierte, reproduzierbare und auditierbare Adversary-Module.
• Kernfähigkeiten:
  • Umfassende Vektorabdeckung: 60+ modulare Techniken für Active Directory (ad.kerberoast, ad.adcs, ad.enum_users), Windows (windows.uac_bypass), Linux, Cloud (AWS, Azure, GCP) und Netzwerkinfrastruktur.
  • Optimiertes Ausführungspanel: Saubere Ausführungsansicht mit persistenten Feldbezeichnungen, herabgestuften Hinweisen zu gering gewichteten Abhängigkeiten und fokussierter On-Submit-Validierung, die aufdringliche Standard-Warnkarten ersetzt.
  • Dynamische typisierte Schemas: UI-Formulare werden dynamisch aus Python-Pydantic-Modellen mit strikter Validierung generiert.
  • Dry-Run-Sicherheits-Engine: Validiert Zielreaktionsfähigkeit, Parameter und erwartetes Ergebnis, bevor offensiver Datenverkehr gesendet wird.
  • Rollengesteuerte Ausführung: Operator- und Team-Lead-Berechtigungen für die Ausführung erforderlich; sensible Module mit hohem Rauschen erfordern explizite Bestätigung.

5. 🕸️ Multi-Vektor-Angriffsgraph & Objective Replay

Interaktiver Directed-Acyclic-Graph-(DAG)-Solver zur Visualisierung von Enterprise-Angriffspfaden und Privilegieneskalationsketten.

• Das gelöste Problem: Übersetzt Rohdaten zu Schwachstellen in umsetzbare, visuelle Kompromittierungspfade, die Führungskräfte und Ingenieure sofort verstehen können.
• Kernfähigkeiten:
  • Automatisiertes Cyber-Patchkabel-Routing: Echtzeit-Rendering automatisierter leuchtender weißer Kabel (#ffffff), die Domain Controller, Sicherheitserkenntnisse und entdeckte Hosts ohne manuelles Ziehen verbinden.
  • Deterministische Links-nach-Rechts-Hierarchie: Sauberes, kollisionsfreies Spaltenlayout, das vom Domain Controller (DC01) auf der linken Seite über aktive Sicherheitserkenntnisse bis zu den Ziel-Mitgliedshosts verläuft.
  • Kürzeste-Pfad-Algorithmen: Berechnet deterministisch die wenigsten Hops, die zur Kompromittierung von Domain Controllern oder Cloud-Root-Credentials erforderlich sind.
  • Nativer BloodHound-/SharpHound-Ingest: Direkter Import von BloodHound-JSON-Archiven in die ARES-Graph-Engine für einheitliche Analyse.
  • Interaktive Entitätsinspektion: Erkundung von Beziehungen zwischen Benutzern, Gruppen, Computern, ACLs und aktiven Kerberos-Sitzungen mit flüssiger Navigation und Echtzeit-Sicherheits-Detailinspektor.
  • Objective Replay: Re-Simulation historischer Angriffsketten zur Überprüfung der Wirksamkeit defensiver Patches.

6. 📑 Automatisierte Report-Engine & Beweisbibliothek

Sofortige Erstellung von Lieferergebnissen mit gebrandeten, auditfähigen Compliance-Berichten in mehreren Enterprise-Formaten (Executive PDF, Technical Markdown, Defect CSV).

• Das gelöste Problem: Eliminiert die 40+ Stunden, die typischerweise für das manuelle Schreiben, Formatieren und Redigieren von Pentest-Berichten aufgewendet werden.
• Kernfähigkeiten:
  • Strukturiertes Generierungsraster: Ausgerichtetes mehrspaltiges Layout mit persistenten <label>-Elementen (Target Campaign, Export Format) und sauberem Inline-Validierungsfehler-Feedback.
  • Multi-Format-Export: Ein-Klick-Generierung von PDF-, HTML-, Markdown- und JSON-Lieferergebnissen.
  • Automatisierte Headless-PDF-Engine: Integrierter Fallback über Microsoft Edge / Chromium Headless-Modus für sauberen PDF-Export ohne komplexe GTK-Abhängigkeiten unter Windows.
  • Automatisierte Beweisredaktion: Redigiert automatisch sensible Rohpasswörter und private Schlüssel in Kundenlieferergebnissen, während Audit-Nachweise erhalten bleiben.
  • Synchronisierte Report-Bibliothek: Authentifiziertes Artefakt-Repository mit sofortigen Downloads, Löschung pro Bericht und Echtzeit-UI-Zustandssynchronisierung.

7. 🧠 Autonome Strategie & KI-Planer

Zielgerichtete autonome Engine, die komplexe Angriffsketten plant, priorisiert und ausführt, während OPSEC-Grenzen respektiert werden.

• Das gelöste Problem: Koordiniert Multi-Modul-Angriffsketten autonom, ohne ständiges manuelles Eingreifen des Operators zu erfordern.
• Kernfähigkeiten:
  • Dynamische Engine-Verifizierung: Echtzeit-asynchrone Healthchecks gegen lokale Ollama-Daemons (GET /api/tags) mit Sub-Sekunden-Timeouts und TTL-Caching, gepaart mit dynamischer serverseitiger Cloud-Key-Verifizierung (Claude, OpenAI).
  • Sauberes operatorzentriertes Design: Persistente Feldbezeichnungen (Target Campaign, Strategic Objective, AI Planning Engine, Explicit Authorizations), menschenlesbare Zielbeschreibungen und vollständige Eliminierung von Server-Umgebungsvariablen-Leakage in UI-Bezeichnungen.
  • Fokussierte On-Submit-Validierung: Warnboxen aus dem Standard-Seitenrendering entfernt; Validierungsfehler werden nur bei Ausführungsversuch inline unter den Zielfeldern angezeigt.
  • Adaptiver Containment-Governor: Bewertet kontinuierlich defensive Telemetrie und Rauschschwellen und verlangsamt oder bricht aggressive Aktionen automatisch ab, wenn das Entdeckungsrisiko seinen Höhepunkt erreicht.

8. 🔍 Attack-Graph-Entitäts-Deep-Dive & Node-Inspektor

Eingehende Active-Directory-Entitätstelemetrie, Beziehungsinspektion und Echtzeit-Sicherheits-Detailauditierung direkt in der Leinwand.

• Das gelöste Problem: Eliminiert Kontextwechsel zwischen Graph-Visualisierern und CLI-Aufklärungstools durch Bereitstellung von Live-Node-Telemetrie in einer interaktiven Seitenleiste.
• Kernfähigkeiten:
  • Entitätsattribut-Inspektion: Sofortige Untersuchung von IP-Adresse, Hostname, OS-Telemetrie, Kompromittierungsstufen und Domain-Controller-Flags (is_dc) bei Auswahl eines beliebigen Graph-Knotens.
  • Angriffsflächen-Port-Mapping: Echtzeit-Sichtbarkeit offener Infrastruktur-Ports (DNS 53, Kerberos 88, RPC 135, NetBIOS 139, LDAP 389, SMB 445, LDAPS 636, Global Catalog 3268, RDP 3389).
  • Sicheres Detail-Auditing: Auditierte Slide-out-Schublade mit granularer Telemetrie ohne die Haupt-DAG-Leinwand zu überladen, komplett mit schneller Ausblendung.

9. 🔗 Mehrstufige Adversary-Ausführungsketten

Deterministische, mehrstufige Kill-Chains, die Aufklärung, Credential-Harvesting und laterale Bewegung sequenziell orchestrieren.

• Das gelöste Problem: Ersetzt manuelle schrittweise Tool-Aufrufe durch vorab verifizierte, koordinierte Angriffsketten, die Ausgaben automatisch an nachgelagerte Module weitergeben.
• Kernfähigkeiten:
  • Vorgefertigte Angriffssequenzen: Out-of-the-Box-Ketten für Kerberos-Exposition (asreproast -> kerberoast -> hashcat), Domain-Enumeration und Cloud-Privilegieneskalation.
  • Dynamische Kontextübergabe: In Schritt 1 gesammelte Credentials und Hashes werden automatisch in Zielargumente für nachfolgende Schritte eingefügt.
  • Integriertes OPSEC-Budgeting: Verfolgt kumulatives Rauschen und Entdeckungswahrscheinlichkeit über die gesamte Kette vor Initiierung der Ausführung.

10. 🛡️ EDR-/OPSEC-Evasion- & Bypass-Wissensdatenbank

Empirische Verfolgung der Evasionswirksamkeit über Enterprise-Endpoint-Detection-and-Response-(EDR)-Plattformen.

• Das gelöste Problem: Verhindert, dass offensive Operatoren blind verbrannte oder erkannte Payloads gegen überwachte Kundeninfrastruktur einsetzen.
• Kernfähigkeiten:
  • Empirische Erfolgsraten: Historische Erfolgsraten kategorisiert nach spezifischen Evasionstechniken (AMSI-Patching, Syscall-Unhooking, Process Hollowing) und EDR-Anbieter.
  • Sitzungsübergreifendes Evasionsgedächtnis: Engagement-Ergebnisse aktualisieren eine einheitliche Wissensdatenbank und warnen Operatoren, bevor sie Techniken mit geringer Erfolgswahrscheinlichkeit ausführen.
  • Defensive Jitter-Kontrollen: Granulare Verzögerungsverteilungen und Paketabstände zur Umgehung verhaltensbasierter Heuristiken und SIEM-Korrelationsregeln.

11. 🔐 Zero-Trust-Sicherheits-Governance & Audit-Trail

Auditierte Multi-Rollen-Zugriffskontrolle, kryptografischer API-Key-Lebenszyklus und kontinuierliche Plattformintegritätsverifizierung.

• Das gelöste Problem: Garantiert Nichtabstreitbarkeit, rollenbasierte Grenztrennung und Compliance-Sicherheit für offensive Sicherheitsoperationen.
• Kernfähigkeiten:
  • Rollenbasierte Zugriffskontrolle (RBAC): Strikt durchgesetzte Berechtigungsstufen (Team Lead, Operator, Recon, Reporter), die Modulausführung und Beweiseinsicht regeln.
  • Bereichsbezogene API-Keys: Kryptografisch generierte Bearer-Tokens mit konfigurierbarem Ablauf und feingranularen Berechtigungen für CI/CD-Integration.
  • Live-Audit-Trail: Kontinuierliche Append-Only-Protokollierung jeder Operator-Aktion, jedes Zielscans und jedes Credential-Abrufs für die Post-Engagement-Überprüfung.

12. 📡 Live-Operationen & Echtzeit-Event-Stream

Hochfrequenter WebSocket-Event-Bus, der operative Telemetrie, Modulausgaben und Pipeline-Status streamt.

• Das gelöste Problem: Verleiht Engagement-Kommandeuren sofortige, einheitliche Situationswahrnehmung aller verteilten Agenten und Hintergrundaufgaben.
• Kernfähigkeiten:
  • Sub-Sekunden-Event-Zustellung: Asynchroner WebSocket-Bus, der Live-stdout/stderr, Modulabschlussereignisse und defensive Warnungen streamt.
  • Gepufferte Log-Telemetrie: Wiederverbindungsresistente Event-Pufferung, die null verlorene Log-Zeilen bei Netzwerkschwankungen gewährleistet.
  • Multi-Operator-Zusammenarbeit: Gleichzeitige Operatoren sehen gemeinsame Kampagnenausführungsereignisse in Echtzeit.

13. 📋 Enterprise-Playbooks & Kampagnenvorlagen

Standardisierte Engagement-Architekturen für wiederkehrende Red-Team-Übungen, Compliance-Audits und Purple-Team-Drills.

• Das gelöste Problem: Eliminiert manuelle Bereichskonfiguration für standardisierte Assessments und gewährleistet konsistente Testmethodik über Enterprise-Engagements hinweg.
• Kernfähigkeiten:
  • Schlüsselfertige Playbooks: Sofort einsatzbereite Kampagnenvorlagen mit vorkonfigurierten Zielprofilen, Modulsätzen und Berichtsanforderungen.
  • Benutzerdefinierte Vorlagenerstellung: Export erfolgreicher benutzerdefinierter Engagements als wiederverwendbare Vorlagen für interne Teams und MSSP-Kunden.
  • Sicherheits-Pre-Flights: Automatisierte Bereichs- und Berechtigungsvalidierung, bevor eine vorlagenbasierte Kampagne live geht.

14. 🔌 Interaktive OpenAPI 3.1 & Entwicklerintegration

Vollständig dokumentierte, interaktive REST-API-Oberfläche für benutzerdefinierte Tooling-, SOC-Orchestrierungs- und CI/CD-Pipeline-Integration.

• Das gelöste Problem: Ermöglicht nahtlose programmatische Integration mit bestehenden Enterprise-SOAR-Plattformen, benutzerdefinierten Reporting-Pipelines und CI/CD-Sicherheitsgates.
• Kernfähigkeiten:
  • 70+ dokumentierte Endpunkte: Vollständige REST-Abdeckung über Authentifizierung, Kampagnen, Modulausführung, Angriffsgraphen und Lieferergebnisse.
  • OpenAPI-3.1-Konformität: Strikt validierte Request-/Response-Schemas, die direkt aus Python-Pydantic-Modellen generiert werden.
  • Interaktive Sandbox: In-Browser-API-Testing mit Bearer-Token-Authentifizierung und CSRF-Token-Unterstützung.

🎛️ Aufschlüsselung der Steuerungsoberflächen| Oberfläche | Kernverantwortung | Verfügbare Unter-Tabs | Primäre Operatoren |

| :--- | :--- | :--- | :--- | | Übersicht | Executive Health, Telemetrie-Zähler, Schweregrad-Metriken von Findings. | Einzelne Ansicht | Alle Stakeholder | | Kampagnen | Scope-Whitelisting, Rauschprofile, verschlüsselter Credential-Tresor. | List, Scope, Findings | Team Lead, Operator | | Module | 60+ Modul-Katalog, Parameter-Eingabeformulare, Ausführungskonsole. | Catalog, Run Panel, Results | Operator | | Berichte | Deliverable-Builder, Evidenz-Pakete, Report Library-Lebenszyklus. | Generate, Library | Operator, Reporter | | Graph | DAG-Entitäten-Exploration, kürzeste Angriffspfade, BloodHound-Ingest. | Entities, Attack Paths, Ingest | Operator, Recon | | Vorlagen | Wiederholbare Engagement-Playbooks und mehrstufige Workflow-Pläne. | Templates, Plan Builder | Team Lead, Operator | | Strategie | Zielgerichtete autonome Engine, KI-Planer-Integration. | Objective, Active, Result | Team Lead, Operator | | Sicherheit | Operator-Anmeldedaten, API-Key-Lebenszyklus, Dependency-Audit-Prüfungen. | Account, API Keys, Audit | Team Lead | | EDR/OPSEC | Defensive Telemetrie, Bypass-Tracking, Regeln zur Erkennungsvermeidung. | Knowledge Base, Report Outcome | Operator | | Live | Echtzeit-WebSocket-Ereignisströme und gepufferte Telemetrie-Logs. | Stream, Buffer | Operator |

🏗️ Systemarchitektur & Datenpipeline

ARES folgt einer strikten Defense-in-Depth-Architektur, die Präsentation, Ausführungsorchestrierung, Sicherheits-Governance und persistenten kryptografischen Speicher trennt:```mermaid flowchart TB subgraph Client["Presentation Layer (Operator Enclave)"] UI["React 19 Dashboard
(Vite + TypeScript)"] Mesh["Dynamic Architectural Grid
(Canvas 2D Engine)"] WSClient["WebSocket Client
(Real-Time Telemetry Stream)"] end

• Active Directory Lab Suites: Vollständige SPN-Erkennung, Kerberoasting (ad.kerberoast), AS-REP Roasting, ADCS-Zertifikatvorlagen-Missbrauch (ESC1 bis ESC8), DCSync-Kontenreplikation und BloodHound-Datengenerierung.
• Endpoint Posture Checkers: Windows-UAC-Bypass-Methoden, Inspektion der Registrierungsschlüssel-Persistenz, Linux-Container-Breakouts und Sudo-Rechte-Enumeration.
• Cloud Control Plane: Multi-Cloud-Identitätsprüfung über AWS IAM, Azure Active Directory / Entra ID-Rollenzuweisungen und GCP IAM-Bindings.

🚀 Quickstart: In 60 Sekunden einsatzbereit

Voraussetzungen

• Python: 3.11 oder 3.12 (Python 3.12 empfohlen für Windows).
• Node.js: v18+ (getestet auf Node v20 LTS).
• OS: Windows 11/10 (PowerShell), Linux (Ubuntu/Debian/Kali) oder macOS.

Schnellstart (PowerShell unter Windows)```powershell

1. Clone the repository

git clone https://github.com/Mafifrizi/ARES.git Set-Location .\ARES

2. Setup isolated Python virtual environment

py -3.12 -m venv .venv ..venv\Scripts\python.exe -m pip install -U pip ..venv\Scripts\python.exe -m pip install -e ".[dev,pdf]"

3. Install frontend dependencies

Set-Location frontend & "C:\Program Files\nodejs\npm.cmd" ci Set-Location ..

4. Configure local Edge PDF rendering engine & verify doctor status

$env:ARES_PDF_BROWSER = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" ..venv\Scripts\ares.exe doctor --pdf-smoke

5. Launch development server (Frontend + Backend proxy)

..venv\Scripts\ares.exe dashboard dev --no-reload

2. 1-Klick-KI-Client-Einrichtung (keine manuelle JSON-Bearbeitung): Konfigurieren Sie Ihre bevorzugte IDE automatisch mit einem einzigen Befehl: ```powershell

   For Cursor IDE:

   .\mcp.bat setup --client cursor

   For Claude Desktop:

   .\mcp.bat setup --client claude

   For Windsurf:

   .\mcp.bat setup --client windsurf

   For VS Code (Cline):

   .\mcp.bat setup --client cline

   root@kitploit:~

Dies schreibt den Pfad Ihrer aktiven Python-virtual-environment direkt in die Client-Konfigurationsdatei (z. B. .cursor/mcp.json).

3. Fenster in Cursor IDE neu laden:

   • Drücken Sie in Cursor Ctrl + Shift + P.
   • Wählen Sie Developer: Reload Window.
   • Öffnen Sie Settings (Ctrl + ,) → Features → MCP Servers. Der Server ares zeigt einen grünen Punkt (Connected).

4. Den Live-Zwei-Bereich-Monitor starten (optionales Begleitfenster): Führen Sie in einem dedizierten Terminalfenster den Zwei-Bereich-Monitor im OpenClaw-Stil aus, um Echtzeit-AI-Tool-Aufrufe, Scope-Prüfungen und Token-Genehmigungen zu beobachten: ```powershell .\mcp.bat monitor

   root@kitploit:~

• Linker Bereich: Live-Stream der vom KI-Agenten ausgeführten Tool-Aufrufe (ares_scope_check, ares_dry_run_module, ares_run_tool).
  • Rechter Bereich: ScopeGuard-CIDR-Grenzen, gestaffelte Aktions-Diffs und das Authorization Gateway.
  • Steuerung: Drücken Sie A, um ein ausstehendes Ausführungs-Token zu genehmigen, R zum Ablehnen, C zum Leeren des Streams, Q zum Beenden.

5. Erteilen Sie Ihren ersten Befehl an den KI-Agenten: Öffnen Sie Cursor Composer / Chat (Ctrl + I oder Ctrl + L) und versuchen Sie diesen Prompt:

   "Prüfe den Status der aktiven Kampagne, verifiziere den Scope für Ziel 10.0.1.50 und bereite einen Dry-Run des Moduls ad_kerberoast vor."

Für eingehende Architektur, die 7 Sicherheitsinvarianten, CLI-Skriptfähigkeit (--json), POSIX-Exit-Codes und operative Tool-Schemas siehe ARES MCP Gateway & Product-Grade CLI Specification.

🛠️ Erweiterbares Developer SDK (Next-Gen Autonomous Architecture)

ARES bietet ein erstklassiges, typsicheres Python SDK (ares.sdk), um benutzerdefinierte Adversary-Module zu erstellen, Techniken in isolierten Test-Harnesses zu simulieren und Engagements programmatisch zu automatisieren:

1. Typsichere Modul-Erstellung (Generisches BaseModule[P, R] & @ares_module)

Deklarieren Sie validierte Parameter-Schemas mit Pydantic v2 und schreiben Sie Module mit vollständiger IDE-Autovervollständigung:```python from ares.sdk import ( BaseModule, ExecutionContext, ModuleResult, ModuleParams, param, SecretParam, OpsecLevel, Severity, ares_module, )

class KerberoastParams(ModuleParams): dc: str = param("Target Domain Controller IP or FQDN", min_length=3) domain: str = param("AD DNS domain name, e.g. CORP.LOCAL", min_length=3) password: SecretParam = param("Domain user password", secret=True, required=False)

class CustomKerberoastModule(BaseModule[KerberoastParams, ModuleResult]): MODULE_ID = "custom.ad.kerberoast" MODULE_NAME = "Custom Kerberoasting" MODULE_CATEGORY = "ad" OPSEC_LEVEL = OpsecLevel.LOW MITRE_TECHNIQUES = ["T1558.003"] PARAMS_MODEL = KerberoastParams

3. Programmatische Automatisierung (AresClient)

Automatisieren Sie Engagements, verteilen Sie Module und streamen Sie Echtzeit-WebSocket-Telemetrie über Python-Skripte oder CI/CD-Pipelines:```python from ares.sdk import AresClient

async with AresClient(base_url="http://127.0.0.1:8000", api_key="ares_key_...") as ares: campaign = await ares.campaigns.create(name="Op-Titan", scope=["10.0.0.0/24"]) job = await ares.modules.run("ad.kerberoast", target="dc01.corp.local", campaign_id=campaign["id"]) findings = await ares.campaigns.findings(campaign["id"])