How terminalkid09/aegis-ecosystem works
Aegis is a local-first XDR/SIEM stack: operators use its dashboard and APIs while endpoint agents and log sources submit telemetry; the Brain normalizes and stores events, detects threats, presents alerts, and can trigger response playbooks. The graph also preserves the documented static-analysis, enrichment, notification, and deception capabilities. Relationships are limited to README-documented flows and excerpted calls; Kraken’s broader runtime wiring and several unsampled subsystems are not asserted.
Main entry points: siem_pipeline.py SIEM Pipeline · router.py Brain API · playbook_engine.py SOAR Playbooks · Main.java Guard Agent
Components 33
Operator Console
- SOC Dashboard
frontend/src/App.tsx
Endpoint Agents
- Guard Agent
aegis-guard/src/main/java/com/aegis/guard/Main.java - Endpoint Events
aegis-guard/src/main/java/com/aegis/guard/models/SystemEvent.java - NodeTrace Agent
NodeTrace/agents/python/agent.py - Kernel Sensors
aegis-ebpf/aegis_exec.bpf.c
Aegis Brain
- Brain API
aegis-brain/app/api/v1/router.py - Authentication
aegis-brain/app/api/v1/auth.py - API Security
aegis-brain/app/core/security.py - Domain Records
aegis-brain/app/database/models.py - Event Database
aegis-brain/app/database/connection.py - Metrics
aegis-brain/app/core/metrics.py - Brain Settings
aegis-brain/app/core/config.py - Structured Logging
aegis-brain/app/core/logging.py - Data Retention
aegis-brain/app/services/retention.py
SIEM Pipeline
- Event Gateway
aegis-link/src/main/java/com/aegis/link/controllers/IngestionController.java - Ingestion Queue
aegis-link/src/main/java/com/aegis/link/service/RedisService.java - Log Parsers
aegis-brain/app/ingest/base.py - SIEM Pipeline
aegis-brain/app/services/siem_pipeline.py - SIEM Event Store
aegis-brain/app/services/siem_store.py - Static Rules
aegis-brain/app/rules/rule_definitions.py - Custom Rules
aegis-brain/app/rules/heuristic_engine.py - Sigma Engine
aegis-brain/app/rules/sigma/engine.py - Event Correlation
aegis-brain/app/rules/correlation_engine.py
Response and Enrichment
- SOAR Playbooks
aegis-brain/app/services/playbook_engine.py - Agent Commands
aegis-brain/app/services/command_queue.py - OSINT Enrichment
aegis-brain/app/services/osint_service.py - AI Enrichment
aegis-brain/app/services/ai_service.py - Telegram Alerts
aegis-brain/app/services/telegram_notifier.py - Device PKI
aegis-brain/app/services/pki.py
Kraken Analysis
- YARA Scanning
aegis-brain/app/services/yara_engine.py - File Analysis
services/kraken/app/services/file_analysis.py - Honeypot Sensors
services/kraken/honeypot/runner.py
Other components
- SOC Operator
Connections 32
- SOC Operator → SOC Dashboard: uses
README.md - SOC Dashboard → Brain API: requests
- Brain API → Authentication: routes
aegis-brain/app/api/v1/router.py - Brain API → API Security: secures
aegis-brain/app/main.py - Guard Agent → Endpoint Events: emits
aegis-guard/src/main/java/com/aegis/guard/Main.java - Guard Agent → Event Gateway: submits events
- NodeTrace Agent → Brain API: submits telemetry
README.md - Kernel Sensors → Guard Agent: provides telemetry
README.md - Event Gateway → Ingestion Queue: queues events
aegis-link/src/main/java/com/aegis/link/controllers/IngestionController.java - Ingestion Queue → SIEM Pipeline: forwards events
- Brain API → SIEM Pipeline: routes log ingestion
README.md - SIEM Pipeline → Log Parsers: parses events
aegis-brain/app/services/siem_pipeline.py - SIEM Pipeline → SIEM Event Store: stores events
aegis-brain/app/services/siem_pipeline.py - SIEM Pipeline → Sigma Engine: runs detection
aegis-brain/app/services/siem_pipeline.py - SIEM Pipeline → Event Correlation: correlates events
aegis-brain/app/services/siem_pipeline.py - SIEM Pipeline → Static Rules: evaluates rules
- SIEM Pipeline → Custom Rules: evaluates custom rules
- SIEM Pipeline → SOAR Playbooks: triggers response
aegis-brain/app/services/siem_pipeline.py - SOAR Playbooks → Agent Commands: queues actions
aegis-brain/app/services/playbook_engine.py - SOAR Playbooks → Domain Records: records executions
aegis-brain/app/services/playbook_engine.py - SOAR Playbooks → Device PKI: uses device identity
aegis-brain/app/services/playbook_engine.py - SIEM Pipeline → Telegram Alerts: notifies
aegis-brain/app/services/siem_pipeline.py - Brain API → OSINT Enrichment: offers enrichment
README.md - Brain API → AI Enrichment: offers analysis
README.md - Brain API → YARA Scanning: exposes scanning
aegis-brain/app/services/yara_engine.py - Brain API → File Analysis: offers file analysis
README.md - Honeypot Sensors → SIEM Pipeline: sends events
- Data Retention → SIEM Event Store: purges expired data
aegis-brain/app/services/retention.py - Brain API → Metrics: serves metrics
aegis-brain/app/main.py - SIEM Pipeline → Domain Records: creates records
aegis-brain/app/services/siem_pipeline.py - SIEM Pipeline → Brain Settings: reads settings
aegis-brain/app/services/siem_pipeline.py - SIEM Pipeline → Structured Logging: logs activity
aegis-brain/app/services/siem_pipeline.py