v1

package
v1.2.2 Latest Latest
Warning

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

Go to latest
Published: Jan 12, 2022 License: Apache-2.0 Imports: 9 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	ErrInvalidLengthGenerated        = fmt.Errorf("proto: negative length found during unmarshaling")
	ErrIntOverflowGenerated          = fmt.Errorf("proto: integer overflow")
	ErrUnexpectedEndOfGroupGenerated = fmt.Errorf("proto: unexpected end of group")
)

Functions

This section is empty.

Types

type CertificateSigningRequest

type CertificateSigningRequest struct {
	// +optional
	Metadata *v1.ObjectMeta `protobuf:"bytes,1,opt,name=metadata" json:"metadata,omitempty"`
	// spec contains the certificate request, and is immutable after creation.
	// Only the request, signerName, and usages fields can be set on creation.
	// Other fields are derived by Kubernetes and cannot be modified by users.
	Spec *CertificateSigningRequestSpec `protobuf:"bytes,2,opt,name=spec" json:"spec,omitempty"`
	// status contains information about whether the request is approved or denied,
	// and the certificate issued by the signer, or the failure condition indicating signer failure.
	// +optional
	Status               *CertificateSigningRequestStatus `protobuf:"bytes,3,opt,name=status" json:"status,omitempty"`
	XXX_NoUnkeyedLiteral struct{}                         `json:"-"`
	XXX_unrecognized     []byte                           `json:"-"`
	XXX_sizecache        int32                            `json:"-"`
}

CertificateSigningRequest objects provide a mechanism to obtain x509 certificates by submitting a certificate signing request, and having it asynchronously approved and issued.

Kubelets use this API to obtain:

  1. client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client-kubelet" signerName).
  2. serving certificates for TLS endpoints kube-apiserver can connect to securely (with the "kubernetes.io/kubelet-serving" signerName).

This API can be used to request client certificates to authenticate to kube-apiserver (with the "kubernetes.io/kube-apiserver-client" signerName), or to obtain certificates from custom non-Kubernetes signers.

func (*CertificateSigningRequest) Descriptor

func (*CertificateSigningRequest) Descriptor() ([]byte, []int)

func (*CertificateSigningRequest) GetMetadata

func (m *CertificateSigningRequest) GetMetadata() *v1.ObjectMeta

func (*CertificateSigningRequest) GetSpec

func (*CertificateSigningRequest) GetStatus

func (*CertificateSigningRequest) Marshal

func (m *CertificateSigningRequest) Marshal() (dAtA []byte, err error)

func (*CertificateSigningRequest) MarshalTo

func (m *CertificateSigningRequest) MarshalTo(dAtA []byte) (int, error)

func (*CertificateSigningRequest) MarshalToSizedBuffer

func (m *CertificateSigningRequest) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*CertificateSigningRequest) ProtoMessage

func (*CertificateSigningRequest) ProtoMessage()

func (*CertificateSigningRequest) Reset

func (m *CertificateSigningRequest) Reset()

func (*CertificateSigningRequest) Size

func (m *CertificateSigningRequest) Size() (n int)

func (*CertificateSigningRequest) String

func (m *CertificateSigningRequest) String() string

func (*CertificateSigningRequest) Unmarshal

func (m *CertificateSigningRequest) Unmarshal(dAtA []byte) error

func (*CertificateSigningRequest) XXX_DiscardUnknown

func (m *CertificateSigningRequest) XXX_DiscardUnknown()

func (*CertificateSigningRequest) XXX_Marshal

func (m *CertificateSigningRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*CertificateSigningRequest) XXX_Merge

func (m *CertificateSigningRequest) XXX_Merge(src proto.Message)

func (*CertificateSigningRequest) XXX_Size

func (m *CertificateSigningRequest) XXX_Size() int

func (*CertificateSigningRequest) XXX_Unmarshal

func (m *CertificateSigningRequest) XXX_Unmarshal(b []byte) error

