How blackdeath-1708/odin-king-of-analysis works
NTRO Unidirectional Threat Monitoring is a passive, real-time threat-detection pipeline with a live evidence-backed dashboard. Its principal workflow turns Zeek traffic metadata into normalized events, applies six threat detectors, correlates alerts, persists them, and exposes them through an API to the dashboard. The graph includes the documented ingest and detection stages, correlation, exports, and dashboard capabilities. Some internal wiring and optional integrations are only documented at the README level; edges use that evidence where available.
Main entry points: App.jsx React Dashboard · stream_consumer.py Stream Consumer · ArchitecturePage.jsx Architecture View · detectors Six Detectors
Components 26
Traffic Ingest
- Zeek
- Kafka Producer
backend/kafka_producer.py - Kafka
Threat Detection
- Stream Consumer
backend/stream_consumer.py - Six Detectors
backend/detectors - Feature Utilities
backend/detectors/features.py - TLS Tier-2 Model
backend/detectors/tier2_model.py - Alert Correlator
backend/correlation/correlator.py - Adaptive Baseline
backend/correlation/baseline.py
Alerts and Evidence
- Alert Log
- Forensic Chain
backend/forensic_chain.py - Alert Export
backend/alert_export.py
API Service
- Flask API
backend/app.py
Dashboard
- React Dashboard
frontend/src/App.jsx - Alert Views
frontend/src/pages/AlertsPage.jsx - Alert Feed
frontend/src/components/AlertFeed.jsx - Correlation View
frontend/src/pages/CorrelationPage.jsx - Export View
frontend/src/pages/ExportPage.jsx - Architecture View
frontend/src/pages/ArchitecturePage.jsx - Pipeline Status
frontend/src/components/PipelineStatus.jsx - Pipeline Stages
frontend/src/data/pipelineStages.js - Threat Coverage
frontend/src/data/threatMatrix.js - Analytics View
frontend/src/pages/AnalyticsPage.jsx - Model Performance
frontend/src/pages/ModelPerformancePage.jsx
Other components
- Mirrored Traffic
- Dashboard User
Connections 26
- Mirrored Traffic → Zeek: observes
- Zeek → Kafka Producer: writes logs
- Kafka Producer → Kafka: publishes events
- Kafka → Stream Consumer: delivers events
- Stream Consumer → Six Detectors: dispatches events
backend/stream_consumer.py - Stream Consumer → Alert Correlator: submits alerts
backend/stream_consumer.py - Alert Correlator → Adaptive Baseline: checks rates
backend/correlation/correlator.py - Six Detectors → Feature Utilities: uses features
backend/detectors/ddos.py - Six Detectors → TLS Tier-2 Model: scores ambiguous flows
backend/detectors/tls_malware.py - Stream Consumer → Alert Log: appends alerts
- Stream Consumer → Forensic Chain: records evidence
backend/stream_consumer.py - Stream Consumer → Alert Export: writes exports
backend/stream_consumer.py - Alert Log → Flask API: reads alerts
- Flask API → Alert Export: builds STIX bundles
backend/app.py - Dashboard User → React Dashboard: views dashboard
- React Dashboard → Flask API: polls and streams
frontend/src/App.jsx - React Dashboard → Alert Views: renders page
frontend/src/App.jsx - Alert Views → Alert Feed: renders feed
frontend/src/pages/AlertsPage.jsx - React Dashboard → Correlation View: renders page
frontend/src/App.jsx - React Dashboard → Export View: renders page
frontend/src/App.jsx - React Dashboard → Architecture View: renders page
frontend/src/App.jsx - Architecture View → Pipeline Stages: reads stages
frontend/src/pages/ArchitecturePage.jsx - Architecture View → Pipeline Status: renders status
frontend/src/pages/ArchitecturePage.jsx - Architecture View → Threat Coverage: shows coverage
frontend/src/pages/ArchitecturePage.jsx - React Dashboard → Analytics View: renders page
frontend/src/App.jsx - React Dashboard → Model Performance: renders page
frontend/src/App.jsx