How sreevathsans/hybrid-intrusion-detection-system works
IDS-Hybrid detects network attacks using flow-level ML plus behavioral and volumetric checks, then blocks malicious sources and exposes attack state through a SOC dashboard. The graph preserves the documented inline packet-to-mitigation workflow and the monitoring and blockchain capabilities. IPS orchestration and dashboard WebSocket behavior are visible in excerpts; some mitigation, logging, and dashboard-state relationships are documented only at a high level, so those links cite the README.
Main entry points: ips/main.py IPS Orchestrator · expiry_engine.py State Expiry · dashboard_backend/main.py Dashboard API · block_manager.py IP Blocking
Components 23
Traffic Detection
- Packet Capture
ips/nfqueue_handler.py - IPS Orchestrator
ips/main.py - Flow Aggregation
ips/flow_manager.py - Behavior Detection
ips/behavior_engine.py - Volumetric Detection
ips/volumetric_engine.py - Flow Classifier
ips/ml_engine.py - Feature Extraction
ips/feature_extractor.py - Host Aggregation
ips/host_aggregator.py - Offline Prediction
ML/predict.py
Prevention and Logging
- Attack Sessions
ips/attack_session_manager.py - IP Blocking
ips/block_manager.py - State Expiry
ips/expiry_engine.py - Attack Logging
ips/attack_logger.py
Blockchain Audit
- Blockchain Logger
ips/blockchain_logger.py - Chain Configuration
blockchain_module/config/attack_config.py - Blockchain Scripts
blockchain_module/scripts/store_log.py
SOC Monitoring
- Dashboard API
dashboard_backend/main.py - Dashboard State
dashboard_backend/state.py - Log Reader
dashboard_backend/log_reader.py - SOC Dashboard
dashboard_frontend/src/App.js
Other components
- Network Traffic
- Ethereum Network
- System Launcher
main.py
Connections 27
- Network Traffic → Packet Capture: enters queue
- Packet Capture → IPS Orchestrator: delivers packets
ips/main.py - IPS Orchestrator → Flow Aggregation: updates flows
ips/main.py - IPS Orchestrator → Behavior Detection: checks behavior
ips/main.py - IPS Orchestrator → Volumetric Detection: checks volume
ips/main.py - IPS Orchestrator → Flow Classifier: classifies flows
ips/main.py - IPS Orchestrator → Feature Extraction: extracts features
- IPS Orchestrator → Host Aggregation: aggregates hosts
ips/main.py - Flow Aggregation → Flow Classifier: requests prediction
ips/flow_manager.py - IPS Orchestrator → IP Blocking: blocks threats
ips/main.py - IP Blocking → Attack Sessions: updates sessions
ips/block_manager.py - IPS Orchestrator → State Expiry: starts cleanup
ips/main.py - State Expiry → Flow Aggregation: expires flows
ips/expiry_engine.py - State Expiry → Behavior Detection: expires sources
ips/expiry_engine.py - State Expiry → Volumetric Detection: expires sources
ips/expiry_engine.py - State Expiry → IP Blocking: expires blocks
ips/expiry_engine.py - State Expiry → Attack Sessions: expires sessions
ips/expiry_engine.py - IP Blocking → Attack Logging: writes events
ips/block_manager.py - Attack Logging → Blockchain Logger: records attacks
- Blockchain Logger → Blockchain Scripts: stores logs
- Blockchain Scripts → Ethereum Network: writes transactions
- System Launcher → Offline Prediction: runs offline mode
- Dashboard API → Dashboard State: reads status
dashboard_backend/main.py - Dashboard API → Log Reader: reads logs
dashboard_backend/main.py - Dashboard API → SOC Dashboard: streams WebSocket data
dashboard_backend/main.py - SOC Dashboard → Dashboard API: connects live
dashboard_frontend/src/App.js - Dashboard API → Ethereum Network: reports chain status