type CertificateSigningRequestCondition

type CertificateSigningRequestCondition struct {
	// type of the condition. Known conditions are "Approved", "Denied", and "Failed".
	//
	// An "Approved" condition is added via the /approval subresource,
	// indicating the request was approved and should be issued by the signer.
	//
	// A "Denied" condition is added via the /approval subresource,
	// indicating the request was denied and should not be issued by the signer.
	//
	// A "Failed" condition is added via the /status subresource,
	// indicating the signer failed to issue the certificate.
	//
	// Approved and Denied conditions are mutually exclusive.
	// Approved, Denied, and Failed conditions cannot be removed once added.
	//
	// Only one condition of a given type is allowed.
	Type *string `protobuf:"bytes,1,opt,name=type" json:"type,omitempty"`
	// status of the condition, one of True, False, Unknown.
	// Approved, Denied, and Failed conditions may not be "False" or "Unknown".
	Status *string `protobuf:"bytes,6,opt,name=status" json:"status,omitempty"`
	// reason indicates a brief reason for the request state
	// +optional
	Reason *string `protobuf:"bytes,2,opt,name=reason" json:"reason,omitempty"`
	// message contains a human readable message with details about the request state
	// +optional
	Message *string `protobuf:"bytes,3,opt,name=message" json:"message,omitempty"`
	// lastUpdateTime is the time of the last update to this condition
	// +optional
	LastUpdateTime *v1.Time `protobuf:"bytes,4,opt,name=lastUpdateTime" json:"lastUpdateTime,omitempty"`
	// lastTransitionTime is the time the condition last transitioned from one status to another.
	// If unset, when a new condition type is added or an existing condition's status is changed,
	// the server defaults this to the current time.
	// +optional
	LastTransitionTime   *v1.Time `protobuf:"bytes,5,opt,name=lastTransitionTime" json:"lastTransitionTime,omitempty"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

CertificateSigningRequestCondition describes a condition of a CertificateSigningRequest object

func (*CertificateSigningRequestCondition) Descriptor

func (*CertificateSigningRequestCondition) Descriptor() ([]byte, []int)

func (*CertificateSigningRequestCondition) GetLastTransitionTime

func (m *CertificateSigningRequestCondition) GetLastTransitionTime() *v1.Time

func (*CertificateSigningRequestCondition) GetLastUpdateTime

func (m *CertificateSigningRequestCondition) GetLastUpdateTime() *v1.Time

func (*CertificateSigningRequestCondition) GetMessage

func (*CertificateSigningRequestCondition) GetReason

func (*CertificateSigningRequestCondition) GetStatus

func (*CertificateSigningRequestCondition) GetType

func (*CertificateSigningRequestCondition) Marshal

func (m *CertificateSigningRequestCondition) Marshal() (dAtA []byte, err error)

func (*CertificateSigningRequestCondition) MarshalTo

func (m *CertificateSigningRequestCondition) MarshalTo(dAtA []byte) (int, error)

func (*CertificateSigningRequestCondition) MarshalToSizedBuffer

func (m *CertificateSigningRequestCondition) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*CertificateSigningRequestCondition) ProtoMessage

func (*CertificateSigningRequestCondition) ProtoMessage()

func (*CertificateSigningRequestCondition) Reset

func (*CertificateSigningRequestCondition) Size

func (*CertificateSigningRequestCondition) String

func (*CertificateSigningRequestCondition) Unmarshal

func (m *CertificateSigningRequestCondition) Unmarshal(dAtA []byte) error

func (*CertificateSigningRequestCondition) XXX_DiscardUnknown

func (m *CertificateSigningRequestCondition) XXX_DiscardUnknown()

func (*CertificateSigningRequestCondition) XXX_Marshal

func (m *CertificateSigningRequestCondition) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*CertificateSigningRequestCondition) XXX_Merge

func (*CertificateSigningRequestCondition) XXX_Size

func (*CertificateSigningRequestCondition) XXX_Unmarshal

func (m *CertificateSigningRequestCondition) XXX_Unmarshal(b []byte) error

type CertificateSigningRequestList

type CertificateSigningRequestList struct {
	// +optional
	Metadata *v1.ListMeta `protobuf:"bytes,1,opt,name=metadata" json:"metadata,omitempty"`
	// items is a collection of CertificateSigningRequest objects
	Items                []*CertificateSigningRequest `protobuf:"bytes,2,rep,name=items" json:"items,omitempty"`
	XXX_NoUnkeyedLiteral struct{}                     `json:"-"`
	XXX_unrecognized     []byte                       `json:"-"`
	XXX_sizecache        int32                        `json:"-"`
}

CertificateSigningRequestList is a collection of CertificateSigningRequest objects

func (*CertificateSigningRequestList) Descriptor

func (*CertificateSigningRequestList) Descriptor() ([]byte, []int)

func (*CertificateSigningRequestList) GetItems

func (*CertificateSigningRequestList) GetMetadata

func (m *CertificateSigningRequestList) GetMetadata() *v1.ListMeta

func (*CertificateSigningRequestList) Marshal

func (m *CertificateSigningRequestList) Marshal() (dAtA []byte, err error)

func (*CertificateSigningRequestList) MarshalTo

func (m *CertificateSigningRequestList) MarshalTo(dAtA []byte) (int, error)

func (*CertificateSigningRequestList) MarshalToSizedBuffer

func (m *CertificateSigningRequestList) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*CertificateSigningRequestList) ProtoMessage

func (*CertificateSigningRequestList) ProtoMessage()

func (*CertificateSigningRequestList) Reset

func (m *CertificateSigningRequestList) Reset()

func (*CertificateSigningRequestList) Size

func (m *CertificateSigningRequestList) Size() (n int)

func (*CertificateSigningRequestList) String

func (*CertificateSigningRequestList) Unmarshal

func (m *CertificateSigningRequestList) Unmarshal(dAtA []byte) error

func (*CertificateSigningRequestList) XXX_DiscardUnknown

func (m *CertificateSigningRequestList) XXX_DiscardUnknown()

func (*CertificateSigningRequestList) XXX_Marshal

func (m *CertificateSigningRequestList) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*CertificateSigningRequestList) XXX_Merge

func (m *CertificateSigningRequestList) XXX_Merge(src proto.Message)

func (*CertificateSigningRequestList) XXX_Size

func (m *CertificateSigningRequestList) XXX_Size() int

func (*CertificateSigningRequestList) XXX_Unmarshal

func (m *CertificateSigningRequestList) XXX_Unmarshal(b []byte) error

type CertificateSigningRequestSpec

type CertificateSigningRequestSpec struct {
	// request contains an x509 certificate signing request encoded in a "CERTIFICATE REQUEST" PEM block.
	// When serialized as JSON or YAML, the data is additionally base64-encoded.
	// +listType=atomic
	Request []byte `protobuf:"bytes,1,opt,name=request" json:"request,omitempty"`
	// signerName indicates the requested signer, and is a qualified name.
	//
	// List/watch requests for CertificateSigningRequests can filter on this field using a "spec.signerName=NAME" fieldSelector.
	//
	// Well-known Kubernetes signers are:
	//  1. "kubernetes.io/kube-apiserver-client": issues client certificates that can be used to authenticate to kube-apiserver.
	//   Requests for this signer are never auto-approved by kube-controller-manager, can be issued by the "csrsigning" controller in kube-controller-manager.
	//  2. "kubernetes.io/kube-apiserver-client-kubelet": issues client certificates that kubelets use to authenticate to kube-apiserver.
	//   Requests for this signer can be auto-approved by the "csrapproving" controller in kube-controller-manager, and can be issued by the "csrsigning" controller in kube-controller-manager.
	//  3. "kubernetes.io/kubelet-serving" issues serving certificates that kubelets use to serve TLS endpoints, which kube-apiserver can connect to securely.
	//   Requests for this signer are never auto-approved by kube-controller-manager, and can be issued by the "csrsigning" controller in kube-controller-manager.
	//
	// More details are available at https://k8s.io/docs/reference/access-authn-authz/certificate-signing-requests/#kubernetes-signers
	//
	// Custom signerNames can also be specified. The signer defines:
	//  1. Trust distribution: how trust (CA bundles) are distributed.
	//  2. Permitted subjects: and behavior when a disallowed subject is requested.
	//  3. Required, permitted, or forbidden x509 extensions in the request (including whether subjectAltNames are allowed, which types, restrictions on allowed values) and behavior when a disallowed extension is requested.
	//  4. Required, permitted, or forbidden key usages / extended key usages.
	//  5. Expiration/certificate lifetime: whether it is fixed by the signer, configurable by the admin.
	//  6. Whether or not requests for CA certificates are allowed.
	SignerName *string `protobuf:"bytes,7,opt,name=signerName" json:"signerName,omitempty"`
	// usages specifies a set of key usages requested in the issued certificate.
	//
	// Requests for TLS client certificates typically request: "digital signature", "key encipherment", "client auth".
	//
	// Requests for TLS serving certificates typically request: "key encipherment", "digital signature", "server auth".
	//
	// Valid values are:
	//  "signing", "digital signature", "content commitment",
	//  "key encipherment", "key agreement", "data encipherment",
	//  "cert sign", "crl sign", "encipher only", "decipher only", "any",
	//  "server auth", "client auth",
	//  "code signing", "email protection", "s/mime",
	//  "ipsec end system", "ipsec tunnel", "ipsec user",
	//  "timestamping", "ocsp signing", "microsoft sgc", "netscape sgc"
	// +listType=atomic
	Usages []string `protobuf:"bytes,5,rep,name=usages" json:"usages,omitempty"`
	// username contains the name of the user that created the CertificateSigningRequest.
	// Populated by the API server on creation and immutable.
	// +optional
	Username *string `protobuf:"bytes,2,opt,name=username" json:"username,omitempty"`
	// uid contains the uid of the user that created the CertificateSigningRequest.
	// Populated by the API server on creation and immutable.
	// +optional
	Uid *string `protobuf:"bytes,3,opt,name=uid" json:"uid,omitempty"`
	// groups contains group membership of the user that created the CertificateSigningRequest.
	// Populated by the API server on creation and immutable.
	// +listType=atomic
	// +optional
	Groups []string `protobuf:"bytes,4,rep,name=groups" json:"groups,omitempty"`
	// extra contains extra attributes of the user that created the CertificateSigningRequest.
	// Populated by the API server on creation and immutable.
	// +optional
	Extra                map[string]*ExtraValue `` /* 130-byte string literal not displayed */
	XXX_NoUnkeyedLiteral struct{}               `json:"-"`
	XXX_unrecognized     []byte                 `json:"-"`
	XXX_sizecache        int32                  `json:"-"`
}

CertificateSigningRequestSpec contains the certificate request.

func (*CertificateSigningRequestSpec) Descriptor

func (*CertificateSigningRequestSpec) Descriptor() ([]byte, []int)

func (*CertificateSigningRequestSpec) GetExtra

func (m *CertificateSigningRequestSpec) GetExtra() map[string]*ExtraValue

func (*CertificateSigningRequestSpec) GetGroups

func (m *CertificateSigningRequestSpec) GetGroups() []string

func (*CertificateSigningRequestSpec) GetRequest

func (m *CertificateSigningRequestSpec) GetRequest() []byte

func (*CertificateSigningRequestSpec) GetSignerName

func (m *CertificateSigningRequestSpec) GetSignerName() string

func (*CertificateSigningRequestSpec) GetUid

func (*CertificateSigningRequestSpec) GetUsages

func (m *CertificateSigningRequestSpec) GetUsages() []string

func (*CertificateSigningRequestSpec) GetUsername

func (m *CertificateSigningRequestSpec) GetUsername() string

func (*CertificateSigningRequestSpec) Marshal

func (m *CertificateSigningRequestSpec) Marshal() (dAtA []byte, err error)

func (*CertificateSigningRequestSpec) MarshalTo

func (m *CertificateSigningRequestSpec) MarshalTo(dAtA []byte) (int, error)

func (*CertificateSigningRequestSpec) MarshalToSizedBuffer

func (m *CertificateSigningRequestSpec) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*CertificateSigningRequestSpec) ProtoMessage

func (*CertificateSigningRequestSpec) ProtoMessage()

func (*CertificateSigningRequestSpec) Reset

func (m *CertificateSigningRequestSpec) Reset()

func (*CertificateSigningRequestSpec) Size

func (m *CertificateSigningRequestSpec) Size() (n int)

func (*CertificateSigningRequestSpec) String

func (*CertificateSigningRequestSpec) Unmarshal

func (m *CertificateSigningRequestSpec) Unmarshal(dAtA []byte) error

func (*CertificateSigningRequestSpec) XXX_DiscardUnknown

func (m *CertificateSigningRequestSpec) XXX_DiscardUnknown()

func (*CertificateSigningRequestSpec) XXX_Marshal

func (m *CertificateSigningRequestSpec) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*CertificateSigningRequestSpec) XXX_Merge

func (m *CertificateSigningRequestSpec) XXX_Merge(src proto.Message)

func (*CertificateSigningRequestSpec) XXX_Size

func (m *CertificateSigningRequestSpec) XXX_Size() int

func (*CertificateSigningRequestSpec) XXX_Unmarshal

func (m *CertificateSigningRequestSpec) XXX_Unmarshal(b []byte) error

type CertificateSigningRequestStatus

type CertificateSigningRequestStatus struct {
	// conditions applied to the request. Known conditions are "Approved", "Denied", and "Failed".
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []*CertificateSigningRequestCondition `protobuf:"bytes,1,rep,name=conditions" json:"conditions,omitempty"`
	// certificate is populated with an issued certificate by the signer after an Approved condition is present.
	// This field is set via the /status subresource. Once populated, this field is immutable.
	//
	// If the certificate signing request is denied, a condition of type "Denied" is added and this field remains empty.
	// If the signer cannot issue the certificate, a condition of type "Failed" is added and this field remains empty.
	//
	// Validation requirements:
	//  1. certificate must contain one or more PEM blocks.
	//  2. All PEM blocks must have the "CERTIFICATE" label, contain no headers, and the encoded data
	//   must be a BER-encoded ASN.1 Certificate structure as described in section 4 of RFC5280.
	//  3. Non-PEM content may appear before or after the "CERTIFICATE" PEM blocks and is unvalidated,
	//   to allow for explanatory text as described in section 5.2 of RFC7468.
	//
	// If more than one PEM block is present, and the definition of the requested spec.signerName
	// does not indicate otherwise, the first block is the issued certificate,
	// and subsequent blocks should be treated as intermediate certificates and presented in TLS handshakes.
	//
	// The certificate is encoded in PEM format.
	//
	// When serialized as JSON or YAML, the data is additionally base64-encoded, so it consists of:
	//
	//     base64(
	//     -----BEGIN CERTIFICATE-----
	//     ...
	//     -----END CERTIFICATE-----
	//     )
	//
	// +listType=atomic
	// +optional
	Certificate          []byte   `protobuf:"bytes,2,opt,name=certificate" json:"certificate,omitempty"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

CertificateSigningRequestStatus contains conditions used to indicate approved/denied/failed status of the request, and the issued certificate.

func (*CertificateSigningRequestStatus) Descriptor

func (*CertificateSigningRequestStatus) Descriptor() ([]byte, []int)

func (*CertificateSigningRequestStatus) GetCertificate

func (m *CertificateSigningRequestStatus) GetCertificate() []byte

func (*CertificateSigningRequestStatus) GetConditions

func (*CertificateSigningRequestStatus) Marshal

func (m *CertificateSigningRequestStatus) Marshal() (dAtA []byte, err error)

func (*CertificateSigningRequestStatus) MarshalTo

func (m *CertificateSigningRequestStatus) MarshalTo(dAtA []byte) (int, error)

func (*CertificateSigningRequestStatus) MarshalToSizedBuffer

func (m *CertificateSigningRequestStatus) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*CertificateSigningRequestStatus) ProtoMessage

