Security Process: Add Distributors List Process

Signed-off-by: Jess Frazelle <acidburn@microsoft.com>
This commit is contained in:
Jess Frazelle 2017-10-05 13:53:50 -04:00
parent 608f3412d8
commit 9fc2a7b5c5
No known key found for this signature in database
GPG Key ID: 18F3685C0022BFF3
1 changed files with 124 additions and 2 deletions

View File

@ -76,8 +76,7 @@ The communication to users should be actionable. They should know when to block
**Optional Fix Disclosure to Private Distributors List** (Completed within 1-14 days of Disclosure):
- The Fix Lead will make a determination with the help of the Fix Team if an issue is critical enough to require early disclosure to distributors. Generally this Private Distributor Disclosure process should be reserved for remotely exploitable or privilege escalation issues. Otherwise, this process can be skipped.
- The Fix Lead will email the patches to kubernetes-distributors-announce@googlegroups.com so distributors can prepare builds to be available to users on the day of the issue's announcement. Distributors can ask to be added to this list by emailing kubernetes-security@googlegroups.com and it is up to the Product Security Team's discretion to manage the list.
- TODO: Figure out process for getting folks onto this list.
- The Fix Lead will email the patches to kubernetes-distributors-announce@googlegroups.com so distributors can prepare builds to be available to users on the day of the issue's announcement. Distributors should read about the [Private Distributors List](#private-distributors-list) to find out the requirements for being added to this list.
- **What if a vendor breaks embargo?** The PST will assess the damage. The Fix Lead will make the call to release earlier or continue with the plan. When in doubt push forward and go public ASAP.
**Fix Release Day** (Completed within 1-21 days of Disclosure)
@ -98,6 +97,129 @@ These steps should be completed 1-3 days after the Release Date. The retrospecti
- The Fix Lead will send a retrospective of the process to kubernetes-dev@googlegroups.com including details on everyone involved, the timeline of the process, links to relevant PRs that introduced the issue, if relevant, and any critiques of the response and release process.
- The Release Managers and Fix Team are also encouraged to send their own feedback on the process to kubernetes-dev@googlegroups.com. Honest critique is the only way we are going to get good at this as a community.
## Private Distributors List
This list is intended to be used primarily to provide actionable information to
multiple distribution vendors at once. This list is not intended for
individuals to find out about security issues.
### Embargo Policy
The information members receive on kubernetes-distributors-announce must not be
made public, shared, nor even hinted at anywhere beyond the need-to-know within
your specific team except with the list's explicit approval. This holds
true until the public disclosure date/time that was agreed upon by the list.
Members of the list and others may not use the information for anything other
than getting the issue fixed for your respective distribution's users.
Before any information from the list is shared with respective members of your
team required to fix said issue, they must agree to the same terms and only
find out information on a need-to-know basis.
In the unfortunate event you share the information beyond what is allowed by
this policy, you _must_ urgently inform the kubernetes-security@googlegroups.com
mailing list of exactly what information
leaked and to whom. A retrospective will take place after the leak so
we can assess how to not make the same mistake in the future.
If you continue to leak information and break the policy outlined here, you
will be removed from the list.
### Contributing Back
This is a team effort. As a member of the list you must carry some water. This
could be in the form of the following:
**Technical**
- Review and/or test the proposed patches and point out potential issues with
them (such as incomplete fixes for the originally reported issues, additional
issues you might notice, and newly introduced bugs), and inform the list of the
work done even if no issues were encountered.
**Administrative**
- Help draft emails to the public disclosure mailing list.
- Help with release notes.
### Membership Criteria
To be eligible for the kubernetes-distributors-announce mailing list, your
distribution should:
1. Be an actively maintained distribution of kubernetes components.
2. Have a user base not limited to your own organization.
3. Have a publicly verifiable track record up to present day of fixing security
issues.
4. Not be a downstream or rebuild of another distribution.
5. Be a participant and active contributor in the community.
6. Accept the [Embargo Policy](#embargo-policy) that is outlined above.
7. Be willing to [contribute back](#contributing-back) as outlined above.
8. Be willing and able to handle PGP-encrypted email.
9. Have someone already on the list vouch for the person requesting membership
on behalf of your distribution.
### Requesting to Join
New membership requests are sent to kubernetes-security@googlegroups.com.
In the body of your request please specify how you qualify and fulfill each
criterion listed in [Membership Criteria](#membership-criteria).
Here is a psuedo example:
```
To: kubernetes-security@googlegroups.com
Subject: Seven-Corp Membership to kubernetes-distributors-announce
Below are each criterion and why I think we, Seven-Corp, qualify.
> 1. Be an actively maintained distribution of kubernetes components.
We distribute the "Seven" distribution of kubernetes [link]. We have been doing
this since 1999 before containers were even cool.
> 2. Have a user base not limited to your own organization.
Our user base spans of the extensive "Seven" community. We have a slack and
GitHub repos and mailing lists where the community hangs out. [links]
> 3. Have a publicly verifiable track record up to present day of fixing security
issues.
We announce on our blog all upstream patches we apply to "Seven." [link to blog
posts]
> 4. Not be a downstream or rebuild of another distribution.
This does not apply, "Seven" is a unique snowflake distribution.
> 5. Be a participant and active contributor in the community.
Our members, Acidburn, Cereal, and ZeroCool are outstanding members and are well
known throughout the kubernetes community. Especially for their contributions
in hacking the Gibson.
> 6. Accept the Embargo Policy that is outlined above.
We accept.
> 7. Be willing to contribute back as outlined above.
We are definitely willing to help!
> 8. Be willing and able to handle PGP-encrypted email.
Yes.
> 9. Have someone already on the list vouch for the person requesting membership
on behalf of your distribution.
CrashOverride will vouch for Acidburn joining the list on behalf of the "Seven"
distribution.
```
<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/devel/security-release-process.md?pixel)]()
<!-- END MUNGE: GENERATED_ANALYTICS -->