authorizer

package
v1.3.8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 28, 2016 License: Apache-2.0 Imports: 2 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Attributes

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
}

Attributes is an interface used by an Authorizer to get information about a request that is used to make an authorization decision.

type AttributesRecord

type AttributesRecord struct {
	User            user.Info
	Verb            string
	Namespace       string
	APIGroup        string
	APIVersion      string
	Resource        string
	Subresource     string
	Name            string
	ResourceRequest bool
	Path            string
}

AttributesRecord implements Attributes interface.

func (AttributesRecord) GetAPIGroup added in v1.2.0

func (a AttributesRecord) GetAPIGroup() string

func (AttributesRecord) GetAPIVersion added in v1.3.0

func (a AttributesRecord) GetAPIVersion() string

func (AttributesRecord) GetGroups added in v0.8.0

func (a AttributesRecord) GetGroups() []string

func (AttributesRecord) GetName added in v1.3.0

func (a AttributesRecord) GetName() string

func (AttributesRecord) GetNamespace

func (a AttributesRecord) GetNamespace() string

func (AttributesRecord) GetPath added in v1.2.0

func (a AttributesRecord) GetPath() string

func (AttributesRecord) GetResource added in v0.11.0

func (a AttributesRecord) GetResource() string

func (AttributesRecord) GetSubresource added in v1.3.0

func (a AttributesRecord) GetSubresource() string

func (AttributesRecord) GetUserName

func (a AttributesRecord) GetUserName() string

func (AttributesRecord) GetVerb added in v1.2.0

func (a AttributesRecord) GetVerb() string

func (AttributesRecord) IsReadOnly

func (a AttributesRecord) IsReadOnly() bool

func (AttributesRecord) IsResourceRequest added in v1.2.0

func (a AttributesRecord) IsResourceRequest() bool

type Authorizer

type Authorizer interface {
	Authorize(a Attributes) (err error)
}

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 AuthorizerFunc added in v0.18.0

type AuthorizerFunc func(a Attributes) error

func (AuthorizerFunc) Authorize added in v0.18.0

func (f AuthorizerFunc) Authorize(a Attributes) error

type RequestAttributesGetter added in v1.2.0

type RequestAttributesGetter interface {
	GetRequestAttributes(user.Info, *http.Request) Attributes
}

RequestAttributesGetter provides a function that extracts Attributes from an http.Request

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL