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: swap stale pre-redesign screenshots for current HD set, remove em dashes (#66)
kraii_78b625045205
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.mdindex 3ade8dd..dafd685 100644--- a/CODE_OF_CONDUCT.md+++ b/CODE_OF_CONDUCT.md@@ -45,7 +45,7 @@ apply to all community interactions:unpatched weaknesses in public discussions, issues, or pull requests.Report them privately via [SECURITY.md](SECURITY.md).* **DO NOT** share real credentials, hashes, tokens, API keys, or session- data in any public channel — even as "examples." Use synthetic or redacted+ data in any public channel, even as "examples." Use synthetic or redactedplaceholders.* **DO NOT** post engagement artifacts (reports, findings, target data) fromreal-world assessments. Use lab environments and sanitized examples only.diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex df7c9aa..b081285 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -31,14 +31,14 @@ ARES uses [GitHub Discussions](https://github.com/Mafifrizi/ARES/discussions) fo| **[Discussions → Module Development](https://github.com/Mafifrizi/ARES/discussions/categories/module-development)** | Module design, research tradecraft, MITRE technique coverage || **GitHub Issues** | Confirmed bugs, tracked tasks, accepted feature work || **Pull Requests** | Code contributions ready for review |-| **[SECURITY.md](SECURITY.md)** | Security vulnerabilities — **never** in public Discussions or Issues |+| **[SECURITY.md](SECURITY.md)** | Security vulnerabilities, **never** in public Discussions or Issues |### Code of ConductAll participants must follow our [Code of Conduct](CODE_OF_CONDUCT.md). In particular:- **DO NOT** post real credentials, hashes, tokens, or target data in any public channel-- **DO NOT** disclose security vulnerabilities publicly — use [SECURITY.md](SECURITY.md)+- **DO NOT** disclose security vulnerabilities publicly. Use [SECURITY.md](SECURITY.md)- **DO** redact all sensitive data from logs, screenshots, and code snippets- **DO** be respectful, constructive, and technically honest@@ -137,11 +137,11 @@ ARES uses formal RFCs to design and coordinate multi-module research efforts.All 5 modules from the Linux AD post-exploitation research track are fullyimplemented and production-ready in ARES v6.0:-- `linux.sssd_harvest` — SSSD LDB database extraction-- `linux.ccache_hunt` — Kerberos ticket cache hunting (file + Kernel Keyring)-- `linux.keytab_abuse` — Machine keytab parsing & Silver Ticket generation-- `linux.samba_secrets` — Samba/Winbind machine password extraction-- `credential.ticket_converter` — Bi-directional ccache ↔ kirbi conversion+- `linux.sssd_harvest`: SSSD LDB database extraction+- `linux.ccache_hunt`: Kerberos ticket cache hunting (file + Kernel Keyring)+- `linux.keytab_abuse`: Machine keytab parsing & Silver Ticket generation+- `linux.samba_secrets`: Samba/Winbind machine password extraction+- `credential.ticket_converter`: Bi-directional ccache ↔ kirbi conversionSee the full technical specification:👉 **[RFC 001: Linux Active Directory Tradecraft](docs/research/linux-active-directory-tradecraft.md)**diff --git a/README.md b/README.mdindex d64e4e4..4e5d9c4 100644--- a/README.md+++ b/README.md@@ -25,7 +25,7 @@ Built for enterprise red teams, MSSPs and security operations centers that need## 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.+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.@@ -37,33 +37,33 @@ A self-hosted platform that runs **real** offensive validation modules inside a<div align="center">-<img src="docs/assets/screens/login-hd.png" alt="ARES login — dragon mascot" width="840"><br>+<img src="docs/assets/screens/login-hd.png" alt="ARES login with dragon mascot" width="840"><br>*Sign-in with the ARES mascot and the SSO fallback. Memory-only JWT access tokens, HttpOnly rotating refresh.*<br><img src="docs/assets/screens/overview-hd.png" alt="Operator overview" width="840"><br>-*Operator overview — active engagements, validated findings, attack surface, engine health, telemetry pulse.*+*Operator overview: active engagements, validated findings, attack surface, engine health, telemetry pulse.*<br><img src="docs/assets/screens/modules-catalog-hd.png" alt="Module catalog" width="840"><br>-*Catalog — 66 active modules across 13 categories, each annotated with MITRE ATT&CK techniques and OPSEC noise level.*+*Catalog: 66 active modules across 13 categories, each annotated with MITRE ATT&CK techniques and OPSEC noise level.*<br><img src="docs/assets/screens/modules-result-hd.png" alt="Finding card after a module run" width="840"><br>-*Results — finding card with severity, confidence, remediation and one-click pivot to the next module.*+*Results: finding card with severity, confidence, remediation and one-click pivot to the next module.*<br><img src="docs/assets/screens/attack-graph-hd.png" alt="Attack graph" width="840"><br>-*Attack graph — perimeter firewall (fire animation), targets, pivot edges. Read-only beacon telemetry per node.*+*Attack graph: perimeter firewall (fire animation), targets, pivot edges. Read-only beacon telemetry per node.*<br><img src="docs/assets/screens/campaigns-scope-hd.png" alt="Campaign scope" width="840"><br>-*Campaign scope — target campaign picker, Restore Vault / Dry-Run Plan / Delete controls.*+*Campaign scope: target campaign picker, Restore Vault / Dry-Run Plan / Delete controls.*</div>@@ -71,14 +71,14 @@ A self-hosted platform that runs **real** offensive validation modules inside a## 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](docs/security-model.md)-- **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](docs/engine_design.md)-- **Multi-vector attack graph (DAG)** — ingest BloodHound or map sessions in real time. Shortest-path, chokepoints, lateral pivot feasibility. [→ attack graph](docs/engine_design.md)-- **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](docs/security-model.md)+- **Fail-closed scope enclave**: dual-layer ScopeGuard (application pre-check + OS/transport firewall) guarantees zero offensive packets reach out-of-scope hosts. [→ security model](docs/security-model.md)+- **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](docs/engine_design.md)+- **Multi-vector attack graph (DAG)**: ingest BloodHound or map sessions in real time. Shortest-path, chokepoints, lateral pivot feasibility. [→ attack graph](docs/engine_design.md)+- **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](docs/security-model.md)- **66 active production modules** across 60+ MITRE ATT&CK techniques (AD, cloud, credential access, exfil, lateral, recon, Windows, Linux, EDR). [→ module catalog](docs/modules.md)-- **Automated deliverables** — one-click branded PDF/HTML/Markdown/JSON reports via headless browser (no GTK deps on Windows/Linux). [→ dashboard guide](docs/dashboard-guide.md)-- **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](docs/mcp-server.md)-- **Type-safe Python SDK** — write custom modules with `BaseModule[P, R]` + `@ares_module`, simulate in `ModuleTestHarness`, automate with `AresClient`. [→ SDK docs](docs/module_sdk.md) · [→ module dev guide](docs/module-development.md)+- **Automated deliverables**: one-click branded PDF/HTML/Markdown/JSON reports via headless browser (no GTK deps on Windows/Linux). [→ dashboard guide](docs/dashboard-guide.md)+- **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](docs/mcp-server.md)+- **Type-safe Python SDK**: write custom modules with `BaseModule[P, R]` + `@ares_module`, simulate in `ModuleTestHarness`, automate with `AresClient`. [→ SDK docs](docs/module_sdk.md) · [→ module dev guide](docs/module-development.md)---@@ -126,7 +126,7 @@ ares upgrade # full-system upgrade (core + db + modules + UI)ares upgrade --check # preview, no changes on disk```-User databases, credentials, config and plugins are mathematically blacklisted from modification — see [in-place upgrade guarantees](docs/execution-policy.md).+User databases, credentials, config and plugins are mathematically blacklisted from modification. See [in-place upgrade guarantees](docs/execution-policy.md).---@@ -168,7 +168,7 @@ If ARES has accelerated your assessments or protected your infrastructure, consi<img src="docs/assets/credits/muhamad-d-alvito.png" width="88" height="88" alt="Muhamad D Alvito" style="border-radius:50%;"></a>-**[Muhamad D Alvito](https://www.linkedin.com/in/muhamad-d-alvito-58607934b/)** — UI & UX partner+**[Muhamad D Alvito](https://www.linkedin.com/in/muhamad-d-alvito-58607934b/)**, UI & UX partner</div>@@ -200,7 +200,7 @@ ARES is distributed under the open-source **[MIT License](LICENSE)**.<div align="center">-**ARES — Modern Red Team Engagement & Continuous Security Validation System.**<br>+**ARES: Modern Red Team Engagement & Continuous Security Validation System.**<br>*Continuous security validation. Deterministic scope containment.*</div>diff --git a/docs/assets/screenshots/api-docs-swagger.png b/docs/assets/screenshots/api-docs-swagger.pngdeleted file mode 100644index c8f6df4..0000000Binary files a/docs/assets/screenshots/api-docs-swagger.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-campaigns.png b/docs/assets/screenshots/dashboard-campaigns.pngdeleted file mode 100644index 84acc17..0000000Binary files a/docs/assets/screenshots/dashboard-campaigns.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-edr.png b/docs/assets/screenshots/dashboard-edr.pngdeleted file mode 100644index f8b222e..0000000Binary files a/docs/assets/screenshots/dashboard-edr.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-graph.png b/docs/assets/screenshots/dashboard-graph.pngdeleted file mode 100644index 4a50aeb..0000000Binary files a/docs/assets/screenshots/dashboard-graph.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-live.png b/docs/assets/screenshots/dashboard-live.pngdeleted file mode 100644index 40b32dd..0000000Binary files a/docs/assets/screenshots/dashboard-live.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-module-drawer.png b/docs/assets/screenshots/dashboard-module-drawer.pngdeleted file mode 100644index 3223a99..0000000Binary files a/docs/assets/screenshots/dashboard-module-drawer.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-modules-catalog.png b/docs/assets/screenshots/dashboard-modules-catalog.pngdeleted file mode 100644index f0334b7..0000000Binary files a/docs/assets/screenshots/dashboard-modules-catalog.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-modules-chains.png b/docs/assets/screenshots/dashboard-modules-chains.pngdeleted file mode 100644index 0cca944..0000000Binary files a/docs/assets/screenshots/dashboard-modules-chains.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-modules-run-panel.png b/docs/assets/screenshots/dashboard-modules-run-panel.pngdeleted file mode 100644index efb4963..0000000Binary files a/docs/assets/screenshots/dashboard-modules-run-panel.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-overview-empty.png b/docs/assets/screenshots/dashboard-overview-empty.pngdeleted file mode 100644index 2147da9..0000000Binary files a/docs/assets/screenshots/dashboard-overview-empty.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-overview-v2.png b/docs/assets/screenshots/dashboard-overview-v2.pngdeleted file mode 100644index 3a17846..0000000Binary files a/docs/assets/screenshots/dashboard-overview-v2.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-overview.png b/docs/assets/screenshots/dashboard-overview.pngdeleted file mode 100644index 3a17846..0000000Binary files a/docs/assets/screenshots/dashboard-overview.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-reports.png b/docs/assets/screenshots/dashboard-reports.pngdeleted file mode 100644index 85de7ed..0000000Binary files a/docs/assets/screenshots/dashboard-reports.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-security.png b/docs/assets/screenshots/dashboard-security.pngdeleted file mode 100644index 93b1b62..0000000Binary files a/docs/assets/screenshots/dashboard-security.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-strategy.png b/docs/assets/screenshots/dashboard-strategy.pngdeleted file mode 100644index c114019..0000000Binary files a/docs/assets/screenshots/dashboard-strategy.png and /dev/null differdiff --git a/docs/assets/screenshots/dashboard-templates.png b/docs/assets/screenshots/dashboard-templates.pngdeleted file mode 100644index 77bb62c..0000000Binary files a/docs/assets/screenshots/dashboard-templates.png and /dev/null differdiff --git a/docs/assets/screenshots/login-enclave-v2.png b/docs/assets/screenshots/login-enclave-v2.pngdeleted file mode 100644index 9f1a74f..0000000Binary files a/docs/assets/screenshots/login-enclave-v2.png and /dev/null differdiff --git a/docs/assets/screenshots/login-enclave.png b/docs/assets/screenshots/login-enclave.pngdeleted file mode 100644index 9f1a74f..0000000Binary files a/docs/assets/screenshots/login-enclave.png and /dev/null differdiff --git a/docs/comparison.md b/docs/comparison.mdindex 18a8453..3c899b7 100644--- a/docs/comparison.md+++ b/docs/comparison.md@@ -16,11 +16,11 @@ How ARES compares to traditional manual penetration testing and legacy vulnerabi## Why those columns matter-- **Testing frequency** — Point-in-time pentests leave gaps every time configuration, identity or infrastructure drifts. ARES is designed to be re-run on every merge or every day.-- **Exploitability validation** — A scanner that says a CVE "might" apply is noise. ARES only reports what it actually proved on the live target.-- **Multi-hop attack paths** — Real breaches chain weak links. The interactive DAG surfaces the shortest path to Tier-0 Crown Jewels, not just a flat vulnerability list.-- **Scope enclave & egress guard** — Fail-closed means a mis-typed CIDR cannot leak offensive packets out-of-scope. This is the single hardest thing to get right without platform support.-- **OPSEC & telemetry throttling** — Noise profiles (`stealth` / `evasive` / `noisy`) let the same module run in a red-team engagement without lighting up the SOC on day one.+- **Testing frequency**: Point-in-time pentests leave gaps every time configuration, identity or infrastructure drifts. ARES is designed to be re-run on every merge or every day.+- **Exploitability validation**: A scanner that says a CVE "might" apply is noise. ARES only reports what it actually proved on the live target.+- **Multi-hop attack paths**: Real breaches chain weak links. The interactive DAG surfaces the shortest path to Tier-0 Crown Jewels, not just a flat vulnerability list.+- **Scope enclave & egress guard**: Fail-closed means a mis-typed CIDR cannot leak offensive packets out-of-scope. This is the single hardest thing to get right without platform support.+- **OPSEC & telemetry throttling**: Noise profiles (`stealth` / `evasive` / `noisy`) let the same module run in a red-team engagement without lighting up the SOC on day one.## Deeper readingdiff --git a/docs/dashboard-guide.md b/docs/dashboard-guide.mdindex 33f9a7f..becfc42 100644--- a/docs/dashboard-guide.md+++ b/docs/dashboard-guide.md@@ -69,11 +69,12 @@ keys, bearer tokens, or sensitive report URLs.| View | File | Use || --- | --- | --- |-| Overview (Standby / Zero-State) | `docs/assets/screenshots/dashboard-overview-empty.png` | Clean onboarding hero, platform readiness strip, and initialization quick actions. |-| Overview (Active Telemetry) | `docs/assets/screenshots/dashboard-overview.png` | Health, telemetry cards, confirmed findings, and campaign summary. |-| Campaigns | `docs/assets/screenshots/dashboard-campaigns.png` | Campaign creation, target/scope input, and management actions. |-| Graph & Beacon Console | `docs/assets/screenshots/dashboard-graph.png` | ARES Tactical Pivot Graph, Perimeter Ingress with animated flames, slide-over Tactical Inspector Drawer, & docked Beacon session terminal. |-| Reports | `docs/assets/screenshots/dashboard-reports.png` | Campaign report generation and artifact list. |+| Login | `docs/assets/screens/login-hd.png` | Dragon mascot sign-in with the live API ignite animation. |+| Overview (Active Telemetry) | `docs/assets/screens/overview-hd.png` | Health, telemetry cards, confirmed findings, and campaign summary. |+| Campaigns & Scope | `docs/assets/screens/campaigns-scope-hd.png` | Campaign picker, target/scope input, and management actions. |+| Modules (Catalog) | `docs/assets/screens/modules-catalog-hd.png` | 66 modules across 13 categories with MITRE ATT&CK and OPSEC labels. |+| Modules (Result) | `docs/assets/screens/modules-result-hd.png` | Finding card with severity, confidence, remediation, and next-module pivot. |+| Graph & Beacon Console | `docs/assets/screens/attack-graph-hd.png` | Tactical pivot graph, perimeter ingress with animated flames, slide-over inspector drawer, and docked beacon session terminal. |## Dashboard Shell@@ -194,7 +195,7 @@ Current page tabs:### Overview-+*Active Telemetry Overview - Real-time telemetry, validated findings, queue metrics, and campaign status.*@@ -220,7 +221,7 @@ records.Purpose: create and manage engagement containers.-+Use it for:@@ -244,7 +245,7 @@ Delete behavior:Purpose: run individual modules safely.-+Use it for:@@ -268,6 +269,8 @@ Good habit:5. Review validation output.6. Run live only if authorized.++Results distinguish confirmed findings, completed runs with no confirmedfindings, operator/dependency/network errors, unsupported runs, and unexpectedmodule errors. A dry-run result is a validation preview only; it is not evidence@@ -286,8 +289,6 @@ Scope behavior:Purpose: generate, download, and manage campaign report artifacts.--Formats:- HTML.@@ -325,7 +326,7 @@ the clean empty state: `No reports generated for this campaign yet.`Purpose: understand lateral pivot relationships, trace multi-hop compromise routes, inspect tactical host vulnerabilities in a slide-over drawer, and interact with compromised hosts directly from a docked Beacon terminal console.-+*ARES Tactical Pivot Graph & Docked Beacon Session Terminal Console - Live enterprise campaign topology (`Kali test`), perimeter ingress firewall with animated flames, Linux/Windows compromised footholds, slide-over Tactical Inspector Drawer, and interactive command execution.*@@ -384,10 +385,6 @@ Located directly below the graph canvas, the Beacon Terminal Dock provides a fulPurpose: generate structured, repeatable, and deterministic campaign execution plans.---*Campaign Templates & Plan Builder - Blueprint catalog, stage planning, and parameterized execution checklist.*-The Templates view provides pre-tested engagement blueprints designed to ensure operational consistency across red-team operators without relying on external LLM calls.#### Tab 1: Templates (Catalog)@@ -422,10 +419,6 @@ Actions:Purpose: autonomous, goal-oriented engagement planning and execution powered by graph heuristics and LLM decision agents.---*Autonomous Strategy & Objective Builder - Goal-directed planning, multi-LLM engine selection, and live cycle telemetry.*-Unlike static templates, the Strategy engine continuously evaluates observed campaign state (discovered hosts, harvested credentials, open ports, and active defenses) to dynamically select and execute the next optimal module toward a specific operational objective.#### Tab 1: Objective (Objective Builder)@@ -503,10 +496,6 @@ The AI planner module performs a local planning/LLM call only. It does not contaPurpose: account and security administration.---*Zero-Trust Security Governance - Password rotation, scoped API keys, audit logging, and operator review.*-Use it for:- Change password.@@ -538,10 +527,6 @@ API key behavior:Purpose: track, record, and evaluate evasion effectiveness across endpoint detection and response (EDR) agents, feeding empirical feedback into the adaptive OPSEC engine.---*EDR/OPSEC Evasion Knowledge Base & Outcome Reporting - Empirical bypass statistics, payload inspection, and adaptive feedback.*-#### Tab 1: Knowledge BaseInspect empirical bypass rates and historical evasion statistics by technique and EDR vendor:@@ -577,10 +562,6 @@ Action:Purpose: watch campaign WebSocket events.---*Live Operations Event Stream - Real-time WebSocket telemetry, module lifecycle events, and active execution logs.*-Use it for:- Module start/complete events.diff --git a/docs/research/linux-active-directory-tradecraft.md b/docs/research/linux-active-directory-tradecraft.mdindex 4668f67..570860f 100644--- a/docs/research/linux-active-directory-tradecraft.md+++ b/docs/research/linux-active-directory-tradecraft.md@@ -14,7 +14,7 @@In enterprise environments, Active Directory security research and offensive tooling have historically concentrated on Windows endpoints and Domain Controllers. Tools such as Mimikatz, Rubeus, and SharpHound established comprehensive visibility into Windows-centric Kerberos ticket extraction, DPAPI secrets, and LSASS memory manipulation.-However, modern enterprise infrastructures are inherently hybrid. Critical production services—including Kubernetes worker nodes, CI/CD runners (GitLab, Jenkins), data analytics engines, identity proxies, and high-value database servers—are routinely joined to Active Directory as **Linux Domain Members** using:+However, modern enterprise infrastructures are inherently hybrid. Critical production services, including Kubernetes worker nodes, CI/CD runners (GitLab, Jenkins), data analytics engines, identity proxies, and high-value database servers, are routinely joined to Active Directory as **Linux Domain Members** using:1. **SSSD (System Security Services Daemon)** integrated with Kerberos and OpenLDAP.2. **Winbind & Samba** managing domain trust relationships and RPC schannel credentials.3. **Direct Kerberos/PAM integrations** managing Single Sign-On (SSO) and host-level access control.