mirror of https://github.com/k3s-io/k3s
151 lines
4.3 KiB
Go
151 lines
4.3 KiB
Go
/*
|
|
Copyright 2014 The Kubernetes Authors.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
package authorizer
|
|
|
|
import (
|
|
"net/http"
|
|
|
|
"k8s.io/kubernetes/pkg/auth/user"
|
|
)
|
|
|
|
// Attributes is an interface used by an Authorizer to get information about a request
|
|
// that is used to make an authorization decision.
|
|
type Attributes interface {
|
|
// The user string which the request was authenticated as, or empty if
|
|
// no authentication occurred and the request was allowed to proceed.
|
|
GetUserName() string
|
|
|
|
// The list of group names the authenticated user is a member of. Can be
|
|
// empty if the authenticated user is not in any groups, or if no
|
|
// authentication occurred.
|
|
GetGroups() []string
|
|
|
|
// GetVerb returns the kube verb associated with API requests (this includes get, list, watch, create, update, patch, delete, and proxy),
|
|
// or the lowercased HTTP verb associated with non-API requests (this includes get, put, post, patch, and delete)
|
|
GetVerb() string
|
|
|
|
// When IsReadOnly() == true, the request has no side effects, other than
|
|
// caching, logging, and other incidentals.
|
|
IsReadOnly() bool
|
|
|
|
// The namespace of the object, if a request is for a REST object.
|
|
GetNamespace() string
|
|
|
|
// The kind of object, if a request is for a REST object.
|
|
GetResource() string
|
|
|
|
// GetSubresource returns the subresource being requested, if present
|
|
GetSubresource() string
|
|
|
|
// GetName returns the name of the object as parsed off the request. This will not be present for all request types, but
|
|
// will be present for: get, update, delete
|
|
GetName() string
|
|
|
|
// The group of the resource, if a request is for a REST object.
|
|
GetAPIGroup() string
|
|
|
|
// GetAPIVersion returns the version of the group requested, if a request is for a REST object.
|
|
GetAPIVersion() string
|
|
|
|
// IsResourceRequest returns true for requests to API resources, like /api/v1/nodes,
|
|
// and false for non-resource endpoints like /api, /healthz, and /swaggerapi
|
|
IsResourceRequest() bool
|
|
|
|
// GetPath returns the path of the request
|
|
GetPath() string
|
|
}
|
|
|
|
// Authorizer makes an authorization decision based on information gained by making
|
|
// zero or more calls to methods of the Attributes interface. It returns nil when an action is
|
|
// authorized, otherwise it returns an error.
|
|
type Authorizer interface {
|
|
Authorize(a Attributes) (err error)
|
|
}
|
|
|
|
type AuthorizerFunc func(a Attributes) error
|
|
|
|
func (f AuthorizerFunc) Authorize(a Attributes) error {
|
|
return f(a)
|
|
}
|
|
|
|
// RequestAttributesGetter provides a function that extracts Attributes from an http.Request
|
|
type RequestAttributesGetter interface {
|
|
GetRequestAttributes(user.Info, *http.Request) Attributes
|
|
}
|
|
|
|
// AttributesRecord implements Attributes interface.
|
|
type AttributesRecord struct {
|
|
User user.Info
|
|
Verb string
|
|
Namespace string
|
|
APIGroup string
|
|
APIVersion string
|
|
Resource string
|
|
Subresource string
|
|
Name string
|
|
ResourceRequest bool
|
|
Path string
|
|
}
|
|
|
|
func (a AttributesRecord) GetUserName() string {
|
|
return a.User.GetName()
|
|
}
|
|
|
|
func (a AttributesRecord) GetGroups() []string {
|
|
return a.User.GetGroups()
|
|
}
|
|
|
|
func (a AttributesRecord) GetVerb() string {
|
|
return a.Verb
|
|
}
|
|
|
|
func (a AttributesRecord) IsReadOnly() bool {
|
|
return a.Verb == "get" || a.Verb == "list" || a.Verb == "watch"
|
|
}
|
|
|
|
func (a AttributesRecord) GetNamespace() string {
|
|
return a.Namespace
|
|
}
|
|
|
|
func (a AttributesRecord) GetResource() string {
|
|
return a.Resource
|
|
}
|
|
|
|
func (a AttributesRecord) GetSubresource() string {
|
|
return a.Subresource
|
|
}
|
|
|
|
func (a AttributesRecord) GetName() string {
|
|
return a.Name
|
|
}
|
|
|
|
func (a AttributesRecord) GetAPIGroup() string {
|
|
return a.APIGroup
|
|
}
|
|
|
|
func (a AttributesRecord) GetAPIVersion() string {
|
|
return a.APIVersion
|
|
}
|
|
|
|
func (a AttributesRecord) IsResourceRequest() bool {
|
|
return a.ResourceRequest
|
|
}
|
|
|
|
func (a AttributesRecord) GetPath() string {
|
|
return a.Path
|
|
}
|