How aggkavya/iot-is works
Secure MQTT-Based IoT Access Control System demonstrates unauthorized command injection in a smart-building MQTT setup and its mitigation with broker ACLs. The main workflow is dashboard or attacker → Mosquitto broker → door, light, or alarm, with device status and security events reflected in the dashboard. The README documents vulnerable and protected broker modes; the sampled source shows device MQTT behavior, backend APIs and event streaming, and attacker reporting. Broker configuration relationships and the overall run modes are documented, but the control-panel orchestration is not mapped here.
Main entry points: app.py Dashboard Backend · attacker.py MQTT Attack Tool · app.js Dashboard UI · door_device.py Door Device
Components 14
Broker Security
- Mosquitto Broker
- Vulnerable Config
secure-iot-mqtt/broker/mosquitto_vulnerable.conf - Protected Config
secure-iot-mqtt/broker/mosquitto_protected.conf - Vulnerable ACL
secure-iot-mqtt/broker/acl_vulnerable.conf - Protected ACL
secure-iot-mqtt/broker/acl_protected.conf
Smart Devices
- Door Device
secure-iot-mqtt/devices/door_device.py - Light Device
secure-iot-mqtt/devices/light_device.py - Alarm Device
secure-iot-mqtt/devices/alarm_device.py
Dashboard
- Dashboard Backend
secure-iot-mqtt/backend/app.py - Dashboard UI
secure-iot-mqtt/frontend/app.js - Dashboard Page
secure-iot-mqtt/frontend/index.html
Attack Tool
- MQTT Attack Tool
secure-iot-mqtt/attacker/attacker.py
Other components
- Dashboard User
- Attacker
Connections 19
- Dashboard User → Dashboard UI: uses
- Dashboard UI → Dashboard Backend: requests API
secure-iot-mqtt/frontend/app.js - Dashboard Backend → Mosquitto Broker: publishes commands
secure-iot-mqtt/backend/app.py - Dashboard Backend → Mosquitto Broker: subscribes status
secure-iot-mqtt/backend/app.py - Mosquitto Broker → Dashboard Backend: delivers status
secure-iot-mqtt/backend/app.py - Door Device → Mosquitto Broker: subscribes commands
secure-iot-mqtt/devices/door_device.py - Door Device → Mosquitto Broker: publishes status
secure-iot-mqtt/devices/door_device.py - Light Device → Mosquitto Broker: subscribes commands
secure-iot-mqtt/devices/light_device.py - Light Device → Mosquitto Broker: publishes status
secure-iot-mqtt/devices/light_device.py - Alarm Device → Mosquitto Broker: subscribes commands
secure-iot-mqtt/devices/alarm_device.py - Alarm Device → Mosquitto Broker: publishes status
secure-iot-mqtt/devices/alarm_device.py - Vulnerable Config → Mosquitto Broker: configures mode
- Protected Config → Mosquitto Broker: configures mode
- Vulnerable ACL → Mosquitto Broker: sets authorization
- Protected ACL → Mosquitto Broker: sets authorization
- Attacker → MQTT Attack Tool: runs
- MQTT Attack Tool → Mosquitto Broker: publishes or subscribes
secure-iot-mqtt/attacker/attacker.py - MQTT Attack Tool → Dashboard Backend: reports attempts
secure-iot-mqtt/attacker/attacker.py - Dashboard Page → Dashboard UI: hosts interface