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

​
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 tu IdP 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.

​
Asegura el apellido (familyName) en tu IdP

Passport requiere un valor familyName en los atributos de usuario del IdP. Completa Last name o el campo de apellido equivalente en cada cuenta que inicie sesión con Passport, incluidas las cuentas de servicio que uses para pruebas.

​
IdP compatibles con Passport

Los IdP compatibles actualmente con Iru Endpoint Passport son Google Workspace, Microsoft Entra ID, Okta y OneLogin.

​
Requisitos de Passport al usar otros IdP

La configuración de Passport requiere los flujos OIDC y ROPG (Resource Owner Password Grant) para funcionar. Consulta con tu IdP para verificar que admite estas funciones. Aunque Iru ofrece la opción de elegir Inicio de sesión de Mac o Inicio de sesión web, configura Passport primero con Inicio de sesión de Mac, ya que puede haber factores adicionales al configurar Inicio de sesión web. Puedes consultar como referencia las configuraciones compatibles con Google Workspace, Microsoft Entra ID, Okta u OneLogin. Si no usas uno de los proveedores de identidad anteriores, es posible que aún puedas configurar Passport con la opción Otro.

​
Configurar otro IdP

​
Configuración de autenticación

  • Al configurar un IdP distinto de Google Workspace, Microsoft Entra ID, Okta u OneLogin, selecciona la opción Otro en el menú desplegable Proveedor de identidad.

​
Modo de autenticación

  • Si no usas autenticación multifactor (MFA), debes elegir Inicio de sesión de Mac.
  • Si sí usas autenticación multifactor (MFA), debes elegir Inicio de sesión web.

​
Inicio de sesión de Mac

1

Introduce la URL del proveedor de identidad

Introduce la URL del proveedor de identidad.
2

Introduce el Client ID

Introduce el Client ID de la app de Passport que creaste en tu IdP (también puede llamarse App ID)

​
Inicio de sesión web

1

Introduce la URL del proveedor de identidad

Introduce la Identity Provider URL
2

Introduce el Client ID

Introduce el Client ID de la app de Passport que creaste en tu IdP (también puede llamarse App ID)
3

Configura la compatibilidad con PKCE y POST

Al usar Inicio de sesión web, tu app debe admitir tanto la autenticación PKCE (Proof Key for Code Exchange) como la autenticación POST. Algunos IdP pueden requerir configurar dos apps distintas.
4

Establece el Redirect URI

En la mayoría de los casos, el Redirect URI debe ser el Redirect URI predeterminado de tu IdP.

​
Solución de problemas

Hay muchos factores que considerar al solucionar problemas de Passport cuando se selecciona la opción Otro como IdP de Passport. Esta sección te ayuda a capturar errores, comprenderlos y ajustar la configuración.
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.
  • 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 al IdP. Es posible que tu IdP llame al identificador de cliente Application ID.
Lo que ves:"error":"access_denied","error_description":"End-user does not have access to this application"Qué hacer:
  • En tu IdP, confirma que el usuario o grupo puede acceder a la aplicación OIDC de Passport y que las reglas de inicio de sesión o de acceso lo permiten.
  • 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 al IdP. Es posible que tu IdP llame al identificador de cliente Application ID.
Lo que ves:Ticket decode failed. Failed to login with possible error: UnknownQué hacer:
  • Elimina el Client secret opcional del Library Item de Passport, deja que el dispositivo se registre, cierra la sesión del usuario local y vuelve a iniciar sesión con Passport.
  • Si el error persiste, descarta problemas de red con un punto de acceso móvil en la ventana de inicio de sesión de Passport.
Lo que ves:An error occurred fetching user info: No key was found matching “familyName”Qué hacer:
  • Completa Last name o el campo de apellido equivalente del usuario en tu IdP. Passport requiere ese atributo.
Si sigues teniendo problemas con Passport, ponte en contacto con el soporte.

​
Búsqueda de códigos de error

Muchos IdP generan sus propios códigos de error específicos. Consulta con tu IdP si tiene una página de búsqueda para obtener más información sobre el error concreto que recibes. Un ejemplo es el formulario de códigos de error de Microsoft para buscar errores de Microsoft Entra ID.

​
Artículos relacionados

Compatibilidad de Passport con macOS y las funciones de Iru Endpoint

Compatibilidad de Passport con macOS y las funciones de Iru

Administrar contraseñas con Passport

Cómo administrar contraseñas con Passport.