Solucionar un inicio de sesión SSO fallido

Cuando un inicio de sesión mediante tu proveedor de identidad no funciona, Kliv está diseñado para decirte la corrección real, no solo "no se pudo iniciar sesión". Esta página te muestra dónde mirar y cómo leer lo que encuentres.

Dónde está la respuesta

Hay dos vistas distintas de un inicio de sesión fallido, a propósito:

  • La persona que inicia sesión ve un mensaje simple de "no pudimos iniciar tu sesión" con un ID de referencia breve. No ve el detalle técnico; eso filtraría cómo está configurada tu identidad.
  • Tú, el administrador, ves el diagnóstico completo en el registro de auditoría. Ahí apunta el ID de referencia.

Así que cuando un compañero reporte un inicio de sesión fallido, pídele el ID de referencia y luego búscalo.

Leer el diagnóstico

  1. Ve a User Management → Single Sign-On y abre la pestaña Audit.
  2. Encuentra el inicio de sesión fallido (haz coincidir el ID de referencia, o simplemente mira las entradas más recientes).
  3. Ábrelo para ver el detalle esperado frente a recibido: para cada verificación que ejecuta Kliv, qué esperaba y qué envió realmente tu proveedor. La discrepancia es tu corrección.

Puedes ejecutar el paso Test login en la página Single Sign-On para reproducir un fallo bajo demanda mientras trabajas en él, sin involucrar usuarios reales.

Causas comunes y correcciones

El issuer no coincide (OIDC). El problema de OIDC más frecuente. La issuer URL debe coincidir con tu proveedor carácter por carácter. Los emisores de Microsoft Entra son específicos de tu tenant; Google publica más de una forma. Copia el issuer exacto desde tu propia app del proveedor y pégalo en Kliv.

El certificado de firma venció (SAML). Inicios de sesión que funcionaban ayer fallan de pronto. El certificado de firma de tu proveedor venció. Sube el certificado actual (o actualiza desde los metadatos de tu proveedor). La tarjeta de estado te advierte antes de que esto ocurra; vigílala.

El dominio de correo del usuario no está verificado. Kliv solo crea cuentas para dominios de correo que demostraste controlar. Si un inicio de sesión se rechaza por un dominio no verificado, termina Verificar tu dominio para ese dominio.

La cuenta está desactivada. Si la persona fue desactivada en tu proveedor de identidad o en Kliv, se rechaza el inicio de sesión por diseño: un inicio de sesión SSO nunca reactiva silenciosamente una cuenta deshabilitada. Reactívala en tu proveedor si debe tener acceso.

La identidad (NameID) no es estable. Si tu proveedor envía un identificador diferente cada vez, o envía un correo en lugar de un ID estable, Kliv no puede reconocer de forma confiable a la misma persona. Configura tu proveedor para enviar el identificador estable que especifica el preset.

Un correo no está marcado como "verified." Kliv no requiere esto: identifica a las personas por un identificador estable del proveedor, no por una marca de correo verificado, así que una marca "verified" faltante no es la causa. Mira las otras verificaciones en su lugar.

Si todavía estás bloqueado

El detalle expected-versus-received nombra la verificación específica que falló y ofrece guía consciente del proveedor. Trabaja esa verificación, corrígela en tu proveedor y vuelve a ejecutar Test login. Como la activación requirió una prueba exitosa, una configuración que funcionaba antes y de pronto dejó de funcionar casi siempre es un certificado vencido o un ajuste cambiado del lado de tu proveedor.