|Index|Primeros pasos con SUSE Private Registry|Configurar Rancher como un Proveedor de Identidad OIDC
Applies to SUSE Private Registry

6 Configurar Rancher como un Proveedor de Identidad OIDC

Esta guía explica cómo configurar Rancher para actuar como un Proveedor de Identidad OIDC, permitiendo a los usuarios autenticarse en aplicaciones externas como SUSE Private Registry utilizando sus credenciales de Rancher.

6.1 Paso 1: Habilitar la bandera de característica oidc-provider

  1. Inicia sesión en la interfaz de usuario de Rancher como administrador.

  2. Haz clic en el menú de tres líneas (☰) en la parte superior izquierda y ve a Configuración Global › Banderas de características.

  3. Encuentra la bandera oidc-provider, haz clic en el icono de Más Acciones (⋮) y haz clic en Activar.

Configurar Rancher como un Proveedor de Identidad OIDC

6.2 Paso 2: Crear un recurso OIDCClient

Rancher utiliza un recurso personalizado OIDCClient para registrar aplicaciones en sentido descendente.

  1. Crea un archivo llamado rancher-oidc-client.yaml con el siguiente contenido:

    apiVersion: management.cattle.io/v3
    kind: OIDCClient
    metadata:
      name: spr-client
    spec:
      tokenExpirationSeconds: 600
      refreshTokenExpirationSeconds: 3600
      redirectURIs:
        # Replace this with the actual callback URL of your SUSE private registry instance
        - "https://<SUSE_PRIVATE_REGISTR_URL>/c/oidc/callback"
  2. Aplica el archivo al clúster donde se está ejecutando Rancher:

    >kubectl apply -f rancher-oidc-client.yaml

6.3 Paso 3: Recupera el ID de Cliente y el Secreto

Una vez que se crea el recurso, Rancher completa automáticamente el clientID y provisiona un Secreto Kubernetes que contiene el clientSecret.

  1. Obtén el ID de Cliente generado:

    >kubectl get oidcclient spr-client -o jsonpath="{.status.clientID}"
  2. Obtén el Secreto de Cliente. Recuerda reemplazar <YOUR_CLIENT_ID> con el ID recuperado en el paso anterior:

    >kubectl get secret <YOUR_CLIENT_ID>
      -n cattle-oidc-client-secrets
      -o jsonpath="{.data.client-secret-1}" | base64 -d

6.4 Paso 4: Configurar SUSE Private Registry

Puedes configurar SUSE Private Registry para usar Rancher como su proveedor OIDC pasando los valores a través de Helm. Usa el bloque core.configureUserSettings en tu configuración de values-oidc.yaml.

Lo siguiente es un bloque de ejemplo utilizando tu endpoint de Rancher y las credenciales recuperadas arriba. Reemplaza los valores de <YOUR_CLIENT_ID> y <YOUR_CLIENT_SECRET>.

core:
  configureUserSettings: |
    {
      "auth_mode": "oidc_auth",
      "oidc_name": "Rancher",
      "oidc_endpoint": "<RANCHER_URL>/oidc",
      "oidc_client_id": "<YOUR_CLIENT_ID>",
      "oidc_client_secret": "<YOUR_CLIENT_SECRET>",
      "oidc_scope": "openid,profile,offline_access",
      "oidc_verify_cert": false,
      "oidc_auto_onboard": true,
      "oidc_user_claim": "preferred_username",
      "oidc_groups_claim": "groups",
      "oidc_admin_group": "spr-admins"
    }
Note
Note

Asegúrate de que oidc_verify_cert esté configurado en false si tu instancia de Rancher está utilizando certificados autofirmados. Al especificar oidc_admin_group, cualquier usuario Rancher que pertenezca al grupo spr-admins recibirá automáticamente privilegios de administrador del sistema en SUSE Private Registry.