UserDefinedAuthentication v1.9.0 自訂資源定義

規格結構定義

UserDefinedAuthenticationSpec 定義 UserDefinedAuthentication 的所選狀態。

dbclusterRef:
  name: string
keytabSecretRef:
  name: string
pgHbaEntries:
- string
pgIdentEntries:
- string
ldapConfiguration:
  allowUnmappedUsersLogin: boolean
  cacheTTLSeconds: integer
  enableGroupMapping: boolean
  enableLdapOptReferrals: boolean
  ldapBaseDN: string
  ldapBindDN: string
  ldapBindPasswordSecretRef:
    name: string
  ldapSearchAttribute: string
  ldapURI: string
  ldapsCertificateSecretRef:
    name: string

欄位

類型
必填或選填

 

說明
dbclusterRef
object
必填
DBClusterRef 是指相同命名空間中的目標 DBCluster,這些驗證設定適用於該命名空間。
dbclusterRef.name
string
必填
參照對象的名稱。詳情請參閱「名稱」。
keytabSecretRef
object
選填
KeytabSecretRef 是指相同命名空間中,含有 Kerberos keytab 檔案的 Secret 資源。Secret 必須有名為 krb5.keytab 的資料欄位。使用 GSSAPI 驗證或 LDAP 群組對應時,必須填寫這個欄位。
keytabSecretRef.name
string
選填
參照對象的名稱。詳情請參閱「名稱」。
pgHbaEntries
list (string)
必填
PgHbaEntries 是 pg_hba.conf 項目清單,營運商會將這些項目套用至目標 DBCluster,以使用這個驗證方式。清單中的每個字串都代表 pg_hba.conf 檔案中的獨立行。
pgIdentEntries
list (string)
選填
PgIdentEntries 是選用的 pg_ident.conf 項目 (使用者名稱對應) 清單,運算子會將這些項目套用至目標 DBCluster。清單中的每個字串都代表 pg_ident.conf 檔案中的一行。
ldapConfiguration
object
選填
LDAPConfiguration 包含群組對應設定。這些設定會設定 google_pg_auth 擴充功能,以便在 GSSAPI 登入成功後,執行 LDAP 查詢來同步處理 Active Directory (AD) 群組。
ldapConfiguration.allowUnmappedUsersLogin
boolean
選填
AllowUnmappedUsersLogin 可決定是否允許未對應的使用者登入。預設為 false。
ldapConfiguration.cacheTTLSeconds
integer
選填
CacheTTLSeconds 是指使用者對應至群組的快取存留時間 (以秒為單位)。
ldapConfiguration.enableGroupMapping
boolean
選填
EnableGroupMapping 是開啟或關閉 AD 群組同步功能的切換鈕。
ldapConfiguration.enableLdapOptReferrals
boolean
選填
EnableLdapOptReferrals 會決定是否啟用 LDAP 參照選項。
ldapConfiguration.ldapBaseDN
string
選填
LDAPBaseDN 是 LDAP 搜尋的基準識別名稱,例如 DC=example,DC=com。
ldapConfiguration.ldapBindDN
string
選填
LDAPBindDN 是要繫結為 LDAP 搜尋的辨別名稱。這是執行群組查詢的服務帳戶使用者,例如 setupadmin@ad-controller.example.com。
ldapConfiguration.ldapBindPasswordSecretRef
object
選填
LDAPBindPasswordSecretRef 是指同一個命名空間中的 Secret,內含 LDAP 繫結使用者的密碼。Secret 必須有名為 password 的資料欄位。
ldapConfiguration.ldapBindPasswordSecretRef.name
string
選填
參照對象的名稱。詳情請參閱「名稱」。
ldapConfiguration.ldapSearchAttribute
string
選填
LDAPSearchAttribute 是要搜尋的 LDAP 屬性,例如 userPrincipalName。
ldapConfiguration.ldapURI
string
選填
LDAPURI 是 LDAPS 或 LDAP 伺服器的 URI,例如 ldap://ad-controller.example.com。
ldapConfiguration.ldapsCertificateSecretRef
object
選填
LDAPSCertificateSecretRef 是選用參照,指向相同命名空間中含有 LDAPS CA 憑證的 Secret。Secret 必須有名為 ldap.crt 的資料欄位。
ldapConfiguration.ldapsCertificateSecretRef.name
string
選填
參照對象的名稱。詳情請參閱「名稱」。

