> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución avanzada de problemas de Passport

> Soluciona problemas avanzados de Passport en Iru Endpoint. Diagnostica fallos de actualización de tokens, problemas de sincronización con el IdP, errores de llavero y bucles de inicio de sesión.

<Callout icon="apple" color="#B84A7A" iconType="regular">Esta guía se aplica a computadoras Mac</Callout>

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

<CardGroup cols={2}>
  <Card title="Inicia sesión con la dirección de correo electrónico completa" icon="user">
    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](/es/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features#login-window).
  </Card>

  <Card title="Usa Passport Diagnostics" icon="display">
    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.
  </Card>

  <Card title="Confirma la conectividad de red" icon="wifi">
    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.
  </Card>

  <Card title="Límites de Wi-Fi y pruebas de aislamiento" icon="triangle-exclamation">
    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.
  </Card>
</CardGroup>

### 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](/es/endpoint/library/passport/google-workspace/passport-configuration-with-google-workspace), [Microsoft Entra ID](/es/endpoint/library/passport/microsoft-entra-id/passport-troubleshooting-with-microsoft-entra-id-formerly-azure-ad), [Okta](/es/endpoint/library/passport/okta/passport-configuration-with-okta) y [OneLogin](/es/endpoint/library/passport/onelogin/passport-configuration-with-onelogin).

### Requisitos de Passport al usar otros IdP

La [configuración de Passport](/es/endpoint/library/passport/configure-the-passport-library-item) 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.

* [Configuración de Passport con Google Workspace](/es/endpoint/library/passport/google-workspace/passport-configuration-with-google-workspace)
* [Configuración de Passport con Microsoft Entra ID (antes Azure AD)](/es/endpoint/library/passport/microsoft-entra-id/configure-passport-with-microsoft-entra-id-mac-login)
* [Configuración de Passport con Okta](/es/endpoint/library/passport/okta/passport-configuration-with-okta)
* [Configuración de Passport con OneLogin](/es/endpoint/library/passport/onelogin/passport-configuration-with-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

<Steps>
  <Step title="Introduce la URL del proveedor de identidad">
    Introduce la **URL del proveedor de identidad**.
  </Step>

  <Step title="Introduce el Client ID">
    Introduce el **Client ID** de la app de Passport que creaste en tu IdP (también puede llamarse App ID)
  </Step>
</Steps>

#### Inicio de sesión web

<Steps>
  <Step title="Introduce la URL del proveedor de identidad">
    Introduce la **Identity Provider URL**
  </Step>

  <Step title="Introduce el Client ID">
    Introduce el **Client ID** de la app de Passport que creaste en tu IdP (también puede llamarse App ID)
  </Step>

  <Step title="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.
  </Step>

  <Step title="Establece el Redirect URI">
    En la mayoría de los casos, el **Redirect URI** debe ser el Redirect URI predeterminado de tu IdP.
  </Step>
</Steps>

### 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.

<AccordionGroup>
  <Accordion title="POST token 401: credenciales de usuario no válidas">
    **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**.
  </Accordion>

  <Accordion title="POST token 403: el usuario no puede acceder a la app de Passport">
    **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**.
  </Accordion>

  <Accordion title="Ticket Decode failed">
    **Lo que ves:**

    Ticket decode failed. Failed to login with possible error: Unknown

    **Qué 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.
  </Accordion>

  <Accordion title="No key was found matching familyName">
    **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.
  </Accordion>
</AccordionGroup>

Si sigues teniendo problemas con Passport, [ponte en contacto con el soporte](/es/iru/iru-support/support-customer-portal).

#### 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](https://login.microsoftonline.com/error) de Microsoft para buscar errores de Microsoft Entra ID.

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Compatibilidad de Passport con macOS y las funciones de Iru Endpoint" icon="apple" href="/es/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features">
    Compatibilidad de Passport con macOS y las funciones de Iru
  </Card>

  <Card title="Administrar contraseñas con Passport" icon="key" href="/es/endpoint/library/passport/managing-passwords-with-passport">
    Cómo administrar contraseñas con Passport.
  </Card>
</CardGroup>