Skip to content

armgit / ARES

Public Imported from GitHub
0

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

docs: align attack graph safe detail inspector and authoritative RBAC lifecycle across README and dashboard guide

Mafifrizi2b6df4af7877
diff --git a/README.md b/README.md
index 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">
![ARES Attack Graph Entity Deep-Dive & Node Inspector](docs/assets/screenshots/dashboard-graph-inspector.png)
-*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.png
index e5fc481..b85671e 100644
Binary files a/docs/assets/screenshots/dashboard-graph-inspector.png and b/docs/assets/screenshots/dashboard-graph-inspector.png differ
diff --git a/docs/assets/screenshots/dashboard-graph.png b/docs/assets/screenshots/dashboard-graph.png
index 1ff4af6..091ad1e 100644
Binary files a/docs/assets/screenshots/dashboard-graph.png and b/docs/assets/screenshots/dashboard-graph.png differ
diff --git a/docs/dashboard-guide.md b/docs/dashboard-guide.md
index 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.
![Attack graph visualization](assets/screenshots/dashboard-graph.png)
-*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.*
+
+![Attack graph node inspector](assets/screenshots/dashboard-graph-inspector.png)
+
+*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, and
relationships.
### Templates