Skip to main content
Esta guía se aplica a computadoras Mac

​
Acerca de la solución de problemas de Passport con Okta

La solución de problemas de Passport con Okta consiste en resolver los problemas de autenticación que se producen al usar Passport con Okta como proveedor de identidad (IdP). Esta guía te ayuda a identificar y resolver problemas habituales de configuración y autenticación específicos de la integración con Okta.

​
Cómo funciona

Cuando se producen problemas de autenticación de Passport con Okta, la solución de problemas consiste en revisar la configuración de la aplicación de Okta, verificar la configuración de OIDC, examinar los flujos de autenticación y resolver las discrepancias de configuración entre Passport y tu inquilino de Okta.

​
Inicio de sesión, diagnóstico y red

Inicia sesión con la dirección de correo electrónico completa

En la ventana de inicio de sesión de Passport, introduce siempre la dirección de correo electrónico completa del usuario en el campo de nombre de usuario para que la sesión use tu IdP en lugar de la autenticación local. Para saber cómo interactúan la ventana de inicio de sesión y la configuración de visibilidad con Passport, consulta Compatibilidad de Passport.

Usa Passport Diagnostics

Si un usuario no puede iniciar sesión, abre Iru Endpoint Passport Diagnostics con Command-Shift-K-L en la Mac. El panel muestra detalles útiles, incluidos los mensajes de error devueltos por tu IdP.

Confirma la conectividad de red

Passport debe poder comunicarse con Okta para validar las credenciales. Cuando personalices la ventana de inicio de sesión de Passport, habilita el administrador de red para que los usuarios puedan conectarse a una red Wi-Fi si es necesario. El control respeta la configuración de seguridad de AirPort en macOS.

Límites de Wi-Fi y pruebas de aislamiento

Passport muestra un icono de Wi-Fi en la parte superior derecha de la ventana de inicio de sesión; los usuarios pueden seleccionarlo para conectarse a una red protegida con contraseña. Passport no admite portales cautivos, páginas de aceptación de clic ni redes empresariales 802.1X que requieran un nombre de usuario y una contraseña independientes en ese flujo. Para aislar problemas de red, prueba con un punto de acceso móvil o Ethernet por cable mientras haces pruebas en la ventana de inicio de sesión de Passport.

​
Errores habituales de Okta

Para buscar códigos de error de la API de Okta, consulta Okta API Error Codes en el sitio para desarrolladores de Okta.
Lo que ves:"error":"Unauthorized","error_description":"Authentication Failed: Invalid user credentials"Qué hacer:
  • Confirma el nombre de usuario y la contraseña con tu IdP. Esta respuesta suele significar que las credenciales no coinciden con lo que Okta espera.
  • Si la solicitud GET a la URL well-known openid-configuration de OIDC devuelve 200, la URL del proveedor de identidad y el Client ID del Library Item de Passport normalmente están llegando correctamente a Okta. En Okta, el mismo valor puede aparecer como Application ID.
Lo que ves:"error":"access_denied","error_description":"End-user does not have access to this application"Qué hacer:
  • En Okta, confirma que el usuario o grupo está asignado a la aplicación OIDC de Passport y que las reglas de inicio de sesión permiten el acceso.
  • Si la solicitud GET a la URL well-known openid-configuration de OIDC devuelve 200, la URL del proveedor de identidad y el Client ID del Library Item de Passport normalmente están llegando correctamente a Okta. En Okta, el mismo valor puede aparecer como Application ID.