Skip to content

Security: fastify/fast-uri

SECURITY.md

Security Policy

This document describes the management of vulnerabilities for fast-uri, an official Fastify project package. It supplements the Fastify project's organization-wide security policy.

Standards and scope

fast-uri implements URI parsing and normalization according to RFC 3986. It does not implement the WHATWG URL Standard.

Differences between fast-uri and WHATWG URL implementations are expected. Reports based solely on comparing or mixing parsers that follow these different standards are out of scope. Applications must use the same parsing and normalization rules for both security decisions and subsequent URI use.

Reports are assessed based on reproducibility, documented supported usage, and concrete security impact—not merely on whether they mention WHATWG URL behavior. Reports demonstrating a parsing or normalization flaw in a supported scheme remain eligible for evaluation.

Threat model

fast-uri's threat model extends the Node.js threat model.

Trusted: Application code, parser options, configuration, and the runtime environment.

Untrusted: URI and IRI strings passed to the package's public APIs.

Examples of vulnerabilities

  • RFC 3986 parsing or normalization flaws that bypass security controls
  • Denial of service through malformed input
  • Inconsistent parsing or normalization between fast-uri APIs

Examples of non-vulnerabilities

The following are not considered vulnerabilities in fast-uri:

  • Different URL standards: Differences between RFC 3986 behavior and WHATWG URL behavior, including differences exposed by mixing parsers that implement those standards
  • Unsupported scheme semantics: Scheme-specific behavior for schemes that fast-uri does not document as supported
  • Application code vulnerabilities: Security flaws in code that consumes fast-uri output
  • Configuration mistakes: Security issues caused by incorrect parser options or application configuration
  • Missing security features: Application-level protections that are not part of URI parsing or normalization
  • Third-party dependencies: Vulnerabilities in packages used by an application alongside fast-uri

Reporting vulnerabilities

Individuals who find potential vulnerabilities in fast-uri are invited to complete a vulnerability report via the GitHub Security page.

Do not assign or request a CVE directly. CVE assignment is handled by the Fastify Security Team. Fastify falls under the OpenJS CNA. A CVE will be assigned as part of our responsible disclosure process.

Note

Fastify's HackerOne program is now closed.

Strict measures when reporting vulnerabilities

It is of the utmost importance that you read carefully and follow these guidelines to ensure the ecosystem as a whole is not disrupted due to improperly reported vulnerabilities:

  • Avoid creating new "informative" reports. Only create a new report if you are confident the issue is an actual vulnerability. Third-party vendors and individuals track new GitHub security reports and may flag them for their customers.
  • Security reports should never be created and triaged by the same person. A second Security Team member must triage a report submitted by a team member or on their behalf. If in doubt, invite more Fastify collaborators to help review the report.
  • Do not attempt to demonstrate CI/CD vulnerabilities by creating pull requests in Fastify organization repositories. Doing so will result in a content report to GitHub as an unsolicited exploit. Create a separate repository configured like the affected repository and provide the proof of concept there instead.

Vulnerabilities found outside this process

The Fastify project does not support vulnerability reporting outside the process described in this document.

Handling vulnerability reports

When a potential vulnerability is reported, the following actions are taken.

Triage

Delay: 4 business days

Within 4 business days, a member of the Security Team provides a first response to the reporter. The possible responses are:

  • Acceptance: The report is considered a new vulnerability.
  • Rejection: The report is not considered a new vulnerability.
  • Need more information: The Security Team needs more information to evaluate the report.

Triaging should include updating these issue fields:

  • Asset: set or create the module affected by the report
  • Severity: TBD, initially left empty

Correction follow-up

Delay: 90 days

When a vulnerability is confirmed, a member of the Security Team volunteers to follow up on the report.

With the reporter's help, they contact the maintainers of the vulnerable package and may invite them as participants in the report. Together, they define a publication date. Ideally, publication should not happen before the package has been patched.

The report's vulnerable-version upper limit should be set to:

  • * if no fixed version is available when the report is published
  • the last vulnerable version, such as <=1.2.3, if the fix is released in 1.2.4

Publication

Delay: 90 days

Within 90 days after triage, the vulnerability must be made public.

Vulnerability severity is assessed using CVSS v3.

If package maintainers are actively developing a patch, the Security Team and the reporter may approve an additional delay.

Secondary contact

If you do not receive an acknowledgment within 6 business days, or cannot find a private security contact, contact the OpenJS Foundation CNA at https://cna.openjsf.org/ or security@lists.openjsf.org for assistance.

The CNA can help ensure that reports are acknowledged, coordinate disclosure timelines, and assign CVEs when necessary.

The Fastify Security Team

The core team manages the security program, policy, and process.

Team members must keep all privileged information private. This includes the existence of undisclosed issues, expected release dates, and upcoming patches.

Members

Learn more about advisories related to fastify/fast-uri in the GitHub Advisory Database