How arshathhaq/industrial-security-analysis-coursework works
AQUASHIELD documents a water-tank OT/SCADA system. Its sampled runtime shows the PLC simulator serving Modbus process values and a SCADA monitoring agent polling the PLC, detecting alarms/anomalies, and logging events. FUXA controls, firewall, reverse proxy, IDS/Wazuh, historian, and assessment capabilities are README-documented but their implementation is not in the supplied tree; edges for those documented paths cite the README. The report’s illustrative project layout is not treated as repository source.
Main entry points: LevelSim.py PLC Simulator · monitor.py Monitor Agent
Components 16
Tank Process
- PLC Simulator
modbus-sim/LevelSim.py - Virtual Tank
modbus-sim/LevelSim.py
SCADA Monitoring
- FUXA HMI/SCADA
- Monitor Agent
scada-monitor/monitor.py - Event Log
scada-monitor/monitor.py - SQLite Historian
- Alarms and Trends
Security Operations
- Suricata IDS
- Wazuh Agent
- Wazuh Manager
- Alert Review
- MQTT Broker
- Security Assessment
Network Boundary
- Nginx Proxy
- OT Firewall
Other components
- Operator
Connections 21
- Operator → FUXA HMI/SCADA: operates and monitors
README.md - FUXA HMI/SCADA → Nginx Proxy: accesses through
README.md - Nginx Proxy → FUXA HMI/SCADA: proxies access
README.md - FUXA HMI/SCADA → PLC Simulator: Modbus control and reads
README.md - PLC Simulator → Virtual Tank: updates process state
modbus-sim/LevelSim.py - Monitor Agent → PLC Simulator: polls Modbus state
scada-monitor/monitor.py - Monitor Agent → Event Log: writes events
scada-monitor/monitor.py - Monitor Agent → Alarms and Trends: detects alarm conditions
scada-monitor/monitor.py - FUXA HMI/SCADA → SQLite Historian: records process values
README.md - SQLite Historian → Alarms and Trends: supports trend review
README.md - FUXA HMI/SCADA → OT Firewall: crosses permitted conduits
README.md - OT Firewall → Nginx Proxy: permits HTTP access
README.md - OT Firewall → PLC Simulator: permits Modbus traffic
README.md - OT Firewall → Suricata IDS: hosts traffic inspection
README.md - Suricata IDS → Wazuh Agent: forwards EVE events
README.md - Wazuh Agent → Wazuh Manager: forwards security events
README.md - Wazuh Manager → Alert Review: presents alerts for review
README.md - MQTT Broker → Suricata IDS: traffic monitored
README.md - Security Assessment → OT Firewall: assesses controls
README.md - Security Assessment → FUXA HMI/SCADA: assesses access controls
README.md - Security Assessment → Suricata IDS: assesses monitoring
README.md