generated.proto 4.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103
  1. /*
  2. Copyright The Kubernetes Authors.
  3. Licensed under the Apache License, Version 2.0 (the "License");
  4. you may not use this file except in compliance with the License.
  5. You may obtain a copy of the License at
  6. http://www.apache.org/licenses/LICENSE-2.0
  7. Unless required by applicable law or agreed to in writing, software
  8. distributed under the License is distributed on an "AS IS" BASIS,
  9. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  10. See the License for the specific language governing permissions and
  11. limitations under the License.
  12. */
  13. // This file was autogenerated by go-to-protobuf. Do not edit it manually!
  14. syntax = "proto2";
  15. package k8s.io.api.certificates.v1alpha1;
  16. import "k8s.io/apimachinery/pkg/apis/meta/v1/generated.proto";
  17. import "k8s.io/apimachinery/pkg/runtime/generated.proto";
  18. import "k8s.io/apimachinery/pkg/runtime/schema/generated.proto";
  19. // Package-wide variables from generator "generated".
  20. option go_package = "k8s.io/api/certificates/v1alpha1";
  21. // ClusterTrustBundle is a cluster-scoped container for X.509 trust anchors
  22. // (root certificates).
  23. //
  24. // ClusterTrustBundle objects are considered to be readable by any authenticated
  25. // user in the cluster, because they can be mounted by pods using the
  26. // `clusterTrustBundle` projection. All service accounts have read access to
  27. // ClusterTrustBundles by default. Users who only have namespace-level access
  28. // to a cluster can read ClusterTrustBundles by impersonating a serviceaccount
  29. // that they have access to.
  30. //
  31. // It can be optionally associated with a particular assigner, in which case it
  32. // contains one valid set of trust anchors for that signer. Signers may have
  33. // multiple associated ClusterTrustBundles; each is an independent set of trust
  34. // anchors for that signer. Admission control is used to enforce that only users
  35. // with permissions on the signer can create or modify the corresponding bundle.
  36. message ClusterTrustBundle {
  37. // metadata contains the object metadata.
  38. // +optional
  39. optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
  40. // spec contains the signer (if any) and trust anchors.
  41. optional ClusterTrustBundleSpec spec = 2;
  42. }
  43. // ClusterTrustBundleList is a collection of ClusterTrustBundle objects
  44. message ClusterTrustBundleList {
  45. // metadata contains the list metadata.
  46. //
  47. // +optional
  48. optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
  49. // items is a collection of ClusterTrustBundle objects
  50. repeated ClusterTrustBundle items = 2;
  51. }
  52. // ClusterTrustBundleSpec contains the signer and trust anchors.
  53. message ClusterTrustBundleSpec {
  54. // signerName indicates the associated signer, if any.
  55. //
  56. // In order to create or update a ClusterTrustBundle that sets signerName,
  57. // you must have the following cluster-scoped permission:
  58. // group=certificates.k8s.io resource=signers resourceName=<the signer name>
  59. // verb=attest.
  60. //
  61. // If signerName is not empty, then the ClusterTrustBundle object must be
  62. // named with the signer name as a prefix (translating slashes to colons).
  63. // For example, for the signer name `example.com/foo`, valid
  64. // ClusterTrustBundle object names include `example.com:foo:abc` and
  65. // `example.com:foo:v1`.
  66. //
  67. // If signerName is empty, then the ClusterTrustBundle object's name must
  68. // not have such a prefix.
  69. //
  70. // List/watch requests for ClusterTrustBundles can filter on this field
  71. // using a `spec.signerName=NAME` field selector.
  72. //
  73. // +optional
  74. optional string signerName = 1;
  75. // trustBundle contains the individual X.509 trust anchors for this
  76. // bundle, as PEM bundle of PEM-wrapped, DER-formatted X.509 certificates.
  77. //
  78. // The data must consist only of PEM certificate blocks that parse as valid
  79. // X.509 certificates. Each certificate must include a basic constraints
  80. // extension with the CA bit set. The API server will reject objects that
  81. // contain duplicate certificates, or that use PEM block headers.
  82. //
  83. // Users of ClusterTrustBundles, including Kubelet, are free to reorder and
  84. // deduplicate certificate blocks in this file according to their own logic,
  85. // as well as to drop PEM block headers and inter-block data.
  86. optional string trustBundle = 2;
  87. }