Ekho is in the 0.x line and receives security fixes on the latest minor release only. Once 1.0 ships the previous minor will continue to receive critical fixes for six months.
| Version | Supported |
|---|---|
| 0.1.x | Yes |
| < 0.1 | No |
Do not open a public GitHub issue for security reports. Public disclosure before a patch is available puts every Ekho deployment at risk.
Report privately using one of these channels, in order of preference:
- GitHub Security Advisories — https://github.com/Drakon-Systems-Ltd/ekho/security/advisories/new (preferred; encrypted by GitHub, gives us an audit trail)
- Email — security@drakonsystems.com (PGP key available on request)
Please include:
- A description of the vulnerability and its impact
- Steps to reproduce, or a proof-of-concept
- The affected Ekho version(s) / commit SHAs
- Any suggested mitigations
We acknowledge reports within 48 hours and aim to ship a fix within 14 days for high-severity issues.
In scope:
- The relay server (
packages/relay) - The agent SDK (
packages/sdk) and its signing protocol - The operator console web app
- The license verification code path
- A2A protocol endpoints
Out of scope:
- Bugs in dependencies — please report upstream. We will bump affected versions once upstream ships a fix.
- Denial of service achievable only with operator credentials (the operator is trusted)
- Social engineering of Drakon Systems staff or users
- Physical access to a relay host
If you run Ekho in production, these defaults keep the blast radius small:
- Set
EKHO_OPERATOR_SESSION_SECRETto a random 32+ byte value — the default string literally sayschange-me - Terminate TLS at a reverse proxy (Caddy, nginx, Traefik) — the relay itself speaks plain HTTP
- Keep the relay behind a private network (Tailscale, WireGuard, VPC). Ekho is designed for mesh networks, not the open internet
- Rotate agent secrets by revoking and re-enrolling on any suspected compromise
- Pin the Docker image to a specific SHA, not
latest - Review
EKHO_RATE_LIMIT_MAX_MESSAGESandEKHO_HEARTBEAT_TIMEOUT_SECONDSfor your workload — too lax = abuse window; too strict = false quarantines - Monitor the dead-letter table and rate-limit violation history — sustained growth is almost always a signal of abuse or misconfiguration
Once a patch is available we will:
- Publish a GitHub Security Advisory with CVE (if applicable)
- Tag a patched release and note the fix in
CHANGELOG.md - Credit the reporter (unless anonymity is requested)
- Hold public details for 7 days after release to give operators time to upgrade
Thanks for helping keep Ekho and its users safe.