3.2. 在 Keycloak 中配置新客户端

对于 Operator 创建的所有 Argo CD 实例，默认安装 Dex。但是，您可以删除 Dex 配置并添加 Keycloak，以使用 OpenShift 凭证登录到 Argo CD。Keycloak 作为 Argo CD 和 OpenShift 之间的身份代理。

流程

要配置 Keycloak，请按照以下步骤执行：

通过从 Argo CD 自定义资源 (CR) 中删除 .spec.sso.dex 参数来删除 Dex 配置，并保存 CR：

dex:
    openShiftOAuth: true
    resources:
      limits:
        cpu:
        memory:
      requests:
        cpu:
        memory:

dex:
    openShiftOAuth: true
    resources:
      limits:
        cpu:
        memory:
      requests:
        cpu:
        memory:

Copy to Clipboard

Toggle word wrap

在 Argo CD CR 中将 provider 参数的值设置为 keycloak。

通过执行以下步骤配置 Keycloak：

对于安全连接，设置 rootCA 参数的值，如下例所示：

apiVersion: argoproj.io/v1beta1
kind: ArgoCD
metadata:
  name: example-argocd
  labels:
    example: basic
spec:
  sso:
    provider: keycloak
    keycloak:
      rootCA: "<PEM-encoded-root-certificate>" 
  server:
    route:
      enabled: true

apiVersion: argoproj.io/v1beta1
kind: ArgoCD
metadata:
  name: example-argocd
  labels:
    example: basic
spec:
  sso:
    provider: keycloak
    keycloak:
      rootCA: "<PEM-encoded-root-certificate>"


  server:
    route:
      enabled: true

Copy to Clipboard

Toggle word wrap

1: 用于验证 Keycloak 的 TLS 证书的自定义证书。

Operator 会协调 .spec.sso.keycloak.rootCA 参数中的更改，并使用 argocd-cm 配置映射中 PEM 编码的 root 证书更新 oidc.config 参数。

对于不安全连接，将 rootCA 参数的值留空，并使用 oidc.tls.insecure.skip.verify 参数，如下所示：

apiVersion: argoproj.io/v1beta1
kind: ArgoCD
metadata:
  name: example-argocd
  labels:
    example: basic
spec:
  extraConfig:
    oidc.tls.insecure.skip.verify: "true"
  sso:
    provider: keycloak
    keycloak:
      rootCA: ""

apiVersion: argoproj.io/v1beta1
kind: ArgoCD
metadata:
  name: example-argocd
  labels:
    example: basic
spec:
  extraConfig:
    oidc.tls.insecure.skip.verify: "true"
  sso:
    provider: keycloak
    keycloak:
      rootCA: ""

Copy to Clipboard

Toggle word wrap

可选：自定义 spec.sso.keycloak 字段，在 ArgoCD CR 中为 keycloak 供应商添加路由名称。使用此功能支持高级路由用例，如在多个 Ingress Controller 分片之间平衡传入的流量负载。

使用以下示例 YAML 在 ArgoCD CR 中添加 host 参数：

ArgoCD CR 示例

apiVersion: argoproj.io/v1alpha1
kind: ArgoCD
metadata:
  name: <resource_name> 
  labels:
    example: route
spec:
  sso:
    provider: keycloak
    keycloak:
     host: <hostname> 
  server:
    ingress:
      enabled: true
    insecure: true

apiVersion: argoproj.io/v1alpha1
kind: ArgoCD
metadata:
  name: <resource_name>


  labels:
    example: route
spec:
  sso:
    provider: keycloak
    keycloak:
     host: <hostname>


  server:
    ingress:
      enabled: true
    insecure: true

Copy to Clipboard

Toggle word wrap

1: 将 <resource_name > 替换为 ArgoCD CR 的名称。
2: 将 <hostname > 替换为主机密钥的名称，如 sso.test.example.com。

要创建 ArgoCD CR，请运行以下命令：

oc create -f <argocd_filename>.yaml -n <your-namespace>

$ oc create -f <argocd_filename>.yaml -n <your-namespace>

Copy to Clipboard

Toggle word wrap

要编辑 ArgoCD CR，请运行以下命令：

oc edit -f <argocd_filename>.yaml -n <your_namespace>

$ oc edit -f <argocd_filename>.yaml -n <your_namespace>

Copy to Clipboard

Toggle word wrap

保存文件以使改变生效。

要应用 ArgoCD CR，请运行以下命令：

oc apply -f <argocd_filename>.yaml -n <your_namespace>

$ oc apply -f <argocd_filename>.yaml -n <your_namespace>

Copy to Clipboard

Toggle word wrap

运行以下命令验证 host 属性是否已添加：

oc get route keycloak -n <your_namespace> -o yaml

$ oc get route keycloak -n <your_namespace> -o yaml

Copy to Clipboard

Toggle word wrap

输出示例

kind: Route
metadata:
  name: keycloak 
  labels:
    application: keycloak
spec:
  host: sso.test.example.com
status:
  ingress:
    - host: sso.test.example.com

kind: Route
metadata:
  name: keycloak


  labels:
    application: keycloak
spec:
  host: sso.test.example.com
status:
  ingress:
    - host: sso.test.example.com

Copy to Clipboard

Toggle word wrap

1: 指定路由的名称。
2: 指定主机密钥的名称。

注意

Keycloak 实例需要 2-3 分钟来安装和运行。

3.2. 在 Keycloak 中配置新客户端

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links