How towss-sec/oceanwind-fingerprint-alarm works
OceanWind observes browser fingerprinting attempts through a local mitmproxy addon, reports them to a Flask backend, and presents per-site scores and detection logs in a browser dashboard. The backend attributes iframe detections to the top-level site, stores alerts in memory, and delegates scoring to computation.py. The README documents the detection and dashboard workflow; source excerpts show the API and process wiring. Dashboard HTML and CSS are included as served assets, but their contents were not sampled.
Main entry points: server.py Flask API · dashboard.js Dashboard logic · proxy.py API hooks · start.py Process launcher
Components 11
Traffic observation
- Detector addon
proxy.py - API hooks
proxy.py
Detection backend
- Flask API
server.py - Alert state
server.py - Danger scoring
computation.py
Live dashboard
- Dashboard page
WebUI/dashboard.html - Dashboard logic
WebUI/dashboard.js - Dashboard styling
WebUI/dashboard.css
Runtime launch
- Process launcher
start.py
Other components
- User browser
- mitmproxy
Connections 17
- User browser → mitmproxy: proxies traffic
README.md - mitmproxy → Detector addon: loads addon
- Detector addon → API hooks: injects script
proxy.py - API hooks → Flask API: reports visits
proxy.py - API hooks → Flask API: reports detections
proxy.py - Flask API → Alert state: records alerts
server.py - Flask API → Danger scoring: computes score
server.py - Flask API → Dashboard page: serves page
server.py - Flask API → Dashboard logic: serves script
server.py - Flask API → Dashboard styling: serves stylesheet
server.py - User browser → Dashboard page: opens dashboard
README.md - Dashboard logic → Flask API: polls alerts
WebUI/dashboard.js - Dashboard logic → Flask API: fetches score
WebUI/dashboard.js - Dashboard logic → Flask API: requests background
WebUI/dashboard.js - Dashboard logic → Flask API: deletes alert
WebUI/dashboard.js - Process launcher → Flask API: starts backend
start.py - Process launcher → mitmproxy: starts proxy
start.py