mirror of
				https://github.com/optim-enterprises-bv/kubernetes.git
				synced 2025-11-04 04:08:16 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			186 lines
		
	
	
		
			7.0 KiB
		
	
	
	
		
			Protocol Buffer
		
	
	
	
	
	
			
		
		
	
	
			186 lines
		
	
	
		
			7.0 KiB
		
	
	
	
		
			Protocol Buffer
		
	
	
	
	
	
/*
 | 
						|
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.
 | 
						|
*/
 | 
						|
 | 
						|
 | 
						|
// This file was autogenerated by go-to-protobuf. Do not edit it manually!
 | 
						|
 | 
						|
syntax = 'proto2';
 | 
						|
 | 
						|
package k8s.io.kubernetes.pkg.apis.authorization.v1;
 | 
						|
 | 
						|
import "k8s.io/apimachinery/pkg/apis/meta/v1/generated.proto";
 | 
						|
import "k8s.io/apimachinery/pkg/runtime/generated.proto";
 | 
						|
import "k8s.io/apimachinery/pkg/runtime/schema/generated.proto";
 | 
						|
import "k8s.io/apimachinery/pkg/util/intstr/generated.proto";
 | 
						|
import "k8s.io/apiserver/pkg/apis/example/v1/generated.proto";
 | 
						|
import "k8s.io/kubernetes/pkg/api/v1/generated.proto";
 | 
						|
 | 
						|
// Package-wide variables from generator "generated".
 | 
						|
option go_package = "v1";
 | 
						|
 | 
						|
// ExtraValue masks the value so protobuf can generate
 | 
						|
// +protobuf.nullable=true
 | 
						|
// +protobuf.options.(gogoproto.goproto_stringer)=false
 | 
						|
message ExtraValue {
 | 
						|
  // items, if empty, will result in an empty slice
 | 
						|
 | 
						|
  repeated string items = 1;
 | 
						|
}
 | 
						|
 | 
						|
// LocalSubjectAccessReview checks whether or not a user or group can perform an action in a given namespace.
 | 
						|
// Having a namespace scoped resource makes it much easier to grant namespace scoped policy that includes permissions
 | 
						|
// checking.
 | 
						|
message LocalSubjectAccessReview {
 | 
						|
  // +optional
 | 
						|
  optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
 | 
						|
 | 
						|
  // Spec holds information about the request being evaluated.  spec.namespace must be equal to the namespace
 | 
						|
  // you made the request against.  If empty, it is defaulted.
 | 
						|
  optional SubjectAccessReviewSpec spec = 2;
 | 
						|
 | 
						|
  // Status is filled in by the server and indicates whether the request is allowed or not
 | 
						|
  // +optional
 | 
						|
  optional SubjectAccessReviewStatus status = 3;
 | 
						|
}
 | 
						|
 | 
						|
// NonResourceAttributes includes the authorization attributes available for non-resource requests to the Authorizer interface
 | 
						|
message NonResourceAttributes {
 | 
						|
  // Path is the URL path of the request
 | 
						|
  // +optional
 | 
						|
  optional string path = 1;
 | 
						|
 | 
						|
  // Verb is the standard HTTP verb
 | 
						|
  // +optional
 | 
						|
  optional string verb = 2;
 | 
						|
}
 | 
						|
 | 
						|
// ResourceAttributes includes the authorization attributes available for resource requests to the Authorizer interface
 | 
						|
message ResourceAttributes {
 | 
						|
  // Namespace is the namespace of the action being requested.  Currently, there is no distinction between no namespace and all namespaces
 | 
						|
  // "" (empty) is defaulted for LocalSubjectAccessReviews
 | 
						|
  // "" (empty) is empty for cluster-scoped resources
 | 
						|
  // "" (empty) means "all" for namespace scoped resources from a SubjectAccessReview or SelfSubjectAccessReview
 | 
						|
  // +optional
 | 
						|
  optional string namespace = 1;
 | 
						|
 | 
						|
  // Verb is a kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy.  "*" means all.
 | 
						|
  // +optional
 | 
						|
  optional string verb = 2;
 | 
						|
 | 
						|
  // Group is the API Group of the Resource.  "*" means all.
 | 
						|
  // +optional
 | 
						|
  optional string group = 3;
 | 
						|
 | 
						|
  // Version is the API Version of the Resource.  "*" means all.
 | 
						|
  // +optional
 | 
						|
  optional string version = 4;
 | 
						|
 | 
						|
  // Resource is one of the existing resource types.  "*" means all.
 | 
						|
  // +optional
 | 
						|
  optional string resource = 5;
 | 
						|
 | 
						|
  // Subresource is one of the existing resource types.  "" means none.
 | 
						|
  // +optional
 | 
						|
  optional string subresource = 6;
 | 
						|
 | 
						|
  // Name is the name of the resource being requested for a "get" or deleted for a "delete". "" (empty) means all.
 | 
						|
  // +optional
 | 
						|
  optional string name = 7;
 | 
						|
}
 | 
						|
 | 
						|
// SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a
 | 
						|
// spec.namespace means "in all namespaces".  Self is a special case, because users should always be able
 | 
						|
// to check whether they can perform an action
 | 
						|
message SelfSubjectAccessReview {
 | 
						|
  // +optional
 | 
						|
  optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
 | 
						|
 | 
						|
  // Spec holds information about the request being evaluated.  user and groups must be empty
 | 
						|
  optional SelfSubjectAccessReviewSpec spec = 2;
 | 
						|
 | 
						|
  // Status is filled in by the server and indicates whether the request is allowed or not
 | 
						|
  // +optional
 | 
						|
  optional SubjectAccessReviewStatus status = 3;
 | 
						|
}
 | 
						|
 | 
						|
// SelfSubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes
 | 
						|
// and NonResourceAuthorizationAttributes must be set
 | 
						|
message SelfSubjectAccessReviewSpec {
 | 
						|
  // ResourceAuthorizationAttributes describes information for a resource access request
 | 
						|
  // +optional
 | 
						|
  optional ResourceAttributes resourceAttributes = 1;
 | 
						|
 | 
						|
  // NonResourceAttributes describes information for a non-resource access request
 | 
						|
  // +optional
 | 
						|
  optional NonResourceAttributes nonResourceAttributes = 2;
 | 
						|
}
 | 
						|
 | 
						|
// SubjectAccessReview checks whether or not a user or group can perform an action.
 | 
						|
message SubjectAccessReview {
 | 
						|
  // +optional
 | 
						|
  optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
 | 
						|
 | 
						|
  // Spec holds information about the request being evaluated
 | 
						|
  optional SubjectAccessReviewSpec spec = 2;
 | 
						|
 | 
						|
  // Status is filled in by the server and indicates whether the request is allowed or not
 | 
						|
  // +optional
 | 
						|
  optional SubjectAccessReviewStatus status = 3;
 | 
						|
}
 | 
						|
 | 
						|
// SubjectAccessReviewSpec is a description of the access request.  Exactly one of ResourceAuthorizationAttributes
 | 
						|
// and NonResourceAuthorizationAttributes must be set
 | 
						|
message SubjectAccessReviewSpec {
 | 
						|
  // ResourceAuthorizationAttributes describes information for a resource access request
 | 
						|
  // +optional
 | 
						|
  optional ResourceAttributes resourceAttributes = 1;
 | 
						|
 | 
						|
  // NonResourceAttributes describes information for a non-resource access request
 | 
						|
  // +optional
 | 
						|
  optional NonResourceAttributes nonResourceAttributes = 2;
 | 
						|
 | 
						|
  // User is the user you're testing for.
 | 
						|
  // If you specify "User" but not "Groups", then is it interpreted as "What if User were not a member of any groups
 | 
						|
  // +optional
 | 
						|
  optional string verb = 3;
 | 
						|
 | 
						|
  // Groups is the groups you're testing for.
 | 
						|
  // +optional
 | 
						|
  repeated string groups = 4;
 | 
						|
 | 
						|
  // Extra corresponds to the user.Info.GetExtra() method from the authenticator.  Since that is input to the authorizer
 | 
						|
  // it needs a reflection here.
 | 
						|
  // +optional
 | 
						|
  map<string, ExtraValue> extra = 5;
 | 
						|
}
 | 
						|
 | 
						|
// SubjectAccessReviewStatus
 | 
						|
message SubjectAccessReviewStatus {
 | 
						|
  // Allowed is required.  True if the action would be allowed, false otherwise.
 | 
						|
  optional bool allowed = 1;
 | 
						|
 | 
						|
  // Reason is optional.  It indicates why a request was allowed or denied.
 | 
						|
  // +optional
 | 
						|
  optional string reason = 2;
 | 
						|
 | 
						|
  // EvaluationError is an indication that some error occurred during the authorization check.
 | 
						|
  // It is entirely possible to get an error and be able to continue determine authorization status in spite of it.
 | 
						|
  // For instance, RBAC can be missing a role, but enough roles are still present and bound to reason about the request.
 | 
						|
  // +optional
 | 
						|
  optional string evaluationError = 3;
 | 
						|
}
 | 
						|
 |