Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

sig-auth charter (v2) #2431

Merged
merged 3 commits into from
Jul 30, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions sig-auth/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ To understand how this file is generated, see https://git.k8s.io/community/gener

Covers improvements to Kubernetes authorization, authentication, and cluster security policy.

The [charter](charter.md) defines the scope and governance of the Auth Special Interest Group.

## Meetings
* Regular SIG Meeting: [Wednesdays at 11:00 PT (Pacific Time)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit) (biweekly). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=11:00&tz=PT%20%28Pacific%20Time%29).
* [Meeting notes and Agenda](https://docs.google.com/document/d/1woLGRoONE3EBVx-wTb4pvp4CI7tmLZ6lS26VTbosLKM/edit#).
Expand Down
69 changes: 69 additions & 0 deletions sig-auth/charter.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
# SIG Auth Charter

This charter adheres to the conventions described in the [Kubernetes Charter README] and uses
the Roles and Organization Management outlined in [sig-governance].

## Scope

SIG Auth is responsible for the design, implementation, and maintenance of features in
Kubernetes that control and protect access to the API and other core components. This includes
authentication and authorization, but also encompasses features like auditing and some security
policy (see below).

### In scope

Link to SIG section in [sigs.yaml]

#### Code, Binaries and Services

- Kubernetes authentication, authorization, audit and security policy features. Examples
include:
- Authentication, authorization and audit interfaces and extension points
- Authentication implementations (service accounts, OIDC, authenticating proxy, webhook,
...)
- Authorizer implementations (RBAC + default policy, Node + default policy, webhook, ...)
- Security-related admission plugins (NodeRestriction, ServiceAccount, PodSecurityPolicy,
ImagePolicy, etc)
- The mechanisms to protect confidentiality/integrity of API data. Examples include:
- Capability for encryption at rest
- Capability for secure communication between components
- Ensuring users and components can operate with appropriately scoped permissions

#### Cross-cutting and Externally Facing Processes

- Consult with other SIGs and the community on how to apply mechanisms owned by SIG
Auth. Examples include:
- Review privilege escalation implications of feature and API designs
- Core component authentication & authorization (apiserver, kubelet, controller-manager,
and scheduler)
- Local-storage volume deployment authentication
- Cloud provider authorization policy
- Container runtime streaming (exec/attach/port-forward) authentication
- Best practices for hardening add-ons or other external integrations

### Out of scope

- Reporting of specific vulnerabilities in Kubernetes. Please report using these instructions:
https://kubernetes.io/security/
- General security discussion. Examples of topics that are out of scope for SIG-auth include:
- Protection of volume data, container ephemeral data, and other non-API data (prefer: sig-storage
and sig-node)
- Container isolation (prefer: sig-node and sig-networking)
- Bug bounty (prefer: product security team)
- Resource quota (prefer: sig-scheduling)
- Resource availability / DOS protection (prefer: sig-apimachinery, sig-network, sig-node)

## Roles and Organization Management

This sig follows adheres to the Roles and Organization Management outlined in [sig-governance]
and opts-in to updates and modifications to [sig-governance].

### Subproject Creation
Copy link
Contributor

Choose a reason for hiding this comment

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

Can be done in a different PR, but there are no subprojects defined for SIG-auth defined in sigs.yaml. How are y'all thinking about breaking this down into smaller chunks?

Copy link
Member

Choose a reason for hiding this comment

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

Enumerating those is in progress in https://docs.google.com/document/d/1RJvnSPOJ3JC61gerCpCpaCtzQjRcsZ2tXkcyokr6sLY

A follow up to this PR would transfer those into sigs.yaml

Copy link
Member

Choose a reason for hiding this comment

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

opened #2505


SIG Auth delegates subproject approval to Technical Leads. See [Subproject creation - Option 1].


[sig-governance]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md
[sigs.yaml]: https://github.com/kubernetes/community/blob/master/sigs.yaml#L250
[Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md
[Subproject creation - Option 1]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md#subproject-creation
2 changes: 1 addition & 1 deletion sigs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -252,7 +252,7 @@ sigs:
mission_statement: >
Covers improvements to Kubernetes authorization, authentication, and
cluster security policy.
charter_link:
charter_link: charter.md
label: auth
leadership:
chairs:
Expand Down