How emilpasca/vast works
VAST is a vulnerable-by-design agricultural IoT research testbed. Its main workflow simulates sensor readings, exposes them through a gateway, and supports monitoring and security experiments; dataset tools collect and analyze measurements from those experiments. The sampled server code supports links among its API, generator, registry, and in-memory reading store. Other runtime relationships are shown only where the README documents them; source excerpts for those components were not provided.
Main entry points: main.py Data Server API · shared_metrics_utils.py Shared Metrics Analysis · data_collector.py Metrics Collector · app.py Temperature Sensor
Components 30
IoT Runtime
- Temperature Sensor
sensors/temp/app.py - IoT Gateway
iot-gateway/gateway.py - MQTT Broker
Data Simulation
- Data Server API
data-server/main.py - Sensor Registry
data-server/sensor_registry.py - Reading Generator
data-server/data_generator.py - Weather Events
data-server/weather_event_manager.py - Vulnerability Controls
data-server/vulnerability_manager.py - Reading Models
data-server/models/models.py - Reading Store
data-server/data_storage.py - Reading Formatter
data-server/data_formatter.py
Security Research
- BOLA Exploits
vulnerabilities/BOLA - Firmware Attacks
vulnerabilities/MaliciousFile
Monitoring
- Metrics Exporter
observability/sensor-metrics-exporter/sensor_metrics.py - Prometheus
- Grafana
Dataset Tools
- Metrics Collector
dataset-tools/data_collector.py - General Collector
dataset-tools/general_dataset_collector.py - Resource Dataset Generator
dataset-tools/generate_resource_exhaustion_dataset.py - Shared Metrics Analysis
dataset-tools/shared_metrics_utils.py - BOLA Analysis
dataset-tools/bola_dataset_processor.py - Command Injection Analysis
dataset-tools/command_injection_processor.py - DDoS Analysis
dataset-tools/ddos_processor.py - Fault Analysis
dataset-tools/fault_dataset_processor.py - LSTM Analysis
dataset-tools/lstm_dataset_processor.py - Custom LSTM Analysis
dataset-tools/lstm_dataset_processor_custom.py - Resource Analysis
dataset-tools/resource_exhaustion_processor.py - LLM Data Preparation
dataset-tools/prepare_llm_data.py - Heatwave Use Case
dataset-tools/use-cases/heatwave/tomato_greenhouse_heatwave.py
Other components
- Researcher
Connections 26
- Researcher → IoT Gateway: requests data
README.md - Temperature Sensor → MQTT Broker: publishes readings
README.md - IoT Gateway → MQTT Broker: uses broker
README.md - Temperature Sensor → Data Server API: provides sensor data
README.md - Data Server API → Sensor Registry: looks up sensors
data-server/main.py - Data Server API → Reading Generator: generates readings
data-server/main.py - Data Server API → Reading Store: stores and reads
data-server/main.py - Data Server API → Weather Events: uses events
data-server/main.py - Data Server API → Vulnerability Controls: uses controls
data-server/main.py - Data Server API → Reading Formatter: formats readings
data-server/main.py - Reading Generator → Reading Models: creates readings
data-server/data_generator.py - Reading Store → Reading Models: stores readings
data-server/data_storage.py - Researcher → BOLA Exploits: tests access flaws
README.md - Researcher → Firmware Attacks: tests firmware attack
- Metrics Exporter → Prometheus: exports metrics
README.md - Grafana → Prometheus: visualizes metrics
README.md - Metrics Collector → Prometheus: queries metrics
dataset-tools/data_collector.py - General Collector → Metrics Collector: reuses collector
dataset-tools/general_dataset_collector.py - Resource Dataset Generator → Metrics Collector: collects metrics
dataset-tools/generate_resource_exhaustion_dataset.py - BOLA Analysis → Shared Metrics Analysis: uses metrics utilities
dataset-tools/bola_dataset_processor.py - Command Injection Analysis → Shared Metrics Analysis: uses metrics utilities
dataset-tools/command_injection_processor.py - DDoS Analysis → Shared Metrics Analysis: uses metrics utilities
dataset-tools/ddos_processor.py - Fault Analysis → Shared Metrics Analysis: uses metrics utilities
dataset-tools/fault_dataset_processor.py - LSTM Analysis → Shared Metrics Analysis: uses metrics utilities
dataset-tools/lstm_dataset_processor.py - Custom LSTM Analysis → Shared Metrics Analysis: uses metrics utilities
dataset-tools/lstm_dataset_processor_custom.py - Resource Analysis → Shared Metrics Analysis: uses metrics utilities
dataset-tools/resource_exhaustion_processor.py