
Plateforme autonome d'engagement red-team avec orchestration de modules MITRE ATT&CK, résolution de chemins d'attaque par DAG, contrôles OPSEC, coffre-fort d'identifiants chiffré et rapports multi-formats.
La plateforme open-core qui permet aux équipes rouges d'entreprise, aux MSSP et aux centres d'opérations de sécurité d'exécuter des engagements offensifs ciblés, de découvrir des chemins d'attaque déterministes et de valider en continu la posture défensive sans aucun risque collatéral.
Vitrine de la plateforme • Pourquoi ARES ? • Matrice concurrentielle • Architecture • Matrice MITRE • Démarrage rapide • Sécurité Zero-Trust • Documentation
Les tests d'intrusion traditionnels sont fondamentalement défaillants : ils sont coûteux, épisodiques, ponctuels et laissent les organisations aveugles face aux nouvelles erreurs de configuration introduites et aux techniques émergentes des adversaires. Pendant ce temps, les scanners de vulnérabilités automatisés submergent les équipes SOC de milliers de CVE hypothétiques sans démontrer l'exploitabilité ni les chemins d'attaque latéraux multi-étapes.
ARES comble cette lacune. Conçu dès le départ pour l'infrastructure d'entreprise moderne, ARES fournit une plateforme autonome d'engagement d'équipe rouge orientée objectifs qui modélise les acteurs de menace du monde réel. En combinant des pare-feux de périmètre au niveau du noyau, un profilage de bruit OPSEC adaptatif, un solveur d'attaque interactif sous forme de graphe orienté acyclique (DAG) et plus de 60 techniques weaponisées mappées à MITRE ATT&CK, ARES permet aux équipes de sécurité de prouver l'exploitabilité des vulnérabilités, de localiser les chemins de compromission les plus courts vers les joyaux de la couronne Active Directory et de générer des livrables prêts pour la direction sans aucun temps d'arrêt opérationnel.
THE ARES ADVANTAGE
┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐ │ 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 │ └─────────────────────────┘
### Piliers de valeur fondamentaux
1. **🛡️ Gouvernance de périmètre sans effet collatéral** : Chaque campagne s'exécute à l'intérieur d'une frontière cryptographique isolée. Des validations strictes des IP et CIDR cibles au niveau de la couche socket réseau garantissent qu'aucun paquet ne touche jamais une infrastructure hors périmètre.
2. **🧠 Planification autonome orientée objectifs** : Les opérateurs définissent des objectifs de haut niveau (par ex. `domain_admin`, `full_compromise`, `cloud_audit`), et le moteur de décision ARES synthétise autonomement des chemins d'exécution multi-étapes en utilisant des heuristiques de graphe et des agents LLM optionnels (Claude / OpenAI / Ollama local).
3. **🕸️ Graphe d'attaque multi-vecteurs (DAG)** : Ingérez des collectes BloodHound ou cartographiez les sessions de domaine actives en temps réel. Le moteur de graphe intégré calcule les chemins d'attaque les plus courts, met en évidence les points d'étranglement et simule la faisabilité des pivots latéraux.
4. **🔐 Modèle de sécurité en profondeur** : Conçu pour les environnements zero-trust. Sessions faisant autorité en base de données, jetons d'accès JWT de courte durée en mémoire uniquement, identifiants de rafraîchissement rotatifs HttpOnly et coffres locaux chiffrés AES-256-GCM protègent les hashes collectés et les preuves clients sensibles.
5. **📑 Pipeline de livrables automatisé** : Génération en un clic de livrables de conformité de marque, prêts pour l'audit, aux formats PDF, HTML, Markdown et JSON. Inclut le rendu PDF automatisé par navigateur headless sous Windows/Linux sans dépendances GTK externes.
---
## 📊 Matrice de comparaison du marché
| Capacité opérationnelle | Pentest manuel traditionnel | Scanners de vulnérabilités hérités | Plateforme autonome ARES |
| :--- | :---: | :---: | :---: |
| **Fréquence de test** | Annuelle / Semestrielle | Planifiée quotidienne / hebdomadaire | **Continue / À la demande** |
| **Validation de l'exploitabilité** | Manuelle et intensive en main-d'œuvre | ❌ Correspondance CVE théorique | **Preuve déterministe multi-étapes** |
| **Chemins d'attaque multi-sauts** | Dessin manuel | ❌ Aucun | **DAG interactif en temps réel** |
| **Enclave de périmètre et pare-feu de sortie** | Discipline de l'opérateur uniquement | Pare-feu réseau uniquement | **Application CIDR stricte au niveau socket** |
| **Chemins latéraux Active Directory** | Exécution de scripts lente | ❌ Aucun chemin actif | **Suite native BloodHound et Kerberos** |
| **Sécurité et stockage des identifiants** | Fichiers plats en clair | Journaux de vulnérabilités | **Coffre chiffré AES-256-GCM** |
| **OPSEC et limitation de télémétrie** | Scripts de jitter manuels | Bruit réseau élevé | **Profils de bruit adaptatifs et gouverneur** |
| **Délai de livraison des rapports** | 1–2 semaines après l'engagement | Vidages de données brutes | **Artefacts multi-formats instantanés** |
| **Empreinte de déploiement** | Consultants externes | Agents cloud volumineux | **Local air-gapped / auto-hébergé** |
---
## 🖥️ Vitrine de la plateforme et surfaces de contrôle
La plateforme ARES dispose d'un tableau de bord opérateur réactif et haute performance, conçu avec une esthétique dark-tech, une faible charge cognitive et un contrôle opérationnel audité.```powershell
# Launch local development environment
.\.venv\Scripts\ares.exe dashboard dev --no-reload
Barrière d'entrée autonome conçue spécifiquement pour les opérateurs offensifs autorisés et le personnel de sécurité.

