# ahsan9267/cyber-investigation-state-model-for-ai-assisted-cyber-incident-investigation architecture

> Architecture diagram of the GitHub repository ahsan9267/cyber-investigation-state-model-for-ai-assisted-cyber-incident-investigation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahsan9267/cyber-investigation-state-model-for-ai-assisted-cyber-incident-investigation
- Repository: https://github.com/ahsan9267/cyber-investigation-state-model-for-ai-assisted-cyber-incident-investigation

## Overview

This snapshot implements the telemetry foundation of an AI-assisted SOC investigation system, not the later investigation workflow. The documented runtime path collects Windows events through Wazuh and network traffic through Suricata, then forwards telemetry to the Wazuh Manager. The README also names Wi-Fi and VirtualBox lab monitoring and a diagnostic Suricata rule. Configuration files are present, but their exact runtime wiring is not shown. Ingestion, case association, investigation state, evidence analysis, AI assistance, and analyst validation are described as later stages, not implemented components here.

Main entry points: [`config/suricata/fyp-test.rules`](https://github.com/ahsan9267/cyber-investigation-state-model-for-ai-assisted-cyber-incident-investigation/blob/main/config/suricata/fyp-test.rules) (Diagnostic rule)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_endpoint["Endpoint telemetry"]
  node_sysmon["Sysmon"]
  node_windows_channel["Windows Event Channel"]
end

subgraph group_network["Network telemetry"]
  node_npcap["Npcap capture"]
  node_suricata["Suricata IDS"]
  node_wifi["Wi-Fi monitoring"]
  node_virtualbox["VirtualBox lab monitoring"]
  node_eve["EVE JSON"]
end

subgraph group_collection["Event collection"]
  node_wazuh_agent["Wazuh Agent"]
  node_wazuh_manager["Wazuh Manager"]
end

subgraph group_configuration["Configuration"]
  node_suricata_rules["Diagnostic rule<br/>[fyp-test.rules]"]
  node_wazuh_collection_example["Collection XML example"]
end

node_sysmon -->|"emits events"| node_windows_channel
node_windows_channel -->|"collects events"| node_wazuh_agent
node_wazuh_agent -->|"forwards TCP 1514"| node_wazuh_manager
node_npcap -->|"provides capture"| node_suricata
node_suricata -->|"generates JSON"| node_eve
node_eve -->|"forwards events"| node_wazuh_agent
node_suricata_rules -.->|"supports diagnostic detection"| node_suricata

click node_suricata_rules "https://github.com/ahsan9267/cyber-investigation-state-model-for-ai-assisted-cyber-incident-investigation/blob/main/config/suricata/fyp-test.rules"
click node_wazuh_collection_example "https://github.com/ahsan9267/cyber-investigation-state-model-for-ai-assisted-cyber-incident-investigation/blob/main/config/wazuh/ossec-collection-example.xml"

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_sysmon,node_windows_channel toneBlue
class node_npcap,node_suricata,node_wifi,node_virtualbox,node_eve toneAmber
class node_wazuh_agent,node_wazuh_manager toneMint
class node_suricata_rules,node_wazuh_collection_example toneRose
```

## Components

### Endpoint telemetry

- **Sysmon**
- **Windows Event Channel**

### Network telemetry

- **Npcap capture**
- **Suricata IDS**
- **Wi-Fi monitoring**
- **VirtualBox lab monitoring**
- **EVE JSON**

### Event collection

- **Wazuh Agent**
- **Wazuh Manager**

### Configuration

- [Diagnostic rule](https://github.com/ahsan9267/cyber-investigation-state-model-for-ai-assisted-cyber-incident-investigation/blob/main/config/suricata/fyp-test.rules): `config/suricata/fyp-test.rules`
- [Collection XML example](https://github.com/ahsan9267/cyber-investigation-state-model-for-ai-assisted-cyber-incident-investigation/blob/main/config/wazuh/ossec-collection-example.xml): `config/wazuh/ossec-collection-example.xml`

## Connections

- Sysmon → Windows Event Channel: emits events (evidence: `README.md`)
- Windows Event Channel → Wazuh Agent: collects events (evidence: `README.md`)
- Wazuh Agent → Wazuh Manager: forwards TCP 1514 (evidence: `README.md`)
- Npcap capture → Suricata IDS: provides capture (evidence: `README.md`)
- Suricata IDS → EVE JSON: generates JSON (evidence: `README.md`)
- EVE JSON → Wazuh Agent: forwards events (evidence: `README.md`)
- Diagnostic rule → Suricata IDS: supports diagnostic detection (evidence: `README.md`)
