Skip to content

docs: point security policy at GitHub private vulnerability reporting#442

Merged
jankapunkt merged 1 commit into
node-oauth:masterfrom
dhensby:docs/security-policy
Jun 16, 2026
Merged

docs: point security policy at GitHub private vulnerability reporting#442
jankapunkt merged 1 commit into
node-oauth:masterfrom
dhensby:docs/security-policy

Conversation

@dhensby

@dhensby dhensby commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

What

Updates SECURITY.md to make GitHub private vulnerability reporting the primary channel for reporting vulnerabilities, replacing the personal-email-only route and removing leftover GitHub-template boilerplate.

Why

  • The old file still contained the GitHub template line ("Use this section to tell people about which versions of your project are currently being supported with security updates.").
  • It directed reporters to a single personal email (info@jankuester.com), which may be out of date. We'd prefer reporters use GitHub's private vulnerability reporting from now on — it's already enabled on this repo and is the flow we use in practice (e.g. GHSA-jhm7-29pj-4xvf / CVE-2026-41213).

Changes

  • Primary reporting channel → GitHub "Report a vulnerability" (Security tab / private advisory form); explicitly discourages public issues/PRs/discussions.
  • Adds: what to include in a report; what happens next (triage → reproduce → private fix → validation → release → disclosure & credit); and coordinated-disclosure expectations.
  • Preserves: the supported-versions table and the existing process commitments (reproduce before fix, private fix, prompt release, all fixes pass tests + audits, collaborate via private fork).
  • No code changes.

Links, the private-reporting flow, and the supported-versions table were all verified against the repo before opening.

🤖 Generated with Claude Code

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the repository security policy to make GitHub private vulnerability reporting the primary channel, removing outdated template boilerplate and expanding guidance around coordinated disclosure and the maintainer triage/release process.

Changes:

  • Replaces the personal-email-only reporting route with GitHub “Report a vulnerability” / Security Advisories flow and discourages public disclosure.
  • Adds structured guidance on what to include in reports and what reporters should expect during triage → fix → release → disclosure.
  • Clarifies support expectations for maintained vs. legacy release lines.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread SECURITY.md
Replace the leftover GitHub-template boilerplate and the personal-email-
only reporting channel with GitHub's private vulnerability reporting
("Report a vulnerability") as the primary, coordinated-disclosure route —
the flow the project already uses for advisories. Expands the policy with
what to include in a report, what happens next, and disclosure
expectations, while preserving the existing supported-versions table and
the reproduce-before-fix / private-fix / tests-and-audits commitments.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dhensby dhensby force-pushed the docs/security-policy branch from 11692e1 to ce902be Compare June 16, 2026 06:28

@jankapunkt jankapunkt left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is very useful indeed. We should also consider pointing issue templates and PR template to this document to avoid users disclosing zero-days via issues/PR to the public. However, we can do this in a separate PR

@jankapunkt jankapunkt merged commit fdb45e1 into node-oauth:master Jun 16, 2026
4 checks passed
@dhensby dhensby deleted the docs/security-policy branch June 16, 2026 07:39
@dhensby

dhensby commented Jun 16, 2026

Copy link
Copy Markdown
Contributor Author

I think the GitHub UI does automatically point users to it, but not certain

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants