Summary
zot’s dist-spec authorization middleware infers the required action for PUT /v2/{name}/manifests/{reference} as create by default, and only switches to update when the tag already exists and reference != "latest".
as a result, when latest already exists, a user who is allowed to create (but not allowed to update) can still pass the authorization check for an overwrite attempt of latest.
affected component
- file:
pkg/api/authz.go(DistSpecAuthzHandler) - condition:
slices.Contains(tags, reference) && reference != "latest"(line 352 at the pinned commit)
severity
HIGH
category: CWE-863 (incorrect authorization)
note: impact depends on how a deployment uses latest (for example, if latest is treated as a protected or “push-once” tag), and on how access control is provisioned (users with create but without update). the attached poc demonstrates a real overwrite of latest (tag digest changes) under a create-only policy.
steps to reproduce
- configure access control so user
attackerhascreatebut notupdateon a repository. - ensure the repository has an existing tag named
latest. - attempt to push a new manifest to
/v2/acme/app/manifests/latest(example repository name). - observe that the authorization check is evaluated as
create(notupdate) forlatest, so the request passes authorization even though the tag already exists.
the attached poc demonstrates this deterministically with canonical.log and control.log markers.
expected vs actual
- expected: overwriting an existing tag should require
updatepermission, includinglatest(orlatestshould be explicitly documented as exempt). - actual: when
reference=="latest"and the tag exists, the middleware keeps the action ascreateinstead of switching toupdate.
security impact
this can break least-privilege expectations in deployments that rely on the create vs update split to prevent tag overwrites (for example, “push-once” policies). if latest is used as a high-trust tag in ci/cd, this can create supply-chain risk because a create-only principal can overwrite an existing latest tag while other existing tags correctly require update.
notes / rationale
- oci distribution spec does not define a standard authorization model; this report is about zot’s own create vs update semantics and the observable behavior in
DistSpecAuthzHandler. - zot documentation describes immutable tags as being enforceable via authorization policies (create-only “push once”, update disallowed). if
latestis exempt, this control does not apply tolatestunless documented otherwise.
Impact
The application does not correctly enforce access controls, allowing a principal to access resources or operations beyond their granted permissions. Typical impact: unauthorized data access or execution of privileged operations.
CVE-2026-31801 has a CVSS score of 7.7 (High). The vector is network-reachable, low privileges required, and no user interaction. A CVSS score reflects the worst-case severity of the vulnerability, not your specific exposure. Whether this affects your application depends on whether the vulnerable code is present and reachable in your environment. A fixed version is available (2.1.15); upgrading removes the vulnerable code path.
Affected versions
Security releases
Kodem intelligence
Severity tells you how bad this could be in the worst case. It does not tell you whether you are exposed. Exploitability and impact are functions of runtime truth: whether the vulnerable code is present, reachable, and actually executes in your application. A vulnerable package can sit in your dependency tree and never run.
Kodem, an Intelligent Application Security platform, uses runtime intelligence to reveal which vulnerabilities actually execute in production, so teams prioritize the ones that genuinely matter. Kodem's runtime-powered SCA identifies whether this CVE is reachable in your applications.
Remediation advice
remove the special-case exemption for latest when determining whether an existing tag requires update permission (treat latest the same as other tags), or document and enforce an explicit policy rule for latest.
Frequently Asked Questions
- What is CVE-2026-31801? CVE-2026-31801 is a high-severity incorrect authorization vulnerability in zotregistry.dev/zot/v2 (go), affecting versions < 2.1.15. It is fixed in 2.1.15. The application does not correctly enforce access controls, allowing a principal to access resources or operations beyond their granted permissions.
- How severe is CVE-2026-31801? CVE-2026-31801 has a CVSS score of 7.7 (High). This score reflects the worst-case severity of the vulnerability, not your specific exposure. Whether it represents real risk in your environment depends on whether the vulnerable code is present and reachable.
- Which packages are affected by CVE-2026-31801?
zotregistry.dev/zot/v2(go) (versions < 2.1.15)zotregistry.dev/zot(go) (versions >= 1.3.0-20210831063041-c8779d9e87d9, <= 1.4.4-20251014054906-73eef25681af)
- Is there a fix for CVE-2026-31801? Yes. CVE-2026-31801 is fixed in 2.1.15. Upgrade to this version or later.
- Is CVE-2026-31801 exploitable, and should I be worried? Whether CVE-2026-31801 is exploitable in your environment depends on whether the vulnerable code is present and reachable. A CVSS score is a worst-case rating; it does not account for your specific deployment, configuration, or usage patterns. Kodem, an Intelligent Application Security platform, uses runtime intelligence to show which vulnerabilities actually execute in production, so you can focus on the ones that represent real risk. Get a demo
- What actually determines whether CVE-2026-31801 is exploitable, and how bad it is? Exploitability and impact are not fixed properties of a CVE. They depend on runtime truth: whether the vulnerable code is present, reachable, and actually executes in your application. A high CVSS score on a dependency that never runs is not the same as real risk. Kodem, an Intelligent Application Security platform, uses runtime intelligence to reveal which vulnerabilities actually execute in production, so teams prioritize the ones that genuinely matter.
- How do I fix CVE-2026-31801? Upgrade
zotregistry.dev/zot/v2to 2.1.15 or later.