Skip to content

docs: switch security reporting to GitHub private vulnerability reporting#23559

Open
Vad1mo wants to merge 2 commits into
goharbor:mainfrom
Vad1mo:docs/github-private-vulnerability-reporting
Open

docs: switch security reporting to GitHub private vulnerability reporting#23559
Vad1mo wants to merge 2 commits into
goharbor:mainfrom
Vad1mo:docs/github-private-vulnerability-reporting

Conversation

@Vad1mo

@Vad1mo Vad1mo commented Jul 14, 2026

Copy link
Copy Markdown
Member

Implements the intake-channel change from goharbor/community#292: replace the cncf-harbor-security@lists.cncf.io mailing list with GitHub private vulnerability reporting as the channel for reporting security vulnerabilities. Private vulnerability reporting is already enabled on this repository.

Changes

  • SECURITY.md
    • Reporters are directed to the Security tab / Report a vulnerability form instead of the mailing list.
    • The Patch, Release, and Disclosure section now describes the advisory workflow: accepted reports become draft advisories with the reporter as collaborator, CVSS is scored with the built-in calculator, the CVE is requested in-band from GitHub, and the fix is developed in a temporary private fork under embargo.
    • The mailing list is kept only as a fallback for reporters without a GitHub account and for distributor list membership requests.
    • Distributor coordination (cncf-harbor-distributors-announce), the embargo policy, and disclosure timing are unchanged, per the proposal's non-goals.
  • .github/ISSUE_TEMPLATE/config.yml (new): contact link on the issue chooser routing vulnerability reports to the private advisory form.
  • .github/ISSUE_TEMPLATE/bug_report.md: warning at the top telling reporters not to file security vulnerabilities as public issues.

Related

@Vad1mo
Vad1mo requested a review from a team as a code owner July 14, 2026 14:15
@codecov

codecov Bot commented Jul 14, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 66.38%. Comparing base (c9e825a) to head (a88d675).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main   #23559      +/-   ##
==========================================
+ Coverage   66.36%   66.38%   +0.01%     
==========================================
  Files        1073     1073              
  Lines      117716   117716              
  Branches     2965     2965              
