Skip to content

chore: add SECURITY.md (private vulnerability reporting policy) - #129

Open
eddieran wants to merge 1 commit into
dromara:masterfrom
eddieran:chore/security-policy
Open

chore: add SECURITY.md (private vulnerability reporting policy)#129
eddieran wants to merge 1 commit into
dromara:masterfrom
eddieran:chore/security-policy

Conversation

@eddieran

@eddieran eddieran commented May 6, 2026

Copy link
Copy Markdown

Why

mayfly-go currently has no SECURITY.md. GitHub's Security and quality tab shows the "Suggest a security policy" prompt for exactly this case (https://github.com/dromara/mayfly-go/security/policy). This PR is that suggestion.

What

Adds a draft SECURITY.md at the repo root, modelled on the dromara org's other projects + the standard GitHub template.

The most important part is documenting a private reporting channel so security researchers can responsibly disclose findings without having to choose between staying silent and posting to a public issue. The draft points at GitHub's Private Vulnerability Reporting (PVR) feature as the preferred channel, with an email fallback that maintainers can fill in.

Suggested action by maintainers after merge:

  1. Enable PVR via Settings → Code security → Private vulnerability reporting → Enable. Free for public repos.
  2. Optionally edit the email fallback in SECURITY.md to point at the maintainer's preferred address.

Sections in the draft:

  • Reporting a vulnerability (PVR + email fallback)
  • What to include
  • Scope and supported versions (with explicit out-of-scope examples to reduce triage burden)
  • Process / SLA / hall-of-fame

Maintainers should feel free to edit any section — the important thing is that a private channel exists.

Why I'm sending this

I have a coordinated security disclosure ready for mayfly-go and would like to file via PVR once it's enabled. See companion issue #128 for context. As soon as this PR lands and PVR is on, I'll file the report through the structured channel — the finding has a concrete PoC and suggested patch, just waiting on the channel.

For broader context, this is part of a wider coordinated-disclosure campaign that has filed 20 GHSAs across 9 maintainer orgs over the past two weeks; all are in triage, none have been published or weaponized.

Thanks for considering!

mayfly-go currently has no security policy on file. GitHub's
"Suggest a security policy" workflow flags this and offers researchers
a friction-free way to send a draft PR.

This is that draft. It documents:

- The preferred private channel: GitHub Private Vulnerability Reporting
  (https://github.com/dromara/mayfly-go/security/advisories/new) once
  enabled in *Settings → Code security → Private vulnerability reporting*.
- A fallback email channel — placeholder for the maintainer to fill in.
- What a good report should include.
- Scope and supported versions.
- Triage / coordinated-disclosure expectations.

Maintainers should feel free to edit any section. The important thing
is that a private reporting channel exists so researchers can submit
findings responsibly without having to choose between "stay silent"
and "post to a public issue."

Refs dromara#128.
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.

1 participant