How samiul008ghub/soc_setup works
Project type and purpose
• This is an automation tool (a Bash-based setup script) for quickly configuring a unified Security Operations Center (SOC) environment on a single Ubuntu host.
• It installs and configures three core components:
• SIEM (Elasticsearch + Kibana + Filebeat)
• NIDS (Suricata)
• HIDS (Wazuh Manager)
File structure
• Top-level files only—no nested “src” or “lib” directories—indicating a small orchestration project rather than a multi-service codebase.
• Key scripts:
• setup_script.sh – main entry point; prompts the user and calls the component-specific scripts
• siem_setup.sh – installs Elasticsearch, Kibana, Filebeat (v7.17.13 for Wazuh 4.5 compatibility)
• suricata_setup.sh (+ suricata_temp.yaml) – installs and configures Suricata to monitor the host interface
• wazuh_setup.sh – installs and configures the Wazuh Manager (v4.5)
Extracted architecture information from the README
• Everything runs on one machine/VM (Ubuntu).
• Filebeat collects logs from both Suricata (eve.json) and Wazuh modules and ships them into Elasticsearch.
• Kibana (in SIEM component) provides dashboards for general event analysis, Suricata alerts, and Wazuh alerts.
• Future extensibility: Wazuh agents on other hosts send logs to the central Wazuh Manager, which feeds into Elasticsearch via Filebeat.
Main components and their relationships
a. Host OS (Ubuntu)
b. Orchestration layer (setup_script.sh)
c. SIEM stack
• Elasticsearch (data store + search engine)
• Kibana (visualization + dashboards)
• Filebeat (log shipper)—module configurations for Suricata and Wazuh
d. NIDS
• Suricata (sensor; writes JSON logs to /var/log/suricata/eve.json)
e. HIDS
• Wazuh Manager (central analysis)
• Wazuh filebeat module (shipped to Elasticsearch)
f. Optional external Wazuh agents
g. Networking
• Suricata monitors local interface (or TAP/SPAN)
• All components communicate over localhost or defined ports
Architectural patterns & design principles
• Single-node deployment (consolidation) for testing/proof-of-concept
• Modular installation scripts—each component is wrapped in its own script for separation of concerns
• Log-centralization pattern: multiple data sources → Filebeat → Elasticsearch → Kibana UI
• Extensibility: additional Wazuh agents or remote sensors simply hook into the same pipeline