How jashvanthan/sentineltrace works
SentinelTrace is a workspace-isolated email threat detection and digital forensics platform. Responders use the SOC workbench to authenticate, ingest suspicious email, review analysis and enrichment, investigate related campaigns or infrastructure, and produce evidence dossiers. The backend API and background worker coordinate analysis; persistence and graph services support investigation. The README documents these capabilities, while source excerpts and the SOURCE INDEX show selected implementation links. Some capability branches are documented but their internal call paths were not sampled, so those links are omitted or marked unverified.
Main entry points: threat_service.py Threat orchestrator · main.py API application · server.py MCP tool bridge · emails.py Email endpoints
Components 26
SOC workbench
- Workbench UI
frontend/src - Email review
frontend/src/pages/EmailAnalysisPage.tsx - Campaign graph
frontend/src/pages/CampaignGraphPage.tsx - Infrastructure map
frontend/src/pages/GeolocationPage.tsx
API and access
- API application
backend/app/main.py - Authentication
backend/app/api/v1/auth.py - Email endpoints
backend/app/api/v1/emails.py - Workspace access
backend/app/api/v1/workspaces.py - Background worker
backend/app/worker.py
Email analysis
- Threat orchestrator
backend/app/services/threat_service.py - Email parsing
backend/app/services/email_service.py - AI classification
backend/app/services/ai_service.py - Analysis agents
backend/app/agents - Analysis records
backend/app/models/email_analysis.py
Investigation and evidence
- Threat intelligence
backend/app/services/intel_service.py - Geolocation
backend/app/services/geo_service.py - IP trace
backend/app/services/ip_trace/service.py - Campaign correlation
backend/app/services/neo4j_service.py - Forensic reports
backend/app/services/forensic_report_service.py
External integrations
- Gmail integration
backend/app/services/gmail_service.py - Encrypted evidence storage
backend/app/services/gcs_service.py - MCP tool bridge
mcp-server/src/server.py
Other components
- Responder
- LLM provider
- Threat intelligence providers
- PostgreSQL
Connections 28
- Responder → Workbench UI: uses
- Workbench UI → API application: requests API
- API application → Authentication: routes to
backend/app/main.py - API application → Email endpoints: routes to
backend/app/main.py - API application → Workspace access: routes to
backend/app/main.py - Email endpoints → Threat orchestrator: invokes
backend/app/api/v1/emails.py - Email endpoints → Background worker: queues analysis
backend/app/api/v1/emails.py - Background worker → Threat orchestrator: runs
backend/app/worker.py - Threat orchestrator → Email parsing: parses email
backend/app/services/threat_service.py - Threat orchestrator → AI classification: classifies
backend/app/services/threat_service.py - Threat orchestrator → Threat intelligence: enriches indicators
backend/app/services/threat_service.py - Threat orchestrator → Geolocation: enriches IPs
backend/app/services/threat_service.py - Threat orchestrator → Campaign correlation: updates graph
backend/app/services/threat_service.py - Threat orchestrator → Encrypted evidence storage: stores evidence
backend/app/services/threat_service.py - Threat orchestrator → Analysis records: records results
backend/app/services/threat_service.py - Email review → Analysis records: reviews
- Campaign graph → Campaign correlation: explores
- Infrastructure map → IP trace: visualizes
- Threat orchestrator → IP trace: traces infrastructure
- Threat orchestrator → Forensic reports: generates dossiers
- Gmail integration → Background worker: supplies messages
backend/app/worker.py - Threat intelligence providers → Threat intelligence: provides enrichment
- AI classification → LLM provider: requests analysis
backend/app/services/ai_service.py - MCP tool bridge → Email parsing: exposes tools
mcp-server/src/server.py - MCP tool bridge → Threat intelligence: exposes tools
mcp-server/src/server.py - MCP tool bridge → Geolocation: exposes tools
mcp-server/src/server.py - Authentication → PostgreSQL: stores sessions
- Analysis records → PostgreSQL: persists in