Distribution affected by pull-through cache credential exfiltration via www-authenticate bearer realm
Published 6 Apr 2026 · Updated 10 Sept 2026
Is your project on an affected github.com/distribution/distribution/v3?
Look after several Go apps? Indie watches up to 15 repos, private ones too, for $5 a month. See Indie
Affected packages
- Affected
- <3.1.0
- Fixed in
- 3.1.0
go get github.com/distribution/distribution/v3@v3.1.0- Affected
- <=2.8.3
- Fixed in
- No fix released
Details
hi guys,
commit: 40594bd98e6d6ed993b5c6021c93fdf96d2e5851 (as-of 2026-01-31) contact: GitHub Security Advisory (https://github.com/distribution/distribution/security/advisories/new)
summary
in pull-through cache mode, distribution discovers token auth endpoints by parsing WWW-Authenticate challenges returned by the configured upstream registry. the realm URL from a bearer challenge is used without validating that it matches the upstream registry host. as a result, an attacker-controlled upstream (or an attacker with MitM position to the upstream) can cause distribution to send the configured upstream credentials via basic auth to an attacker-controlled realm URL.
this is the same vulnerability class as CVE-2020-15157 (containerd), but in distribution’s pull-through cache proxy auth flow.
severity
HIGH
note: the baseline impact is credential disclosure of the configured upstream credentials. if a deployment uses broader credentials for upstream auth (for example cloud iam credentials), the downstream impact can be higher; i am not claiming this as default for all deployments.
impact
credential exfiltration of the upstream authentication material configured for the pull-through cache.
attacker starting positions that make this realistic:
- supply chain / configuration: an operator configures a proxy cache to use an upstream that becomes attacker-controlled (compromised registry, stale domain, or a malicious mirror)
- network: MitM on the upstream connection in environments where the upstream is reachable over insecure transport or a compromised network path
affected components
registry/proxy/proxyauth.go:66-81(getAuthURLs): extracts bearerrealmfrom upstreamWWW-Authenticatewithout validating destinationinternal/client/auth/session.go:485-510(fetchToken): uses the realm URL directly for token fetchinternal/client/auth/session.go:429-434(fetchTokenWithBasicAuth): sends credentials via basic auth to the realm URL
reproduction
attachment: poc.zip (local harness) with canonical and control runs.
the harness is local and does not contact a real registry: it uses two local HTTP servers (upstream + attacker token service) to demonstrate whether basic auth is sent to an attacker-chosen realm.
unzip -q -o poc.zip -d poc cd poc make canonical make control
expected output (excerpt):
[CALLSITE_HIT]: getAuthURLs::configureAuth [PROOF_MARKER]: basic_auth_sent=true realm_host=127.0.0.1 account_param=user authorization_prefix=Basic
control output (excerpt):
[CALLSITE_HIT]: getAuthURLs::configureAuth [NC_MARKER]: realm_validation=PASS basic_auth_sent=false
suggested remediation
validate that the token realm destination is within the intended trust boundary before associating credentials with it or sending any authentication to it. one conservative option is strict same-host binding: only accept a realm whose host matches the configured upstream host.
fix accepted when
- distribution does not send configured upstream credentials to an attacker-chosen realm URL
- a regression test covers the canonical and blocked cases
addendum.md poc.zip PR_DESCRIPTION.md RUNNABLE_POC.md
best, oleh
Is GHSA-3p65-76g6-3w7r in any of your client repos?
Checking one package by hand is fine. Checking it across forty client projects is not. NPMscan reads the lockfiles in every GitHub repo you pick, finds each project with an affected github.com/distribution/distribution/v3, and gives you the command that fixes it.
More advisories for github.com/distribution/distribution/v3
- LowCVE-2026-85747Distribution: Client does not verify returned content against requested digest in github.com/distribution/distribution · 5 Nov 2026
- MediumCVE-2026-85747Distribution: Client `manifests.Get()` does not verify returned content against requested digest · 15 Oct 2026
- LowCVE-2026-35172Stale blob descriptor cache invalidation in github.com/distribution/distribution · 18 Aug 2026
- LowCVE-2026-41888Distribution's tag deletion bypasses `storage.delete.enabled` configuration in github.com/distribution/distribution · 25 Jun 2026
- MediumCVE-2026-41888Distribution's tag deletion bypasses `storage.delete.enabled` configuration · 4 May 2026
- HighCVE-2026-35172Distribution: stale blob access resurrection via repo-scoped redis descriptor cache invalidation · 6 Apr 2026
References
Advisory data from OSV.dev (opens OSV.dev in a new tab), refreshed daily.