How vuducanhnguyen/soc-homelab works
This repository documents a SOC homelab whose main workflow runs from endpoint telemetry, through Wazuh detection and alerting, to Shuffle-driven enrichment and incident response. The response branches include TheHive case management, pfSense IP blocking, and Wazuh active response for host isolation. The README documents additional network, dashboard, and threat-simulation capabilities; the tree provides configuration and workflow artifacts rather than the full platforms, so links between those components follow documented integrations, not inspected platform code.
Main entry points: ossec.conf Wazuh manager · Shuffle Shuffle workflows · Wazuh_config Wazuh agent · Active_response_pfSense_block.py pfSense firewall
Components 19
Monitoring & Detection
- Sysmon & OpenSSH
- Wazuh agent
Wazuh_config - Wazuh manager
Wazuh_config/ossec.conf - Local decoders
Wazuh_config/local_decoder.xml - Local rules
Wazuh_config/local_rules.xml - Wazuh indexer
Wazuh_config - Wazuh dashboard
Wazuh_config
SOAR & Incidents
- Shuffle workflows
Shuffle - TheHive cases
Shuffle/TheHive_Bruteforce_SSH_body.json - VirusTotal API
- Email API
Network Security
- pfSense firewall
Shuffle/Active_response_pfSense_block.py - DHCP & DNS
Response Actions
- Active response config
Wazuh_config/ossec.conf - Isolation commands
Wazuh_config/isolate-host.cmd - Isolation script
Wazuh_config/isolate-host.ps1
Other components
- Kali attacker
- Windows endpoint
- SOC analyst
Connections 20
- Kali attacker → Windows endpoint: simulates attacks
- Sysmon & OpenSSH → Wazuh agent: sends events
- Windows endpoint → Wazuh agent: forwards logs
- Wazuh agent → Wazuh manager: transmits logs
- Wazuh manager → Local decoders: decodes events
- Wazuh manager → Local rules: matches rules
- Wazuh manager → Wazuh indexer: indexes alerts
- Wazuh dashboard → Wazuh indexer: queries data
- SOC analyst → Wazuh dashboard: investigates alerts
- Wazuh manager → Shuffle workflows: sends webhooks
- Shuffle workflows → TheHive cases: creates cases
- Shuffle workflows → VirusTotal API: enriches indicators
- Shuffle workflows → Email API: sends notifications
- Shuffle workflows → pfSense firewall: blocks IPs
- pfSense firewall → DHCP & DNS: protects subnets
- Wazuh manager → Active response config: dispatches response
- Active response config → Isolation commands: invokes command
- Active response config → Isolation script: invokes script
- Wazuh manager → Wazuh agent: sends response
- Wazuh agent → Windows endpoint: isolates host