Platform Showcase • Why ARES? • Competitive Matrix • Architecture • MITRE Matrix • Quickstart • Zero-Trust Security • Documentation

⚡ Sintesi Esecutiva

Il penetration testing tradizionale è fondamentalmente carente: è costoso, episodico, puntuale e lascia le organizzazioni cieche di fronte a misconfigurazioni di nuova introduzione e alle tecniche emergenti degli avversari. Nel frattempo, gli scanner di vulnerabilità automatizzati sommergono i team SOC con migliaia di CVE ipotetici senza dimostrare la sfruttabilità o i percorsi di attacco laterale multi-stadio.

ARES colma questa lacuna. Costruito da zero per l'infrastruttura aziendale moderna, ARES offre una piattaforma autonoma di red team engagement orientata agli obiettivi che modella attori di minaccia del mondo reale. Combinando firewall di scope a livello kernel, profilazione adattiva del rumore OPSEC, un risolutore di attacchi interattivo basato su grafo aciclico diretto (DAG) e oltre 60 tecniche weaponizzate mappate su MITRE ATT&CK, ARES consente ai team di sicurezza di dimostrare la sfruttabilità delle vulnerabilità, individuare i percorsi di compromissione più brevi verso i Crown Jewels di Active Directory e generare deliverable pronti per il management con zero downtime operativo.

