Clauster: Non-loopback deployments can serve the dashboard unauthenticated when auth.enabled is unsetGHSA-h4g2-xfmw-q2c9
GHSA-h4g2-xfmw-q2c9 is a remote code execution vulnerability in clauster. A fix is available for clauster — see the affected versions and patch details below.
Real-World Exposure
clausterReal-time download stats are indexed for npm and PyPI packages. This vulnerability affects PyPI packages — download data is not available via public APIs for these ecosystems.
Description
Summary
A Clauster instance bound to a non-loopback address (e.g. 0.0.0.0 or a LAN IP) can serve the entire dashboard and its API without any authentication — even when the operator has configured a password — if auth.enabled is left at its default (false). The operator believes the instance is password-protected; in reality every request is served unauthenticated.
Impact
An unauthenticated attacker with network access to the instance gains full control of the dashboard: list projects, spawn/stop claude remote-control bridges in any project directory, edit CLAUDE.md, read bridge logs, and (where configured) clone repositories. Because bridges run Claude Code against the host's project directories, this is effectively remote code execution in those projects.
Loopback (127.0.0.1) deployments need no auth by design and are not affected.
Affected configurations
All released versions (≤ 0.2.1) where all of the following hold:
hostis a non-loopback address, andauth.password_required: trueand/orauth.reverse_proxy.enabled: trueis set, andauth.enabledis left at its defaultfalse.
Docker deployments are affected: the image binds 0.0.0.0, and the previously-documented docker run command did not set auth.enabled.
Root cause
Two layers checked different flags:
- The runtime auth guard enforces authentication only when
config.auth.enabledis true; when false it passes every request through unauthenticated. - The config validator, for a non-loopback bind, required only one of
auth.password_required/auth.reverse_proxy.enabled/auth.allow_unauthenticated_network— notauth.enabled. So a config with a password butenabled=falsevalidated, started, and enforced nothing.
Proof of concept
With host: 0.0.0.0, auth.password_required: true, a valid auth.password_hash, and auth.enabled unset:
curl http://<host>:7621/api/instances
returns 200 with the full instance list and no credentials. Setting auth.enabled: true returns 401.
Patches
An upcoming patch release makes the config validator fail closed: a non-loopback bind is refused unless authentication is actually enforced — auth.enabled: true together with auth.password_required (+ a hash) or auth.reverse_proxy.enabled, or the explicit auth.allow_unauthenticated_network opt-out. The README, clauster.yml.example, and Docker docs were corrected to match.
Workaround
On any non-loopback deployment, set auth.enabled: true in clauster.yml (or CLAUSTER_AUTH_ENABLED=true) alongside your existing auth.password_required + hash (or reverse-proxy) settings. Alternatively, bind to loopback only and reach it via an SSH tunnel or a trusted authenticating reverse proxy.
Credit
Found during an internal security review.
Affected Packages
| Ecosystem | Package | Vulnerable range | Fix |
|---|---|---|---|
| 🐍PyPI | clauster | all versions | 0.2.2pip install --upgrade 'clauster==0.2.2' |
Detection & mitigation playbook
Open-source dependencyDetect
Scan your dependency tree (package-lock.json, pnpm-lock.yaml, requirements.txt, go.sum, etc.) for clauster, including transitive dependencies — a direct dependency you never call can still pull in a vulnerable version.
Fix
Update clauster to 0.2.2 or later, then make sure no transitive (indirect) dependency still pins the vulnerable range — O3 confirms GHSA-h4g2-xfmw-q2c9 is resolved across your whole dependency graph.
Workarounds
If you can't upgrade right away: gate or disable the affected feature, validate untrusted input at the boundary, and avoid passing attacker-controlled data into the vulnerable path. O3's runtime protection blocks exploitation in production as an interim safeguard until the upgrade lands.
Frequently Asked Questions
Is GHSA-h4g2-xfmw-q2c9 in your dependencies?
Find it across PyPI, including transitive dependencies.