fa0dd46ab7
Before this change, Authorize() method was just returning an error, regardless of whether the user is unauthorized or whether there is some other unrelated error. Returning boolean with information about user authorization and error (which should be unrelated to the authorization) separately will make it easier to debug. Fixes #27974
141 lines
4.0 KiB
Go
141 lines
4.0 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 {
|
|
// GetUser returns the user.Info object to authorize
|
|
GetUser() user.Info
|
|
|
|
// 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) (authorized bool, reason string, err error)
|
|
}
|
|
|
|
type AuthorizerFunc func(a Attributes) (bool, string, error)
|
|
|
|
func (f AuthorizerFunc) Authorize(a Attributes) (bool, string, 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) GetUser() user.Info {
|
|
return a.User
|
|
}
|
|
|
|
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
|
|
}
|