107 lines
4 KiB
Go
107 lines
4 KiB
Go
/*
|
|
Copyright 2017 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 v1
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
|
|
)
|
|
|
|
const (
|
|
// ImpersonateUserHeader is used to impersonate a particular user during an API server request
|
|
ImpersonateUserHeader = "Impersonate-User"
|
|
|
|
// ImpersonateGroupHeader is used to impersonate a particular group during an API server request.
|
|
// It can be repeated multiplied times for multiple groups.
|
|
ImpersonateGroupHeader = "Impersonate-Group"
|
|
|
|
// ImpersonateUserExtraHeaderPrefix is a prefix for any header used to impersonate an entry in the
|
|
// extra map[string][]string for user.Info. The key will be every after the prefix.
|
|
// It can be repeated multiplied times for multiple map keys and the same key can be repeated multiple
|
|
// times to have multiple elements in the slice under a single key
|
|
ImpersonateUserExtraHeaderPrefix = "Impersonate-Extra-"
|
|
)
|
|
|
|
// +genclient
|
|
// +genclient:nonNamespaced
|
|
// +genclient:noVerbs
|
|
// +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
|
|
|
|
// TokenReview attempts to authenticate a token to a known user.
|
|
// Note: TokenReview requests may be cached by the webhook token authenticator
|
|
// plugin in the kube-apiserver.
|
|
type TokenReview struct {
|
|
metav1.TypeMeta `json:",inline"`
|
|
// +optional
|
|
metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
|
|
|
|
// Spec holds information about the request being evaluated
|
|
Spec TokenReviewSpec `json:"spec" protobuf:"bytes,2,opt,name=spec"`
|
|
|
|
// Status is filled in by the server and indicates whether the request can be authenticated.
|
|
// +optional
|
|
Status TokenReviewStatus `json:"status,omitempty" protobuf:"bytes,3,opt,name=status"`
|
|
}
|
|
|
|
// TokenReviewSpec is a description of the token authentication request.
|
|
type TokenReviewSpec struct {
|
|
// Token is the opaque bearer token.
|
|
// +optional
|
|
Token string `json:"token,omitempty" protobuf:"bytes,1,opt,name=token"`
|
|
}
|
|
|
|
// TokenReviewStatus is the result of the token authentication request.
|
|
type TokenReviewStatus struct {
|
|
// Authenticated indicates that the token was associated with a known user.
|
|
// +optional
|
|
Authenticated bool `json:"authenticated,omitempty" protobuf:"varint,1,opt,name=authenticated"`
|
|
// User is the UserInfo associated with the provided token.
|
|
// +optional
|
|
User UserInfo `json:"user,omitempty" protobuf:"bytes,2,opt,name=user"`
|
|
// Error indicates that the token couldn't be checked
|
|
// +optional
|
|
Error string `json:"error,omitempty" protobuf:"bytes,3,opt,name=error"`
|
|
}
|
|
|
|
// UserInfo holds the information about the user needed to implement the
|
|
// user.Info interface.
|
|
type UserInfo struct {
|
|
// The name that uniquely identifies this user among all active users.
|
|
// +optional
|
|
Username string `json:"username,omitempty" protobuf:"bytes,1,opt,name=username"`
|
|
// A unique value that identifies this user across time. If this user is
|
|
// deleted and another user by the same name is added, they will have
|
|
// different UIDs.
|
|
// +optional
|
|
UID string `json:"uid,omitempty" protobuf:"bytes,2,opt,name=uid"`
|
|
// The names of groups this user is a part of.
|
|
// +optional
|
|
Groups []string `json:"groups,omitempty" protobuf:"bytes,3,rep,name=groups"`
|
|
// Any additional information provided by the authenticator.
|
|
// +optional
|
|
Extra map[string]ExtraValue `json:"extra,omitempty" protobuf:"bytes,4,rep,name=extra"`
|
|
}
|
|
|
|
// ExtraValue masks the value so protobuf can generate
|
|
// +protobuf.nullable=true
|
|
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
type ExtraValue []string
|
|
|
|
func (t ExtraValue) String() string {
|
|
return fmt.Sprintf("%v", []string(t))
|
|
}
|