How nnam099/enterprise-soc-detection-ir-lab works
This repository is a defensive SOC lab spanning Windows telemetry collection, Wazuh detections, threat-hunting evidence, and incident response. The main workflow follows endpoint activity into SIEM alerts, then analyst investigation and case timelines. It also documents lab topology, detection validation, and the distinction between independent validation events and confirmed incident evidence. The DFIR scripts show the evidence-to-timeline transformation; other subsystem links are included only where the README documents them, since most supporting files were not sampled.
Main entry points: DFIR-001-timeline.jsonl Normalized Timeline · evidence Hunt Evidence · verify_case.py Case Verification · local_rules.xml Custom Rules
Components 20
Lab Environment
- Windows Endpoint
- Windows Logs
- Wazuh Agent
- Wazuh SIEM
- Network Design
architecture/topology.md
Detection Engineering
- Custom Rules
configs/wazuh/rules/local_rules.xml - Detection Validation
screenshots/phase3-detection
Threat Hunting
- Hunt Analyses
hunting - Hunt Evidence
hunting/evidence
Incident Response
- SOC-INC-001 Investigation
incidents/SOC-INC-001/README.md - Incident Timeline
incidents/SOC-INC-001/timeline.md
DFIR Case Artifacts
- DFIR-001 Case
dfir/cases/DFIR-001/investigation-report.md - Timeline Builder
dfir/scripts/build_timeline.py - Normalized Timeline
dfir/timelines/DFIR-001-timeline.jsonl - Timeline Exporter
dfir/scripts/export_timeline.py - CSV and Markdown
dfir/timelines - Case Verification
dfir/scripts/verify_case.py - Timeline Schema
dfir/schemas/timeline-schema.json - Evidence Hashes
dfir/evidence/DFIR-001/SHA256SUMS.txt
Other components
- Windows Activity
Connections 17
- Windows Activity → Windows Endpoint: occurs on
README.md - Windows Endpoint → Windows Logs: generates
README.md - Windows Logs → Wazuh Agent: collected by
README.md - Wazuh Agent → Wazuh SIEM: forwards logs
README.md - Wazuh SIEM → Custom Rules: evaluates
README.md - Custom Rules → Detection Validation: validated by
README.md - Hunt Analyses → Hunt Evidence: documents evidence
README.md - Detection Validation → Hunt Evidence: produces evidence
- Wazuh SIEM → SOC-INC-001 Investigation: alerts inform
README.md - SOC-INC-001 Investigation → Incident Timeline: documents sequence
README.md - Hunt Evidence → Timeline Builder: reads records
dfir/scripts/build_timeline.py - Timeline Builder → Normalized Timeline: writes timeline
dfir/scripts/build_timeline.py - Normalized Timeline → Timeline Exporter: reads timeline
dfir/scripts/export_timeline.py - Timeline Exporter → CSV and Markdown: writes formats
dfir/scripts/export_timeline.py - Normalized Timeline → Case Verification: checks records
dfir/scripts/verify_case.py - Timeline Schema → Case Verification: required input
dfir/scripts/verify_case.py - Evidence Hashes → Case Verification: checks integrity
dfir/scripts/verify_case.py