How wahyubudiprastowo/agenticaisoc works
This is a multi-service agentic SOC: security events enter through Syslog, M365/Defender, or Wazuh; SOC Core normalizes, filters, enriches, detects, and persists findings; Hermes adds asynchronous AI analysis, with Jev providing reasoning and Qdrant-backed memory; the dashboard presents findings and analytics. The graph preserves the documented threat-intelligence and detection branches. Some subsystem links rely on README-level architecture because their implementation was not excerpted.
Main entry points: app/worker.py Hermes orchestrator · app/worker.py SOC event worker · redis_client.py Raw event queue · main.py M365 collector
Components 27
Event collection
- Syslog collector
syslog-collector/app/main.py - M365 collector
m365-collector/app/main.py - Microsoft OAuth
m365-collector/app/auth.py
SOC processing
- Wazuh polling
soc-core/app/wazuh_client.py - Raw event queue
soc-core/app/redis_client.py - SOC event worker
soc-core/app/worker.py - Detection rules
soc-core/app/detections.py - Detection taxonomy
shared/taxonomy.py - Events and findings
soc-core/app/db.py - Filtered event queue
soc-core/app/redis_client.py
Threat intelligence
- Threat intel API
threat-intel/app/main.py - IOC providers
threat-intel/app/providers.py - Threat intel feeds
threat-intel/app/cyfirma_feeds.py
AI enrichment
- Hermes orchestrator
hermes/app/worker.py - Detection skills
hermes/app/skill_loader.py - Analysis agents
hermes/app/agents.py - Jev reasoning client
hermes/app/jev_client.py - Jev reasoning service
jev-client/app/reasoning.py - AI memory
hermes/app/memory.py - Finding enrichment
hermes/app/db.py
Findings interface
- Dashboard API
dashboard/app/main.py - Finding analytics
dashboard/app/aggregations.py
Other components
- Security event sources
- Redis
- PostgreSQL
- Qdrant
- SOC analyst
Connections 30
- Security event sources → Syslog collector: send syslog
- Syslog collector → Raw event queue: normalize and enqueue
syslog-collector/app/main.py - Security event sources → M365 collector: provide activity
- M365 collector → Microsoft OAuth: authenticate
m365-collector/app/main.py - M365 collector → Raw event queue: normalize and enqueue
m365-collector/app/main.py - Security event sources → Wazuh polling: provide alerts
- Wazuh polling → SOC event worker: poll events
soc-core/app/worker.py - Raw event queue → SOC event worker: consume events
soc-core/app/worker.py - SOC event worker → Detection rules: classify events
soc-core/app/worker.py - Detection rules → Detection taxonomy: resolve categories
soc-core/app/detections.py - SOC event worker → Events and findings: persist findings
soc-core/app/worker.py - SOC event worker → Threat intel API: enrich indicators
- Threat intel API → IOC providers: query providers
threat-intel/app/main.py - Threat intel API → Threat intel feeds: serve feed data
threat-intel/app/main.py - SOC event worker → Filtered event queue: queue filtered events
soc-core/app/worker.py - Filtered event queue → Hermes orchestrator: claim events
- Hermes orchestrator → Detection skills: load skills
hermes/app/worker.py - Hermes orchestrator → Analysis agents: run analysis
hermes/app/worker.py - Hermes orchestrator → Jev reasoning client: request reasoning
hermes/app/worker.py - Jev reasoning client → Jev reasoning service: call reasoning API
- Hermes orchestrator → AI memory: use memory
hermes/app/worker.py - Hermes orchestrator → Finding enrichment: save enrichment
hermes/app/worker.py - Events and findings → Dashboard API: serve findings
- Dashboard API → Finding analytics: aggregate results
dashboard/app/main.py - Dashboard API → SOC analyst: present findings
- Raw event queue → Redis: store queue data
- Filtered event queue → Redis: store queue data
- Events and findings → PostgreSQL: persist records
- Finding enrichment → PostgreSQL: persist enrichment
- AI memory → Qdrant: retrieve memory