Security policy

How to report a vulnerability privately and what to expect next.

TL;DR

Found a vulnerability? Report it privately at github.com/DerotLuna/vpn-kongtrol/security/advisories/new — do not open a public issue. I will try to answer as soon as possible and coordinate disclosure with you.

Version 1.1.0 ·

1

How to report

Use GitHub private vulnerability reporting: github.com/DerotLuna/vpn-kongtrol/security/advisories/new. Only the maintainer can see it. Do not post details in issues, discussions or social media until a fix is out.

If you can, include:

  • Kongtrol version (kongtrol version) and operating system.
  • Which component: CLI, background service, tray app, web dashboard, privileged helper or this website.
  • Steps to reproduce and the impact (for example, traffic leaking outside the tunnel).
  • Never include real passwords, your full kongtrol.yaml or the ~/.kongtrol/api-token token; use test data.
2

What is in scope

In scope: the code in this repository and the binaries of the latest release.

  • Traffic or DNS leaks that the kill switch, DNS guard or rules should prevent.
  • Privilege escalation through the system helper or the background service.
  • Access to the local dashboard or its API without the token, or from another machine.
  • Credentials exposed outside the operating system credential store.
  • Undetected tampering with the audit log.
  • Vulnerabilities in kongtrol.app (for example, XSS).

Out of scope: VPN providers' own clients and services, attacks that already require administrator control of the machine, volumetric denial of service, social engineering, and missing headers with no demonstrable impact.

3

What to expect

I will try to answer as soon as possible; this is a non-profit project maintained by one person, so there are no guaranteed timelines.

  • I will confirm receipt and, later, whether the issue is confirmed and how severe it is.
  • The fix and its release are coordinated with you; details are published once the fix is available.
  • Credit in the security advisory, if you want it.
4

Supported versions

Kongtrol is in beta: only the latest release on GitHub Releases gets security fixes. Update before reporting if you can.

5

Good-faith research

If you research in good faith, on your own machines, without accessing other people's data and following this policy, I will not take action against you and will work with you to understand and fix the issue.

Report: github.com/DerotLuna/vpn-kongtrol/security/advisories/new (GitHub private vulnerability reporting). Also published at /.well-known/security.txt.