How samfrieman/c2-beacon-detector works
C2 Beacon Detector is a browser-based tool for analyzing network-connection JSON and identifying possible command-and-control beaconing. The user submits a file or sample; the app validates the data, extracts behavioral features, checks threat intelligence, and produces scored findings for display and export. Historical analyses and custom rules are stored locally, while ThreatFox lookups use an external service. The README documents the analysis stages; sampled code confirms selected initialization, validation, and lookup relationships. Other runtime wiring is not shown, so those links are omitted.
Main entry points: app.js App controller · analyzer.js Behavioral analyzer · detector.js Scoring engine · threat-intel.js Threat intelligence
Components 12
Input & Workflow
- App controller
js/app.js - Validation & utilities
js/utils.js
Detection Analysis
- Behavioral analyzer
js/analyzer.js - Scoring engine
js/detector.js
Intel & Learning
- Threat intelligence
js/threat-intel.js - ML detector
js/ml-detector.js
Results & History
- Results UI
js/ui.js - Report generator
js/report-generator.js - Analysis history
js/history-manager.js
Other components
- Security analyst
- ThreatFox API
- Browser local storage
Connections 14
- Security analyst → App controller: submits traffic
README.md - App controller → Validation & utilities: validates JSON
js/app.js - App controller → Behavioral analyzer: coordinates analysis
README.md - Behavioral analyzer → Validation & utilities: uses statistics
js/analyzer.js - Behavioral analyzer → Scoring engine: provides features
README.md - Scoring engine → Threat intelligence: looks up IPs
js/detector.js - App controller → Threat intelligence: initializes
js/app.js - Threat intelligence → ThreatFox API: queries IOCs
js/threat-intel.js - App controller → ML detector: initializes
js/app.js - Scoring engine → ML detector: combines predictions
- App controller → Analysis history: initializes history
js/app.js - Analysis history → Browser local storage: reads and writes
js/history-manager.js - App controller → Results UI: coordinates rendering
README.md - App controller → Report generator: coordinates export