func (*CertificateSigningRequestStatus) ProtoMessage()

func (*CertificateSigningRequestStatus) Reset

func (*CertificateSigningRequestStatus) Size

func (m *CertificateSigningRequestStatus) Size() (n int)

func (*CertificateSigningRequestStatus) String

func (*CertificateSigningRequestStatus) Unmarshal

func (m *CertificateSigningRequestStatus) Unmarshal(dAtA []byte) error

func (*CertificateSigningRequestStatus) XXX_DiscardUnknown

func (m *CertificateSigningRequestStatus) XXX_DiscardUnknown()

func (*CertificateSigningRequestStatus) XXX_Marshal

func (m *CertificateSigningRequestStatus) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*CertificateSigningRequestStatus) XXX_Merge

func (m *CertificateSigningRequestStatus) XXX_Merge(src proto.Message)

func (*CertificateSigningRequestStatus) XXX_Size

func (m *CertificateSigningRequestStatus) XXX_Size() int

func (*CertificateSigningRequestStatus) XXX_Unmarshal

func (m *CertificateSigningRequestStatus) XXX_Unmarshal(b []byte) error

type ExtraValue

type ExtraValue struct {
	Items                []string `protobuf:"bytes,1,rep,name=items" json:"items,omitempty"`
	XXX_NoUnkeyedLiteral struct{} `json:"-"`
	XXX_unrecognized     []byte   `json:"-"`
	XXX_sizecache        int32    `json:"-"`
}

