How jangidc/watchdesk works
Watchdesk is a self-hosted threat-intelligence platform for collecting, normalizing, correlating, and triaging indicators of compromise. Feed connectors fetch from ThreatFox, URLhaus, and optional AbuseIPDB; ingestion merges sightings and records feed-run health in SQLite. A scheduled job and the dashboard’s manual refresh both trigger ingestion. Analysts use the dashboard to search and filter indicators and inspect severity, corroboration, and feed health. The README documents the overall pipeline; some template and URLhaus implementation details were not excerpted.
Main entry points: ingest.py Normalize and correlate · routes.py Dashboard and JSON API · app.js Dashboard interactions · __init__.py Refresh scheduler
Components 14
Feed collection
- ThreatFox connector
app/feeds/threatfox.py - URLhaus connector
app/feeds/urlhaus.py - AbuseIPDB connector
app/feeds/abuseipdb.py
Ingestion and storage
- Normalize and correlate
app/ingest.py - IOC and feed-run records
app/models.py - SQLite database
app/__init__.py
Application service
- Refresh scheduler
app/__init__.py - Dashboard and JSON API
app/routes.py
Analyst dashboard
- Dashboard page
app/templates/dashboard.html - Dashboard interactions
app/static/app.js
Other components
- SOC analyst
- ThreatFox API
- URLhaus API
- AbuseIPDB API
Connections 15
- ThreatFox connector → ThreatFox API: fetches from
app/feeds/threatfox.py - URLhaus connector → URLhaus API: fetches from
README.md - AbuseIPDB connector → AbuseIPDB API: fetches from
app/feeds/abuseipdb.py - Normalize and correlate → ThreatFox connector: calls fetch
app/ingest.py - Normalize and correlate → URLhaus connector: calls fetch
app/ingest.py - Normalize and correlate → AbuseIPDB connector: calls fetch
app/ingest.py - Normalize and correlate → IOC and feed-run records: upserts and audits
app/ingest.py - Refresh scheduler → Normalize and correlate: schedules runs
app/__init__.py - Refresh scheduler → SQLite database: configures storage
app/__init__.py - Dashboard and JSON API → IOC and feed-run records: queries records
app/routes.py - Dashboard and JSON API → Normalize and correlate: triggers refresh
app/routes.py - Dashboard and JSON API → Dashboard page: renders page
app/routes.py - Dashboard interactions → Dashboard and JSON API: fetches API data
app/static/app.js - Dashboard page → Dashboard interactions: presents dashboard
README.md - SOC analyst → Dashboard interactions: uses