ARES Operator Enclave — Le bouton Sign In explose en feu plasma cramoisi au survol, au clic et à la touche Entrée. Canvas Dynamic Architectural Grid, spécifications de l'environnement système et mascotte ARES Cyber Dragon sur le panneau de droite.
requestAnimationFrame.InResponseTo/nonce), le mappage des rôles JIT et le verrouillage strict des mots de passe locaux pour les identités fédérées. (Voir Guide de Configuration SSO).X-ARES-CSRF).Console de commandement opérationnelle en temps réel offrant une visibilité instantanée sur la posture à travers les campagnes actives.

Centre de Commandement Exécutif affichant la télémétrie en temps réel, les constats confirmés par sévérité et la santé opérationnelle.

Vue d'Ensemble Tactique Zero-State — Hero d'onboarding épuré avec bande de préparation instantanée et actions d'initialisation lors de l'exécution sans campagne active.
panel-subtle), des indicateurs de santé réactifs dynamiques dans la barre supérieure et des pistes de progression en pointillés distinctes pour les métriques non initialisées.Staged, Executing ou Standby) distinguant les cibles délimitées des campagnes en exécution.Gouvernance des cibles sans dommages collatéraux appliquant des frontières strictes de liste blanche CIDR et une isolation chiffrée des preuves.

Interface de Gestion des Campagnes affichant les périmètres de cibles, les frontières CIDR, les contrôles de bruit et le coffre d'identifiants chiffré.
<label> sur tous les sélecteurs de campagne et champs de paramètres, évitant toute ambiguïté pour l'opérateur lors d'engagements rapides.Stealth, Normal, Aggressive) avec des distributions de délais randomisées.Catalogue étendu de techniques adverses weaponisées alignées sur la matrice MITRE ATT&CK enterprise.

Catalogue de Modules avec catégorisation MITRE ATT&CK, génération dynamique de paramètres et modes de sécurité dry-run.
ad.kerberoast, ad.adcs, ad.enum_users), Windows (windows.uac_bypass), Linux, Cloud (AWS, Azure, GCP) et infrastructure réseau.Solveur interactif de graphe acyclique dirigé (DAG) visualisant les chemins d'attaque d'entreprise et les chaînes d'élévation de privilèges.

Graphe d'Attaque Multi-Vecteurs avec câbles de raccordement blancs lumineux automatisés, hiérarchie de gauche à droite (Contrôleur de Domaine → Constats → Hôtes) et inspection sécurisée des métadonnées en temps réel.
#ffffff) connectant les Contrôleurs de Domaine, les constats de sécurité et les hôtes découverts sans glisser-déposer manuel.DC01) à gauche, à travers les constats de sécurité actifs, jusqu'aux hôtes membres cibles.Génération instantanée de livrables produisant des rapports de conformité brandés et prêts pour l'audit dans plusieurs formats d'entreprise (PDF Exécutif, Markdown Technique, CSV de Défauts).