🎯 Perché le Aziende Scelgono ARES```

┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐ │ 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. 🛡️ Enclave Operatore & Gateway Zero-Trust

Barriera d'ingresso autonoma progettata specificamente per operatori offensivi autorizzati e personale di sicurezza.

• Il Problema Risolto: Elimina l'accesso non autorizzato degli operatori, gli attacchi di replay dei token e la fuga di token verso l'archiviazione locale del browser.
• Capacità Chiave:
  • Interazione con Firma di Fuoco Cremisi: Sistema di particelle di fuoco in tempo reale su HTML5 Canvas che avvolge il pulsante Sign In al passaggio del mouse (continuo), al clic (esplosione) e al tasto Invio (esplosione senza puntatore) — particelle basate sulla fisica con galleggiamento, turbolenza e bagliore radiale tramite requestAnimationFrame.
  • Mascotte Ambientale ARES Cyber Dragon: Filigrana della mascotte del brand integrata sul pannello di telemetria con opacità calibrata e retro-bagliore cremisi, armonizzata con le specifiche dell'ambiente in vetro smerigliato.
  • Canvas della Griglia Architetturale Dinamica in tempo reale: Canvas HTML5 a 60 FPS con accelerazione hardware a basso overhead, impulsi di dati viaggianti in tempo reale e illuminazione per prossimità del cursore.
  • Isolamento dei Token Solo in Memoria: JWT a breve durata risiedono rigorosamente in memoria; le credenziali di refresh utilizzano cookie host-only, HttpOnly con rotazione monouso.
  • SSO Multi-Tenant Enterprise (SAML 2.0 & OIDC): Autenticazione federata avviata dal SP con Okta, Azure AD e Google Workspace. Include crittografia delle credenziali Fernet a livello di App, protezione anti-replay monouso (InResponseTo/nonce), mappatura dei ruoli JIT e blocco rigoroso della password locale per le identità federate. (Vedi Guida alla Configurazione SSO).
  • Protezione CSRF Double-Submit HMAC: Verifica a tempo costante su tutte le richieste che modificano lo stato (X-ARES-CSRF).
  • Scudo Crittografico Anti Brute-Force: Applica backoff esponenziale e rate limiting basato su IP sui tentativi di autenticazione.

2. 📊 Centro di Comando Esecutivo & Telemetria

Console di comando operativa in tempo reale che fornisce visibilità istantanea sulla postura attraverso le campagne attive.

• Il Problema Risolto: Aggrega metriche offensive sparse in un unico pannello operativo in tempo reale senza richiedere query manuali di stato.
• Capacità Chiave:
  • Sistema di Design Operativo: Progettato con gerarchia visiva ad alta densità (ispirato a Grafana, Linear e Sentry) — con pannelli contestuali con accento sinistro sottile (panel-subtle), indicatori di stato reattivi dinamici nella topbar e tracce di avanzamento tratteggiate distinte per le baseline metriche non inizializzate.
  • Insight Azionabili sull'Engagement: Sostituisce i conteggi grezzi ridondanti con insight contestuali sulla postura di sicurezza:
    • Postura dell'Engagement: Chiara delineazione dello stato (Staged, Executing o Standby) che distingue i target in scope dalle campagne in esecuzione.
    • Stato di Esecuzione: Monitor in tempo reale di anomalie nella pipeline, fallimenti nell'esecuzione dei moduli e stabilità dell'enclave.
    • Superficie d'Attacco: Tracciamento live degli host scoperti, pivot di credenziali e profondità di penetrazione nella rete.
  • Telemetria & Ingestione Pipeline: Throughput del pool di worker in tempo reale, durata P95 delle attività e indicatori di ingestione eventi live.
  • Hero Tattico Fresh-Install: Fallback automatico allo stato vuoto con CTA di inizializzazione centrata e striscia di prontezza minimale quando si parte con zero campagne.

3. 🎯 Gestione Campagne in Scope & Confini dei Target

Governance dei target a zero collateral che applica confini rigidi di whitelist CIDR e isolamento crittografato delle evidenze.

• Il Problema Risolto: Previene scansioni catastrofiche fuori scope ed elimina i file di credenziali non crittografati sui laptop degli operatori.
• Capacità Chiave:
  • Guida Persistente per l'Operatore: Definizioni persistenti di <label> su tutti i selettori di campagna e input di parametri, prevenendo ambiguità per l'operatore durante engagement rapidi.
  • Whitelist CIDR Rigide: Applicazione dei confini a livello di rete. Il motore intercetta e scarta qualsiasi richiesta diretta a indirizzi IP o subnet non approvati.
  • Profili di Rumore & Jitter: Configura i livelli di throttle dell'engagement (Stealth, Normal, Aggressive) con distribuzioni di ritardo randomizzate.
  • Vault Enclave Crittografato AES-256: Hash NTLM raccolti, ticket Kerberos e credenziali di servizio sono crittografati a riposo con AES-256-GCM.
  • Workflow di Teardown Puliti: Eliminazione della campagna con un singolo clic che pulisce in modo sicuro tutte le righe del database associate, i vertici del grafo e gli artefatti temporanei.

4. ⚡ Orchestrazione Modulare dell'Avversario (60+ Moduli)

Vasto catalogo di tecniche avversarie weaponizzate allineate con la matrice enterprise MITRE ATT&CK.

• Il Problema Risolto: Sostituisce script GitHub non validati e inaffidabili con moduli avversari tipizzati, riproducibili e verificabili.
• Capacità Chiave:
  • Copertura Completa dei Vettori: 60+ tecniche modulari che coprono Active Directory (ad.kerberoast, ad.adcs, ad.enum_users), Windows (windows.uac_bypass), Linux, Cloud (AWS, Azure, GCP) e infrastruttura di rete.
  • Pannello di Esecuzione Semplificato: Vista di esecuzione pulita con etichette dei campi persistenti, suggerimenti sulle dipendenze a basso peso declassati e validazione focalizzata all'invio che sostituisce le carte di avviso intrusive predefinite.
  • Schemi Tipizzati Dinamici: I form dell'interfaccia vengono generati dinamicamente da modelli Python Pydantic con validazione rigorosa.
  • Motore di Sicurezza Dry-Run: Valida la reattività del target, i parametri e il risultato atteso prima di trasmettere traffico offensivo.
  • Esecuzione con Gating per Ruolo: Sono richiesti permessi di Operatore e Team Lead per l'esecuzione; i moduli sensibili ad alto rumore richiedono conferma esplicita.

5. 🕸️ Grafo d'Attacco Multi-Vettore & Replay degli Obiettivi

Solver interattivo di grafi aciclici diretti (DAG) che visualizza percorsi d'attacco enterprise e catene di escalation dei privilegi.

• Il Problema Risolto: Traduce i dati grezzi sulle vulnerabilità in percorsi di compromissione visivi e azionabili che dirigenti e ingegneri possono comprendere immediatamente.
• Capacità Chiave:
  • Routing Automatizzato dei Cavi Patch Cyber: Rendering in tempo reale di cavi bianchi luminosi automatizzati (#ffffff) che collegano Domain Controller, risultati di sicurezza e host scoperti senza trascinamento manuale.
  • Gerarchia Deterministica da Sinistra a Destra: Layout a colonne pulito e senza collisioni che origina dal Domain Controller (DC01) a sinistra, attraverso i risultati di sicurezza attivi, fino agli host membri target.
  • Algoritmi del Percorso più Breve: Calcola deterministicamente il minor numero di hop necessari per compromettere Domain Controller o credenziali root cloud.
  • Ingestione Nativa BloodHound / SharpHound: Importa direttamente archivi JSON BloodHound nel motore di grafo ARES per un'analisi unificata.
  • Ispezione Interattiva delle Entità: Esplora le relazioni tra utenti, gruppi, computer, ACL e sessioni Kerberos attive con navigazione fluida e ispettore dei dettagli sicuro in tempo reale.
  • Replay degli Obiettivi: Ri-simula catene d'attacco storiche per verificare l'efficacia delle patch difensive.

6. 📑 Motore di Report Automatizzato & Libreria delle Evidenze

Generazione istantanea di deliverable che produce report di conformità brandizzati e pronti per l'audit in molteplici formati enterprise (PDF Esecutivo, Markdown Tecnico, CSV dei Difetti).

• Il Problema Risolto: Elimina le 40+ ore tipicamente spese per scrivere, formattare e redigere manualmente i report di pentest.
• Capacità Chiave:
  • Griglia di Generazione Strutturata: Layout multi-colonna allineato con elementi <label> persistenti (Target Campaign, Export Format) e feedback pulito sugli errori di validazione inline.
  • Esportazione Multi-Formato: Generazione con un clic di deliverable in PDF, HTML, Markdown e JSON.
  • Motore PDF Headless Automatizzato: Fallback integrato che utilizza la modalità headless di Microsoft Edge / Chromium per un'esportazione PDF pulita senza complesse dipendenze GTK su Windows.
  • Redazione Automatizzata delle Evidenze: Redige automaticamente password grezze sensibili e chiavi private nei deliverable per il cliente, mantenendo le prove di audit.
  • Libreria di Report Sincronizzata: Repository di artefatti autenticato con download istantanei, eliminazione per singolo report e sincronizzazione dello stato dell'interfaccia in tempo reale.

7. 🧠 Strategia Autonoma & Planner AI

Motore autonomo orientato agli obiettivi che pianifica, prioritizza ed esegue catene d'attacco complesse rispettando i limiti OPSEC.

• Il Problema Risolto: Coordina catene d'attacco multi-modulo in modo autonomo senza richiedere costante intervento manuale dell'operatore.
• Capacità Chiave:
  • Verifica Dinamica del Motore: Healthcheck asincroni in tempo reale verso daemon Ollama locali (GET /api/tags) con timeout sub-secondo e caching TTL, abbinati a verifica dinamica lato server delle chiavi cloud (Claude, OpenAI).
  • Design Pulito Centrato sull'Operatore: Etichette dei campi persistenti (Target Campaign, Strategic Objective, AI Planning Engine, Explicit Authorizations), descrizioni degli obiettivi leggibili dall'uomo ed eliminazione completa della fuga di variabili d'ambiente del server nelle etichette dell'interfaccia.
  • Validazione Focalizzata all'Invio: Box di avviso rimossi dal rendering predefinito della pagina; gli errori di validazione vengono mostrati inline sotto i campi target solo al tentativo di esecuzione.
  • Governor di Contenimento Adattivo: Valuta continuamente la telemetria difensiva e le soglie di rumore, rallentando o interrompendo automaticamente le azioni aggressive quando il rischio di rilevamento raggiunge il picco.

8. 🔍 Deep-Dive sulle Entità del Grafo d'Attacco & Ispettore dei Nodi

Telemetria approfondita delle entità Active Directory, ispezione delle relazioni e audit sicuro dei dettagli in tempo reale direttamente all'interno del canvas.

• Il Problema Risolto: Elimina il context-switching tra visualizzatori di grafi e strumenti di ricognizione CLI fornendo telemetria live dei nodi in una sidebar interattiva.
• Capacità Chiave:
  • Ispezione degli Attributi delle Entità: Esamina istantaneamente indirizzo IP, hostname, telemetria del sistema operativo, livelli di compromissione e flag del domain controller (is_dc) selezionando qualsiasi nodo del grafo.
  • Mappatura delle Porte della Superficie d'Attacco: Visibilità in tempo reale sulle porte aperte dell'infrastruttura (DNS 53, Kerberos 88, RPC 135, NetBIOS 139, LDAP 389, SMB 445, LDAPS 636, Global Catalog 3268, RDP 3389).
  • Audit Sicuro dei Dettagli: Drawer a scomparsa verificato che fornisce telemetria granulare senza ingombrare il canvas DAG principale, completo di chiusura rapida.

9. 🔗 Catene di Esecuzione Multi-Stadio dell'Avversario

Kill chain deterministiche multi-step che orchestrano ricognizione, raccolta di credenziali e movimento laterale in sequenza.

• Il Problema Risolto: Sostituisce l'invocazione manuale passo-passo degli strumenti con catene d'attacco pre-verificate e coordinate che passano automaticamente gli output ai moduli a valle.
• Capacità Chiave:
  • Sequenze d'Attacco Pre-Costruite: Catene pronte all'uso per l'esposizione Kerberos (asreproast -> kerberoast -> hashcat), l'enumerazione del dominio e l'escalation dei privilegi cloud.
  • Passaggio Dinamico del Contesto: Credenziali e hash raccolti nello step 1 vengono automaticamente popolati negli argomenti target per gli step successivi.
  • Budgeting OPSEC Integrato: Traccia il rumore cumulativo e la probabilità di rilevamento lungo l'intera catena prima di avviare l'esecuzione.

10. 🛡️ Knowledge Base per Evasione & Bypass EDR / OPSEC

Tracciamento empirico dell'efficacia dell'evasione attraverso le piattaforme enterprise di endpoint detection and response (EDR).

• Il Problema Risolto: Impedisce agli operatori offensivi di distribuire ciecamente payload bruciati o rilevati contro infrastrutture clienti monitorate.
• Capacità Chiave:
  • Tassi di Successo Empirici: Tassi di successo storici categorizzati per specifiche tecniche di evasione (AMSI patching, syscall unhooking, process hollowing) e vendor EDR.
  • Memoria di Evasione Cross-Sessione: Gli esiti degli engagement aggiornano una knowledge base unificata, avvisando gli operatori prima che eseguano tecniche con basse probabilità di successo.
  • Controlli di Jitter Difensivi: Distribuzioni granulari dei ritardi e spaziatura dei pacchetti per evadere le euristiche comportamentali e le regole di correlazione SIEM.

11. 🔐 Governance di Sicurezza Zero-Trust & Audit Trail

Controllo degli accessi multi-ruolo verificato, ciclo di vita crittografico delle chiavi API e verifica continua dell'integrità della piattaforma.

• Il Problema Risolto: Garantisce non ripudio, separazione dei confini basata sui ruoli e garanzia di conformità per le operazioni di sicurezza offensiva.
• Capacità Chiave:
  • Controllo degli Accessi Basato sui Ruoli (RBAC): Livelli di permesso rigorosamente applicati (Team Lead, Operator, Recon, Reporter) che governano l'esecuzione dei moduli e la visualizzazione delle evidenze.
  • Chiavi API con Scope: Token bearer generati crittograficamente con scadenza configurabile e permessi granulari per l'integrazione CI/CD.
  • Audit Trail Live: Logging continuo append-only di ogni azione dell'operatore, scansione del target e recupero delle credenziali per la revisione post-engagement.

12. 📡 Operazioni Live & Stream di Eventi in Tempo Reale

Bus di eventi WebSocket ad alta frequenza che trasmette telemetria operativa, output dei moduli e stato della pipeline.

• Il Problema Risolto: Fornisce ai comandanti dell'engagement una consapevolezza situazionale istantanea e unificata di tutti gli agenti distribuiti e le attività in background.
• Capacità Chiave:
  • Consegna Eventi Sub-Secondo: Bus WebSocket asincrono che trasmette stdout/stderr live, eventi di completamento dei moduli e avvisi difensivi.
  • Telemetria dei Log Bufferizzata: Buffering degli eventi resiliente alla riconnessione che garantisce zero righe di log perse durante fluttuazioni di rete.
  • Collaborazione Multi-Operatore: Operatori simultanei vedono gli eventi di esecuzione condivisi della campagna in tempo reale.

13. 📋 Playbook Enterprise & Template di Campagna

Architetture di engagement standardizzate per esercitazioni red team ricorrenti, audit di conformità e drill purple team.

• Il Problema Risolto: Elimina la configurazione manuale dello scope per valutazioni standardizzate e garantisce una metodologia di test coerente attraverso gli engagement enterprise.
• Capacità Chiave:
  • Playbook Chiavi in Mano: Template di campagna pronti al deployment con profili target pre-configurati, set di moduli e requisiti di report.
  • Authoring di Template Personalizzati: Esporta engagement personalizzati di successo come template riutilizzabili per team interni e clienti MSSP.
  • Pre-Flight di Sicurezza: Validazione automatizzata di scope e permessi prima che qualsiasi campagna basata su template venga avviata.

14. 🔌 OpenAPI 3.1 Interattivo & Integrazione per Sviluppatori

Superficie REST API interattiva e completamente documentata per tooling personalizzato, orchestrazione SOC e integrazione con pipeline CI/CD.

• Il Problema Risolto: Consente un'integrazione programmatica senza soluzione di continuità con le piattaforme SOAR enterprise esistenti, pipeline di report personalizzate e gate di sicurezza CI/CD.
• Capacità Chiave:
  • 70+ Endpoint Documentati: Copertura REST completa su autenticazione, campagne, esecuzione dei moduli, grafi d'attacco e deliverable.
  • Conformità OpenAPI 3.1: Schemi di richiesta/risposta rigorosamente validati e generati direttamente da modelli Python Pydantic.
  • Sandbox Interattiva: Test API nel browser con autenticazione Bearer token e supporto CSRF token.

🎛️ Suddivisione delle Superfici di Controllo| Superficie | Responsabilità Principale | Sotto-Tab Disponibili | Operatori Principali |

| :--- | :--- | :--- | :--- | | Overview | Stato di salute esecutivo, contatori di telemetria, metriche di severità dei finding. | Pannello Singolo | Tutti gli Stakeholder | | Campaigns | Whitelisting dello scope, profili di rumore, vault di credenziali cifrato. | List, Scope, Findings | Team Lead, Operatore | | Modules | Catalogo di oltre 60 moduli, form di input parametri, console di esecuzione. | Catalog, Run Panel, Results | Operatore | | Reports | Builder di deliverable, pacchetti di evidenze, ciclo di vita della Report Library. | Generate, Library | Operatore, Reporter | | Graph | Esplorazione entità DAG, percorsi di attacco più brevi, ingest BloodHound. | Entities, Attack Paths, Ingest | Operatore, Recon | | Templates | Playbook di engagement ripetibili e piani di workflow multi-stadio. | Templates, Plan Builder | Team Lead, Operatore | | Strategy | Motore autonomo orientato agli obiettivi, integrazione planner AI. | Objective, Active, Result | Team Lead, Operatore | | Security | Credenziali operatore, ciclo di vita delle API key, controlli di audit delle dipendenze. | Account, API Keys, Audit | Team Lead | | EDR/OPSEC | Telemetria difensiva, tracciamento bypass, regole di evasione del rilevamento. | Knowledge Base, Report Outcome | Operatore | | Live | Stream di eventi WebSocket in tempo reale e log di telemetria bufferizzati. | Stream, Buffer | Operatore |

🏗️ Architettura del Sistema e Pipeline Dati

ARES segue una rigorosa architettura di difesa in profondità che separa presentazione, orchestrazione dell'esecuzione, governance della sicurezza e storage crittografico persistente:```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: Scoperta completa degli SPN, Kerberoasting (ad.kerberoast), AS-REP Roasting, abuso dei Certificate Template ADCS (da ESC1 a ESC8), replica degli account DCSync e generazione di dati BloodHound.
• Endpoint Posture Checkers: Metodi di bypass UAC su Windows, ispezione della persistenza tramite chiavi di registro, breakout da container Linux ed enumerazione dei privilegi Sudo.
• Cloud Control Plane: Audit delle identità multi-cloud su AWS IAM, assegnazioni di ruolo Azure Active Directory / Entra ID e binding IAM di GCP.

