> ## 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 de problemas de Passport con Okta

> Soluciona problemas de Passport con Okta en Iru Endpoint. Resuelve fallos de inicio de sesión, errores de actualización de tokens, problemas de sincronización de contraseñas y conflictos de configuración.

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

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

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

### Errores habituales de Okta

Para buscar códigos de error de la API de Okta, consulta [Okta API Error Codes](https://developer.okta.com/docs/reference/error-codes/) en el sitio para desarrolladores de Okta.

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