狀態結構定義

UserDefinedAuthenticationStatus 定義 UserDefinedAuthentication 的觀測狀態。

conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
criticalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams: object
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
message: string
observedGeneration: integer
reconciled: boolean
state: string

欄位

類型
必填或選填

 

說明
conditions[]
object
選填
條件代表實體目前狀態的最新可用觀測值。
conditions[].lastTransitionTime
string
必填
lastTransitionTime 是指條件上次從某個狀態轉換為另一個狀態的時間,也就是底層條件變更時。如果基礎條件變更的時間不明,請使用 API 欄位變更的時間。
conditions[].message
string
必填
message 是使用者可解讀的訊息,指出轉換的詳細資料。這個值可以是空白字串。
conditions[].observedGeneration
integer
選填
observedGeneration 代表設定條件時依據的 .metadata.generation。舉例來說,如果 .metadata.generation 為 12,但 .status.conditions[x].observedGeneration 為 9,則條件相對於執行個體的目前狀態已過時。
conditions[].reason
string
必填
reason 包含程式輔助 ID,指出條件上次轉換的原因。特定條件類型的產生者可以定義這個欄位的預期值和意義,以及這些值是否視為穩定的 API。值必須是駝峰式大小寫字串。 這個欄位可能不是空白。
conditions[].status
string
必填
條件狀態,可為 True、False 或 Unknown。
conditions[].type
string
必填
條件類型,採用駝峰式大小寫或 foo.example.com/CamelCase 格式。許多 .condition.type 值在資源之間保持一致,例如 Available。由於任意條件可能很有用 (請參閱 .node.status.conditions),因此解除衝突的能力非常重要。比對的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
criticalIncidents[]
object
選填
CriticalIncidents 是所有有效重大事件的平面清單。
criticalIncidents[].code
string
必填
Code 是這項特定錯誤的錯誤代碼。錯誤代碼為 DBSE+numeric 字串,例如 DBSE1012。
criticalIncidents[].createTime
string
必填
CreateTime 是在來源建立這個事件的時間戳記。
criticalIncidents[].message
string
選填
訊息會說明發生的事件或錯誤。
criticalIncidents[].messageTemplateParams
object
選填
MessageTemplateParams 包含必要鍵/值組合,可在使用者介面中產生容易使用的資料導向訊息版本。
criticalIncidents[].resource
object
必填
資源包含回報事件的資料庫服務元件相關資訊,以及 Kubernetes 資源的相關資訊。
criticalIncidents[].resource.component
string
必填
元件是回報事件的資料庫服務子系統內部 ID。
criticalIncidents[].resource.location
object
選填
位置。
criticalIncidents[].resource.location.cluster
string
選填
受影響 Kubernetes 資源的叢集名稱。
criticalIncidents[].resource.location.group
string
選填
Kubernetes 資源的群組名稱。
criticalIncidents[].resource.location.kind
string
選填
Kubernetes 資源的種類。
criticalIncidents[].resource.location.name
string
選填
受影響 Kubernetes 資源的名稱。
criticalIncidents[].resource.location.namespace
string
選填
受影響 Kubernetes 資源的命名空間。
criticalIncidents[].resource.location.version
string
選填
Kubernetes 資源的版本。
criticalIncidents[].stackTrace[]
object
選填
堆疊追蹤中的非結構化訊息清單。
criticalIncidents[].stackTrace[].component
string
選填
記錄訊息的資料庫服務元件名稱。
criticalIncidents[].stackTrace.message
string
選填
記錄訊息。
criticalIncidents[].transientUntil
string
選填
如果出現 TransientUntil,表示在指定時間之前,問題都必須視為暫時性。
message
string
選填
Message 會提供人類可讀的訊息,詳細說明目前狀態或任何錯誤。
observedGeneration
integer
選填
內部:控制器觀察到的世代。
reconciled
boolean
選填
內部:資源是否已由控制器協調。
state
string
選填
「State」代表 UserDefinedAuthentication 資源目前的狀態。值包括:Processing、Ready、Failed 和 Unknown。