🚀 Quickstart: Operativo in 60 Secondi

Prerequisiti

• Python: 3.11 o 3.12 (Python 3.12 consigliato per Windows).
• Node.js: v18+ (testato su Node v20 LTS).
• OS: Windows 11/10 (PowerShell), Linux (Ubuntu/Debian/Kali) o macOS.

Percorso Rapido (PowerShell su 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. Configurazione del client AI con 1 clic (nessuna modifica manuale del JSON): Configura automaticamente il tuo IDE preferito con un singolo comando: ```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:~

Questo scrive il percorso del tuo ambiente virtuale Python attivo direttamente nel file di configurazione del client (ad es. .cursor/mcp.json).

3. Ricarica la finestra nell'IDE Cursor:

   • In Cursor, premi Ctrl + Shift + P.
   • Seleziona Developer: Reload Window.
   • Apri Settings (Ctrl + ,) → Features → MCP Servers. Il server ares mostrerà un punto verde (Connected).

4. Avvia il monitor live a due pannelli (finestra companion opzionale): In una finestra di terminale dedicata, esegui il monitor a due pannelli in stile OpenClaw per osservare in tempo reale le invocazioni degli strumenti AI, i controlli di scope e approvare i token: ```powershell .\mcp.bat monitor

   root@kitploit:~

• Riquadro sinistro: Flusso live delle chiamate agli strumenti eseguite dall'agente AI (ares_scope_check, ares_dry_run_module, ares_run_tool).
  • Riquadro destro: Confini CIDR di ScopeGuard, diff delle azioni in staging e l'Authorization Gateway.
  • Controlli: Premi A per approvare un token di esecuzione in sospeso, R per rifiutare, C per cancellare il flusso, Q per uscire.

5. Emetti il tuo primo comando all'agente AI: Apri Cursor Composer / Chat (Ctrl + I o Ctrl + L) e prova questo prompt:

   "Controlla lo stato della campagna attiva, verifica lo scope per il target 10.0.1.50 e prepara un dry-run del modulo ad_kerberoast."

Per l'architettura approfondita, le 7 invarianti di sicurezza, la scriptabilità CLI (--json), i codici di uscita POSIX e gli schemi operativi degli strumenti, consulta ARES MCP Gateway & Product-Grade CLI Specification.

🛠️ SDK per sviluppatori estensibile (architettura autonoma di nuova generazione)

ARES fornisce un SDK Python type-safe di prima classe (ares.sdk) per creare moduli avversari personalizzati, simulare tecniche in harness di test isolati e automatizzare gli engagement a livello programmatico:

1. Authoring di moduli type-safe (BaseModule[P, R] generico e @ares_module)

Dichiara schemi di parametri validati con Pydantic v2 e scrivi moduli con autocompletamento IDE completo:```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. Automazione programmatica (AresClient)

Automatizza gli engagement, invia moduli e trasmetti telemetria WebSocket in tempo reale tramite script Python o pipeline CI/CD:```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"])