ARES - authorized red-team engagement automation with dashboard, campaign scope, module orchestration, OPSEC controls, encrypted vault, and reporting.
Python active-directorycloud-securitydefensive-validationfastapigood-first-issuemitre-attackopsecreactred-teamreportingsecurity
docs(readme): add visual gallery and platform showcase across all 14 surfaces with real screenshots
Mafifrizi2debfdb44734
diff --git a/.gitignore b/.gitignoreindex d59b377..a4223db 100644--- a/.gitignore+++ b/.gitignore@@ -59,6 +59,7 @@ evidence/logs/frontend/*.tsbuildinfo.cursor/+docs/MARKETING_EVIDENCE_SHOWCASE.mdfilescratch/.agents/diff --git a/README.md b/README.mdindex 8f26775..8fac689 100644--- a/README.md+++ b/README.md@@ -20,7 +20,7 @@<br>-[**Platform Showcase**](#-platform-showcase--control-surfaces) • [**Why ARES?**](#-why-enterprises-choose-ares) • [**Competitive Matrix**](#-market-comparison-matrix) • [**Architecture**](#-system-architecture--data-pipeline) • [**MITRE Matrix**](#-adversary-techniques--mitre-attck-matrix) • [**Quickstart**](#-quickstart-up-and-running-in-60-seconds) • [**Zero-Trust Security**](#-enterprise-security-model--compliance) • [**Documentation**](docs/)+[**Platform Showcase**](#-platform-showcase--control-surfaces) • [**Visual Gallery**](#-platform-visual-gallery) • [**Why ARES?**](#-why-enterprises-choose-ares) • [**Competitive Matrix**](#-market-comparison-matrix) • [**Architecture**](#-system-architecture--data-pipeline) • [**MITRE Matrix**](#-adversary-techniques--mitre-attck-matrix) • [**Quickstart**](#-quickstart-up-and-running-in-60-seconds) • [**Zero-Trust Security**](#-enterprise-security-model--compliance) • [**Documentation**](docs/)</div>@@ -84,6 +84,27 @@ Traditional penetration testing is fundamentally flawed: it is expensive, episodThe ARES Platform features a high-performance, responsive operator dashboard engineered with dark-tech aesthetics, low cognitive load, and audited operational control.+### 📸 Platform Visual Gallery++| # | Feature Surface | Screenshot Evidence | Verified Technical Capabilities |+|---|---|---|---|+| **01** | **Operator Enclave & Auth Gateway** | [`login-enclave.png`](docs/assets/screenshots/login-enclave.png) | Dragon particle physics canvas, SSO tabs, memory-only JWT barrier |+| **02** | **Executive Cockpit & Telemetry** | [`dashboard-overview.png`](docs/assets/screenshots/dashboard-overview.png) | 10 module runs (100% success), 8 confirmed findings, 6 targets, monthly telemetry |+| **03** | **Scoped Campaign Operations** | [`dashboard-campaigns.png`](docs/assets/screenshots/dashboard-campaigns.png) | `camp_titan_shield`, CIDR socket whitelisting, encrypted credential vault |+| **04** | **Attack Graph (BloodHound DAG)** | [`dashboard-graph.png`](docs/assets/screenshots/dashboard-graph.png) | 25 connected DAG nodes, shortest path to Domain Admin, crown jewel mapping |+| **05** | **Attack Graph Node Inspector** | [`dashboard-graph-inspector.png`](docs/assets/screenshots/dashboard-graph-inspector.png) | DC01.CORP.LOCAL live attributes, exposed ports (88, 389, 445, 636) |+| **06** | **Adversary Module Catalog** | [`dashboard-modules-catalog.png`](docs/assets/screenshots/dashboard-modules-catalog.png) | 62 modernized modules across 9 waves with MITRE ATT&CK tactic tags |+| **07** | **Interactive Module Drawer** | [`dashboard-module-drawer.png`](docs/assets/screenshots/dashboard-module-drawer.png) | Dynamic parameter schema & OPSEC noise rating (`low`, `high_noise`) |+| **08** | **Multi-Stage Execution Chains** | [`dashboard-modules-chains.png`](docs/assets/screenshots/dashboard-modules-chains.png) | AD Kerberos Exposure Chain & AD Domain Enumeration Chain |+| **09** | **Module Run Console** | [`dashboard-modules-run-panel.png`](docs/assets/screenshots/dashboard-modules-run-panel.png) | Scoped campaign targeting, parameter tuning, and execution panel |+| **10** | **Autonomous Strategy Engine** | [`dashboard-strategy.png`](docs/assets/screenshots/dashboard-strategy.png) | Goal planner (`domain_admin`, `full_compromise`) with AI agent support |+| **11** | **EDR & OPSEC Bypass Matrix** | [`dashboard-edr.png`](docs/assets/screenshots/dashboard-edr.png) | CrowdStrike, SentinelOne, Defender evasion tracking & knowledge base |+| **12** | **Compliance Deliverables Generator** | [`dashboard-reports.png`](docs/assets/screenshots/dashboard-reports.png) | Executive PDF, Markdown, and JSON report builder with headless Edge engine |+| **13** | **Zero-Trust Security Governance** | [`dashboard-security.png`](docs/assets/screenshots/dashboard-security.png) | RBAC roles, scoped API key lifecycle, automated dependency audit |+| **14** | **Live Operations WebSocket Stream** | [`dashboard-live.png`](docs/assets/screenshots/dashboard-live.png) | Real-time event streaming console with sub-second event delivery |+| **15** | **Campaign Playbook Templates** | [`dashboard-templates.png`](docs/assets/screenshots/dashboard-templates.png) | Turnkey playbooks (`internal_pentest`, `ad_full_compromise`, `cloud_assessment`) |+| **16** | **Interactive OpenAPI 3.1 Docs** | [`api-docs-swagger.png`](docs/assets/screenshots/api-docs-swagger.png) | Swagger UI exposing 70+ authenticated operational REST endpoints |+```powershell# Launch local development environment.\.venv\Scripts\ares.exe dashboard dev --no-reload@@ -253,6 +274,146 @@ The ARES Platform features a high-performance, responsive operator dashboard eng---+### 8. 🔍 Attack Graph Entity Deep-Dive & Node Inspector++*In-depth Active Directory entity telemetry, relationship inspection, and real-time risk scoring directly inside the canvas.*++<div align="center">++++*Real-time Node Inspector displaying Domain Controller (DC01.CORP.LOCAL) attributes, open attack ports (88, 389, 445, 636), and risk ratings.*++</div>++- **The Problem Solved**: Eliminates context-switching between graph visualizers and CLI reconnaissance tools by providing live node telemetry in an interactive sidebar.+- **Key Capabilities**:+ - **Entity Attribute Inspection**: Instantly examine OS versions, functional levels, Kerberos SPNs, and high-risk group memberships upon clicking any graph node.+ - **Attack Surface Port Mapping**: Live visibility into exposed services and potential pivot paths (LDAP, Kerberos, SMB, MSSQL, WinRM).+ - **Privilege Chokepoint Identification**: Highlights critical path bottlenecks where compromise of a single intermediate principal leads directly to Domain Admin.++---++### 9. 🔗 Multi-Stage Adversary Execution Chains++*Deterministic, multi-step kill chains orchestrating reconnaissance, credential harvesting, and lateral movement in sequence.*++<div align="center">++++*Automated execution chains including AD Kerberos Exposure Chain and AD Domain Enumeration Chain.*++</div>++- **The Problem Solved**: Replaces manual step-by-step tool invocation with pre-verified, coordinated attack chains that pass outputs automatically to downstream modules.+- **Key Capabilities**:+ - **Pre-Built Attack Sequences**: Out-of-the-box chains for Kerberos exposure (`asreproast` -> `kerberoast` -> `hashcat`), domain enumeration, and cloud privilege escalation.+ - **Dynamic Context Passing**: Credentials and hashes harvested in step 1 are automatically populated into target arguments for subsequent steps.+ - **Integrated OPSEC Budgeting**: Tracks cumulative noise and detection likelihood across the entire chain before initiating execution.++---++### 10. 🛡️ EDR / OPSEC Evasion & Bypass Knowledge Base++*Empirical tracking of evasion efficacy across enterprise endpoint detection and response (EDR) platforms.*++<div align="center">++++*Bypass Knowledge Base tracking technique success rates across CrowdStrike Falcon, SentinelOne, and Microsoft Defender.*++</div>++- **The Problem Solved**: Prevents offensive operators from blindly deploying burned or detected payloads against monitored customer infrastructure.+- **Key Capabilities**:+ - **Empirical Success Rates**: Historical success rates categorized by specific evasion techniques (AMSI patching, syscall unhooking, process hollowing) and EDR vendor.+ - **Cross-Session Evasion Memory**: Engagement outcomes update a unified knowledge base, warning operators before they execute techniques with low success probabilities.+ - **Defensive Jitter Controls**: Granular delay distributions and packet spacing to evade behavioral heuristics and SIEM correlation rules.++---++### 11. 🔐 Zero-Trust Security Governance & Audit Trail++*Audited multi-role access control, cryptographic API key lifecycle, and continuous platform integrity verification.*++<div align="center">++++*Operator profile management, scoped API key provisioning, and automated system security audits.*++</div>++- **The Problem Solved**: Guarantees non-repudiation, role-based boundary separation, and compliance assurance for offensive security operations.+- **Key Capabilities**:+ - **Role-Based Access Control (RBAC)**: Strictly enforced permission tiers (`Team Lead`, `Operator`, `Recon`, `Reporter`) governing module execution and evidence viewing.+ - **Scoped API Keys**: Cryptographically generated bearer tokens with configurable expiration and fine-grained permissions for CI/CD integration.+ - **Live Audit Trail**: Continuous append-only logging of every operator action, target scan, and credential retrieval for post-engagement review.++---++### 12. 📡 Live Operations & Real-Time Event Stream++*High-frequency WebSocket event bus streaming operational telemetry, module output, and pipeline status.*++<div align="center">++++*Live operational event console with buffered telemetry and high-throughput WebSocket streaming.*++</div>++- **The Problem Solved**: Gives engagement commanders instant, unified situational awareness of all distributed agents and background tasks.+- **Key Capabilities**:+ - **Sub-Second Event Delivery**: Asynchronous WebSocket bus streaming live stdout/stderr, module completion events, and defensive alerts.+ - **Buffered Log Telemetry**: Reconnection-resilient event buffering ensuring zero lost log lines during network fluctuations.+ - **Multi-Operator Collaboration**: Simultaneous operators see shared campaign execution events in real time.++---++### 13. 📋 Enterprise Playbooks & Campaign Templates++*Standardized engagement architectures for recurring red team exercises, compliance audits, and purple team drills.*++<div align="center">++++*Built-in engagement templates including Internal Pentest, AD Full Compromise, Cloud Assessment, and Assumed Breach.*++</div>++- **The Problem Solved**: Eliminates manual scope configuration for standardized assessments and ensures consistent testing methodology across enterprise engagements.+- **Key Capabilities**:+ - **Turnkey Playbooks**: Ready-to-deploy campaign templates with pre-configured target profiles, module sets, and report requirements.+ - **Custom Template Authoring**: Export successful custom engagements as reusable templates for internal teams and MSSP clients.+ - **Safety Pre-Flights**: Automated scope and permission validation before any template-based campaign goes live.++---++### 14. 🔌 Interactive OpenAPI 3.1 & Developer Integration++*Fully documented, interactive REST API surface for custom tooling, SOC orchestration, and CI/CD pipeline integration.*++<div align="center">++++*Interactive Swagger UI documentation exposing 70+ operational endpoints for enterprise automation.*++</div>++- **The Problem Solved**: Enables seamless programmatic integration with existing enterprise SOAR platforms, custom reporting pipelines, and CI/CD security gates.+- **Key Capabilities**:+ - **70+ Documented Endpoints**: Complete REST coverage across authentication, campaigns, module execution, attack graphs, and deliverables.+ - **OpenAPI 3.1 Conformance**: Strictly validated request/response schemas generated directly from Python Pydantic models.+ - **Interactive Sandbox**: In-browser API testing with Bearer token authentication and CSRF token support.++---+## 🎛️ Control Surfaces Breakdown| Surface | Core Responsibility | Available Sub-Tabs | Primary Operators |diff --git a/ares/api/rbac.py b/ares/api/rbac.pyindex b1124aa..36bb8a2 100644--- a/ares/api/rbac.py+++ b/ares/api/rbac.py@@ -18,6 +18,7 @@ TTL auto-expires keys after 120s to prevent memory leaks.from __future__ import annotationsimport math+import osimport timefrom collections import defaultdict, dequefrom collections.abc import Mapping@@ -331,6 +332,8 @@ class _InProcessLimiter:)def is_allowed(self, key: str, max_per_minute: int) -> tuple[bool, int]:+ if os.environ.get("ARES_DISABLE_RATE_LIMIT") == "1":+ return True, 999999now = time.time()window = self._windows[key]while window and window[0] < now - 60:@@ -367,6 +370,8 @@ class _RedisRateLimiter:self._r = redis_clientasync def is_allowed_async(self, key: str, max_per_minute: int) -> tuple[bool, int]:+ if os.environ.get("ARES_DISABLE_RATE_LIMIT") == "1":+ return True, 999999import uuid as _uuidnow = time.time()window_key = f"ares:rl:{key}"diff --git a/ares/api/server.py b/ares/api/server.pyindex 1718409..4f997b4 100644--- a/ares/api/server.py+++ b/ares/api/server.py@@ -114,13 +114,26 @@ logger = get_logger("ares.api.server")def _campaign_from_db_row(row: dict[str, Any]) -> Campaign:data = {k: v for k, v in row.items() if k in Campaign.model_fields}+ if data.get("status") == "active":+ data["status"] = "running"if "scope" not in data and row.get("scope_json"):import json as _jsontry:scope = _json.loads(str(row["scope_json"]))if isinstance(scope, list):- data["scope"] = scope+ coerced_scope = []+ for s in scope:+ if isinstance(s, str):+ try:+ from netaddr import IPNetwork+ IPNetwork(s)+ coerced_scope.append({"cidr": s, "description": ""})+ except Exception:+ continue+ elif isinstance(s, dict):+ coerced_scope.append(s)+ data["scope"] = coerced_scopeexcept (TypeError, ValueError):data["scope"] = []if "targets" not in data and row.get("targets_json"):@@ -635,16 +648,29 @@ async def security_headers(request: Request, call_next: Any) -> Any:response.headers["X-Frame-Options"] = "DENY"response.headers["X-XSS-Protection"] = "1; mode=block"response.headers["Referrer-Policy"] = "strict-origin-when-cross-origin"- response.headers["Content-Security-Policy"] = (- "default-src 'self'; "- "script-src 'self'; "- "style-src 'self'; "- "img-src 'self' data:; "- "connect-src 'self' ws: wss:; "- "object-src 'none'; "- "base-uri 'self'; "- "frame-ancestors 'none'"- )+ is_debug = os.environ.get("ARES_DEBUG", "").lower() in ("true", "1", "yes")+ if is_debug and request.url.path in ("/docs", "/redoc", "/openapi.json"):+ response.headers["Content-Security-Policy"] = (+ "default-src 'self' 'unsafe-inline' https://cdn.jsdelivr.net; "+ "script-src 'self' 'unsafe-inline' https://cdn.jsdelivr.net; "+ "style-src 'self' 'unsafe-inline' https://cdn.jsdelivr.net; "+ "img-src 'self' data: https://fastapi.tiangolo.com; "+ "connect-src 'self' ws: wss:; "+ "object-src 'none'; "+ "base-uri 'self'; "+ "frame-ancestors 'none'"+ )+ else:+ response.headers["Content-Security-Policy"] = (+ "default-src 'self'; "+ "script-src 'self'; "+ "style-src 'self'; "+ "img-src 'self' data:; "+ "connect-src 'self' ws: wss:; "+ "object-src 'none'; "+ "base-uri 'self'; "+ "frame-ancestors 'none'"+ )# HSTS is only meaningful on HTTPS — don't send on plain HTTPif request.url.scheme == "https":response.headers["Strict-Transport-Security"] = (diff --git a/docs/assets/screenshots/api-docs-swagger.png b/docs/assets/screenshots/api-docs-swagger.pngnew file mode 100644index 0000000..c8f6df4Binary files /dev/null and b/docs/assets/screenshots/api-docs-swagger.png differdiff --git a/docs/assets/screenshots/dashboard-campaigns.png b/docs/assets/screenshots/dashboard-campaigns.pngindex 3c3f34d..bc4ca5d 100644Binary files a/docs/assets/screenshots/dashboard-campaigns.png and b/docs/assets/screenshots/dashboard-campaigns.png differdiff --git a/docs/assets/screenshots/dashboard-edr.png b/docs/assets/screenshots/dashboard-edr.pngnew file mode 100644index 0000000..f8b222eBinary files /dev/null and b/docs/assets/screenshots/dashboard-edr.png differdiff --git a/docs/assets/screenshots/dashboard-graph-inspector.png b/docs/assets/screenshots/dashboard-graph-inspector.pngnew file mode 100644index 0000000..e5fc481Binary files /dev/null and b/docs/assets/screenshots/dashboard-graph-inspector.png differdiff --git a/docs/assets/screenshots/dashboard-graph.png b/docs/assets/screenshots/dashboard-graph.pngindex af02a66..4f15925 100644Binary files a/docs/assets/screenshots/dashboard-graph.png and b/docs/assets/screenshots/dashboard-graph.png differdiff --git a/docs/assets/screenshots/dashboard-live.png b/docs/assets/screenshots/dashboard-live.pngnew file mode 100644index 0000000..40b32ddBinary files /dev/null and b/docs/assets/screenshots/dashboard-live.png differdiff --git a/docs/assets/screenshots/dashboard-module-drawer.png b/docs/assets/screenshots/dashboard-module-drawer.pngnew file mode 100644index 0000000..3223a99Binary files /dev/null and b/docs/assets/screenshots/dashboard-module-drawer.png differdiff --git a/docs/assets/screenshots/dashboard-modules-catalog.png b/docs/assets/screenshots/dashboard-modules-catalog.pngindex 9627fe4..f0334b7 100644Binary files a/docs/assets/screenshots/dashboard-modules-catalog.png and b/docs/assets/screenshots/dashboard-modules-catalog.png differdiff --git a/docs/assets/screenshots/dashboard-modules-chains.png b/docs/assets/screenshots/dashboard-modules-chains.pngnew file mode 100644index 0000000..0cca944Binary files /dev/null and b/docs/assets/screenshots/dashboard-modules-chains.png differdiff --git a/docs/assets/screenshots/dashboard-modules-run-panel.png b/docs/assets/screenshots/dashboard-modules-run-panel.pngnew file mode 100644index 0000000..efb4963Binary files /dev/null and b/docs/assets/screenshots/dashboard-modules-run-panel.png differdiff --git a/docs/assets/screenshots/dashboard-overview.png b/docs/assets/screenshots/dashboard-overview.pngindex 3c69ea7..8c5ce6d 100644Binary files a/docs/assets/screenshots/dashboard-overview.png and b/docs/assets/screenshots/dashboard-overview.png differdiff --git a/docs/assets/screenshots/dashboard-reports.png b/docs/assets/screenshots/dashboard-reports.pngindex c0b1e4a..85de7ed 100644Binary files a/docs/assets/screenshots/dashboard-reports.png and b/docs/assets/screenshots/dashboard-reports.png differdiff --git a/docs/assets/screenshots/dashboard-security.png b/docs/assets/screenshots/dashboard-security.pngnew file mode 100644index 0000000..93b1b62Binary files /dev/null and b/docs/assets/screenshots/dashboard-security.png differdiff --git a/docs/assets/screenshots/dashboard-strategy.png b/docs/assets/screenshots/dashboard-strategy.pngindex ee99803..c114019 100644Binary files a/docs/assets/screenshots/dashboard-strategy.png and b/docs/assets/screenshots/dashboard-strategy.png differdiff --git a/docs/assets/screenshots/dashboard-templates.png b/docs/assets/screenshots/dashboard-templates.pngnew file mode 100644index 0000000..77bb62cBinary files /dev/null and b/docs/assets/screenshots/dashboard-templates.png differdiff --git a/docs/assets/screenshots/login-enclave.png b/docs/assets/screenshots/login-enclave.pngindex 48e8153..474526b 100644Binary files a/docs/assets/screenshots/login-enclave.png and b/docs/assets/screenshots/login-enclave.png differ