Moteur de Rapports et Bibliothèque d'Artefacts prenant en charge les exports multi-formats avec gestion synchronisée du cycle de vie en temps réel.
<label> persistants (Target Campaign, Export Format) et retour d'erreur de validation en ligne épuré.Moteur autonome orienté objectifs qui planifie, priorise et exécute des chaînes d'attaque complexes tout en respectant les limites OPSEC.

Console de Stratégie Autonome pour la planification de campagnes basée sur les objectifs et la gouvernance adaptative du confinement.
GET /api/tags) avec timeouts inférieurs à la seconde et mise en cache TTL, associés à une vérification dynamique côté serveur des clés cloud (Claude, OpenAI).Target Campaign, Strategic Objective, AI Planning Engine, Explicit Authorizations), descriptions d'objectifs lisibles par l'homme et élimination complète des fuites de variables d'environnement serveur dans les libellés de l'UI.Télémétrie approfondie des entités Active Directory, inspection des relations et audit sécurisé des détails en temps réel directement dans le canvas.

Tiroir de Détails Sécurisé Interactif affichant la télémétrie du Contrôleur de Domaine (DC01 10.10.10.2), les niveaux de compromission actifs, les ports de surface d'attaque ouverts (53, 88, 135, 139, 389, 445, 636, 3268, 3389) et les états de propriété des actifs.
is_dc) lors de la sélection de n'importe quel nœud du graphe.53, Kerberos 88, RPC 135, NetBIOS 139, LDAP 389, SMB 445, LDAPS 636, Global Catalog 3268, RDP 3389).Kill chains déterministes multi-étapes orchestrant la reconnaissance, la collecte d'identifiants et le mouvement latéral en séquence.

Chaînes d'exécution automatisées incluant la Chaîne d'Exposition Kerberos AD et la Chaîne d'Énumération de Domaine AD.
asreproast -> kerberoast -> hashcat), l'énumération de domaine et l'élévation de privilèges cloud.Suivi empirique de l'efficacité de l'évasion sur les plateformes de détection et réponse des points de terminaison (EDR) d'entreprise.

Base de Connaissances de Contournement suivant les taux de succès des techniques sur CrowdStrike Falcon, SentinelOne et Microsoft Defender.
Contrôle d'accès multi-rôles audité, cycle de vie cryptographique des clés API et vérification continue de l'intégrité de la plateforme.

Gestion du profil opérateur, provisionnement de clés API délimitées et audits de sécurité système automatisés.
Team Lead, Operator, Recon, Reporter) régissant l'exécution des modules et la consultation des preuves.Bus d'événements WebSocket haute fréquence diffusant la télémétrie opérationnelle, la sortie des modules et l'état du pipeline.

Console d'événements opérationnels en direct avec télémétrie tamponnée et streaming WebSocket à haut débit.
Architectures d'engagement standardisées pour les exercices red team récurrents, les audits de conformité et les drills purple team.

Modèles d'engagement intégrés incluant Internal Pentest, AD Full Compromise, Cloud Assessment et Assumed Breach.
Surface d'API REST interactive et entièrement documentée pour l'outillage personnalisé, l'orchestration SOC et l'intégration de pipelines CI/CD.

