Reporting a bug

All security bugs in rails should be reported by email to security@rubyonrails.org. This list is delivered to a subset of the core team who handle security issues. Your email will be acknowledged within 24 hours, and you’ll receive a more detailed response to your email within 48 hours indicating the next steps in handling your report.

This email address receives a large amount of spam, so be sure to use a descriptive subject line to avoid having your email getting lost in the spam and your report being missed. 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. As recommended by RFPolicy these updates will be sent at least every five days, in reality this is more likely to be every 24-48 hours.

If you have not received a reply to your email within 48 hours, or have not heard from the security team for the past five days there are a few steps you can take:

1. Contact the current security coordinator (Michael Koziarski) directly
2. Contact the back-up contact (Jeremy Kemper) directly.
3. Email the rails core list or ask in #rails-contrib

Please note, the rails core list and #rails-contrib are public areas. When escalating to that address please do not discuss your issue, simply say that you’re trying to get a hold of someone from the security team.

Disclosure Policy

Ruby on Rails has a 5 step disclosure policy.

1. Security report received and is assigned a primary handler. This person will coordinate the fix and release process.
2. Problem is confirmed and, a list of all affected versions is determined. Code is audited to find any potential similar problems.
3. Fixes are prepared for all releases which are still under maintenance (at present 2.2.x, 2.3.x, master). These fixes are not committed to the public repository but rather held locally pending the announcement.
4. A suggested embargo date for this vulnerability is chosen and vendor-sec is notified. This notification will include detailed instructions to reproduce, patches for all versions still under support and a contact address for packagers who need advice back-porting patches to older versions.
5. On the embargo date, the rails security mailing list is sent a copy of the announcement. The changes are pushed to the public repository and new gems released to rubyforge. At least 6 hours after the mailing list is notified, a copy of the advisory will be published on Riding Rails

Typically the embargo date will be set 72 hours from the time vendor-sec is first notified, 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

The best way to receive all the security announcements is to subscribe to the rails security mailing list. The mailing list is very low traffic, and it receives the public notifications the moment the embargo is lifted. If you produce packages of Ruby on Rails and require prior notification of vulnerabilities, you should be subscribed to vendor-sec.

No one outside the core team, the initial reporter or vendor-sec will be notified prior to the lifting of the embargo. We regret that we cannot make exceptions to this policy for high traffic or important sites, as any disclosure beyond the minimum required to coordinate a fix could cause an early leak of the vulnerability.

Comments on this Policy

If you have any suggestions to improve this policy, please send an email to security@rubyonrails.org.