> ## 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ó de la integració de Google Workspace

> Connecteu Google Workspace a Living Security per obtenir activitat del cicle de vida dels usuaris, d'inici de sessió, d'MFA, administrativa i de protecció de dades.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Recursos relacionats</h2>
    <ul>
      <li>
        <a href="/ca/signals/data-sources">Descobriu com les dades d'integració es converteixen en Signals de Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Exploreu les Integrations de Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Obriu la Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Sol·liciteu una demostració de Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Introduïu les credencials a la Living Security Platform">
    <p>
      Ho ha de dur a terme qui tingui accés a Living Security: el responsable del programa o
      l'administrador del sistema, si ha estat convidat (configuració delegada).
    </p>
    <ol>
      <li>
        Aneu a <strong>Settings → Integrations → Catalog</strong>, cerqueu la icona de{' '}
        <strong>{tile}</strong> i feu clic a <strong>Connect</strong>.
      </li>
      <li>
        Ompliu els camps següents i, a continuació, feu clic a <strong>Connect</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Aquesta guia és per a l'administrador o administradora de {system}.</strong> Explica com crear
      credencials d'API dins de {system}, cosa que requereix accés d'administració a {system}, no
      a la Living Security Platform.
    </p>
    <p>
      Si sou el <strong>responsable del programa</strong> de Living Security i no administreu {system},
      envieu aquesta pàgina a la persona que ho faci. Aquesta persona completarà la Part A i us lliurarà les credencials
      (o les introduirà directament si l'heu convidada a la plataforma).
      {recommendDelegated && <>
          {' '}Com que la configuració genera material de claus sensible, recomanem seguir el procés de{' '}
          <strong>configuració delegada</strong>, de manera que el secret no se us enviï mai.
        </>}
    </p>
  </Note>;

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

## Què aporta aquesta integració

Google Workspace pot aportar activitat normalitzada del cicle de vida dels usuaris, d'inici de sessió, d'MFA, administrativa i de protecció de dades. Alguns exemples revisats són:

* `account.compromised` — compte marcat com a compromès
* `data.sensitive.downloaded` — descarrega dades sensibles
* `auth.login.unusual` — inicia sessió des de contextos inusuals

Consulteu [com les dades de la integració es converteixen en Signals](/ca/signals/data-sources).

## Què necessita Living Security

| Credencial | Descripció |
| - | - |
| **Service-account key** | Una clau JSON d'un compte de servei de Google Cloud dedicat. |
| **Delegated administrator** | Un correu electrònic d'administrador de Google Workspace que el compte de servei pot suplantar. |

Activeu les API d'Admin SDK i autoritzeu només els àmbits que la connexió llegeix:

* `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ó

<Steps>
  <Step title="Creeu un compte de servei de Google Cloud">
    Creeu un compte de servei dedicat, activeu la delegació a tot el domini i baixeu-ne la clau JSON. Deseu la clau de manera segura.
  </Step>

  <Step title="Autoritzeu la delegació a tot el domini">
    A la Google Admin Console, obriu **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Afegiu-hi l'identificador de client numèric del compte de servei i els tres àmbits de només lectura indicats més amunt.
  </Step>

  <Step title="Trieu l'administrador delegat">
    Seleccioneu un administrador actiu de Workspace que pugui llegir el directori, les assignacions de rols i els informes d'auditoria. Living Security utilitza aquesta identitat únicament per a lectures delegades de l'API.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Carregueu o enganxeu la credencial del compte de servei quan se us demani i introduïu el correu electrònic de l'administrador delegat.
  </ConnectInPlatform>
</Steps>

## Verificació i resolució de problemes

Verifiqueu que la connexió pot llegir un usuari del directori i l'activitat d'inici de sessió recent. Google indica que les noves concessions de delegació a tot el domini poden trigar a propagar-se.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Comproveu que la delegació a tot el domini utilitza l'identificador de client numèric del compte de servei, no la seva adreça de correu electrònic, i que els tres àmbits coincideixen exactament.
  </Accordion>

  <Accordion title="El directori funciona però falten les assignacions de rols">
    Afegiu `admin.directory.rolemanagement.readonly` a l'entrada de delegació i comproveu que l'administrador delegat pot veure les assignacions de rols.
  </Accordion>

  <Accordion title="Els informes són buits">
    Comproveu que l'API Admin Reports està activada i que l'administrador delegat pot accedir als informes d'auditoria de l'inquilí de Workspace.
  </Accordion>
</AccordionGroup>

Per obtenir detalls del proveïdor, consulteu [la guia de delegació a tot el domini de Google](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.