Configurar SAML SSO
Single sign-on (SSO) permite que tu equipo inicie sesión en Kliv con las cuentas que ya usa en el trabajo, mediante el proveedor de identidad de tu empresa (el servicio que administra los inicios de sesión de tus empleados, como Okta o Microsoft Entra). No hay una contraseña separada de Kliv que administrar, y cuando alguien se va, quitarlo en un solo lugar también le quita el acceso aquí.
SAML es la forma con mayor compatibilidad para conectar un proveedor de identidad. Esta página te guía para configurarlo, probarlo con un inicio de sesión real y activarlo, en ese orden, para que nada se rompa para tu equipo.
Tú configuras todo esto. No hay ticket de soporte ni llamada con proveedor.
Antes de empezar
- Necesitas una cuenta de administrador con permiso para administrar single sign-on en tu organización.
- Necesitarás acceso a la consola de administración de tu proveedor de identidad (Okta, Entra, Google Workspace, OneLogin u otro proveedor SAML).
- Ten un dominio que puedas verificar: el dominio de correo con el que inicia sesión tu equipo (por ejemplo
yourcompany.com).
Abrir el asistente de configuración
- Ve a User Management → Single Sign-On.
- Elige Set up single sign-on.
- Elige tu proveedor: Okta, Microsoft Entra, Google, OneLogin u Other. Elegir un proveedor conocido precarga la configuración correcta para que tengas menos que copiar a mano.
- Deja el protocolo en SAML (el valor predeterminado). OIDC es una alternativa avanzada; consulta Configurar OIDC SSO.
Intercambiar configuraciones con tu proveedor de identidad
SSO funciona haciendo que tu proveedor de identidad y Kliv confíen entre sí. Das a cada uno algunos detalles del otro:
- Kliv te muestra los valores que necesita tu proveedor (como la URL de inicio de sesión que escucha Kliv). Cópialos en una nueva aplicación SAML en la consola de administración de tu proveedor.
- Tu proveedor te devuelve sus propios detalles, normalmente una metadata URL o un archivo XML, más un certificado de firma. Pega los metadatos (o sube el archivo) en Kliv.
- Asegúrate de que tu proveedor envíe un identificador estable para cada usuario, no solo una dirección de correo electrónico. (El atributo exacto depende del proveedor: el preset nombra cuál usar; confirma la redacción en tu consola.) Este es el valor que Kliv usa para reconocer a una persona que vuelve, incluso si su correo cambia.
Kliv guarda esto como borrador. Un borrador está configurado pero aún no está Live: tu equipo sigue iniciando sesión como lo hace hoy hasta que termines.
Verificar tu dominio
Antes de que Kliv cree cuentas desde tu proveedor, debes demostrar que controlas el dominio de correo que usa tu equipo. Esto evita que alguien reclame un dominio que no le pertenece.
Sigue Verificar tu dominio para agregar un registro DNS o un archivo a tu sitio web. Vuelve aquí cuando muestre Verified.
Probar con un inicio de sesión real
Este es el paso que hace seguro activar SSO: demuestras que todo el viaje de ida y vuelta funciona antes de afectar a alguien.
- En el asistente, elige Test login.
- Se te enviará a tu proveedor de identidad para iniciar sesión, exactamente como lo hará tu equipo.
- Si tiene éxito, Kliv registra la prueba exitosa y desbloquea el botón Turn on.
- Si falla, Kliv te muestra qué esperaba frente a lo que tu proveedor realmente envió; consulta Solucionar un inicio de sesión SSO fallido. Corrígelo en tu proveedor y prueba otra vez.
No puedes activar SSO hasta que un inicio de sesión de prueba haya tenido éxito contra la configuración exacta que estás por activar. Guardar sin más nunca es suficiente.
Activarlo
Una vez que la prueba pasó, elige Turn on. Desde ahora, cuando alguien ingrese una dirección de correo en tu dominio verificado, Kliv lo envía a tu proveedor de identidad para iniciar sesión. Las personas que inician sesión por primera vez obtienen una cuenta de Kliv creada automáticamente, con acceso de miembro estándar.
Los miembros nuevos llegan solo a tu everyone-group. No obtienen acceso de administrador ni ningún rol elevado de tu proveedor de identidad a menos que lo configures deliberadamente; consulta Mapear grupos de IdP a roles de Kliv.
Después de configurar
Tu página Single Sign-On ahora muestra una tarjeta de estado en lugar del asistente: tu proveedor, tu dominio verificado, el último inicio de sesión correcto y una advertencia si tu certificado de firma se acerca a su vencimiento. Presta atención a esa advertencia: un certificado vencido detiene los inicios de sesión hasta que subas uno nuevo.
Para requerir que todos en tu dominio usen SSO (y mantener una forma segura de volver a entrar si alguna vez se rompe), consulta Requerir SSO y definir administradores break-glass.