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

# Integración de directorio de usuarios con Google Workspace

> Conecta Google Workspace a Iru Endpoint para sincronizar usuarios y grupos. Completa el inicio de sesión de Google, los permisos y la configuración del directorio.

### Integración de directorio de usuarios con Google Workspace

La integración de Google Workspace en Iru Endpoint sincroniza los objetos de usuario y grupo de Google Workspace con el directorio de usuarios de Iru Endpoint. Iru Endpoint usa estos permisos delegados a través de la API de Google para sincronizar esa información del directorio. Para saber por qué es importante la integración de directorio, así como sobre los filtros del marketplace, la sincronización, la reautenticación y la eliminación, consulta [Descripción general y proveedores de la integración de directorio de usuarios](/es/endpoint/integrations/directory-services/user-directory-integration).

### Agregar una integración de Google Workspace

<Steps>
  <Step title="Abre Integrations">
    En la barra lateral, selecciona el [**Botón del menú de la cuenta**](/es/iru/platform-overview/account-menu) y, a continuación, selecciona **Integraciones**.

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-integrations.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=e89fa7e9b81ac504a6f519608e10b8a3" alt="Captura de pantalla del menú de la cuenta con la opción Integrations resaltada" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
    </Frame>
  </Step>

  <Step title="Explora todas las integraciones">
    Selecciona **Explorar todas las integraciones** en la parte superior derecha de la página Integrations.
  </Step>

  <Step title="Selecciona Google Workspace">
    Selecciona el mosaico **Google Workspace**.
  </Step>

  <Step title="Inicia la configuración">
    Selecciona **Get Started**.
  </Step>

  <Step title="Introduce el nombre de la integración">
    Introduce un nombre único, que se usará en Iru Endpoint para mostrar el directorio del que procede un usuario.
  </Step>

  <Step title="Inicia sesión con Google">
    Selecciona **Sign in with Google**.
  </Step>

  <Step title="Completa la autenticación">
    Inicia sesión con una cuenta de Google con acceso de administrador al directorio que quieres integrar.
  </Step>

  <Step title="Confirma los permisos de la cuenta">
    Revisa la información básica de la cuenta que solicita Iru Endpoint y, a continuación, selecciona **Continuar**.

    <Note>
      Cuando concedes acceso en Google, Google sigue llamando a esta app **Kandji** <img className="inline dark:hidden" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-light-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3ac73eb9098c090ac2838a4902a70e35" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-light-icon.png" /><img className="hidden dark:inline" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-dark-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=1d4b643c8e1903aabdb072fdf211f2de" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-dark-icon.png" />. Permite que la app **Kandji** conecte tu directorio de Google Workspace a Iru Endpoint.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-directory-sign-in.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=825f25759f2648293f647e6c3fcfa1ba" alt="Pantalla de Google Sign in to Kandji que solicita el nombre, la foto de perfil y la dirección de correo, con Continue resaltado" width="1080" height="625" data-path="assets/media/images/iru-google-directory-sign-in.png" />
    </Frame>
  </Step>

  <Step title="Selecciona todos los permisos">
    En la pantalla de permisos, marca la casilla **Select all**.

    <Note>
      Cuando [vuelvas a autenticar la integración](/es/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration), vuelve a seleccionar **Select all** y, a continuación, selecciona **Continuar**. Volver a autenticar no restaura el acceso a tus usuarios y grupos a menos que vuelvas a conceder esos permisos.
    </Note>
  </Step>

  <Step title="Concede acceso a usuarios y grupos">
    Confirma que **View groups on your domain** y **See info about users on your domain** están seleccionados y, a continuación, selecciona **Continuar**.

    <Frame>
      <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-directory-grant-user-and-group-access.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=0e99bc87005fc0c2129c1c6649c1c989" alt="Pantalla de acceso de Google con Select all, View groups on your domain y See info about users on your domain seleccionados, con Continue resaltado" width="1072" height="710" data-path="assets/media/images/iru-google-directory-grant-user-and-group-access.png" />
    </Frame>

    <Note>
      Si continúas sin permitir que Iru Endpoint vea los grupos de tu dominio y la información sobre los usuarios de tu dominio, la integración se conecta correctamente, pero tus usuarios y grupos no se sincronizan correctamente. Para corregirlo, [vuelve a autenticar la integración](/es/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration) y concede todos los permisos solicitados.
    </Note>
  </Step>

  <Step title="Confirma la integración">
    Verás el nuevo directorio de usuarios en la página **Integraciones**.
  </Step>
</Steps>

