Maintainer Process
This page explains how coordinated disclosure works when the EEF CNA is involved, whether we reached out to you or you came to us with a report from a third party.
1. How You May Be Contacted
1.1 The CNA Contacts You
If we have received a vulnerability report concerning your project, we will reach out to you directly. You can expect a personal email from one of our Points of Contact, or an invitation to a GitHub Security Advisory on your repository.
Our initial message will include:
- A summary of the reported vulnerability
- The CVE ID we have reserved (or a note that we will assign one)
- A request to confirm your preferred coordination channel (GitHub Advisory or email)
1.2 You Contact the CNA
If you have received a vulnerability report from a third party and need a CVE number, please reach out to us via our Contact page. We will acknowledge your report within two business days and guide you through the rest of the process.
2. Preferred Channel: GitHub Private Vulnerability Reporting
We strongly recommend using GitHub Private Vulnerability Reporting for coordinating disclosure. It keeps all communication, patches, and timelines in one place, and makes it easy to collaborate privately.
3. Email Alternative
If your project is not hosted on GitHub, or you prefer email, you can coordinate everything through cna@erlef.org. Encrypted communication is also supported; see the Contact page for our GPG key and fingerprint.
4. The Disclosure Process
Once initial contact is established, the typical workflow is as follows:
Review the advisory or report. Confirm the issue is valid and assess its severity.
Agree on a publication date with the CNA. We appreciate a heads-up so we can be ready to publish the CVE promptly. You can use the GHSA comments to coordinate; comments remain private even after the advisory is published.
We encourage you to inform your users about the vulnerability and the fix through your community channels such as Slack, Discord, forums, or mailing lists. If the CVE has high severity or the package has wide adoption, the CNA may also publish its own announcements.
5. Timelines & Embargo
If information becomes public, our disclosure timeline immediately shifts to 24 hours or less, regardless of whether a patch is ready.
Key timeframes:
- Maximum embargo: 3 months from the date we first contact you.
- Non-response: If we do not receive a response within 14 days, we may proceed with publishing the CVE unilaterally.
- Active exploitation: If we become aware that the vulnerability is being actively exploited in the wild, we will publish within 24 hours, regardless of patch status.
- Coordination period: We aim to be as flexible as possible, but all timelines are bounded by our Security Policy.
Please remain reachable throughout the process. We will always try to give you a heads-up before we publish.
6. What Not to Do
The following actions break the embargo and can cause the CVE to be published immediately, even if no patch is available:
- Opening a public Pull Request that references or fixes the vulnerability
- Merging a security fix to
mainor any public branch before the advisory is published - Including the CVE ID or vulnerability details in a public commit message
- Discussing the issue in a public GitHub issue or discussion
- Announcing a “security release” before the advisory is ready
- Posting about the vulnerability on social media, a blog, or a mailing list
7. Feedback
Once you are through the process, we would love to hear your feedback on this document. If anything took extra time to figure out or required clarification, we want to know so we can make it clearer for future maintainers. You can reach us via the Contact page, or send a Pull Request directly to this file on GitHub.