How hamayl-ali/siem-dashboard works
SIEM Dashboard ingests submitted or host-shipped logs, normalizes and classifies them, correlates detections into alerts, persists events and alerts, and streams updates to a React dashboard. The product also provides JWT-based account access, alert management, analytics, and YAML playbook simulation. The graph combines documented capabilities with sampled calls; frontend-to-API and some unsampled subsystem links rely on README descriptions rather than inspected implementation.
Main entry points: log_controller.py Log Processing · hooks API Data Hooks · scenario_routes.py Scenario Routes · log_routes.py Log API Routes
Components 24
Ingestion and Detection
- Log Processing
siem-dashboard/backend/app/controllers/log_controller.py - Log Normalizer
siem-dashboard/backend/app/engine/normalizer.py - Severity Classifier
siem-dashboard/backend/app/engine/severity.py - Correlation Engine
siem-dashboard/backend/app/engine/correlation.py - Log Events
siem-dashboard/backend/app/models/log_event.py - Alerts
siem-dashboard/backend/app/models/alert.py - Redis Streams
API and Identity
- Log API Routes
siem-dashboard/backend/app/routes/log_routes.py - SSE Streaming
siem-dashboard/backend/app/core/streaming.py - Alert API Routes
siem-dashboard/backend/app/routes/alert_routes.py - Authentication Routes
siem-dashboard/backend/app/routes/auth_routes.py - Identity Controller
siem-dashboard/backend/app/controllers/auth_controller.py - User Accounts
siem-dashboard/backend/app/models/user.py - JWT and Passwords
siem-dashboard/backend/app/core/auth.py
Scenario Simulation
- Scenario Routes
siem-dashboard/backend/app/routes/scenario_routes.py - Playbook Definitions
siem-dashboard/backend/app/scenarios/playbook.py - Scenario Runner
siem-dashboard/backend/app/scenarios/runner.py - Scenario Runs
siem-dashboard/backend/app/models/scenario_run.py
Dashboard UI
- React Dashboard
siem-dashboard/frontend/src/routes - API Data Hooks
siem-dashboard/frontend/src/api/hooks - Analytics Charts
siem-dashboard/frontend/src/core/charts/SeverityBarChart.tsx
Other components
- Analyst / Admin
- Host Log Shipper
siem-dashboard/scripts/log_shipper.py - Dashboard User
Connections 29
- Analyst / Admin → Log API Routes: submits logs
siem-dashboard/backend/app/routes/log_routes.py - Host Log Shipper → Log API Routes: ships events
README.md - Log API Routes → Log Processing: dispatches ingestion
siem-dashboard/backend/app/routes/log_routes.py - Log Processing → Log Normalizer: normalizes batch
siem-dashboard/backend/app/controllers/log_controller.py - Log Processing → Severity Classifier: classifies events
siem-dashboard/backend/app/controllers/log_controller.py - Log Processing → Correlation Engine: correlates events
siem-dashboard/backend/app/controllers/log_controller.py - Log Processing → Log Events: saves events
siem-dashboard/backend/app/controllers/log_controller.py - Log Processing → Alerts: saves alerts
siem-dashboard/backend/app/controllers/log_controller.py - Log Processing → Redis Streams: publishes updates
siem-dashboard/backend/app/controllers/log_controller.py - Alert API Routes → SSE Streaming: streams alerts
siem-dashboard/backend/app/routes/alert_routes.py - Log API Routes → SSE Streaming: streams events
siem-dashboard/backend/app/routes/log_routes.py - SSE Streaming → Redis Streams: reads stream
siem-dashboard/backend/app/core/streaming.py - Analyst / Admin → Authentication Routes: authenticates
siem-dashboard/backend/app/routes/auth_routes.py - Authentication Routes → Identity Controller: dispatches auth
siem-dashboard/backend/app/routes/auth_routes.py - Identity Controller → User Accounts: reads and saves
siem-dashboard/backend/app/controllers/auth_controller.py - Identity Controller → JWT and Passwords: hashes and issues tokens
siem-dashboard/backend/app/controllers/auth_controller.py - Analyst / Admin → Scenario Routes: starts simulation
siem-dashboard/backend/app/routes/scenario_routes.py - Scenario Routes → Playbook Definitions: loads playbooks
siem-dashboard/backend/app/routes/scenario_routes.py - Scenario Routes → Scenario Runner: starts run
siem-dashboard/backend/app/routes/scenario_routes.py - Scenario Routes → Scenario Runs: reads run status
siem-dashboard/backend/app/routes/scenario_routes.py - Scenario Runner → Scenario Runs: records run
siem-dashboard/backend/app/scenarios/runner.py - Scenario Runner → Log Processing: submits scenario logs
siem-dashboard/backend/app/scenarios/runner.py - Dashboard User → React Dashboard: uses dashboard
README.md - React Dashboard → API Data Hooks: requests data
- API Data Hooks → Log API Routes: calls backend API
README.md - API Data Hooks → Alert API Routes: calls backend API
README.md - API Data Hooks → Authentication Routes: calls backend API
README.md - API Data Hooks → Scenario Routes: calls backend API
README.md - React Dashboard → Analytics Charts: renders analytics