4.11. 使用 Dex 为 Argo CD 配置 SSO
安装 Red Hat OpenShift GitOps Operator 后,Argo CD 会自动创建一个具有 admin 权限的用户。要管理多个用户,集群管理员可以使用 Argo CD 来配置 Single Sign-On(SSO)。
ArgoCD CR 中的 spec.dex 参数已弃用。在以后的 Red Hat OpenShift GitOps v1.9 发行版本中,计划使用 ArgoCD CR 中的 spec.dex 参数配置 Dex。考虑改用 .spec.sso 参数。
4.11.1. 启用 Dex OpenShift OAuth 连接器
Dex 通过检查平台提供的 OAuth 服务器,使用 OpenShift 中定义的用户和组。以下示例显示了 Dex 的属性以及示例配置:
apiVersion: argoproj.io/v1alpha1
kind: ArgoCD
metadata:
name: example-argocd
labels:
example: openshift-oauth
spec:
dex:
openShiftOAuth: true 1
groups:2
- default
rbac:3
defaultPolicy: 'role:readonly'
policy: |
g, cluster-admins, role:admin
scopes: '[groups]'4.11.1.1. 将用户映射到特定的角色
如果有直接 ClusterRoleBinding 角色,Argo CD 无法将用户映射到特定角色。您可以通过 OpenShift,手动更改 SSO 上的 role:admin 角色。
流程
创建名为
cluster-admins的组。$ oc adm groups new cluster-admins
将用户添加到组。
$ oc adm groups add-users cluster-admins USER
将
cluster-adminClusterRole应用到组:$ oc adm policy add-cluster-role-to-group cluster-admin cluster-admins
4.11.2. 禁用 Dex
对于 Operator 创建的所有 Argo CD 实例,默认安装 Dex。您可以通过设置 .spec.dex 参数,将 Red Hat OpenShift GitOps 配置为使用 Dex 作为 SSO 身份验证提供程序。
在 Red Hat OpenShift GitOps v1.6.0 中,DISABLE_DEX 已被弃用,计划在 Red Hat OpenShift GitOps v1.9.0 中删除。请考虑使用 .spec.sso.dex 参数。请参阅 "使用 .spec.sso 启用或禁用 Dex"。
流程
在 Operator 的
YAML资源中将环境变量DISABLE_DEX设置为 true:... spec: config: env: - name: DISABLE_DEX value: "true" ...
4.11.3. 使用 .spec.sso 启用或禁用 Dex
您可以通过设置 .spec.sso 参数,将 Red Hat OpenShift GitOps 配置为使用 Dex 作为其 SSO 身份验证供应商。
流程
要启用 Dex,请在 Operator 的 YAML 资源中设置
.spec.sso.provider: dex参数:... spec: sso: provider: dex dex: openShiftOAuth: true ...-
要禁用 dex,可以从 Argo CD 自定义资源中删除
spec.sso元素,或指定不同的 SSO 供应商。