==========================================
+ Hits        78120    78142      +22     
+ Misses      35292    35273      -19     
+ Partials     4304     4301       -3     
Flag Coverage Δ
unittests 66.38% <ø> (+0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 7 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@wy65701436 wy65701436 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.

lgtm

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 Harbor’s security disclosure documentation and GitHub issue intake to route vulnerability reports through GitHub Private Vulnerability Reporting, aligning the repo’s public guidance with the advisory-based workflow.

Changes:

  • Updates SECURITY.md to direct reporters to GitHub private vulnerability reporting and describe the advisory-driven embargo workflow.
  • Adds an issue chooser contact_links entry to route security reports away from public issues.
  • Adds a prominent warning to the bug report template to prevent public filing of vulnerabilities.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
SECURITY.md Switches primary reporting channel to GitHub private vulnerability reporting and updates the disclosure workflow narrative.
.github/ISSUE_TEMPLATE/config.yml Adds an issue chooser contact link for private vulnerability reporting.
.github/ISSUE_TEMPLATE/bug_report.md Adds a top-of-template warning to redirect security reports to the private advisory form.

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

Comment thread SECURITY.md Outdated
**IMPORTANT: Do not file public issues on GitHub for security vulnerabilities**

To report a vulnerability or a security-related issue, please email the private address cncf-harbor-security@lists.cncf.io with the details of the vulnerability. The email will be fielded by the Harbor Security Team, which is made up of Harbor maintainers who have committer and release permissions. Emails will be addressed within 3 business days, including a detailed plan to investigate the issue and any potential workarounds to perform in the meantime. Do not report non-security-impacting bugs through this channel. Use [GitHub issues](https://github.com/goharbor/harbor/issues/new/choose) instead.
To report a vulnerability or a security-related issue, use [GitHub private vulnerability reporting](https://github.com/goharbor/harbor/security/advisories/new): open the [Security tab](https://github.com/goharbor/harbor/security) of the affected repository and click **Report a vulnerability**. The report is only visible to the Harbor Security Team, which is made up of Harbor maintainers who have committer and release permissions. Reports will be addressed within 3 business days, including a detailed plan to investigate the issue and any potential workarounds to perform in the meantime. Do not report non-security-impacting bugs through this channel. Use [GitHub issues](https://github.com/goharbor/harbor/issues/new/choose) instead.
Comment thread SECURITY.md
Comment on lines 49 to 50
## Mailing lists
- Use cncf-harbor-security@lists.cncf.io to report security concerns to the Harbor Security Team, who uses the list to privately discuss security issues and fixes prior to disclosure.
- Join cncf-harbor-distributors-announce@lists.cncf.io for early private information and vulnerability disclosure. Early disclosure may include mitigating steps and additional information on security patch releases. See below for information on how Harbor distributors or vendors can apply to join this list.
Comment thread .github/ISSUE_TEMPLATE/bug_report.md Outdated

**⚠️ If this is a security vulnerability, do NOT file a public issue.** Report it privately via [GitHub private vulnerability reporting](https://github.com/goharbor/harbor/security/advisories/new). See [SECURITY.md](https://github.com/goharbor/harbor/blob/main/SECURITY.md) for the full disclosure policy.

If you are reporting a problem, please make sure the following information are provided:
Vad1mo added 2 commits July 22, 2026 15:32
…ting

Replace the cncf-harbor-security mailing list with GitHub private
vulnerability reporting as the intake channel for security reports,
per goharbor/community#292. Private vulnerability reporting is enabled
on the repository.

- SECURITY.md: point reporters at the Security tab / Report a
  vulnerability form; describe the advisory-based triage, CVSS,
  in-band CVE request, and temporary private fork workflow; keep the
  mailing list only as a fallback for reporters without a GitHub
  account and for distributor list membership requests
- Add issue template contact link routing vulnerability reports to
  the private advisory form
- Add a security warning to the bug report template

Signed-off-by: Vadim Bauer <vb@container-registry.com>
Address review feedback: drop the mailing-list fallback so there is a
single reporting method, clarify that the reporter can see their own
report, and fix template grammar.

Signed-off-by: Vadim Bauer <vb@container-registry.com>
Copilot AI review requested due to automatic review settings July 22, 2026 07:32
@stonezdj
stonezdj force-pushed the docs/github-private-vulnerability-reporting branch from 1c233be to a88d675 Compare July 22, 2026 07:32
@stonezdj
stonezdj enabled auto-merge (squash) July 22, 2026 07:32

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

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (1)

SECURITY.md:14

  • The PR says the mailing list remains a fallback for reporters without a GitHub account, but this section only states that an account is required and gives those reporters no reporting path. Please document the promised fallback here so accountless reporters are not blocked from private disclosure.
To report a vulnerability or a security-related issue, use [GitHub private vulnerability reporting](https://github.com/goharbor/harbor/security/advisories/new): open the [Security tab](https://github.com/goharbor/harbor/security) of the affected repository and click **Report a vulnerability**. The report is visible only to you and the Harbor Security Team, which is made up of Harbor maintainers who have committer and release permissions. Reports will be addressed within 3 business days, including a detailed plan to investigate the issue and any potential workarounds to perform in the meantime. Do not report non-security-impacting bugs through this channel. Use [GitHub issues](https://github.com/goharbor/harbor/issues/new/choose) instead. Note that filing a report requires a GitHub account.

Comment thread SECURITY.md
**IMPORTANT: Do not file public issues on GitHub for security vulnerabilities**

To report a vulnerability or a security-related issue, please email the private address cncf-harbor-security@lists.cncf.io with the details of the vulnerability. The email will be fielded by the Harbor Security Team, which is made up of Harbor maintainers who have committer and release permissions. Emails will be addressed within 3 business days, including a detailed plan to investigate the issue and any potential workarounds to perform in the meantime. Do not report non-security-impacting bugs through this channel. Use [GitHub issues](https://github.com/goharbor/harbor/issues/new/choose) instead.
To report a vulnerability or a security-related issue, use [GitHub private vulnerability reporting](https://github.com/goharbor/harbor/security/advisories/new): open the [Security tab](https://github.com/goharbor/harbor/security) of the affected repository and click **Report a vulnerability**. The report is visible only to you and the Harbor Security Team, which is made up of Harbor maintainers who have committer and release permissions. Reports will be addressed within 3 business days, including a detailed plan to investigate the issue and any potential workarounds to perform in the meantime. Do not report non-security-impacting bugs through this channel. Use [GitHub issues](https://github.com/goharbor/harbor/issues/new/choose) instead. Note that filing a report requires a GitHub account.
Comment thread SECURITY.md
6. The Security Team will work on fixing the vulnerability and perform internal testing before preparing to roll out the fix.
7. The Security Team will provide early disclosure of the vulnerability by emailing the cncf-harbor-distributors-announce@lists.cncf.io mailing list. Distributors can initially plan for the vulnerability patch ahead of the fix, and later can test the fix and provide feedback to the Harbor team. See the section **Early Disclosure to Harbor Distributors List** for details about how to join this mailing list.
4. If a vulnerability is acknowledged, the Security Team will accept the report as a draft security advisory, and the reporter is added as a collaborator on it. The Security Team will then work on a plan to communicate with the appropriate community, including identifying mitigating steps that affected users can take to protect themselves until the fix is rolled out.
5. The Security Team will also assess the severity of the vulnerability with a [CVSS](https://www.first.org/cvss/specification-document) score, using the calculator built into the draft advisory. The Security Team makes the final call on the calculated CVSS; it is better to move quickly than making the CVSS perfect. A CVE will be requested from GitHub through the draft advisory; the CVE remains private until the advisory is published.
@stonezdj
stonezdj disabled auto-merge July 22, 2026 07:36
Comment thread SECURITY.md
**IMPORTANT: Do not file public issues on GitHub for security vulnerabilities**

To report a vulnerability or a security-related issue, please email the private address cncf-harbor-security@lists.cncf.io with the details of the vulnerability. The email will be fielded by the Harbor Security Team, which is made up of Harbor maintainers who have committer and release permissions. Emails will be addressed within 3 business days, including a detailed plan to investigate the issue and any potential workarounds to perform in the meantime. Do not report non-security-impacting bugs through this channel. Use [GitHub issues](https://github.com/goharbor/harbor/issues/new/choose) instead.
To report a vulnerability or a security-related issue, use [GitHub private vulnerability reporting](https://github.com/goharbor/harbor/security/advisories/new): open the [Security tab](https://github.com/goharbor/harbor/security) of the affected repository and click **Report a vulnerability**. The report is visible only to you and the Harbor Security Team, which is made up of Harbor maintainers who have committer and release permissions. Reports will be addressed within 3 business days, including a detailed plan to investigate the issue and any potential workarounds to perform in the meantime. Do not report non-security-impacting bugs through this channel. Use [GitHub issues](https://github.com/goharbor/harbor/issues/new/choose) instead. Note that filing a report requires a GitHub account.

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.

Reports will be addressed within 3 business days, including a detailed plan to investigate the issue and any potential workarounds to perform in the meantime.

Because of LLM is widedly used, there maybe more security issues than we can handled in 3 business days. it is better to changed to

Reports will be acknowledged in 3 business days. the Harbor Security Team need to investigate the issue and make follow-up decision in 2 weeks.

@wy65701436 wy65701436 added the release-note/docs Docs changes(made and needed) label Jul 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release-note/docs Docs changes(made and needed)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants