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

# Configuración de la integración de Google Workspace

> Conecte Google Workspace a Living Security para obtener actividad del ciclo de vida de los usuarios, de inicio de sesión, de MFA, administrativa y de protección de datos.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Recursos relacionados</h2>
    <ul>
      <li>
        <a href="/es/signals/data-sources">Descubra cómo los datos de las integraciones se convierten en señales de Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Explore las integraciones de Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Abra Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Solicite una demostración de Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Introduzca las credenciales en Living Security Platform">
    <p>
      Lo realiza la persona que tenga acceso a Living Security: el responsable del programa o el
      administrador del sistema, si se le ha invitado (configuración delegada).
    </p>
    <ol>
      <li>
        Vaya a <strong>Configuración → Integraciones → Catálogo</strong>, busque el icono de{' '}
        <strong>{tile}</strong> y haga clic en <strong>Conectar</strong>.
      </li>
      <li>
        Complete los campos que se indican a continuación y, a continuación, haga clic en <strong>Conectar</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Esta guía está dirigida al administrador de {system}.</strong> Describe cómo crear
      credenciales de API dentro de {system}, lo que requiere acceso de administrador a {system}, no a
      Living Security Platform.
    </p>
    <p>
      Si usted es el <strong>responsable del programa</strong> de Living Security y no administra {system},
      envíe esta página a la persona que lo haga. Dicha persona completará la Parte A y le entregará las credenciales
      (o las introducirá directamente si usted la ha invitado a la plataforma).
      {recommendDelegated && <>
          {' '}Dado que la configuración genera material de claves confidencial, recomendamos la vía de{' '}
          <strong>configuración delegada</strong>, de modo que el secreto nunca se le envíe a usted.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Google Workspace" recommendDelegated={true} />

## Qué aporta esta integración

Google Workspace puede aportar actividad normalizada del ciclo de vida de los usuarios, de inicio de sesión, de MFA, administrativa y de protección de datos. Algunos ejemplos revisados son:

* `account.compromised` — cuenta marcada como comprometida
* `data.sensitive.downloaded` — descarga datos confidenciales
* `auth.login.unusual` — inicia sesión desde contextos inusuales

Consulte [cómo los datos de la integración se convierten en Señales](/es/signals/data-sources).

## Qué necesita Living Security

| Credencial | Descripción |
| - | - |
| **Clave de cuenta de servicio** | Una clave JSON de una cuenta de servicio dedicada de Google Cloud. |
| **Administrador delegado** | El correo electrónico de un administrador de Google Workspace al que la cuenta de servicio puede suplantar. |

Habilite las API del SDK de Admin y autorice únicamente los ámbitos que lee la conexión:

* `https://www.googleapis.com/auth/admin.reports.audit.readonly`
* `https://www.googleapis.com/auth/admin.directory.user.readonly`
* `https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`

## Configuración

<Steps>
  <Step title="Cree una cuenta de servicio de Google Cloud">
    Cree una cuenta de servicio dedicada, habilite la delegación en todo el dominio y descargue su clave JSON. Almacene la clave de forma segura.
  </Step>

  <Step title="Autorice la delegación en todo el dominio">
    En la consola de administración de Google, abra **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Agregue el ID de cliente numérico de la cuenta de servicio y los tres ámbitos de solo lectura indicados arriba.
  </Step>

  <Step title="Elija el administrador delegado">
    Seleccione un administrador de Workspace activo que pueda leer el directorio, las asignaciones de roles y los informes de auditoría. Living Security utiliza esta identidad únicamente para lecturas delegadas de la API.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Cargue o pegue la credencial de la cuenta de servicio cuando se le solicite e introduzca el correo electrónico del administrador delegado.
  </ConnectInPlatform>
</Steps>

## Verificación y solución de problemas

Verifique que la conexión pueda leer un usuario del directorio y la actividad de inicio de sesión reciente. Google indica que las nuevas concesiones de delegación en todo el dominio pueden tardar en propagarse.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Confirme que la delegación en todo el dominio utiliza el ID de cliente numérico de la cuenta de servicio, y no su dirección de correo electrónico, y que los tres ámbitos coinciden exactamente.
  </Accordion>

  <Accordion title="El directorio funciona, pero faltan las asignaciones de roles">
    Agregue `admin.directory.rolemanagement.readonly` a la entrada de delegación y confirme que el administrador delegado puede ver las asignaciones de roles.
  </Accordion>

  <Accordion title="Los informes están vacíos">
    Confirme que la API de Admin Reports está habilitada y que el administrador delegado puede acceder a los informes de auditoría del inquilino de Workspace.
  </Accordion>
</AccordionGroup>

Para obtener detalles del lado del proveedor, consulte [la guía de Google sobre la delegación en todo el dominio](https://developers.google.com/identity/protocols/oauth2/service-account#delegatingauthority).

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.