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