How uruc/soc-automation-lab works
Project type and purpose
• This is a hands-on SOC Automation Lab: a full-stack security monitoring and response system built on virtual machines and open-source tools.
• Purpose: Collect Windows security events (via Sysmon), centralize and alert on them (via Wazuh), automate incident workflows (via Shuffle), manage cases (via TheHive), enrich alerts (via VirusTotal), and notify analysts.
File structure
• Top-level files: README.md (detailed deployment and architecture guide), LICENSE, .gitignore, .gitattributes.
• images directory: screenshots and the master SOC_Automation_Diagram.png.
• No code—this is an infrastructure lab with manual and scripted installations.
Extract architectural insights from the README
• Components: Windows 10 Sysmon client; Wazuh server (manager, web UI, Filebeat); TheHive server (application, Java, Cassandra, Elasticsearch); Shuffle (SOAR workflows); VirusTotal API; Email system.
• Workflows: Sysmon → Wazuh → custom alert → webhook to Shuffle → VirusTotal lookup + TheHive case creation + email notification.
• Deployment: Each major tool lives on its own VM or service endpoint.
Main components and their interactions
a. Windows 10 VM with Sysmon agent
b. Wazuh VM
– Wazuh Manager (ossec)
– Elasticsearch & Filebeat (for archiving & indexing)
– Wazuh Web UI
c. Shuffle SOAR (cloud or VM service)
d. TheHive VM
– TheHive application
– Cassandra (data store)
– Elasticsearch (search/index store)
e. External services
– VirusTotal API
– SMTP/Email server
1. Sysmon → Wazuh Manager (event forwarding)
2. Wazuh Manager → Filebeat → Elasticsearch (log indexing)
3. Wazuh Manager → webhook (Shuffle integration)
4. Shuffle workflow:
• extract SHA256 → VirusTotal API → parse results
• call TheHive API → create incident/case
• send email notification
Architectural patterns and principles
• Micro-VM/service separation: each tool lives in its own sandbox VM or container.
• Event-driven integration: Wazuh alerts trigger webhooks into Shuffle.
• Modular SOAR workflows: each step (regex extraction, API enrichment, case creation, notification) is a self-contained module.
• Data persistence: Elasticsearch indexes events; Cassandra/Elasticsearch store TheHive cases.
Technologies, frameworks, libraries
• Sysmon on Windows for event capture.
• Wazuh (Ossec + Filebeat + Elasticsearch + Kibana-like UI).
• Shuffle (SOAR orchestration).
• TheHive (Scala/Play application) with Cassandra and Elasticsearch.
• VirusTotal REST API.
• SMTP/email.
• Virtualization platform (VMware or cloud droplets on DigitalOcean).