# m524security/exonerve architecture

> Architecture diagram of the GitHub repository m524security/exonerve, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/m524security/exonerve
- Repository: https://github.com/m524security/exonerve

## Overview

Exonerve is an out-of-band cyber-resilience platform combining endpoint telemetry, deterministic detection, SOC casework, network containment, workload failover, and self-healing. Its documented response lifecycle runs from attack telemetry through detection and incident handling to containment, standby failover, and recovery; analysts use the dashboard and standards-based exports to review results. The graph preserves the major blue-team, detection, response, and interoperability capabilities. Several relationships are documented only at the README level; unsampled implementation details are not inferred.

Main entry points: [`host_control_plane/incident_manager.py`](https://github.com/m524security/exonerve/blob/main/host_control_plane/incident_manager.py) (Incident manager), [`blue_team/alert_correlator/alert_correlator.py`](https://github.com/m524security/exonerve/blob/main/blue_team/alert_correlator/alert_correlator.py) (Alert correlator), [`blue_team/sigma_engine/sigma_engine.py`](https://github.com/m524security/exonerve/blob/main/blue_team/sigma_engine/sigma_engine.py) (Sigma engine), [`blue_team`](https://github.com/m524security/exonerve/tree/main/blue_team) (Blue-team tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_telemetry["Telemetry and detection"]
  node_sensors["Guest sensors"]
  node_sigma["Sigma engine<br/>[sigma_engine.py]"]
  node_yara["YARA engine<br/>[yara_engine.py]"]
  node_blue_suite["Blue-team tools"]
end

subgraph group_soc["SOC and investigation"]
  node_correlator["Alert correlator"]
  node_dashboard["SOC dashboard<br/>[soc_dashboard.py]"]
  node_incident["Incident manager"]
  node_killchain["Kill-chain analysis"]
end

subgraph group_response["Response and recovery"]
  node_decision["Decision engine<br/>[decision_engine.py]"]
  node_containment["Network containment<br/>[containment.py]"]
  node_failover["Standby failover"]
  node_healing["Healing orchestrator"]
  node_health["Health monitor<br/>[health_monitor.py]"]
  node_nervous["Nervous system<br/>[nervous_system.py]"]
end

subgraph group_shared["Shared intelligence and exports"]
  node_safe_eval["Safe evaluator<br/>[safe_eval.py]"]
  node_mitre["ATT&amp;CK mapping<br/>[mitre_attack.py]"]
  node_navigator["Navigator export"]
  node_stix["STIX export<br/>[stix_export.py]"]
  node_audit["Decision audit<br/>[audit_log.py]"]
  node_siem["SIEM export<br/>[siem_export.py]"]
  node_ticketing["Ticketing export"]
end

node_user(("Analyst"))
node_analyst_result["SOC findings"]

node_sensors -.->|"send telemetry"| node_sigma
node_sensors -.->|"emit events"| node_blue_suite
node_sigma -->|"evaluates conditions"| node_safe_eval
node_yara -->|"evaluates conditions"| node_safe_eval
node_sigma -.->|"produce findings"| node_correlator
node_yara -.->|"produce findings"| node_correlator
node_blue_suite -.->|"contributes findings"| node_correlator
node_correlator -->|"ingests findings"| node_dashboard
node_user -.->|"reviews alerts"| node_dashboard
node_correlator -.->|"opens cases"| node_incident
node_incident -->|"reconstructs chain"| node_killchain
node_incident -->|"exports coverage"| node_navigator
node_incident -->|"exports bundle"| node_stix
node_incident -.->|"guides response"| node_decision
node_decision -.->|"triggers block"| node_containment
node_containment -.->|"isolates workload"| node_failover
node_failover -.->|"hands off recovery"| node_healing
node_healing -->|"checks health"| node_health
node_healing -->|"subscribes commands"| node_nervous
node_blue_suite -.->|"maps techniques"| node_mitre
node_navigator -->|"uses technique catalog"| node_mitre
node_stix -->|"uses technique catalog"| node_mitre
node_incident -.->|"records decisions"| node_audit
node_dashboard -->|"presents findings"| node_analyst_result
node_incident -.->|"exports events"| node_siem
node_incident -.->|"exports cases"| node_ticketing

click node_sensors "https://github.com/m524security/exonerve/tree/main/guest_production_vm"
click node_sigma "https://github.com/m524security/exonerve/blob/main/blue_team/sigma_engine/sigma_engine.py"
click node_yara "https://github.com/m524security/exonerve/blob/main/blue_team/yara_engine/yara_engine.py"
click node_blue_suite "https://github.com/m524security/exonerve/tree/main/blue_team"
click node_safe_eval "https://github.com/m524security/exonerve/blob/main/common/safe_eval.py"
click node_correlator "https://github.com/m524security/exonerve/blob/main/blue_team/alert_correlator/alert_correlator.py"
click node_dashboard "https://github.com/m524security/exonerve/blob/main/blue_team/soc_dashboard/soc_dashboard.py"
click node_incident "https://github.com/m524security/exonerve/blob/main/host_control_plane/incident_manager.py"
click node_killchain "https://github.com/m524security/exonerve/blob/main/blue_team/killchain_reconstructor/killchain_reconstructor.py"
click node_decision "https://github.com/m524security/exonerve/blob/main/decision_engine/decision_engine.py"
click node_containment "https://github.com/m524security/exonerve/blob/main/host_control_plane/containment.py"
click node_failover "https://github.com/m524security/exonerve/blob/main/host_control_plane/failover_orchestrator.py"
click node_healing "https://github.com/m524security/exonerve/blob/main/self_healing/healing_orchestrator.py"
click node_health "https://github.com/m524security/exonerve/blob/main/self_healing/health_monitor.py"
click node_nervous "https://github.com/m524security/exonerve/blob/main/self_healing/nervous_system.py"
click node_mitre "https://github.com/m524security/exonerve/blob/main/common/mitre_attack.py"
click node_navigator "https://github.com/m524security/exonerve/blob/main/common/attack_navigator.py"
click node_stix "https://github.com/m524security/exonerve/blob/main/common/stix_export.py"
click node_audit "https://github.com/m524security/exonerve/blob/main/common/audit_log.py"
click node_siem "https://github.com/m524security/exonerve/blob/main/common/siem_export.py"
click node_ticketing "https://github.com/m524security/exonerve/blob/main/common/ticketing_export.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sensors,node_sigma,node_yara,node_blue_suite toneBlue
class node_correlator,node_dashboard,node_incident,node_killchain toneAmber
class node_decision,node_containment,node_failover,node_healing,node_health,node_nervous toneMint
class node_safe_eval,node_mitre,node_navigator,node_stix,node_audit,node_siem,node_ticketing toneRose
class node_user,node_analyst_result toneIndigo
```

## Components

### Telemetry and detection

- [Guest sensors](https://github.com/m524security/exonerve/tree/main/guest_production_vm): `guest_production_vm`
- [Sigma engine](https://github.com/m524security/exonerve/blob/main/blue_team/sigma_engine/sigma_engine.py): `blue_team/sigma_engine/sigma_engine.py`
- [YARA engine](https://github.com/m524security/exonerve/blob/main/blue_team/yara_engine/yara_engine.py): `blue_team/yara_engine/yara_engine.py`
- [Blue-team tools](https://github.com/m524security/exonerve/tree/main/blue_team): `blue_team`

### SOC and investigation

- [Alert correlator](https://github.com/m524security/exonerve/blob/main/blue_team/alert_correlator/alert_correlator.py): `blue_team/alert_correlator/alert_correlator.py`
- [SOC dashboard](https://github.com/m524security/exonerve/blob/main/blue_team/soc_dashboard/soc_dashboard.py): `blue_team/soc_dashboard/soc_dashboard.py`
- [Incident manager](https://github.com/m524security/exonerve/blob/main/host_control_plane/incident_manager.py): `host_control_plane/incident_manager.py`
- [Kill-chain analysis](https://github.com/m524security/exonerve/blob/main/blue_team/killchain_reconstructor/killchain_reconstructor.py): `blue_team/killchain_reconstructor/killchain_reconstructor.py`

### Response and recovery

- [Decision engine](https://github.com/m524security/exonerve/blob/main/decision_engine/decision_engine.py): `decision_engine/decision_engine.py`
- [Network containment](https://github.com/m524security/exonerve/blob/main/host_control_plane/containment.py): `host_control_plane/containment.py`
- [Standby failover](https://github.com/m524security/exonerve/blob/main/host_control_plane/failover_orchestrator.py): `host_control_plane/failover_orchestrator.py`
- [Healing orchestrator](https://github.com/m524security/exonerve/blob/main/self_healing/healing_orchestrator.py): `self_healing/healing_orchestrator.py`
- [Health monitor](https://github.com/m524security/exonerve/blob/main/self_healing/health_monitor.py): `self_healing/health_monitor.py`
- [Nervous system](https://github.com/m524security/exonerve/blob/main/self_healing/nervous_system.py): `self_healing/nervous_system.py`

### Shared intelligence and exports

- [Safe evaluator](https://github.com/m524security/exonerve/blob/main/common/safe_eval.py): `common/safe_eval.py`
- [ATT&CK mapping](https://github.com/m524security/exonerve/blob/main/common/mitre_attack.py): `common/mitre_attack.py`
- [Navigator export](https://github.com/m524security/exonerve/blob/main/common/attack_navigator.py): `common/attack_navigator.py`
- [STIX export](https://github.com/m524security/exonerve/blob/main/common/stix_export.py): `common/stix_export.py`
- [Decision audit](https://github.com/m524security/exonerve/blob/main/common/audit_log.py): `common/audit_log.py`
- [SIEM export](https://github.com/m524security/exonerve/blob/main/common/siem_export.py): `common/siem_export.py`
- [Ticketing export](https://github.com/m524security/exonerve/blob/main/common/ticketing_export.py): `common/ticketing_export.py`

### Other components

- **Analyst**
- **SOC findings**

## Connections

- Guest sensors → Sigma engine: send telemetry (evidence: `README.md`)
- Guest sensors → Blue-team tools: emit events (evidence: `README.md`)
- Sigma engine → Safe evaluator: evaluates conditions (evidence: `blue_team/sigma_engine/sigma_engine.py`)
- YARA engine → Safe evaluator: evaluates conditions (evidence: `blue_team/yara_engine/yara_engine.py`)
- Sigma engine → Alert correlator: produce findings
- YARA engine → Alert correlator: produce findings
- Blue-team tools → Alert correlator: contributes findings (evidence: `README.md`)
- Alert correlator → SOC dashboard: ingests findings (evidence: `blue_team/soc_dashboard/soc_dashboard.py`)
- Analyst → SOC dashboard: reviews alerts (evidence: `README.md`)
- Alert correlator → Incident manager: opens cases (evidence: `README.md`)
- Incident manager → Kill-chain analysis: reconstructs chain (evidence: `host_control_plane/incident_manager.py`)
- Incident manager → Navigator export: exports coverage (evidence: `host_control_plane/incident_manager.py`)
- Incident manager → STIX export: exports bundle (evidence: `host_control_plane/incident_manager.py`)
- Incident manager → Decision engine: guides response (evidence: `README.md`)
- Decision engine → Network containment: triggers block (evidence: `README.md`)
- Network containment → Standby failover: isolates workload (evidence: `README.md`)
- Standby failover → Healing orchestrator: hands off recovery (evidence: `README.md`)
- Healing orchestrator → Health monitor: checks health (evidence: `self_healing/healing_orchestrator.py`)
- Healing orchestrator → Nervous system: subscribes commands (evidence: `self_healing/healing_orchestrator.py`)
- Blue-team tools → ATT&CK mapping: maps techniques (evidence: `README.md`)
- Navigator export → ATT&CK mapping: uses technique catalog (evidence: `common/attack_navigator.py`)
- STIX export → ATT&CK mapping: uses technique catalog (evidence: `common/stix_export.py`)
- Incident manager → Decision audit: records decisions (evidence: `README.md`)
- SOC dashboard → SOC findings: presents findings (evidence: `blue_team/soc_dashboard/soc_dashboard.py`)
- Incident manager → SIEM export: exports events (evidence: `README.md`)
- Incident manager → Ticketing export: exports cases (evidence: `README.md`)
