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

# Google Workspace

> Intégrez Google Workspace

> [!NOTE]
>
> Nous utilisons la prise en charge d’[OAuth](https://developers.google.com/identity/protocols/oauth2) de Google Workspace pour nous intégrer à votre compte Workspace. L’intégration Workspace nécessite des autorisations de lecture de l’annuaire pour pouvoir rechercher tous les utilisateurs de votre organisation.

Pour commencer, [ajoutez une nouvelle intégration](https://app.wirespeed.co/settings/integrations?tab=browse) et sélectionnez Google Workspace. Vous serez redirigé vers la page de consentement OAuth.

### Ajouter les e-mails de Wirespeed à la liste d’autorisation dans la Google Admin Console

Vous pouvez ajouter certains domaines et adresses e-mail à une liste d’autorisation pour l’ensemble de votre Google Workspace. Pour vous assurer que les e-mails de Wirespeed parviennent à votre équipe :

1. Connectez-vous à la Google Admin Console sur [https://admin.google.com](https://admin.google.com) avec un compte administrateur.
2. Dans le menu de gauche, cliquez sur **Apps** > **Google Workspace** > **Gmail**.
3. Vérifiez que votre domaine est sélectionné dans la section **Organizational Units**.
4. Dans l’onglet **Spam, Phishing, and Malware**, repérez la section **Spam**.
5. Cliquez sur **Configure** (si aucune règle n’existe) ou sur **Add another rule**.
6. Nommez votre règle et vérifiez que la case **Bypass spam filters and hide warnings for messages from senders or domains in selected lists** est cochée.

> [!WARNING]
>
> La case **Bypass spam filters for internal senders** peut être cochée par défaut. Il n’est PAS nécessaire de la cocher pour notre usage, et cela peut ajouter un risque indésirable. Tenez-en compte avant de la laisser activée.

7. Cliquez sur **Create or edit list** pour ouvrir la page Manage Address list.
   * ***Si vous créez une nouvelle liste***, cliquez sur **ADD ADDRESS LIST**, nommez-la en conséquence, puis sélectionnez **Add Address**.
   * ***Si vous modifiez une liste existante***, sélectionnez la liste et cliquez sur **Add Address**.

8. Dans le champ prévu, saisissez le domaine : [wirespeed.co](https://wirespeed.co).

9. Cliquez sur **SAVE**.

10. Revenez à la page de configuration de la règle anti-spam, cliquez sur **Use existing list** et sélectionnez la liste que vous avez modifiée.

11. Cliquez sur **Save** pour appliquer les modifications.

## Quels événements sont collectés ?

Wirespeed lit l’activité Google Workspace depuis l’API Reports du SDK Admin avec l’autorisation d’audit en lecture seule accordée lors de la connexion, et synchronise votre annuaire d’utilisateurs. Aucune configuration supplémentaire n’est nécessaire dans Wirespeed. Les événements Gemini et NotebookLM n’apparaissent que si ces services sont activés dans votre Workspace.

| Source | Événements |
| - | - |
| Connexion | Connexions réussies et en échec, et vérifications à la connexion |
| Console d’administration | Modifications apportées par les administrateurs aux utilisateurs, aux rôles, à la sécurité et aux paramètres du domaine |
| Jetons OAuth | Autorisations d’applications tierces et activité des jetons |
| SAML | Connexions aux applications SAML qui utilisent Google comme fournisseur d’identité |
| Drive, Agenda et Meet | Activité des fichiers, de l’agenda et des réunions |
| Comptes et appareils | Modifications de compte, comme les changements de mot de passe et de validation en deux étapes, enregistrement d’appareils mobiles et activité de la console Google Cloud |
| Gmail | Activité de distribution des messages, lorsque l’administrateur qui a autorisé l’intégration peut lire les journaux d’audit |
| Gemini | Utilisation des fonctionnalités Gemini dans les applications Workspace, lorsque Google fournit les journaux d’audit Gemini pour votre organisation |
| NotebookLM | Activité des notebooks, des sources et des artefacts générés, ainsi que les modifications de partage, de visibilité et d’exportation, lorsque Google fournit les journaux d’audit NotebookLM pour votre organisation |

La collecte Gemini et NotebookLM s’active automatiquement lorsque Google fournit ces journaux d’audit, et Wirespeed vérifie de nouveau leur disponibilité à intervalles de quelques heures. Vous n’avez pas besoin de reconnecter l’intégration. Si l’une de ces sources n’est pas disponible, l’intégration affiche un avertissement et les autres sources continuent de fonctionner. La collecte commence lorsqu’une source devient disponible ; l’historique antérieur n’est pas importé.

## Détections gérées

Wirespeed évalue les événements collectés pour détecter :

| Détection | Condition |
| - | - |
| Délégation à l’échelle du domaine accordée | Un administrateur autorise un client API à agir au nom de n’importe quel utilisateur du domaine |
| Paramètres SSO modifiés | Un administrateur modifie, active ou désactive l’authentification unique |
| Utilisateur supprimé | Un administrateur supprime un utilisateur |
| Rôle d’administrateur attribué | Un utilisateur reçoit des droits de super-administrateur ou un rôle d’administrateur |
| Accès contextuel modifié | Un administrateur active ou désactive l’accès contextuel, ou modifie les niveaux d’accès appliqués à une application |
| Autorisation OAuth Gmail pour Apps Script | Un script Apps Script est autorisé avec un accès complet à Gmail et l’autorisation d’envoyer des e-mails |
| Connexion par mot de passe seul après une vérification | Une connexion ayant réussi une vérification est suivie d’une connexion sans validation en deux étapes depuis un réseau de centre de données nouveau pour l’utilisateur |

Les connexions réussies et en échec sont également normalisées en tant qu’événements d’authentification pour les recherches SIEM et les détections de connexion multiplateformes. Wirespeed ne crée pas de détection individuelle pour chaque connexion.

## Erreurs

### access\_not\_configured

> [!WARNING]
>
> Access blocked: Your institution's admin needs to review Wirespeed. Error 400: access\_not\_configured

Cette erreur se produit lorsque votre organisation Google Workspace restreint par défaut les applications OAuth tierces. Il s’agit d’une fonctionnalité de sécurité de la Google Admin Console qui exige qu’un administrateur approuve explicitement les applications avant que les utilisateurs puissent leur accorder l’accès.

Pour résoudre ce problème, un Super Admin Google Workspace doit pré-approuver l’application Wirespeed :

1. Connectez-vous à la [Google Admin Console](https://admin.google.com) en tant que Super Admin.
2. Accédez à **Security** > **Access and data control** > **API controls**.
3. Cliquez sur **Manage Third-Party App Access** (ou accédez directement à [App Access Control](https://admin.google.com/ac/owl/list?tab=apps)).
4. Cliquez sur **Add app** > **OAuth App Name Or Client ID**.
5. Recherchez **Wirespeed** ou collez l’ID client OAuth fourni par votre administrateur Wirespeed.
6. Sélectionnez l’application Wirespeed et cliquez sur **Select**.
7. Définissez le niveau d’accès sur **Trusted** (recommandé) ou **Limited**.
8. Cliquez sur **Configure** pour enregistrer.

Une fois l’application approuvée, revenez dans Wirespeed et relancez l’[intégration Google Workspace](https://app.wirespeed.co/settings/integrations?tab=browse).

> [!TIP]
>
> Si vous ne connaissez pas l’ID client OAuth, contactez votre chargé de compte Wirespeed ou écrivez à [support@wirespeed.co](mailto:support@wirespeed.co).

### L’intégration échoue avec un accès Limited mais fonctionne avec Trusted

Lorsque l’accès de Wirespeed est défini sur **Limited** (ou **Specific Google data**) dans App Access Control, Google indique que votre administrateur doit accorder des autorisations supplémentaires et la connexion échoue, alors que tous les champs d’application (scopes) demandés sont autorisés. Définir Wirespeed sur **Trusted** permet à la connexion d’aboutir.

Une cause connue est que le compte utilisé pour connecter Wirespeed est inscrit au [Programme Protection Avancée](https://support.google.com/a/answer/9378686) de Google. La Protection Avancée limite les applications tierces que les utilisateurs inscrits peuvent autoriser : une application disposant d’un accès **Limited** ou **Specific Google data** peut donc quand même être bloquée. Marquer l’application comme **Trusted** lève cette restriction.

Pour résoudre ce problème sans définir Wirespeed sur Trusted :

1. Créez ou choisissez un compte Super Admin dédié qui n’est **pas** inscrit à la Protection Avancée, et utilisez-le uniquement pour donner le consentement. Sans la Protection Avancée, la connexion par clé de sécurité n’est pas imposée pour ce compte : placez-le donc dans une unité organisationnelle dont la règle de validation en deux étapes est appliquée avec **Only security key** comme méthode autorisée.
2. Dans App Access Control, définissez Wirespeed sur le niveau d’accès autorisé par votre politique, par exemple **Limited** ou **Specific Google data**.
3. Relancez l’[intégration Google Workspace](https://app.wirespeed.co/settings/integrations?tab=browse). Sur la page de consentement Google, connectez-vous avec le compte Super Admin dédié.

Si tous les comptes pouvant donner leur consentement doivent rester inscrits à la Protection Avancée, Wirespeed doit rester **Trusted** dans App Access Control.

> [!NOTE]
>
> L’utilisation des données utilisateur brutes ou dérivées reçues des API Workspace respectera la Google User Data Policy, y compris les exigences Limited Use.


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