If you discover a security vulnerability in this project, please report it responsibly:
- Email: Create a private security advisory on GitHub
- Response Time: We aim to respond within 72 hours
- Description of the vulnerability
- Steps to reproduce (proof of concept if possible)
- Impact assessment (what could an attacker do?)
- Affected versions
- Suggested fix (optional)
- Acknowledgment within 72 hours
- Initial assessment within 1 week
- Fix timeline communicated within 2 weeks
- Credit in CHANGELOG.md and release notes (unless you prefer anonymity)
In scope:
- API authentication bypass
- Remote code execution
- Buffer overflows in packet parsing
- PSK key exposure beyond intended functionality
- Denial of service against the device
Out of scope:
- Physical access attacks (device already requires physical access)
- Social engineering
- RF jamming (hardware limitation)
- Vulnerabilities in third-party libraries (report upstream)
This tool is designed for authorized security research on networks you own or have permission to test. See docs/reference/THREAT_MODEL.md for detailed security assumptions.
- Receive-only by default — Active transmission requires explicit user action
- Local network only — No cloud connectivity, no telemetry
- Token authentication — Protected endpoints require
X-API-Tokenheader - Minimal attack surface — No shell access, no remote code execution
- WiFi AP password is device-unique but printed at boot (physical access = full access)
- API token is generated at boot and displayed on serial (physical access = full access)
- No encryption on local WiFi traffic (use HTTPS proxy if needed)
- CORS allows all origins — Acceptable for local-only tool
- Change default WiFi credentials via web UI Settings
- Note your API token from serial output or
tcommand - Use AP mode (192.168.4.1) for isolated operation