16.3. 声明性配置示例
您可以使用以下示例创建声明配置作为指南。使用 roxctl declarative-config lint
命令来验证您的配置是否有效。
16.3.1. 声明性配置身份验证供应商示例
声明性配置身份验证供应商示例
name: A sample auth provider minimumRole: Analyst 1 uiEndpoint: central.custom-domain.com:443 2 extraUIEndpoints: 3 - central-alt.custom-domain.com:443 groups: 4 - key: email 5 value: example@example.com role: Admin 6 - key: groups value: reviewers role: Analyst requiredAttributes: 7 - key: org_id value: "12345" claimMappings: 8 - path: org_id value: my_org_id oidc: 9 issuer: sample.issuer.com 10 mode: auto 11 clientID: CLIENT_ID clientSecret: CLIENT_SECRET clientSecret: CLIENT_SECRET iap: 12 audience: audience saml: 13 spIssuer: sample.issuer.com metadataURL: sample.provider.com/metadata saml: 14 spIssuer: sample.issuer.com cert: | 15 ssoURL: saml.provider.com idpIssuer: idp.issuer.com userpki: certificateAuthorities: | 16 certificate 17 openshift: 18 enable: true
- 1
- 标识默认分配给任何用户登录的最小角色。如果留空,则值为
None
。 - 2
- 使用 Central 实例的用户界面端点。
- 3
- 如果您的 Central 实例公开给不同的端点,请在此处指定它们。
- 4
- 这些字段根据用户的属性将用户映射到特定的角色。
- 5
- 密钥可以是从身份验证提供程序返回的任何声明。
- 6
- 标识用户被授予的角色。您可以使用默认角色或声明性创建的角色。
- 7
- 可选: 如果需要从身份验证供应商返回的属性,请使用这些字段;例如,如果使用者仅限于特定的机构或组。
- 8
- 可选: 如果从身份提供程序返回的声明应映射到自定义声明,请使用这些字段。
- 9
- 本节只适用于 OpenID Connect (OIDC)身份验证供应商。
- 10
- 标识令牌的预期签发者。
- 11
- 标识 OIDC 回调模式。可能的值有
auto
、post
、query
和fragment
。首选的值为auto
。 - 12
- 本节只适用于 Google Identity-Aware Proxy (IAP)身份验证供应商。
- 13
- 本节只适用于安全断言标记语言(SAML) 2.0 动态配置身份验证提供程序。
- 14
- 本节只适用于 SAML 2.0 静态配置身份验证供应商。
- 15
- 以 Privacy Enhanced Mail (PEM)格式包括证书。
- 16
- 本节只适用于使用用户证书进行身份验证。
- 17
- 以 PEM 格式包含证书。
- 18
- 本节只适用于 OpenShift Auth 身份验证提供程序。
16.3.2. 声明性配置权限集示例
声明性配置权限集示例
name: A sample permission set description: A sample permission set created declaratively resources: - resource: Integration 1 access: READ_ACCESS 2 - resource: Administration access: READ_WRITE_ACCESS
16.3.3. 声明性配置访问范围示例
声明性配置访问范围示例
name: A sample access scope description: A sample access scope created declaratively rules: included: - cluster: secured-cluster-A 1 namespaces: - namespaceA - cluster: secured-cluster-B 2 clusterLabelSelectors: - requirements: key: kubernetes.io/metadata.name operator: IN 3 values: - production - staging - environment
16.3.4. 声明性配置角色示例
声明性配置角色示例
name: A sample role description: A sample role created declaratively permissionSet: A sample permission set 1 accessScope: Unrestricted 2