Skip to content
Merged
Changes from 2 commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
1461f86
docs: add document to handle security reports
UlisesGascon Mar 5, 2025
c30511c
docs: add Security Report Handling Flowchart
UlisesGascon Mar 5, 2025
1a9042a
docs: add roles
UlisesGascon Mar 7, 2025
7aac07b
docs: add runbook
UlisesGascon Mar 7, 2025
03d7b60
Update docs/handle_security_reports.md
UlisesGascon Mar 8, 2025
dba71a6
Update docs/handle_security_reports.md
UlisesGascon Mar 8, 2025
99b4102
Update docs/handle_security_reports.md
UlisesGascon Mar 8, 2025
054ab8a
fix: format issues
UlisesGascon Mar 8, 2025
707c04d
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
eec7b04
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
de83da8
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
e88d94d
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
ee83fa1
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
799e888
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
315b02c
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
183adc6
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
014a4b1
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
fbc2d2c
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
fa6bf1b
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
6bb6700
Update docs/handle_security_reports.md
UlisesGascon Apr 2, 2025
0241b7c
Update docs/handle_security_reports.md
UlisesGascon Apr 22, 2025
2544711
Update docs/handle_security_reports.md
UlisesGascon Apr 22, 2025
38b6532
Update docs/handle_security_reports.md
UlisesGascon Apr 22, 2025
8c09fbb
Update docs/handle_security_reports.md
UlisesGascon Apr 22, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions docs/handle_security_reports.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Security Report Handling Process
**Version:** 1.0
**Last Updated:** March 2025
**Maintainers:** Security Triage Team

## Introduction
Security is a top priority for the Express.js project. This document outlines the **formal process** for handling **security reports**, including how to **triage**, **assess**, and **disclose** vulnerabilities responsibly.

## Scope

The Security Triage Team will use this document as a process guide when a security vulnerability is reported, from triage to resolution. This process must align with the project's [SECURITY policy](https://github.com/expressjs/.github/blob/master/SECURITY.md) and cannot diverge significantly.


## Security Report Handling Flowchart
The following diagram details the **decision-making process** for handling security reports:

```mermaid
flowchart TD
A[Security Report Received] --> B[Assign Security Report Coordinator]
B --> E{Premature Disclosure?}

E -- No --> J[Proceed with Standard Private Process]
E -- Yes --> F[Privatize Disclosure]
F --> G[Handle Related PRs & Issues]
G --> H[Request GitHub to Remove Public PR/Issues]
H --> I[Create Public Placeholder Issue]
I --> J[Acknowledge within 5 days to the Reporter]
J --> K[Create Issue in Triage Repo for Visibility]

K --> L[Assess Report]
L --> M{Enough Information?}

M -- No --> N[Request Additional Info]
N --> L[Assess Report]

M -- Yes --> O{Valid Vulnerability?}
O -- No --> X[Close Report as Invalid]
X --> Y[Acknowledge within 10 days to the Reporter]

O -- Yes --> Q[Create Advisory]
Q --> Q1[Calculate CVSS Score]
Q1 --> Q2[Request a CVE]

Q2 --> R{Patch Required?}

R -- No --> Z[Public Disclosure]

R -- Yes --> T[Develop Patch]
T --> U[Test Solution]
U --> V[Add Regression Testing]
V --> W[Create a Security Release with CVE Included]
W --> Z[Public Disclosure]
Z --> Z1[Notify Community]
Z1 --> Z2[Official Blog Post]
Z1 --> Z3[Social Media Announcements]
```