Reporting a Security Bug
- If you think you have found a security issue in an OPA project, please send an
email to open-policy-agent-security.
This list is delivered to a small security team. We will then acknowledge receipt
of your report and prioritize initial analysis of severity.
- After the initial reply to your report, the security team will endeavor to keep you informed
of the progress being made towards a fix and full announcement, and may ask for additional
information or guidance surrounding the reported issue.
- If you have not received a reply to your report within two days, please reach out on our
by posting a message in the
- Note that the
#contributors channel is public, so please don't discuss details of your
issue there. Instead, simply say that you're trying to get a hold of someone from the security team.
- The security report is received and is assigned a primary handler.
This person will coordinate the fix and release process.
The problem is confirmed and a list of all affected versions is determined.
Code is audited to find any potential similar problems.
Fixes are prepared for all releases which are still under maintenance.
These fixes are not committed to the public repository but rather held locally or in a private fork pending the announcement.
- A suggested embargo date for this vulnerability is chosen and a CVE
(Common Vulnerabilities and Exposures (CVE®)) is requested for the vulnerability,
through the GitHub Advisory database.
- A prenotification may be published on the security announcements channels listed below,
providing information about affected projects, severity, and the embargo date.
- On the embargo date, the announcement is published.
The changes are pushed to the public repository and new builds are deployed.
- Typically the embargo date will be set 72 hours from the time the CVE is issued.
However, this may vary depending on the severity of the bug or difficulty in applying a fix.
- This process can take some time, especially when coordination is required with maintainers of
other projects. Every effort will be made to handle the bug in as timely a manner as possible;
however, it’s important that we follow the release process above to ensure that the disclosure
is handled in a consistent manner.
Receiving Security Updates