How rijul-negi/project-ids works
This is a hybrid network intrusion-detection system with configurable TCP honeypots and a Flask monitoring dashboard. Its principal workflow captures packets, builds and exports flows, checks signatures, then applies whitelist filtering and ML classification before queuing alerts for the dashboard stream. The launcher starts these workers concurrently. The README documents dashboard and monitoring capabilities beyond the sampled HTML; source excerpts show the backend stream and routes, but not the dashboard implementation. Note that main.py imports sniffer while the tree lists Sniffer.py, which may affect imports on case-sensitive systems.
Main entry points: main.py Worker Launcher · server.py Flask Event Server · Sniffer.py Alert Queue · infer.py ML Classification
Components 14
Traffic Analysis
- Worker Launcher
main.py - Packet Capture
Sniffer.py - Flow Processing
Sniffer.py
Detection
- Signature Matching
sign.py - Snort Rules
snort3-community.rules - ML Classification
infer.py - XGBoost Model
v5_model.json - IP Whitelist
whitelist.json
Honeypot
- Port Honeypots
honeypot.py
Alerts and Dashboard
- Alert Queue
Sniffer.py - Flask Event Server
server.py - Web Dashboard
dashboard.html
Other components
- Dashboard User
- Network Clients
Connections 22
- Worker Launcher → Packet Capture: starts capture
main.py - Worker Launcher → Flow Processing: starts workers
main.py - Worker Launcher → ML Classification: starts worker
main.py - Worker Launcher → Port Honeypots: starts listeners
main.py - Worker Launcher → Flask Event Server: starts server
main.py - Packet Capture → Flow Processing: updates flows
Sniffer.py - Packet Capture → Signature Matching: checks packets
Sniffer.py - Signature Matching → Snort Rules: loads rules
sign.py - Flow Processing → Alert Queue: queues flow data
Sniffer.py - Alert Queue → ML Classification: consumes flows
- ML Classification → XGBoost Model: loads model
infer.py - ML Classification → IP Whitelist: loads trusted IPs
infer.py - ML Classification → Alert Queue: queues results
- Worker Launcher → Alert Queue: shares alert queue
main.py - Port Honeypots → Alert Queue: queues hit alerts
honeypot.py - Network Clients → Port Honeypots: connects to ports
honeypot.py - Worker Launcher → Flask Event Server: configures queue
main.py - Flask Event Server → Alert Queue: reads alerts
server.py - Flask Event Server → Web Dashboard: serves page
server.py - Dashboard User → Web Dashboard: views monitoring
README.md - Flask Event Server → IP Whitelist: serves whitelist
server.py - Web Dashboard → Flask Event Server: opens event stream