approver-policy API 參考
套件
policy.cert-manager.io/v1alpha1
資源類型
CertificateRequestPolicy
CertificateRequestPolicy 是一個用於描述「政策設定檔」的物件,該設定檔會決定是否應核准或拒絕適用的 CertificateRequest。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
apiVersion | 字串 | policy.cert-manager.io/v1alpha1 | 是 |
kind | 字串 | CertificateRequestPolicy | 是 |
metadata | 物件 | 請參閱 Kubernetes API 文件,了解 metadata 欄位的相關資訊。 | 是 |
spec | 物件 | CertificateRequestPolicySpec 定義 CertificateRequestPolicy 的期望狀態。 | 否 |
status | 物件 | CertificateRequestPolicyStatus 定義 CertificateRequestPolicy 的觀察狀態。 | 否 |
CertificateRequestPolicy.spec
CertificateRequestPolicySpec 定義 CertificateRequestPolicy 的期望狀態。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
selector | 物件 | Selector 用於選擇此 CertificateRequestPolicy 適用於哪些 CertificateRequest,並將用於其核准評估。 | 是 |
allowed | 物件 | Allowed 定義 CertificateRequest 的允許屬性。CertificateRequest 可以請求少於允許的項目,但不能多於允許的項目,也就是說,CertificateRequest 可以請求政策宣告為允許的項目的子集。省略的欄位表示等效的 CertificateRequest 欄位必須省略,或是請求的值必須為空,才允許該請求。 | 否 |
constraints | 物件 | Constraints 定義 CertificateRequest 必須滿足的欄位,才能讓此政策允許該請求。省略的欄位對請求中對應的屬性沒有限制。 | 否 |
plugins | map[string]object | 外掛程式是在編譯時建置到 approver-policy 中的核准者。這是一個通常用於擴充 approver-policy 核心功能的高階功能。這個欄位定義當針對 CertificateRequest 評估此政策時,應執行的外掛程式及其設定。 | 否 |
CertificateRequestPolicy.spec.selector
Selector 用於選擇此 CertificateRequestPolicy 適用於哪些 CertificateRequest,並將用於其核准評估。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
issuerRef | 物件 | IssuerRef 用於依簽發者比對,表示 CertificateRequestPolicy 只會評估參照符合的簽發者的 CertificateRequest。如果簽發者不符,則不會處理 CertificateRequest,無論請求者是否受限於 RBAC。 以下值會比對所有簽發者
| 否 |
namespace | 物件 | Namespace 用於依命名空間比對,表示 CertificateRequestPolicy 只會比對在符合的命名空間中建立的 CertificateRequest。如果省略此欄位,則會檢查所有命名空間中的資源。 | 否 |
CertificateRequestPolicy.spec.selector.issuerRef
IssuerRef 用於依簽發者比對,表示 CertificateRequestPolicy 只會評估參照符合的簽發者的 CertificateRequest。如果簽發者不符,則不會處理 CertificateRequest,無論請求者是否受限於 RBAC。
以下值會比對所有簽發者
issuerRef: {}
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
group | 字串 | Group 是萬用字元選取器,可比對請求中的 | 否 |
kind | 字串 | Kind 是萬用字元選取器,可比對請求中的 | 否 |
name | 字串 | Name 是已啟用萬用字元的選取器,可比對請求的 | 否 |
CertificateRequestPolicy.spec.selector.namespace
Namespace 用於依命名空間比對,表示 CertificateRequestPolicy 只會比對在符合的命名空間中建立的 CertificateRequest。如果省略此欄位,則會檢查所有命名空間中的資源。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
matchLabels | map[string]string | MatchLabels 是一組命名空間標籤,可用於選取在符合選取器的命名空間中建立的 CertificateRequest。 | 否 |
matchNames | []string | MatchNames 是一組命名空間名稱,可用於選取在符合的命名空間中建立的 CertificateRequest。接受萬用字元「*」。TODO:在 v1alpha2 中新增 x-kubernetes-list-type: set | 否 |
CertificateRequestPolicy.spec.allowed
Allowed 定義 CertificateRequest 的允許屬性。CertificateRequest 可以請求少於允許的項目,但不能多於允許的項目,也就是說,CertificateRequest 可以請求政策宣告為允許的項目的子集。省略的欄位表示等效的 CertificateRequest 欄位必須省略,或是請求的值必須為空,才允許該請求。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
commonName | 物件 | CommonName 定義可能請求的 X.509 一般名稱。 | 否 |
dnsNames | 物件 | DNSNames 定義可能請求的 X.509 DNS SAN。 | 否 |
emailAddresses | 物件 | EmailAddresses 定義可能請求的 X.509 電子郵件 SAN。 | 否 |
ipAddresses | 物件 | IPAddresses 定義可能請求的 X.509 IP SAN。 | 否 |
isCA | 布林值 | IsCA 定義是否允許 CertificateRequest 將 | 否 |
subject | 物件 | Subject 宣告 CertificateRequest 中允許的 X.509 主體屬性。省略的欄位會禁止請求任何主體屬性。CertificateRequest 可以請求允許的 X.509 主體屬性的子集。 | 否 |
uris | 物件 | URIs 定義可能請求的 X.509 URI SAN。 | 否 |
usages | []列舉 | Usages 定義可包含在 CertificateRequest | 否 |
CertificateRequestPolicy.spec.allowed.commonName
CommonName 定義可能請求的 X.509 一般名稱。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 表示必須提供相關欄位,且不得為空字串。預設為 | 否 |
validations | []物件 | Validations 使用通用運算式語言 (CEL) 套用規則,以驗證請求中存在的屬性值,超出使用值/必要項所能表達的範圍。相關 CertificateRequest 欄位上的屬性值必須通過所有驗證,才能讓此政策允許該請求。 | 否 |
value | 字串 | Value 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,則相關欄位必須符合指定的模式。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.commonName.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.dnsNames
DNSNames 定義可能請求的 X.509 DNS SAN。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.dnsNames.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.emailAddresses
EmailAddresses 定義可能請求的 X.509 電子郵件 SAN。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.emailAddresses.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.ipAddresses
IPAddresses 定義可能請求的 X.509 IP SAN。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.ipAddresses.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.subject
Subject 宣告 CertificateRequest 中允許的 X.509 主體屬性。省略的欄位會禁止請求任何主體屬性。CertificateRequest 可以請求允許的 X.509 主體屬性的子集。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
countries | 物件 | Countries 定義可能請求的 X.509 主體國家/地區。 | 否 |
localities | 物件 | Localities 定義可能請求的 X.509 主體地點。 | 否 |
organizationalUnits | 物件 | OrganizationalUnits 定義可能請求的 X.509 主體組織單位。 | 否 |
organizations | 物件 | Organizations 定義可能請求的 X.509 主體組織。 | 否 |
postalCodes | 物件 | PostalCodes 定義可能請求的 X.509 主體郵遞區號。 | 否 |
provinces | 物件 | Provinces 定義可能請求的 X.509 主體省份。 | 否 |
serialNumber | 物件 | SerialNumber 定義可能請求的 X.509 主體序號。 | 否 |
streetAddresses | 物件 | StreetAddresses 定義可能請求的 X.509 主體街道地址。 | 否 |
CertificateRequestPolicy.spec.allowed.subject.countries
Countries 定義可能請求的 X.509 主體國家/地區。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.subject.countries.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.subject.localities
Localities 定義可能請求的 X.509 主體地點。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.subject.localities.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.subject.organizationalUnits
OrganizationalUnits 定義可能請求的 X.509 主體組織單位。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.subject.organizationalUnits.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.subject.organizations
Organizations 定義可能請求的 X.509 主體組織。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.subject.organizations.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.subject.postalCodes
PostalCodes 定義可能請求的 X.509 主體郵遞區號。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.subject.postalCodes.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.subject.provinces
Provinces 定義可能請求的 X.509 主體省份。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.subject.provinces.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.subject.serialNumber
SerialNumber 定義可能請求的 X.509 主體序號。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 表示必須提供相關欄位,且不得為空字串。預設為 | 否 |
validations | []物件 | Validations 使用通用運算式語言 (CEL) 套用規則,以驗證請求中存在的屬性值,超出使用值/必要項所能表達的範圍。相關 CertificateRequest 欄位上的屬性值必須通過所有驗證,才能讓此政策允許該請求。 | 否 |
value | 字串 | Value 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,則相關欄位必須符合指定的模式。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.subject.serialNumber.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.subject.streetAddresses
StreetAddresses 定義可能請求的 X.509 主體街道地址。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.subject.streetAddresses.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.allowed.uris
URIs 定義可能請求的 X.509 URI SAN。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
required | 布林值 | Required 控制相關欄位是否必須至少有一個值。預設值為 | 否 |
validations | []物件 | Validations 使用通用表達式語言 (CEL) 套用規則,以驗證請求上的屬性值,超出使用 values/required 可能表達的範圍。相關 CertificateRequest 欄位的所有屬性值必須通過 ALL 驗證,此原則才會授予請求。 | 否 |
values | []string | Values 定義相關 CertificateRequest 欄位上允許的屬性值。接受萬用字元「*」。如果設定,相關欄位只能包含允許值中包含的項目。 注意: | 否 |
CertificateRequestPolicy.spec.allowed.uris.validations[index]
ValidationRule 描述以 CEL 表示的驗證規則。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
rule | 字串 | 規則代表將由 CEL 評估的表達式。參考:https://github.com/google/cel-spec。規則的作用範圍限定於 schema 中驗證的位置。CEL 表達式中的 範例(針對命名空間的 DNS 名稱的規則)
| 是 |
訊息 | 字串 | 訊息是在驗證失敗時顯示的訊息。如果規則包含換行符號,則必須提供訊息。請注意,訊息不得包含換行符號。如果未設定,則會使用後備訊息:「規則失敗: | 否 |
CertificateRequestPolicy.spec.constraints
Constraints 定義 CertificateRequest 必須滿足的欄位,才能讓此政策允許該請求。省略的欄位對請求中對應的屬性沒有限制。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
maxDuration | 字串 | MaxDuration 定義憑證請求的最大期限。數值是包含性的(例如, | 否 |
minDuration | 字串 | MinDuration 定義憑證請求的最小期限。數值是包含性的(例如, | 否 |
privateKey | 物件 | PrivateKey 定義 CertificateRequest 允許的私鑰形狀的約束。省略的欄位表示沒有私鑰形狀約束。 | 否 |
CertificateRequestPolicy.spec.constraints.privateKey
PrivateKey 定義 CertificateRequest 允許的私鑰形狀的約束。省略的欄位表示沒有私鑰形狀約束。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
algorithm | 列舉 | Algorithm 定義請求中允許的私鑰加密演算法。省略的欄位允許任何演算法。 列舉:RSA、ECDSA、Ed25519 | 否 |
maxSize | 整數 | MaxSize 定義私鑰的最大金鑰大小。數值是包含性的(例如, | 否 |
minSize | 整數 | MinSize 定義私鑰的最小金鑰大小。數值是包含性的(例如, | 否 |
CertificateRequestPolicy.spec.plugins[key]
CertificateRequestPolicyPluginData 是外掛程式批准者評估此原則上的 CertificateRequest 所需的組態。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
values | map[string]string | 值定義一組外掛程式已知的、對外掛程式而言必要的鍵值對,以便外掛程式根據此原則成功評估請求。 | 否 |
CertificateRequestPolicy.status
CertificateRequestPolicyStatus 定義 CertificateRequestPolicy 的觀察狀態。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
conditions | []物件 | 狀態條件列表,表示 CertificateRequestPolicy 的狀態。已知的條件類型為 | 否 |
CertificateRequestPolicy.status.conditions[index]
CertificateRequestPolicyCondition 包含 CertificateRequestPolicyStatus 的條件資訊。
名稱 | 類型 | 描述 | 必要 |
---|---|---|---|
status | 字串 | 條件的狀態,為 ('True'、'False'、'Unknown') 之一。 | 是 |
type | 字串 | 條件的類型,已知的值為 ( | 是 |
lastTransitionTime | 字串 | LastTransitionTime 是此條件最後一次狀態變更的時間戳記。 格式:日期時間 | 否 |
訊息 | 字串 | Message 是對最後一次轉換詳細資訊的人工可讀描述,補充了原因。 | 否 |
observedGeneration | 整數 | 如果設定,則此值表示條件設定所依據的 .metadata.generation。例如,如果 .metadata.generation 目前為 12,但 .status.condition[x].observedGeneration 為 9,則條件相對於 CertificateRequestPolicy 的目前狀態已過時。 格式:int64 | 否 |
reason | 字串 | Reason 是對條件的最後一次轉換的簡短機器可讀解釋。 | 否 |