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: align attack graph safe detail inspector and authoritative RBAC lifecycle across README and dashboard guide
Mafifrizi2b6df4af7877
diff --git a/README.md b/README.mdindex ba37c7b..424a9ae 100644--- a/README.md+++ b/README.md@@ -257,21 +257,21 @@ 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.*+*In-depth Active Directory entity telemetry, relationship inspection, and real-time safe detail auditing 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.*+*Interactive Safe Detail Drawer displaying Domain Controller (DC01 10.10.10.2) telemetry, active compromise levels, open attack surface ports (53, 88, 135, 139, 389, 445, 636, 3268, 3389), and asset ownership states.*</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.+ - **Entity Attribute Inspection**: Instantly examine IP address, hostname, OS telemetry, compromise levels, and domain controller flags (`is_dc`) upon selecting any graph node.+ - **Attack Surface Port Mapping**: Real-time visibility into open infrastructure ports (DNS `53`, Kerberos `88`, RPC `135`, NetBIOS `139`, LDAP `389`, SMB `445`, LDAPS `636`, Global Catalog `3268`, RDP `3389`).+ - **Safe Detail Auditing**: Audited slide-out drawer providing granular telemetry without cluttering the main DAG canvas, complete with quick dismissal.---@@ -535,14 +535,20 @@ ARES was designed for environments with the most stringent compliance and confid- **HMAC CSRF Barrier**: State-changing endpoints mandate valid `X-ARES-CSRF` headers matched against cryptographically secure cookie tokens.### Role-Based Access Control (RBAC)-ARES enforces strict RBAC permissions across all API endpoints and UI controls:--| Role | Operational Scope | Administrative Authority |-| :--- | :--- | :--- |-| **`team_lead`** | Complete platform authority: campaign creation/deletion, user provisioning, security audits, high-noise module overrides. | Full |-| **`operator`** | Day-to-day operations: execute authorized modules, review findings, explore attack graph, generate reports. | Operational Tier |-| **`recon`** | Read-heavy reconnaissance: execute safe discovery and network fingerprinting modules. Execution of disruptive modules is blocked. | Read-Heavy |-| **`reporter`** | Stakeholder review: read-only access to campaign analytics, findings, attack graphs, and generated deliverables. | Read-Only |+ARES enforces strict RBAC permissions across all API endpoints, background jobs, and UI surfaces:++| Role | API Value | Operational Scope | Administrative Authority |+| :--- | :---: | :--- | :--- |+| **Team Lead** | `team_lead` | Complete platform authority: campaign creation/deletion, user provisioning, security audits, high-noise module overrides. | Full System Admin |+| **Operator** | `operator` | Day-to-day operations: execute authorized modules, review findings, explore attack graph, generate reports. Cannot register users. | Operational Tier |+| **Recon** | `recon` | Read-heavy reconnaissance: execute safe discovery and network fingerprinting modules. Execution of disruptive modules is blocked. | Read-Heavy |+| **Reporter** | `reporter` | Stakeholder review: read-only access to campaign analytics, findings, attack graphs, and generated deliverables. No execution rights. | Read-Only Audit |++#### Role Provisioning & Anti-Privilege Escalation Guarantees+- **Authoritative Database Identity**: Unlike systems that blindly trust client-side JWT role claims, ARES resolves user identity and role directly from the live database on every request (`row = await db.resolve_access_token_principal(...)`). Tampered JWT claims are mathematically discarded.+- **Strict Role Gating at Account Creation**: New user roles are assigned exclusively by a `team_lead` via `POST /auth/register` (guarded by `require_team_lead()`) or automatically mapped from enterprise Identity Providers during SP-initiated SAML/OIDC SSO.+- **Role Immutability**: Role assignments are immutable post-creation. No public endpoint exists to alter user roles (`PUT /users/{id}` does not exist), eliminating horizontal and vertical privilege escalation vectors (e.g., `recon` escalating to `team_lead` or `reporter` running offensive modules).+- **Audited User Inventory**: The dashboard `Security` console provides a transparent inventory of all registered identities and active sessions for engagement accountability.---diff --git a/docs/assets/screenshots/dashboard-graph-inspector.png b/docs/assets/screenshots/dashboard-graph-inspector.pngindex e5fc481..b85671e 100644Binary files a/docs/assets/screenshots/dashboard-graph-inspector.png 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 1ff4af6..091ad1e 100644Binary files a/docs/assets/screenshots/dashboard-graph.png and b/docs/assets/screenshots/dashboard-graph.png differdiff --git a/docs/dashboard-guide.md b/docs/dashboard-guide.mdindex 16f3f5e..f28ba85 100644--- a/docs/dashboard-guide.md+++ b/docs/dashboard-guide.md@@ -73,7 +73,8 @@ keys, bearer tokens, or sensitive report URLs.| 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. || Modules | `docs/assets/screenshots/dashboard-modules-catalog.png` | Module catalog filters, OPSEC labels, campaign selection, and parameter forms. |-| Graph | `docs/assets/screenshots/dashboard-graph.png` | Interactive attack graph DAG with automated white patch cables, left-to-right hierarchy, and real-time safe metadata inspection. |+| Graph | `docs/assets/screenshots/dashboard-graph.png` | Interactive attack graph DAG with automated white patch cables, left-to-right hierarchy, and top attack paths panel. |+| Graph Inspector | `docs/assets/screenshots/dashboard-graph-inspector.png` | Interactive Safe Detail slide-out drawer with asset telemetry, open ports, and compromise status. || Reports | `docs/assets/screenshots/dashboard-reports.png` | Campaign report generation and artifact list. |## Dashboard Shell@@ -335,15 +336,20 @@ Purpose: understand relationships and attack paths.-*Multi-Vector Attack Graph β Automated white patch cables connecting Domain Controllers, security findings, and discovered hosts with real-time metadata inspector.*+*Multi-Vector Attack Graph β Automated white patch cables connecting Domain Controllers, security findings, and discovered hosts with top attack paths.*++++*Safe Detail Node Inspector β Click any node on the canvas to open the slide-out drawer displaying live asset telemetry, open ports, and compromise status.*Use it for:-- Campaign graph review.-- Attack path review.-- BloodHound JSON ingest.+- Campaign graph review and entity relationship exploration.+- Safe detail inspection (IP, hostname, open ports, DC flag, and ownership state).+- Attack path review and shortest hop compromise analysis.+- BloodHound JSON archive ingest.-This is useful after enumeration modules create users, computers, groups, and+This is useful after enumeration modules discover Active Directory entities, computers, groups, andrelationships.### Templates