Documentation Swagger UI interactive exposant 70+ endpoints opérationnels pour l'automatisation d'entreprise.
| :--- | :--- | :--- | :--- |
| Overview | Santé exécutive, compteurs de télémétrie, métriques de sévérité des findings. | Single Pane | Toutes les parties prenantes |
| Campaigns | Liste blanche de périmètre, profils de bruit, coffre de credentials chiffré. | List, Scope, Findings | Chef d'équipe, Opérateur |
| Modules | Catalogue de 60+ modules, formulaires de saisie de paramètres, console d'exécution. | Catalog, Run Panel, Results | Opérateur |
| Reports | Générateur de livrables, packages de preuves, cycle de vie de la Report Library. | Generate, Library | Opérateur, Reporter |
| Graph | Exploration d'entités DAG, chemins d'attaque les plus courts, ingestion BloodHound. | Entities, Attack Paths, Ingest | Opérateur, Recon |
| Templates | Playbooks d'engagement réutilisables et plans de workflow multi-étapes. | Templates, Plan Builder | Chef d'équipe, Opérateur |
| Strategy | Moteur autonome orienté objectifs, intégration du planificateur IA. | Objective, Active, Result | Chef d'équipe, Opérateur |
| Security | Credentials des opérateurs, cycle de vie des clés API, contrôles d'audit des dépendances. | Account, API Keys, Audit | Chef d'équipe |
| EDR/OPSEC | Télémétrie défensive, suivi des contournements, règles d'évasion de détection. | Knowledge Base, Report Outcome | Opérateur |
| Live | Flux d'événements WebSocket en temps réel et journaux de télémétrie mis en tampon. | Stream, Buffer | Opérateur |
ARES suit une architecture stricte de défense en profondeur séparant la présentation, l'orchestration de l'exécution, la gouvernance de la sécurité et le stockage cryptographique persistant :```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
subgraph Gateway["Zero-Trust Security Gateway"]
FastAPI["FastAPI Async Engine<br>(Uvicorn Backend)"]
AuthGuard["Auth & Session Guard<br>(Memory-Only JWT + HttpOnly Refresh)"]
CSRF["HMAC Double-Submit CSRF<br>(X-ARES-CSRF Validation)"]
RateLimit["Rate Limiting & Brute-Force Shield"]
end
subgraph Core["ARES Core Engine & Governance"]
ScopeFirewall["Scope Egress Firewall<br>(Strict CIDR & IP Whitelist)"]
Governor["OPSEC Noise Governor<br>(Adaptive Jitter & Throttling)"]
Orchestrator["Module Execution Orchestrator<br>(Worker Thread Pool)"]
AutoPlanner["Autonomous Strategy Engine<br>(DAG Heuristics / AI Planner)"]
end
subgraph Storage["Cryptographic Persistence Layer"]
DB[(SQLite / PostgreSQL<br>Alembic Versioned)]
Vault[(AES-256-GCM Vault<br>Encrypted Credentials & Hashes)]
GraphEngine["Attack Graph DAG Engine<br>(BloodHound Ingest & Shortest Path)"]
end
subgraph Deliverables["Reporting Pipeline"]
PDFGen["Headless Chromium / Edge Engine<br>(Automated PDF Generation)"]
Artifacts["Evidence Library<br>(HTML, Markdown, JSON)"]
end
UI -->|HTTPS / REST| AuthGuard
WSClient -->|WSS / Ticket Barrier| AuthGuard
AuthGuard --> CSRF --> RateLimit --> FastAPI
FastAPI --> ScopeFirewall
ScopeFirewall --> Orchestrator
Orchestrator --> Governor
Orchestrator --> AutoPlanner
Orchestrator --> Storage
Storage --> GraphEngine
FastAPI --> Deliverables
## ⚔️ Techniques d'adversaire & Matrice MITRE ATT&CK
ARES implémente plus de 60 techniques d'adversaire modulaires nativement mappées au Cadre MITRE ATT&CK Enterprise :```
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ MITRE ATT&CK MATRIX COVERAGE │
├─────────────────────┬─────────────────────┬─────────────────────┬─────────────────────┬──────────────────────────┤
│ DISCOVERY │ CREDENTIAL ACCESS │ LATERAL MOVEMENT │ PRIVILEGE ESCALATION│ DEFENSE EVASION / CLOUD │
├─────────────────────┼─────────────────────┼─────────────────────┼─────────────────────┼──────────────────────────┤
│ • T1087 User Enum │ • T1558.003 Kerberoast│ • T1021.002 SMB/RPC │ • T1548.002 UAC Byps│ • T1070 Indicator Removal│
│ • T1069 Group Enum │ • T1558.004 AS-REP │ • T1021.006 WinRM │ • T1068 Token Privs │ • T1562 Impair Defenses │
│ • T1046 Port/Net │ • T1003 LSASS Dump │ • T1550 Use Ticket │ • T1053 Scheduled │ • T1078 Cloud IAM Enum │
│ • T1018 Host Disc │ • T1649 ADCS ESC1-8 │ • T1071 App Layer │ • T1055 Injection │ • T1580 Cloud Discovery │
│ • T1082 System Info │ • T1110 Pass Spray │ • T1021.001 RDP │ • T1134 Access Token│ • T1526 Cloud Hierarchy │
└─────────────────────┴─────────────────────┴─────────────────────┴─────────────────────┴──────────────────────────┘
ad.kerberoast), AS-REP Roasting, abus des modèles de certificats ADCS (ESC1 à ESC8), réplication de comptes DCSync et génération de données BloodHound.git clone https://github.com/Mafifrizi/ARES.git Set-Location .\ARES
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]"
Set-Location frontend & "C:\Program Files\nodejs\npm.cmd" ci Set-Location ..
$env:ARES_PDF_BROWSER = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" ..venv\Scripts\ares.exe doctor --pdf-smoke
..venv\Scripts\ares.exe dashboard dev --no-reload
Ouvrez votre navigateur sur **`http://127.0.0.1:5173/dashboard/`**.
- **Opérateur initial** : `admin`
- **Mot de passe initial** : Configuré via `ARES_DEFAULT_ADMIN_PASSWORD` dans `.env` (par défaut : `Admin123456!`)
---
## 🔐 Modèle de sécurité d'entreprise et conformité
ARES a été conçu pour les environnements soumis aux exigences de conformité et de confidentialité les plus strictes :
### Authentification en profondeur
- **Jetons d'accès en mémoire uniquement** : Les JWT à courte durée de vie (15 minutes) existent uniquement dans l'état React en mémoire et ne sont jamais écrits dans `localStorage` ou `sessionStorage`.
- **Famille de rafraîchissement rotative** : Les identifiants de rafraîchissement à longue durée de vie sont liés à des cookies stricts, host-only et HttpOnly (`ares_refresh`) avec rotation à usage unique et révocation automatique en cas de réutilisation.
- **Barrière CSRF HMAC** : Les points de terminaison modifiant l'état exigent des en-têtes `X-ARES-CSRF` valides, vérifiés par rapport à des jetons de cookie cryptographiquement sûrs.
### Contrôle d'accès basé sur les rôles (RBAC)
ARES applique des permissions RBAC strictes sur tous les points de terminaison API, les tâches en arrière-plan et les interfaces utilisateur :
| Rôle | Valeur API | Périmètre opérationnel | Autorité administrative |
| :--- | :---: | :--- | :--- |
| **Chef d'équipe** | `team_lead` | Autorité complète sur la plateforme : création/suppression de campagnes, provisionnement des utilisateurs, audits de sécurité, dérogations pour les modules à fort bruit. | Administrateur système complet |
| **Opérateur** | `operator` | Opérations quotidiennes : exécution des modules autorisés, examen des résultats, exploration du graphe d'attaque, génération de rapports. Ne peut pas enregistrer d'utilisateurs. | Niveau opérationnel |
| **Recon** | `recon` | Reconnaissance à forte composante lecture : exécution des modules sûrs de découverte et d'empreinte réseau. L'exécution des modules perturbateurs est bloquée. | Forte composante lecture |
| **Rapporteur** | `reporter` | Revue par les parties prenantes : accès en lecture seule aux analyses de campagne, résultats, graphes d'attaque et livrables générés. Aucun droit d'exécution. | Audit en lecture seule |
#### Garanties de provisionnement des rôles et d'anti-escalade de privilèges
- **Identité faisant autorité en base de données** : Contrairement aux systèmes qui font aveuglément confiance aux revendications de rôle JWT côté client, ARES résout l'identité et le rôle de l'utilisateur directement depuis la base de données active à chaque requête (`row = await db.resolve_access_token_principal(...)`). Les revendications JWT falsifiées sont mathématiquement écartées.
- **Contrôle strict des rôles à la création de compte** : Les rôles des nouveaux utilisateurs sont attribués exclusivement par un `team_lead` via `POST /auth/register` (protégé par `require_team_lead()`) ou automatiquement mappés depuis les fournisseurs d'identité d'entreprise lors d'un SSO SAML/OIDC initié par le SP.
- **Immutabilité des rôles** : Les attributions de rôles sont immuables après création. Aucun point de terminaison public ne permet de modifier les rôles des utilisateurs (`PUT /users/{id}` n'existe pas), éliminant les vecteurs d'escalade de privilèges horizontale et verticale (par exemple, `recon` passant à `team_lead` ou `reporter` exécutant des modules offensifs).
- **Inventaire des utilisateurs audité** : La console `Security` du tableau de bord fournit un inventaire transparent de toutes les identités enregistrées et des sessions actives pour la responsabilité de l'engagement.
---
## 🔌 Passerelle MCP ARES et CLI de qualité professionnelle
ARES fournit une passerelle **Model Context Protocol (MCP)** de qualité production qui permet aux assistants de codage IA modernes (Cursor IDE, Claude Desktop, Windsurf, VS Code Cline, Zed, Open-WebUI, LibreChat) d'interagir avec la plateforme offensive purple-team ARES en toute sécurité et sous gouvernance stricte.
<div align="center">

*Moniteur de terminal à deux volets ARES MCP (style OpenClaw) avec télémétrie des outils en temps réel, inspection du périmètre en direct et autorisation de jeton à 1 touche.*
</div>
Contrairement aux serveurs MCP basiques qui exposent des points de terminaison bruts aux LLM sans garde-fous, ARES applique une **Invariance de périmètre pré-vol (`ScopeGuard`)** stricte, une **Isolation de contamination anti-injection de prompt** et des **Jetons de confirmation HMAC à usage unique de 60 secondes** avant toute action offensive en direct.
### 🚀 Par où commencer ? (Intégration pas à pas)
Pour les opérateurs ou développeurs connectant Cursor, Claude Desktop ou Windsurf à ARES :
1. **Vérifier l'état de préparation des sous-systèmes (`doctor`)** :
Assurez-vous que tous les sous-systèmes principaux (moteur de protocole, 9 outils, 3 ressources, 3 prompts, 62 modules, barrières de sécurité) rapportent `PASS` : ```powershell
.\mcp.bat doctor
Configuration client IA en 1 clic (sans édition manuelle de JSON) : Configurez automatiquement votre IDE préféré avec une seule commande : ```powershell
.\mcp.bat setup --client cursor
.\mcp.bat setup --client claude
.\mcp.bat setup --client windsurf
.\mcp.bat setup --client cline
Cela écrit le chemin de votre environnement virtuel Python actif directement dans le fichier de configuration du client (par exemple .cursor/mcp.json).
Recharger la fenêtre dans l'IDE Cursor :
Ctrl + Shift + P.Developer: Reload Window.Ctrl + ,) → Features → MCP Servers. Le serveur ares affichera un point vert (Connected).Lancer le moniteur en direct à deux volets (fenêtre complémentaire facultative) : Dans une fenêtre de terminal dédiée, exécutez le moniteur à deux volets de style OpenClaw pour observer en temps réel les invocations d'outils IA, les vérifications de portée et approuver les jetons : ```powershell .\mcp.bat monitor
ares_scope_check, ares_dry_run_module, ares_run_tool).
A pour approuver un jeton d'exécution en attente, R pour rejeter, C pour effacer le flux, Q pour quitter.Ctrl + I ou Ctrl + L), et essayez ce prompt :
"Vérifie le statut de la campagne active, valide le périmètre pour la cible 10.0.1.50, et prépare un dry-run du module ad_kerberoast."
Pour une architecture approfondie, les 7 invariants de sécurité, la scriptabilité CLI (--json), les codes de sortie POSIX, et les schémas d'outils opérationnels, consultez ARES MCP Gateway & Product-Grade CLI Specification.
ARES fournit un SDK Python typé de premier ordre (ares.sdk) pour créer des modules adverses personnalisés, simuler des techniques dans des harnais de test isolés, et automatiser des engagements par programmation :
BaseModule[P, R] & @ares_module)Déclarez des schémas de paramètres validés avec Pydantic v2 et écrivez des modules avec autocomplétion IDE complète :```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
async def execute(self, ctx: ExecutionContext[KerberoastParams]) -> ModuleResult:
# ctx.params provides full static typing and runtime validation
await self.before_request(ctx.params.dc)
# Emit findings using fluent context helpers
finding = ctx.emit_finding(
title=f"Kerberoastable SPN Captured on {ctx.params.dc}",
severity=Severity.HIGH,
mitre_technique="T1558.003",
)
return ModuleResult(status="success", findings=[finding], module_id=self.MODULE_ID)
### 2. Tests isolés et simulation (`ModuleTestHarness`)
Testez unitairement vos techniques personnalisées localement avec des gardes de portée simulés, des coffres-forts d'identifiants synthétiques et des matchers d'assertion fluides :```python
from ares.sdk import ModuleTestHarness, Severity
async def test_module():
harness = ModuleTestHarness(CustomKerberoastModule)
result = await harness.simulate(params={"dc": "10.0.0.10", "domain": "LAB.LOCAL"})
result.assert_success()
result.assert_finding(severity=Severity.HIGH, mitre="T1558.003")
AresClient)Automatisez les engagements, dispatchez les modules et diffusez la télémétrie WebSocket en temps réel via des scripts Python ou des pipelines 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"])
Consultez [docs/module_sdk.md](https://github.com/mafifrizi/ares/blob/main/docs/module_sdk.md) et [docs/module-development.md](https://github.com/mafifrizi/ares/blob/main/docs/module-development.md) pour la documentation complète destinée aux développeurs, les spécifications d'architecture et des exemples.
---
## 📚 Plan du site de documentation
Une documentation complète est disponible dans le répertoire [`docs/`](https://github.com/mafifrizi/ares/blob/main/docs) :
- [**Portail de documentation et index des sous-systèmes**](https://github.com/mafifrizi/ares/blob/main/docs/README.md)
- [**Guide de démarrage rapide pour les engagements**](https://github.com/mafifrizi/ares/blob/main/QUICKSTART.md)
- [**Spécification du SDK de modules de nouvelle génération (v2)**](https://github.com/mafifrizi/ares/blob/main/docs/module_sdk.md)
- [**Spécification du serveur ARES MCP et de la CLI de qualité professionnelle**](https://github.com/mafifrizi/ares/blob/main/docs/mcp-server.md)
- [**Guide de développement de modules étape par étape**](https://github.com/mafifrizi/ares/blob/main/docs/module-development.md)
- [**Manuel du tableau de bord, surface par surface**](https://github.com/mafifrizi/ares/blob/main/docs/dashboard-guide.md)
- [**Catalogue et schémas des modules adverses**](https://github.com/mafifrizi/ares/blob/main/docs/modules.md)
- [**Référence des points de terminaison de l'API et charges utiles**](https://github.com/mafifrizi/ares/blob/main/docs/api-reference.md)
- [**Guide d'intégration SSO d'entreprise (SAML 2.0 / OIDC)**](https://github.com/mafifrizi/ares/blob/main/docs/sso-setup.md)
- [**Sécurité d'entreprise et modèle de menaces**](https://github.com/mafifrizi/ares/blob/main/docs/security-model.md)
- [**Laboratoire de validation et banc d'essai**](https://github.com/mafifrizi/ares/blob/main/docs/validation-lab.md)
---
## ⚖️ Utilisation responsable et clause de non-responsabilité juridique
> [!IMPORTANT]
> **ARES est un framework logiciel à double usage conçu exclusivement pour la recherche autorisée en cybersécurité, la validation de la résilience interne des entreprises et les engagements professionnels de red team avec autorisation écrite explicite.**
- **N'exécutez PAS** ARES contre un réseau, un hôte ou une infrastructure cloud sans autorisation écrite préalable des propriétaires du système.
- Tout accès ou test non autorisé à un système enfreint les législations nationales et internationales sur la cybercriminalité (par exemple, le Computer Fraud and Abuse Act 18 U.S.C. § 1030).
- Les créateurs et mainteneurs d'ARES n'assument aucune responsabilité pour toute utilisation abusive, tout dommage ou toute violation réglementaire causés par ce logiciel.
Pour signaler des vulnérabilités de sécurité dans ARES, veuillez suivre notre [Politique de sécurité](https://github.com/mafifrizi/ares/blob/main/SECURITY.md).
---
## 📄 Licence
ARES est distribué sous la **[Licence MIT](https://github.com/mafifrizi/ares/blob/main/LICENSE)** open source.
<br>
<div align="center">
**ARES — Système autonome d'engagement red team de qualité professionnelle.**
*Validation continue de la sécurité. Risque collatéral nul.*
</div>