How ajaxontheway/threat-mapper works
ThreatMapper is a FastAPI threat-intelligence service. Its main workflow validates an IOC, queries reputation providers, calculates a confidence verdict, persists the result, and returns it. Separate capabilities manage tenant organizations and watchlists, periodically rescan watched IOCs, send qualifying alerts to Splunk, and export watchlisted IOCs as STIX 2.1. The scheduler and SIEM dispatch are visible in sampled source; other subsystem links are limited to the shown calls and README, which names no further capabilities.
Main entry points: main.py FastAPI endpoints · jobs.py Background rescans · models.py Persistence models · database.py Database sessions
Components 15
API and exports
- FastAPI endpoints
backend/main.py - STIX 2.1 export
backend/main.py
IOC analysis
- IOC normalization
backend/engine.py - Threat feeds
backend/connectors.py - Confidence scoring
backend/engine.py - VirusTotal
- AbuseIPDB
Monitoring and SIEM
- Watchlist management
backend/main.py - Background rescans
backend/jobs.py - Alert dispatch
backend/siem.py - Splunk HEC
Tenant data
- Organization and SIEM config
backend/main.py - Persistence models
backend/models.py - Database sessions
backend/database.py
Other components
- API consumer
Connections 24
- API consumer → FastAPI endpoints: requests
backend/main.py - FastAPI endpoints → IOC normalization: normalizes
backend/main.py - FastAPI endpoints → Threat feeds: queries feeds
backend/main.py - Threat feeds → VirusTotal: queries
backend/connectors.py - Threat feeds → AbuseIPDB: queries
backend/connectors.py - FastAPI endpoints → Confidence scoring: scores results
backend/main.py - FastAPI endpoints → Database sessions: persists lookup
backend/main.py - FastAPI endpoints → Persistence models: queries models
backend/main.py - FastAPI endpoints → Watchlist management: serves routes
backend/main.py - FastAPI endpoints → Organization and SIEM config: serves routes
backend/main.py - FastAPI endpoints → STIX 2.1 export: serves export
backend/main.py - Watchlist management → Database sessions: reads and writes
backend/main.py - Watchlist management → Persistence models: uses records
backend/main.py - Organization and SIEM config → Database sessions: reads and writes
backend/main.py - Organization and SIEM config → Persistence models: uses records
backend/main.py - STIX 2.1 export → Persistence models: loads watch item
backend/main.py - FastAPI endpoints → Background rescans: starts scheduler
backend/main.py - Background rescans → Database sessions: loads watchlist
backend/jobs.py - Background rescans → Persistence models: queries records
backend/jobs.py - Background rescans → Threat feeds: queries feeds
backend/jobs.py - Background rescans → Confidence scoring: scores results
backend/jobs.py - Background rescans → Alert dispatch: sends alerts
backend/jobs.py - Alert dispatch → Splunk HEC: posts events
backend/siem.py - Persistence models → Database sessions: inherits base
backend/models.py