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

# Configuration de l'intégration Google Workspace

> Connectez Google Workspace à Living Security pour suivre le cycle de vie des utilisateurs, les connexions, l'authentification multifacteur (MFA), les actions d'administration et les activités de protection des données.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Ressources associées</h2>
    <ul>
      <li>
        <a href="/fr/signals/data-sources">Découvrez comment les données d'intégration deviennent des signaux de Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Découvrir les intégrations de Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Ouvrir la Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Demander une démonstration de Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Saisissez les identifiants dans la Living Security Platform">
    <p>
      À effectuer par la personne disposant d'un accès à Living Security : le responsable du programme, ou
      l'administrateur système s'il a été invité (configuration déléguée).
    </p>
    <ol>
      <li>
        Accédez à <strong>Paramètres → Intégrations → Catalogue</strong>, repérez la vignette{' '}
        <strong>{tile}</strong>, puis cliquez sur <strong>Connecter</strong>.
      </li>
      <li>
        Renseignez les champs ci-dessous, puis cliquez sur <strong>Connecter</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Ce guide s'adresse à votre administrateur {system}.</strong> Il explique comment créer des
      identifiants d'API dans {system}, ce qui nécessite un accès administrateur à {system} — et non à la
      Living Security Platform.
    </p>
    <p>
      Si vous êtes le <strong>responsable du programme</strong> Living Security et que vous n'administrez pas {system},
      transmettez cette page à la personne qui en est chargée. Celle-ci réalise la partie A et vous remet les identifiants
      (ou les saisit directement si vous l'avez invitée sur la plateforme).
      {recommendDelegated && <>
          {' '}Comme la configuration génère des clés sensibles, nous recommandons de privilégier la{' '}
          <strong>configuration déléguée</strong>, afin que le secret ne vous soit jamais transmis.
        </>}
    </p>
  </Note>;

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

## Ce que cette intégration apporte

Google Workspace peut fournir des données normalisées sur le cycle de vie des utilisateurs, les connexions, la MFA, les actions d'administration et les activités de protection des données. Voici quelques exemples examinés :

* `account.compromised` — compte signalé comme compromis
* `data.sensitive.downloaded` — téléchargement de données sensibles
* `auth.login.unusual` — connexion depuis des contextes inhabituels

Consultez [la manière dont les données d'intégration deviennent des Signaux](/fr/signals/data-sources).

## Ce dont Living Security a besoin

| Identifiant | Description |
| - | - |
| **Clé de compte de service** | Une clé JSON pour un compte de service Google Cloud dédié. |
| **Administrateur délégué** | Une adresse e-mail d'administrateur Google Workspace que le compte de service peut emprunter. |

Activez les API Admin SDK et n'autorisez que les portées que la connexion lit :

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

## Configuration

<Steps>
  <Step title="Créer un compte de service Google Cloud">
    Créez un compte de service dédié, activez la délégation à l'échelle du domaine, puis téléchargez sa clé JSON. Conservez la clé en lieu sûr.
  </Step>

  <Step title="Autoriser la délégation à l'échelle du domaine">
    Dans la console d'administration Google, ouvrez **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Ajoutez l'ID client numérique du compte de service ainsi que les trois portées en lecture seule indiquées ci-dessus.
  </Step>

  <Step title="Choisir l'administrateur délégué">
    Sélectionnez un administrateur Workspace actif qui peut lire l'annuaire, les attributions de rôles et les rapports d'audit. Living Security utilise cette identité uniquement pour les lectures d'API déléguées.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Importez ou collez l'identifiant du compte de service lorsque vous y êtes invité, puis saisissez l'adresse e-mail de l'administrateur délégué.
  </ConnectInPlatform>
</Steps>

## Vérification et dépannage

Vérifiez que la connexion peut lire un utilisateur de l'annuaire ainsi que l'activité de connexion récente. Google indique que la propagation des nouvelles autorisations de délégation à l'échelle du domaine peut prendre du temps.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Vérifiez que la délégation à l'échelle du domaine utilise l'ID client numérique du compte de service, et non son adresse e-mail, et que les trois portées correspondent exactement.
  </Accordion>

  <Accordion title="L'annuaire fonctionne, mais les attributions de rôles sont absentes">
    Ajoutez `admin.directory.rolemanagement.readonly` à l'entrée de délégation et vérifiez que l'administrateur délégué peut consulter les attributions de rôles.
  </Accordion>

  <Accordion title="Les rapports sont vides">
    Vérifiez que l'API Admin Reports est activée et que l'administrateur délégué peut accéder aux rapports d'audit du locataire Workspace.
  </Accordion>
</AccordionGroup>

Pour plus de détails côté fournisseur, consultez [le guide de Google sur la délégation à l'échelle du domaine](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.