Una vez conectada la integración, puedes [ver información adicional](/es/endpoint/integrations/directory-services/user-directory-integration#view-additional-information-about-a-directory-integration), [forzar una sincronización del directorio de usuarios](/es/endpoint/integrations/directory-services/user-directory-integration#force-a-user-directory-sync), [volver a autenticar](/es/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration) o [eliminar la integración](/es/endpoint/integrations/directory-services/user-directory-integration#remove-a-directory-integration).

### Permisos de Google Workspace

Los siguientes permisos se solicitan automáticamente y son necesarios para sincronizar correctamente los usuarios de Google Workspace con Iru Endpoint. Un administrador de Google debe tener permisos suficientes para delegar los siguientes permisos a Iru Endpoint.

| Permiso | Texto mostrado | Justificación |
| - | - | - |
| openid | See info about users on your domain | Asociarte con tu información personal en Google |
| userinfo.profile | See info about users on your domain | Ver tu información personal, incluida cualquier información personal que hayas hecho pública |
| userinfo.email | See info about users on your domain | Ver la dirección de correo principal de tu cuenta de Google |
| admin.directory.group.readonly | View groups on your domain | Ver los detalles (p. ej., nombre, miembros) y los metadatos (p. ej., detalles de inicio de sesión) de los grupos de tu dominio |
| admin.directory.user.readonly | See info about users on your domain | Permiso para ver la información de perfil de los usuarios de tu dominio, como: nombre, correo, cargo y departamento |

### Solución de problemas de sincronización de usuarios y grupos

Si los usuarios o grupos no aparecen en Iru Endpoint después de conectar la integración, realiza las siguientes comprobaciones en orden.

<AccordionGroup>
  <Accordion title="Los usuarios y grupos no se sincronizan después de conectar la integración" icon="arrows-rotate">
    La causa más común es un consentimiento incompleto. Si el administrador continuó más allá de la pantalla de permisos de Google sin seleccionar todos los permisos, la integración se conecta e informa de que se realizó correctamente, pero Iru Endpoint no puede leer tu directorio.

    [Vuelve a autenticar la integración](/es/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration), marca la casilla **Select all** en la pantalla de permisos y, a continuación, selecciona **Continuar**. Cuando la integración se vuelva a conectar, [fuerza una sincronización del directorio de usuarios](/es/endpoint/integrations/directory-services/user-directory-integration#force-a-user-directory-sync) en lugar de esperar a la próxima sincronización de cuatro horas.
  </Accordion>

  <Accordion title="Confirma que el administrador puede leer usuarios y grupos" icon="user-shield">
    Iru Endpoint lee tu directorio con los privilegios del administrador que autorizó la integración, por lo que esa cuenta necesita acceso de lectura tanto a usuarios como a grupos.

    En la consola de administración de Google, ve a **Directorio** > **Usuarios**, selecciona la cuenta que usaste para autorizar la integración y abre **Admin roles and privileges**. Abre cada rol asignado y confirma que concede privilegios de lectura para usuarios y grupos.

    La Directory API pertenece al Google Admin SDK y está limitada a los administradores. Cuando la cuenta no tiene esos privilegios, Google devuelve un error `403 Not Authorized to access this resource/api` y no llega ningún dato del directorio a Iru Endpoint. Para ver la lista completa de ámbitos, consulta [Choose Directory API scopes](https://developers.google.com/workspace/admin/directory/v1/guides/authorizing) de Google.
  </Accordion>

  <Accordion title="Confirma que Google Workspace permite que Iru Endpoint acceda a los datos del directorio" icon="shield-check">
    Los administradores de Google Workspace pueden restringir qué aplicaciones acceden a las API de Google Workspace, lo que bloquea la sincronización aunque la pantalla de consentimiento parezca correcta.

    En la consola de administración de Google, ve a **Seguridad** > **Access and data control** > **API controls** > **App access control** y confirma que la app OAuth que usa Iru Endpoint es **Trusted** en lugar de **Limited** o **Blocked**. En la pantalla de consentimiento de Google, esa app sigue llamándose **Kandji**.

    Para obtener detalles sobre el comportamiento de estos controles, consulta [Control which apps access Google Workspace data](https://knowledge.workspace.google.com/admin/apps/control-which-apps-access-google-workspace-data) de Google.
  </Accordion>

  <Accordion title="Autoriza con la cuenta correcta en una ventana de navegación privada" icon="user-lock">
    Google aplica el consentimiento a la cuenta con la que se ha iniciado sesión en ese momento, por lo que una sesión existente de una cuenta que no es de administrador puede autorizar la integración con el usuario equivocado.

    Abre una ventana de navegación privada en [Safari](https://support.apple.com/guide/safari/browse-in-private-ibrw1069/mac) o una ventana de incógnito en [Chrome](https://support.google.com/chrome/answer/95464), cierra cualquier otra ventana del navegador que tenga una sesión de Google y, a continuación, inicia sesión en Iru Endpoint y [vuelve a autenticar la integración](/es/endpoint/integrations/directory-services/user-directory-integration#re-authenticate-a-directory-integration) con la cuenta de administrador correcta.
  </Accordion>
</AccordionGroup>

### Desconectar la integración de Google

<Steps>
  <Step title="Accede a los permisos de Google">
    Ve a [https://myaccount.google.com/permissions.](https://myaccount.google.com/permissions) Asegúrate de haber iniciado sesión con la misma cuenta que configuró originalmente la integración.
  </Step>

  <Step title="Quita la aplicación Kandji">
    Selecciona **Quitar** para la aplicación **Kandji** en la lista de aplicaciones. Google sigue llamando a esta app **Kandji**.
  </Step>
</Steps>
