Summary
Quarkus: Authentication/Authorization Bypass via Advanced Path Normalization Vulnerabilities
Quarkus HTTP path-based authorization policies can be bypassed using encoded semicolons (%3B) to smuggle matrix
parameters past the security layer, and using encoded slashes (%2F) or backslashes (%5C) to access protected static
resources. This is a distinct issue from CVE-2026-39852, which addressed only literal semicolon stripping.
Technical Details
The security layer (AbstractPathMatchingHttpSecurityPolicy) normalizes request paths using Vert.x's normalizedPath(),
which only decodes unreserved RFC 3986 characters (letters, digits, -, ., _, ~). It then strips matrix parameters by
looking for literal ; characters. This creates two mismatches:
- Encoded semicolons (
%3B): Since%3Bis not decoded by normalizedPath(), the matrix parameter stripping in
pathWithoutMatrixParams() never sees it. The encoded semicolon and everything after it become part of the path
segment, causing policy matching to fail. This affects all path-policy-protected endpoints. - Static resource path mismatch: Static resource handlers (StaticHandlerImpl, FileSystemStaticHandler) perform full
percent-decoding via URIDecoder.decodeURIComponent() and backslash-to-slash conversion before filesystem resolution.
Reserved characters like%2F(slash) and%5C(backslash) that survive the security layer's partial decoding are fully
decoded before file serving.
REST endpoints using Quarkus REST (RESTEasy Reactive) are not affected by the %2F/%5C vectors because the routing layer also uses normalizedPath(), both security and routing agree on the path, so no mismatch exists.
Attack Vectors
Encoded semicolon (matrix parameter smuggling), affects all path-policy-protected endpoints:
/api/admin%3Bbypass=true/data: security sees this as a single segmentadmin%3Bbypass=true, which does not match the
/api/admin/* policy. The request passes through unauthenticated./api/secret%3b/data: same mechanism with lowercase hex digit.
Encoded slash/backslash on static resources, affects static files behind path policies:
/static-secret%2Fhtml, security does not match /static-secret.html policy; static handler decodes%2Fto/and may
resolve the file./static-secret%5Chtml. static handler decodes%5Cto\, then converts to/.
Double encoding, affects static resources:
/secret%252Fconfidential.html, first decode by normalizedPath() turns%25into%, producing%2F. Static handler's
second decode turns%2Finto/.
The following vectors were investigated and confirmed not exploitable:
- Unreserved character encoding (
/api/adm%69n/data):normalizedPath()decodes these. Both security and routing see
/api/admin/data. - Null byte injection (
/api/admin%00/data):%00is not decoded bynormalizedPath(). - Encoded dot segments (
/api/%2e%2e/secret/data): Period is unreserved, so%2eis decoded to.bynormalizedPath(),
thenremoveDots()normalizes..segments. - REST endpoint bypass via
%2F/%5C: Routing uses the samenormalizedPath()as security. The encoded slash/backslash
doesn't match any route.
Root Cause
pathWithoutMatrixParams() operates on the partially-decoded output of normalizedPath(), where reserved characters
remain encoded. It searches for literal ; but never sees %3B. The fix (normalizePath()) performs full percent-decoding
in a loop before stripping matrix parameters, removing null bytes, normalizing backslashes, and resolving dot
segments, aligning the security layer's view of the path with what downstream handlers resolve.
Proof of Concept
# Encoded semicolon bypass, works on any path-policy-protected endpoint
# Security sees "/api/admin%3Bbypass=true/data", doesn't match /api/admin/* policy
curl -v http://target/api/admin%3Bbypass=true/data
# Encoded semicolon on authenticated endpoint
curl -v http://target/api/secret%3b/data
# Static resource bypass via encoded slash (if static file behind path policy)
curl -v http://target/static-secret%2Fhtml
# Static resource bypass via encoded backslash
curl -v http://target/static-secret%5Chtml
Impact
- Unauthenticated access to endpoints protected by
quarkus.http.auth.permissionpath-based policies via%3Bsmuggling- Static resource exposure by bypassing path policies on protected files via
%2F/%5C - Applications using annotation-based security (
@RolesAllowed,@Authenticated) on JAX-RS resources without path-based
policies are not affected by the%2F/%5Cvectors, but may still be affected by%3Bif path policies coexist
- Static resource exposure by bypassing path policies on protected files via
The application does not adequately verify the identity of a user, device, or process before granting access. Typical impact: unauthorized access to functions or data reserved for authenticated parties.
CVE-2026-50559 has a CVSS score of 7.5 (High). The vector is network-reachable, no 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 (3.20.6.2, 3.27.4.1, 3.33.2.1, 3.36.3, 3.37.0); 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.
Already deployed Kodem?
See it in your environmentNew to Kodem? Get a demo →Remediation advice
io.quarkus:quarkus-vertx-http to 3.20.6.2 or later; io.quarkus:quarkus-vertx-http to 3.27.4.1 or later; io.quarkus:quarkus-vertx-http to 3.33.2.1 or later; io.quarkus:quarkus-vertx-http to 3.36.3 or later; io.quarkus:quarkus-vertx-http to 3.37.0 or later
Kodem Kai can prioritize this vulnerability in your dependency tree and generate a fix recommendation.
Frequently Asked Questions
- What is CVE-2026-50559? CVE-2026-50559 is a high-severity improper authentication vulnerability in io.quarkus:quarkus-vertx-http (maven), affecting versions < 3.20.6.2. It is fixed in 3.20.6.2, 3.27.4.1, 3.33.2.1, 3.36.3, 3.37.0. The application does not adequately verify the identity of a user, device, or process before granting access.
- How severe is CVE-2026-50559? CVE-2026-50559 has a CVSS score of 7.5 (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 versions of io.quarkus:quarkus-vertx-http are affected by CVE-2026-50559? io.quarkus:quarkus-vertx-http (maven) versions < 3.20.6.2 is affected.
- Is there a fix for CVE-2026-50559? Yes. CVE-2026-50559 is fixed in 3.20.6.2, 3.27.4.1, 3.33.2.1, 3.36.3, 3.37.0. Upgrade to this version or later.
- Is CVE-2026-50559 exploitable, and should I be worried? Whether CVE-2026-50559 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-50559 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-50559?
- Upgrade
io.quarkus:quarkus-vertx-httpto 3.20.6.2 or later - Upgrade
io.quarkus:quarkus-vertx-httpto 3.27.4.1 or later - Upgrade
io.quarkus:quarkus-vertx-httpto 3.33.2.1 or later - Upgrade
io.quarkus:quarkus-vertx-httpto 3.36.3 or later - Upgrade
io.quarkus:quarkus-vertx-httpto 3.37.0 or later
- Upgrade