Skip to content
This repository has been archived by the owner on Jul 11, 2023. It is now read-only.

Add security markdown #4121

Closed
wants to merge 3 commits into from
Closed

Add security markdown #4121

wants to merge 3 commits into from

Conversation

phillipgibson
Copy link
Contributor

Description: Add security markdown

Testing done: NA

Affected area:

Functional Area
New Functionality [ ]
CI System [ ]
CLI Tool [ ]
Certificate Management [ ]
Control Plane [ ]
Demo [ ]
Documentation [X]
Egress [ ]
Ingress [ ]
Install [ ]
Networking [ ]
Observability [ ]
Performance [ ]
SMI Policy [ ]
Security [ ]
Sidecar Injection [ ]
Tests [ ]
Upgrade [ ]
Other [ ]

Please answer the following questions with yes/no.

  1. Does this change contain code from or inspired by another project? N/A

    • Did you notify the maintainers and provide attribution?
  2. Is this a breaking change? No

nojnhuh and others added 2 commits September 15, 2021 17:43
chore(pkg/envoy): log pod metadata always

Signed-off-by: Phill Gibson <phillipgibson-github@outlook.com>
@phillipgibson phillipgibson requested a review from a team as a code owner September 15, 2021 22:36
Signed-off-by: Phill Gibson <phillipgibson-github@outlook.com>
Copy link
Member

@shashankram shashankram left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, just 1 comment. Also please remember to use the Squash and Merge option since you have merge commits in your PR.

SECURITY.md Show resolved Hide resolved
Copy link
Contributor

@michelleN michelleN left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @phillipgibson.

  • Since this doc is taken from the Helm project, could we add a line giving the Helm project attribution at the bottom of this doc?
  • We don't at this time have a dedicated security team that is a subset of the maintainers so we may want to make sure there is one
  • We don't at this time have guidance for the team on how to get CVE IDs. Do you know where we could get training for this from CNCF potentially? Is there a doc?


### When Not To Send A Report

* If a vulnerability has been found in an application managed by OSM. Instead, contact the application maintainers
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure "an application managed by OSM" is clear to me. Do we mean an application managed by an OSM control plane?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* If a vulnerability has been found in an application managed by OSM. Instead, contact the application maintainers
* If a vulnerability has been found in a user application binary that does not belong to OSM, contact the application maintainers instead.

@davinci26
Copy link

Some questions that I have:

  • Is there a breakoff point where a commit can be reverted? i.e. if a regression is introduced how many days do you have until you can revert the commit from main before you consider it a vulnerability?
  • Are security releases backported and then how back?
  • What about public zero day bugs for osm deps?

@@ -0,0 +1,76 @@
# OSM Security Process and Policy

This document provides the details on the OSM security policy and details the processes
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This document provides the details on the OSM security policy and details the processes
This document provides the details on the OSM security policy and processes

Comment on lines +18 to +22
Name | Key URL | Fingerprint
------------------ | ---------------------------------------------------- | -----------
TBD | TBD | TBD
TBD | TBD | TBD
TBD | TBD | TBD
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's fill this list.


### When Not To Send A Report

* If a vulnerability has been found in an application managed by OSM. Instead, contact the application maintainers
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* If a vulnerability has been found in an application managed by OSM. Instead, contact the application maintainers
* If a vulnerability has been found in a user application binary that does not belong to OSM, contact the application maintainers instead.


### Public Disclosure

A public disclosure of security vulnerabilities is released alongside release updates or details that fix the vulnerability. We try to fully disclose vulnerabilities once a mitigation strategy is available. Our goal is to perform a release and public disclosure quickly and in a timetable that works well for users. For example, a release may be ready on a Friday but for the sake of users may be delayed to a Monday.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't get the last part on why a security release could be delayed for users. Could you clarify how delaying a security patch helps?


New members are required to be active maintainers of OSM projects who are willing to perform the responsibilities outlined above. The security team is a subset of the maintainers. Members can step down at any time and may join at any time.

From time to time, OSM projects are deprecated. If at any time a security team member is found to be no longer be an active maintainer on active OSM projects, this individual will be removed from the security team.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What does OSM projects refer to here? We should clarify this because to be the security doc refers to the OSM project, so I am unsure why one would deprecate one or more OSM projects.

Suggested change
From time to time, OSM projects are deprecated. If at any time a security team member is found to be no longer be an active maintainer on active OSM projects, this individual will be removed from the security team.
From time to time, OSM projects may be deprecated. If at any time a security team member is found to be no longer be an active maintainer on active OSM projects, this individual will be removed from the security team.


## Patch and Release Team

When a vulnerability comes in and is acknowledged, a team - including maintainers of the OSM project affected - will assembled to patch the vulnerability, release an update, and publish the vulnerability disclosure. This may expand beyond the security team as needed but will stay within the pool of OSM project maintainers.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When a vulnerability comes in and is acknowledged, a team - including maintainers of the OSM project affected - will assembled to patch the vulnerability, release an update, and publish the vulnerability disclosure. This may expand beyond the security team as needed but will stay within the pool of OSM project maintainers.
When a vulnerability comes in and is acknowledged, a team - including maintainers of the OSM project affected - will assemble to patch the vulnerability, release an update, and publish the vulnerability disclosure. This may expand beyond the security team as needed but will stay within the pool of OSM project maintainers.

@github-actions github-actions bot added the stale label Jan 27, 2022
@github-actions
Copy link

github-actions bot commented Feb 3, 2022

PR closed due to inactivity.

@github-actions github-actions bot closed this Feb 3, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants