GitHub Advisoryadvisory · npm
GHSA-9q9j-q6p8-xq58 fastify vulnerable to header validation bypass via incomplete schema case normalization
HIGH
Official page ↗
- Aliases
- CVE-2026-84428
- Ecosystem
- npm
- Packages
- fastify
- Severity
- High
- CVSS vector
- CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:H/A:N
- Weaknesses
- CWE-178
- Reviewed
- 2026-09-30
Affected packages
• npm fastify: < 5.12.2 → fixed in 5.12.2
Description
Impact
Fastify lowercases header-schema property names before compiling the schema, because Node.js stores request header names in lowercase. That normalization was incomplete: it lowercased only top-level `properties` keys and the root `required` array, and did not lowercase the JSON Schema Draft 7 `dependencies` keyword (its trigger keys and dependent property names) or names in nested subschemas. As a result, a header schema that uses `dependencies` to require one header when another is present (for example `X-Admin` requiring `X-Admin-Token`) never matches the lowercased request headers, so the dependency assertion is silently skipped. An unauthenticated remote client can send the header that activates a privileged path while omitting the header the dependency was meant to require, bypassing a schema-enforced security control. The header schema is idiomatic, valid JSON Schema Draft 7, and no custom validator, malformed request, or misconfiguration is required.
Patches
Header-schema names are now normalized across all schema positions (`properties`, `required`, `dependencies`, `dependentRequired`, `dependentSchemas`, and nested subschemas). Patched in fastify `5.12.2`. The fix is also included in the `6.0.0` release. Header schemas referenced through an external shared `$ref` (registered with `addSchema`) are not reached by this normalization and now emit an `FSTSEC002` startup warning; inline the header schema to keep case-insensitive assertions in effect.
Workarounds
If upgrading is not immediately possible, write header-schema names in lowercase so the `dependencies` and other case-sensitive assertions match Node's lowercased request headers, or enforce the cross-header requirement in an `onRequest` or `preValidation` hook instead of the schema.
Related
Alias · CVE (1)
- CVE-2026-84428 fastify versions before 5.12.2 implement the case-insensitive nature of HTTP header names by lowercasing names in a route's header schema… vulnerability
Weakness · CWE (1)
- CWE-178 Improper Handling of Case Sensitivity weakness
References
- https://github.com/fastify/fastify/security/advisories/GHSA-9q9j-q6p8-xq58 web
- https://nvd.nist.gov/vuln/detail/CVE-2026-84428 advisory
- https://github.com/fastify/fastify/commit/179619c8e99d54924309b9933402151ef9af37e0 web
- https://cna.openjsf.org/security-advisories.html web
- https://github.com/fastify/fastify package
- https://github.com/fastify/fastify/releases/tag/v5.12.2 web