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

# Google Workspace

> Permite que los usuarios inicien sesión en Iru Identity con sus cuentas de Google Workspace mediante la plantilla de conexión integrada para la autenticación federada y el aprovisionamiento.

Conectar **Google Workspace** permite que tus usuarios inicien sesión en Iru (y accedan a las
aplicaciones que les has asignado) con las cuentas de Google que ya tienen. Iru
ofrece una **plantilla de Google Workspace** que rellena previamente la configuración
estándar, por lo que es uno de los proveedores más rápidos de conectar.

<Info>
  La mayoría de las organizaciones que usan Iru Identity como proveedor de identidad hacen que los usuarios
  inicien sesión directamente con una passkey o con la aplicación Iru Access. Conecta Google Workspace
  cuando uses Iru Identity como capa de autenticación para acceder a la plataforma Iru
  en lugar de como tu proveedor de identidad principal, o para facilitar una migración a Iru
  Identity. Consulta [Autenticación federada](/es/identity/connections/connections-overview).
</Info>

<Note>
  Necesitas acceso de administrador a tu tenant de Iru y acceso a la
  consola de administración de Google de tu organización de Google Workspace para completar
  esta conexión.
</Note>

## Antes de empezar

<Steps>
  <Step title="Confirma tus dominios de inicio de sesión">
    Anota los **dominios** de correo electrónico con los que inician sesión tus usuarios (por ejemplo,
    `yourcompany.com`). Puedes restringir la conexión a estos dominios para que solo
    la usen los usuarios que pertenecen a ellos.
  </Step>

  <Step title="Decide cómo asocia Iru a los usuarios">
    Cuando alguien inicia sesión a través de Google, Iru lo asocia con un usuario de tu
    directorio. Decide con qué valor hacer la coincidencia, normalmente el correo electrónico o el
    nombre de usuario. Consulta [coincidencia de usuarios](/es/identity/connections/connections-overview#what-you-configure-on-every-identity-provider-connection).
  </Step>

  <Step title="Asegúrate de que tus usuarios existan en Iru">
    El inicio de sesión a través de una conexión se resuelve en un usuario de Iru existente. Primero añade o importa
    a tus usuarios; consulta [Importar usuarios](/es/identity/directory/importing-users)
    o [Directory Sync](/es/identity/directory/directory-sync).
  </Step>
</Steps>

## Conectar Google Workspace

<Steps>
  <Step title="Añade la conexión">
    En **Access → Authentication**, añade un **método de autenticación** y elige la
    plantilla de **Google Workspace**. Al usar la plantilla, se rellena automáticamente la
    configuración estándar.
  </Step>

  <Step title="Autoriza a Iru con Google">
    Sigue las indicaciones para autorizar a Iru en tu organización de Google Workspace,
    iniciando sesión con una cuenta de **superadministrador** de Google cuando
    se te solicite y aceptando los scopes de inicio de sesión estándar (`openid`, `email` y
    `profile`). Si tu organización proporciona su propio cliente OAuth, créalo en
    la consola de Google Cloud, añade el URI de redirección que Iru muestra para esta conexión
    y copia su client ID y secret en Iru. Las pantallas de la consola de Google pueden
    cambiar; sigue la documentación actual de Google si las indicaciones son diferentes.
  </Step>

  <Step title="Elige para qué se usa la conexión">
    Selecciona los **casos de uso** de la conexión: **inicio de sesión de usuarios finales**, **inscripción
    de dispositivos** o ambos. La mayoría de las configuraciones activan el inicio de sesión de usuarios finales.
  </Step>

  <Step title="Restringe a tus dominios">
    Si quieres que solo los usuarios de determinados dominios de correo electrónico usen esta conexión,
    activa las **restricciones de dominio** y añade esos dominios.
  </Step>

  <Step title="Configura la coincidencia de usuarios">
    Elige cómo asocia Iru un inicio de sesión de Google con un usuario de Iru (por UPN, nombre de usuario,
    ID externo o un atributo personalizado). Elige un valor que sea único y estable
    para cada usuario.
  </Step>

  <Step title="Guarda la conexión">
    Guarda y, a continuación, inicia sesión como usuario de prueba cuyo correo pertenezca a un dominio permitido para
    confirmar que el traspaso a Google funciona de principio a fin.
  </Step>
</Steps>

<Tip>
  Prueba con un solo usuario antes de implementar la conexión de forma generalizada. Si el inicio de sesión
  no llega al usuario correcto, revisa tu elección de **coincidencia de usuarios**; el
  valor de coincidencia debe estar presente y ser único para todas las personas que usan la conexión.
</Tip>

## Cómo funciona el inicio de sesión una vez conectado

Cuando alguien inicia sesión, Iru delega el inicio de sesión en Google, Google confirma al
usuario e Iru continúa la sesión y evalúa la
[política de autenticación](/es/identity/authentication/authentication-policies) de la aplicación
antes de conceder el acceso. Para ver el panorama completo, consulta
[Arquitectura del sistema](/es/identity/getting-started/system-architecture).

## Relacionado

<CardGroup cols={2}>
  <Card title="Autenticación federada" icon="plug" href="/es/identity/connections/connections-overview">
    Casos de uso, restricciones de dominio y coincidencia de usuarios, explicados en un solo lugar.
  </Card>

  <Card title="Microsoft Entra ID" icon="microsoft" href="/es/identity/connections/microsoft-entra-id">
    Conecta Microsoft Entra ID para el inicio de sesión con su propia plantilla.
  </Card>

  <Card title="Experiencia de inicio de sesión" icon="arrow-right-to-bracket" href="/es/identity/authentication/sign-in-experience">
    Define lo que ven los usuarios cuando inician sesión.
  </Card>

  <Card title="SAML personalizado" icon="shield-halved" href="/es/identity/connections/custom-saml">
    Conecta un proveedor que no esté cubierto por una plantilla.
  </Card>
</CardGroup>