ExtraValue masks the value so protobuf can generate +protobuf.nullable=true +protobuf.options.(gogoproto.goproto_stringer)=false

func (*ExtraValue) Descriptor

func (*ExtraValue) Descriptor() ([]byte, []int)

func (*ExtraValue) GetItems

func (m *ExtraValue) GetItems() []string

func (*ExtraValue) Marshal

func (m *ExtraValue) Marshal() (dAtA []byte, err error)

func (*ExtraValue) MarshalTo

func (m *ExtraValue) MarshalTo(dAtA []byte) (int, error)

func (*ExtraValue) MarshalToSizedBuffer

func (m *ExtraValue) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*ExtraValue) ProtoMessage

func (*ExtraValue) ProtoMessage()

func (*ExtraValue) Reset

func (m *ExtraValue) Reset()

func (*ExtraValue) Size

func (m *ExtraValue) Size() (n int)

func (*ExtraValue) String

func (m *ExtraValue) String() string

func (*ExtraValue) Unmarshal

func (m *ExtraValue) Unmarshal(dAtA []byte) error

func (*ExtraValue) XXX_DiscardUnknown

func (m *ExtraValue) XXX_DiscardUnknown()

func (*ExtraValue) XXX_Marshal

func (m *ExtraValue) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*ExtraValue) XXX_Merge

func (m *ExtraValue) XXX_Merge(src proto.Message)

func (*ExtraValue) XXX_Size

func (m *ExtraValue) XXX_Size() int

func (*ExtraValue) XXX_Unmarshal

func (m *ExtraValue) XXX_Unmarshal(b []byte) error

Jump to

Keyboard shortcuts

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