Mafifrizi /ARES

ARES - authorized red-team engagement automation with dashboard, campaign scope, module orchestration, OPSEC controls, encrypted vault, and reporting.

★ 1,057⑂ 236👁 7⑃ 74● 4▤ 1
PythonMITCreated 2026-06-21
Download: v6.0.0v6.0.0 ↓6.0.02026-06-22
+5
Daily
1,057
stars
236
forks
7
watchers
74
prs
4
issues
1
releases

README

Operator-directed red team orchestration & continuous security validation

Prove exploitability. Compute shortest paths to Crown Jewels. Ship audit-ready evidence.
Built for enterprise red teams, MSSPs and security operations centers that need to validate defensive posture continuously, not once a year.











Quickstart · Screens · Features · Docs · Security · Sponsor



---

 What ARES is

A self-hosted platform that runs real offensive validation modules inside a fail-closed scope enclave, maps attack paths on an interactive DAG, and produces branded reports, so your SOC sees exactly what an attacker could reach today, not what a scanner thinks might be a problem.

Not just a scanner. ARES only reports what it actually proved on a live target, including the multi-stage chain used to prove it.

 Why not a traditional pentest or a vulnerability scanner? See the market comparison matrix.

---

 Screens




Sign-in with the ARES mascot and the SSO fallback. Memory-only JWT access tokens, HttpOnly rotating refresh.




Operator overview: active engagements, validated findings, attack surface, engine health, telemetry pulse.




Catalog: 66 active modules across 13 categories, each annotated with MITRE ATT&CK techniques and OPSEC noise level.




Results: finding card with severity, confidence, remediation and one-click pivot to the next module.




Attack graph: perimeter firewall (fire animation), targets, pivot edges. Read-only beacon telemetry per node.




Campaign scope: target campaign picker, Restore Vault / Dry-Run Plan / Delete controls.



---

 Features

- Fail-closed scope enclave: dual-layer ScopeGuard (application pre-check + OS/transport firewall) guarantees zero offensive packets reach out-of-scope hosts. → security model
- Goal-directed attack planning: set domain_admin or cloud_audit, and the decision engine synthesizes multi-stage execution paths (graph heuristics, optional LLM agents under explicit authorization). → engine design
- Multi-vector attack graph (DAG): ingest BloodHound or map sessions in real time. Shortest-path, chokepoints, lateral pivot feasibility. → attack graph
- Zero-trust auth model: memory-only short-lived JWTs, HttpOnly rotating refresh, HMAC CSRF, AES-256-GCM AEAD vault (PBKDF2-HMAC-SHA256 600k). → security model
- 66 active production modules across 60+ MITRE ATT&CK techniques (AD, cloud, credential access, exfil, lateral, recon, Windows, Linux, EDR). → module catalog
- Automated deliverables: one-click branded PDF/HTML/Markdown/JSON reports via headless browser (no GTK deps on Windows/Linux). → dashboard guide
- MCP Gateway: Cursor/Claude Desktop/Windsurf/Cline can drive ARES safely under Pre-Flight ScopeGuard, anti-prompt-injection taint isolation and single-use HMAC confirmation tokens. → MCP spec
- Type-safe Python SDK: write custom modules with BaseModule[P, R] + @ares_module, simulate in ModuleTestHarness, automate with AresClient. → SDK docs · → module dev guide

---

 Quickstart

 Prerequisit

Discussions

Latest release

v6.0.0 v6.0.0 2026-06-22
ARES is an operator dashboard and automation framework for authorized red-team validation, lab workflows, campaign orchestration, module execution, telemetry, reporting, API key management, RBAC, and security validation.

Highlights:
- React operator dashboard
- FastAPI backend
- Campaign and module orchestration
- API key lifecycle management
- HTML report generation
- Security audit snapshot
- Validation lab script
- GitHub Actions CI
- 1078 unit tests passing

This project is intended for authorized security testing, lab use, and defensive validation only.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON