Configurar OIDC SSO
OIDC es una alternativa a SAML para conectar tu proveedor de identidad. Ambos permiten que tu equipo inicie sesión con sus cuentas corporativas existentes; OIDC es un protocolo más moderno que algunos proveedores prefieren. Si no estás seguro de cuál usar, usa SAML: es el valor predeterminado y funciona con todos los proveedores admitidos. Recurre a OIDC cuando tu proveedor lo recomienda o cuando SAML no es una opción para ti.
La configuración tiene la misma forma que SAML: configurar, verificar tu dominio, probar y luego activar, con algunos detalles específicos de OIDC.
Antes de empezar
- Una cuenta de administrador con permiso para administrar single sign-on.
- Acceso a la consola de administración de tu proveedor de identidad.
- Un dominio que puedas verificar (el dominio de correo con el que inicia sesión tu equipo).
Abrir el asistente de configuración
- Ve a User Management → Single Sign-On.
- Elige Set up single sign-on.
- Elige tu proveedor y luego cambia el protocolo a OIDC.
Intercambiar configuraciones con tu proveedor de identidad
-
Crea una nueva aplicación OIDC (u "OpenID Connect") en la consola de tu proveedor. Kliv te muestra la URL de redirección que debes pegar.
-
Tu proveedor te da un client ID, un client secret y una issuer URL (la dirección web que identifica el servicio de inicio de sesión de tu proveedor). Pega los tres en Kliv.
-
La issuer URL debe coincidir con tu proveedor exactamente, carácter por carácter. Esto es lo más común que se configura mal:
- Los emisores de Microsoft Entra son específicos de tu tenant e incluyen un identificador largo; cópialo desde tu propia app, no reutilices uno de una guía.
- Google publica su emisor en más de una forma; usa exactamente el que muestra tu consola.
Si el emisor está aunque sea ligeramente distinto, se rechazan inicios de sesión válidos. El paso de prueba de abajo te dirá si este es el problema.
Kliv guarda esto como borrador: configurado, pero no Live. Tu equipo sigue iniciando sesión como lo hace hoy hasta que termines.
Verificar tu dominio
Como con SAML, Kliv no creará cuentas desde tu proveedor hasta que hayas demostrado que controlas el dominio de correo. Sigue Verificar tu dominio y luego vuelve aquí cuando muestre Verified.
Probar con un inicio de sesión real
- Elige Test login.
- Inicia sesión en tu proveedor exactamente como lo hará tu equipo.
- Si tiene éxito, Kliv registra la prueba y desbloquea Turn on.
- Si falla, Kliv muestra el detalle de lo esperado frente a lo recibido para que puedas corregir el emisor, secreto o redirección; consulta Solucionar un inicio de sesión SSO fallido.
Activarlo
Una vez que un inicio de sesión de prueba tuvo éxito, elige Turn on. Las personas en tu dominio verificado ahora se envían a tu proveedor para iniciar sesión, y los primeros inicios de sesión crean automáticamente una cuenta de miembro estándar.
Los miembros nuevos obtienen solo acceso de miembro, sin rol elevado a menos que configures mapeo de grupos.
Una nota sobre la identidad del usuario
OIDC identifica a cada persona por un par estable de valores de tu proveedor, no por su dirección de correo electrónico. Esto es deliberado: significa que una persona mantiene la misma cuenta de Kliv aunque cambie su correo, y significa que Kliv no depende de que tu proveedor marque un correo como "verified" (algunos proveedores no envían eso para cuentas de trabajo). No tienes que configurar nada para esto; solo es útil saber por qué un cambio de correo no crea una cuenta duplicada.