How montysecurity/c2-tracker works
C2 Tracker collects infrastructure indicators by querying Shodan, writes per-tool and aggregate IP feeds, and offers an OpenCTI connector that imports, reconciles, and optionally relates indicators to tool or malware entities. The README also describes historical analysis through repository history and SIEM/TIP ingestion of raw feed files. Censys support exists in tracker.py but is disabled. The repository is archived, and the README says its former data files are no longer maintained; the excerpts do not show the full connector startup or every OpenCTI operation.
Main entry points: tracker.py Tracker runner · connector.py Indicator reconciliation · purge.py Indicator purger
Components 12
IOC collection
- Tracker runner
tracker.py - Shodan search
tracker.py - Censys search
tracker.py
Feed output
- IP feed files
tracker.py
OpenCTI integration
- Feed fetcher
opencti-connector/src/connector.py - Indicator reconciliation
opencti-connector/src/connector.py - OpenCTI platform
- Entity relationships
opencti-connector/src/connector.py - Indicator purger
opencti-connector/src/purge.py
Feed consumption
- SIEM / TIP
- History investigator
Other components
- Local operator
Connections 13
- Local operator → Tracker runner: runs
README.md - Tracker runner → Shodan search: queries
tracker.py - Tracker runner → Censys search: can query
README.md - Tracker runner → IP feed files: writes IPs
tracker.py - IP feed files → SIEM / TIP: ingested as feed
README.md - History investigator → IP feed files: searches history
README.md - Feed fetcher → IP feed files: fetches IPs
opencti-connector/src/connector.py - Feed fetcher → Indicator reconciliation: passes IPs
opencti-connector/src/connector.py - Indicator reconciliation → OpenCTI platform: creates and deletes
opencti-connector/src/connector.py - Indicator reconciliation → Entity relationships: checks MITRE
opencti-connector/src/connector.py - Entity relationships → OpenCTI platform: creates relationships
opencti-connector/src/connector.py - Local operator → Indicator purger: runs cleanup
- Indicator purger → OpenCTI platform: deletes tagged indicators
opencti-connector/src/purge.py