# 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](https://github.com/fastify/.github/blob/main/SECURITY.md). ## Standards and scope `fast-uri` implements URI parsing and normalization according to [RFC 3986](https://www.rfc-editor.org/rfc/rfc3986). It does not implement the [WHATWG URL Standard](https://url.spec.whatwg.org/). 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](https://github.com/nodejs/node/blob/main/SECURITY.md#the-nodejs-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][advisory]. Do not assign or request a CVE directly. CVE assignment is handled by the Fastify Security Team. Fastify falls under the [OpenJS CNA](https://cna.openjsf.org/). A CVE will be assigned as part of our responsible disclosure process. > [!NOTE] > Fastify's [HackerOne](https://hackerone.com/fastify) program is now closed. [advisory]: ../../security/advisories/new ### 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][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. [content-report]: https://docs.github.com/en/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam#reporting-an-issue-or-pull-request ### 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](https://www.first.org/cvss/user-guide). 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 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 - [Matteo Collina](https://github.com/mcollina) - [Tomas Della Vedova](https://github.com/delvedor) - [Vincent Le Goff](https://github.com/zekth) - [KaKa Ng](https://github.com/climba03003) - [James Sumners](https://github.com/jsumners)