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

# Installatie van de Google Workspace-integratie

> Koppel Google Workspace aan Living Security voor activiteiten op het gebied van gebruikerslevenscyclus, aanmelding, MFA, beheer en gegevensbescherming.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Gerelateerde bronnen</h2>
    <ul>
      <li>
        <a href="/nl/signals/data-sources">Lees hoe integratiegegevens worden omgezet in Human Risk Management-signalen</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Ontdek de integraties van Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Open het Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Vraag een demo van Living Security aan</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Voer de inloggegevens in het Living Security Platform in">
    <p>
      Uit te voeren door degene die toegang heeft tot Living Security — de programma-eigenaar, of de
      systeembeheerder als deze is uitgenodigd (gedelegeerde installatie).
    </p>
    <ol>
      <li>
        Ga naar <strong>instellingen → Integraties → Catalog</strong>, zoek de tegel{' '}
        <strong>{tile}</strong> en klik op <strong>verbinden</strong>.
      </li>
      <li>
        Vul de onderstaande velden in en klik vervolgens op <strong>verbinden</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Deze handleiding is bedoeld voor uw {system}-beheerder.</strong> Hierin wordt beschreven hoe u API-referenties aanmaakt in {system}. Hiervoor is beheerderstoegang tot {system} vereist, niet tot het
      Living Security Platform.
    </p>
    <p>
      Als u de <strong>programma-eigenaar</strong> van Living Security bent en {system} niet beheert,
      stuur deze pagina dan door naar de persoon die dat wel doet. Die persoon voltooit deel A en geeft de referenties aan u terug
      (of voert ze rechtstreeks in als u diegene hebt uitgenodigd voor het platform).
      {recommendDelegated && <>
          {' '}Omdat tijdens de installatie gevoelig sleutelmateriaal wordt gegenereerd, raden wij het{' '}
          <strong>gedelegeerde installatietraject</strong> aan, zodat het geheim nooit naar u wordt teruggestuurd.
        </>}
    </p>
  </Note>;

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

## Wat deze integratie bijdraagt

Google Workspace kan genormaliseerde activiteitsgegevens aanleveren over de gebruikerslevenscyclus, aanmelding, MFA, beheer en gegevensbescherming. Beoordeelde voorbeelden zijn:

* `account.compromised` — account gemarkeerd als gecompromitteerd
* `data.sensitive.downloaded` — downloadt gevoelige gegevens
* `auth.login.unusual` — meldt zich aan vanuit ongebruikelijke contexten

Zie [hoe integratiegegevens Signalen worden](/nl/signals/data-sources).

## Wat Living Security nodig heeft

| Referentie | Beschrijving |
| - | - |
| **Sleutel van het serviceaccount** | Een JSON-sleutel voor een specifiek Google Cloud-serviceaccount. |
| **Gedelegeerde beheerder** | Het e-mailadres van een Google Workspace-beheerder dat het serviceaccount kan imiteren. |

Schakel de Admin SDK-API's in en autoriseer alleen de scopes die de koppeling leest:

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

## Installatie

<Steps>
  <Step title="Een Google Cloud-serviceaccount maken">
    Maak een specifiek serviceaccount aan, schakel domeinbrede delegatie in en download de JSON-sleutel. Bewaar de sleutel op een veilige plaats.
  </Step>

  <Step title="Domeinbrede delegatie autoriseren">
    Open in de Google Admin Console **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Voeg de numerieke client-ID van het serviceaccount en de drie bovenstaande alleen-lezenscopes toe.
  </Step>

  <Step title="De gedelegeerde beheerder kiezen">
    Selecteer een actieve Workspace-beheerder die de directory, roltoewijzingen en auditrapporten kan lezen. Living Security gebruikt deze identiteit uitsluitend voor gedelegeerde API-leesacties.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Upload of plak de referentie van het serviceaccount zoals gevraagd en voer het e-mailadres van de gedelegeerde beheerder in.
  </ConnectInPlatform>
</Steps>

## Verifiëren en problemen oplossen

Controleer of de koppeling één directorygebruiker en recente aanmeldactiviteit kan lezen. Google vermeldt dat het enige tijd kan duren voordat nieuwe toekenningen van domeinbrede delegatie zijn doorgevoerd.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Controleer of de domeinbrede delegatie de numerieke client-ID van het serviceaccount gebruikt en niet het e-mailadres, en of alle drie de scopes exact overeenkomen.
  </Accordion>

  <Accordion title="Directory werkt, maar roltoewijzingen ontbreken">
    Voeg `admin.directory.rolemanagement.readonly` toe aan de delegatie-invoer en controleer of de gedelegeerde beheerder roltoewijzingen kan bekijken.
  </Accordion>

  <Accordion title="Rapporten zijn leeg">
    Controleer of de Admin Reports API is ingeschakeld en of de gedelegeerde beheerder toegang heeft tot auditrapportage voor de Workspace-tenant.
  </Accordion>
</AccordionGroup>

Voor details aan de kant van de leverancier, zie de [handleiding van Google over domeinbrede delegatie](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.