1 <!--{ 2 "Title": "Go Security Policy", 3 "Path": "/security", 4 "Template": true 5 }--> 6 7 <h2>Implementation</h2> 8 9 <h3>Reporting a Security Bug</h3> 10 11 <p> 12 Please report to us any issues you find. 13 This document explains how to do that and what to expect in return. 14 </p> 15 16 <p> 17 All security bugs in the Go distribution should be reported by email to 18 <a href="mailto:security (a] golang.org">security (a] golang.org</a>. 19 This mail is delivered to a small security team. 20 Your email will be acknowledged within 24 hours, and you'll receive a more 21 detailed response to your email within 72 hours indicating the next steps in 22 handling your report. 23 If you would like, you can encrypt your report using our PGP key (listed below). 24 </p> 25 26 <p> 27 Please use a descriptive subject line for your report email. 28 After the initial reply to your report, the security team will endeavor to keep 29 you informed of the progress being made towards a fix and full announcement. 30 These updates will be sent at least every five days. 31 In reality, this is more likely to be every 24-48 hours. 32 </p> 33 34 <p> 35 If you have not received a reply to your email within 48 hours or you have not 36 heard from the security team for the past five days please contact the Go 37 security team directly: 38 </p> 39 40 <ul> 41 <li>Primary security coordinator: <a href="mailto:adg (a] golang.org">Andrew Gerrand</a> (<a href="https://drive.google.com/a/google.com/file/d/0B42ZAZN5yFufRldybEVNandRN2c/view">public key</a>).</li> 42 <li>Secondary coordinator: <a href="mailto:agl (a] golang.org">Adam Langley</a> (<a href="https://www.imperialviolet.org/key.asc">public key</a>).</li> 43 <li>If you receive no response, mail <a href="mailto:golang-dev (a] googlegroups.com">golang-dev (a] googlegroups.com</a> or use the <a href="https://groups.google.com/forum/#!forum/golang-dev">golang-dev web interface</a>.</li> 44 </ul> 45 46 <p> 47 Please note that golang-dev is a public discussion forum. 48 When escalating on this list, please do not disclose the details of the issue. 49 Simply state that you're trying to reach a member of the security team. 50 </p> 51 52 <h3>Flagging Existing Issues as Security-related</h3> 53 54 <p> 55 If you believe that an <a href="https://golang.org/issue">existing issue</a> 56 is security-related, we ask that you send an email to 57 <a href="mailto:security (a] golang.org">security (a] golang.org</a>. 58 The email should include the issue ID and a short description of why it should 59 be handled according to this security policy. 60 </p> 61 62 <h3>Disclosure Process</h3> 63 64 <p>The Go project uses the following disclosure process:</p> 65 66 <ol> 67 <li>Once the security report is received it is assigned a primary handler. 68 This person coordinates the fix and release process.</li> 69 <li>The issue is confirmed and a list of affected software is determined.</li> 70 <li>Code is audited to find any potential similar problems.</li> 71 <li>If it is determined, in consultation with the submitter, that a CVE-ID is 72 required, the primary handler obtains one via email to 73 <a href="http://oss-security.openwall.org/wiki/mailing-lists/distros">oss-distros</a>.</li> 74 <li>Fixes are prepared for the two most recent major releases and the head/master 75 revision. These fixes are not yet committed to the public repository.</li> 76 <li>A notification is sent to the 77 <a href="https://groups.google.com/group/golang-announce">golang-announce</a> 78 mailing list to give users time to prepare their systems for the update.</li> 79 <li>Three working days following this notification, the fixes are applied to 80 the <a href="https://go.googlesource.com/go">public repository</a> and a new 81 Go release is issued.</li> 82 <li>On the date that the fixes are applied, announcements are sent to 83 <a href="https://groups.google.com/group/golang-announce">golang-announce</a>, 84 <a href="https://groups.google.com/group/golang-dev">golang-dev</a>, and 85 <a href="https://groups.google.com/group/golang-nuts">golang-nuts</a>. 86 </ol> 87 88 <p> 89 This process can take some time, especially when coordination is required with 90 maintainers of other projects. Every effort will be made to handle the bug in 91 as timely a manner as possible, however it's important that we follow the 92 process described above to ensure that disclosures are handled consistently. 93 </p> 94 95 <p> 96 For security issues that include the assignment of a CVE-ID, 97 the issue is listed publicly under the 98 <a href="https://www.cvedetails.com/vulnerability-list/vendor_id-14185/Golang.html">"Golang" product on the CVEDetails website</a> 99 as well as the 100 <a href="https://web.nvd.nist.gov/view/vuln/search">National Vulnerability Disclosure site</a>. 101 </p> 102 103 <h3>Receiving Security Updates</h3> 104 105 <p> 106 The best way to receive security announcements is to subscribe to the 107 <a href="https://groups.google.com/forum/#!forum/golang-announce">golang-announce</a> 108 mailing list. Any messages pertaining to a security issue will be prefixed 109 with <code>[security]</code>. 110 </p> 111 112 <h3>Comments on This Policy</h3> 113 114 <p> 115 If you have any suggestions to improve this policy, please send an email to 116 <a href="mailto:golang-dev (a] golang.org">golang-dev (a] golang.org</a> for discussion. 117 </p> 118 119 <h3>PGP Key for <a href="mailto:security (a] golang.org">security (a] golang.org</a></h3> 120 121 <pre> 122 -----BEGIN PGP PUBLIC KEY BLOCK----- 123 Comment: GPGTools - https://gpgtools.org 124 125 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 171 UDrmjf9pr7o00hC7lCHFzw== 172 =WE0r 173 -----END PGP PUBLIC KEY BLOCK----- 174 </pre> 175