Gmail : Configuration de l'Intégration des Activités de l'Application

Cet article explique comment configurer l'intégration des Activités de l'Application pour Gmail.

Vue d'ensemble

Les Activités de l'Application vous fournissent une solution basée sur l'API pour une visibilité hors bande de toutes les activités réalisées par n'importe quel utilisateur dans une application SaaS connectée. Pour offrir aux Activités de l'Application la visibilité des données au sein d'une application, vous devez configurer une intégration avec l'application requise. Une fois l'intégration créée, si un champ a changé ou expiré, vous pouvez le modifier depuis la page Ressources > Intégrations > Applications intégrées. Pour plus d'informations, voir Qu'est-ce que le contrôle d'application via API avec App Activities.

Pour configurer l'intégration des Activités de l'Application, vous devez :

Configurer l'intégration dans l'application SaaS
Créer le connecteur API dans la CMA

Une licence CASB est requise pour les Activités de l'Application. Cette licence inclut le contrôle des applications et des données et les Activités de l'Application via l'API. Pour en savoir plus sur l'achat d'une licence CASB, contactez votre représentant Cato.

Avantages de la connexion de Gmail

Après avoir créé ce connecteur, vous pouvez visualiser et surveiller l'activité dans votre tenant Gmail, par exemple :

Partage de courrier (Envoyer / Transférer / Transfert automatique)
Étiquetage du courrier (Spam / Archive)
Pièces jointes / Liens attachés
Changement des permissions de l'élément

Configuration de l'Intégration de Gmail

Pour configurer l'intégration de Gmail, créez un nouveau projet.

Prérequis

Vous devez avoir acquis une licence Google Cloud Enterprise

Étape 1 : Configurer l'Intégration dans la Console Google Cloud

Dans la Console Google Cloud, créez une clé privée de compte de service à entrer dans la CMA.

Pour configurer l'intégration de Gmail :

Dans votre Console Google Cloud, cliquez sur Sélectionner un Projet.
Cliquez sur Nouveau projet.
Choisissez un Nom et un Emplacement puis cliquez sur Créer.
Accédez à APIs et Services > Bibliothèque.
Recherchez Admin SDK.
Cliquez sur Admin SDK API puis cliquez sur Activer.
Recherchez Gmail API.
Cliquez sur Gmail API et cliquez sur Activer.
Accédez à IAM & Administration > Comptes de Service.
Sélectionnez le projet que vous avez créé à l'étape deux et cliquez sur Créer un Compte de Service.
Ajoutez un ID de compte de service puis cliquez sur Créer et continuer.
Dans la liste déroulante Sélectionner un rôle, choisissez Audit Manager Admin (vous pouvez rechercher ce rôle).
Cliquez sur Terminé.
Cliquez sur le compte de service que vous avez créé et accédez à l'onglet Clés,
Cliquez sur Ajouter clé > Créer une nouvelle clé.
Choisissez le type de clé JSON, puis cliquez sur Créer.

Un fichier JSON contenant la clé privée est téléchargé.
Copiez et sauvegardez la clé privée afin qu'elle puisse être ajoutée au CMA.
Dans la console d'administration Google, accédez à Sécurité > Contrôle des Accès et des Données > Contrôle API.
Sous Délégation à l'échelle du domaine, sélectionnez Gérer la Délégation à l'Échelle du Domaine.
Cliquez sur Ajouter nouveau.
Ajoutez le ID Client du Compte de Service. Vous pouvez le trouver sur la page du Compte de Service.
Ajoutez ce champ :
- https://www.googleapis.com/auth/admin.reports.audit.readonly admin.directory.user.readonly
Cliquez sur Autoriser.

Étape 2 : Créez le connecteur API dans le CMA

Une fois que vous avez configuré une intégration avec l'application requise, ajoutez les détails dans le CMA.

Pour créer le connecteur d'API dans le CMA :

Dans le menu de navigation, cliquez sur Ressources > Intégrations.
Cliquez sur l'onglet Intégrations Configurées.
Cliquez sur Nouveau.

Le panneau Nouvelle intégration s'ouvre.
Sélectionnez l'application SaaS que vous souhaitez ajouter.

Note : Entrez la clé privée au format JSON.
Dans la liste déroulante Capacité, sélectionnez Activités de l'application.
Ajoutez les détails créés au cours de l'étape un.

Note : Le JSON et l'adresse email de l'admin sont les détails nécessaires pour la création du connecteur. Le champ email de l'administrateur doit inclure l'email d'un utilisateur avec le rôle de Super Administrateur.
Cliquez sur Sauvegarder.
L'application est visible dans le tableau Applications intégrées avec un statut Connecté.

Après avoir connecté vos API, vous pouvez suivre les activités de l'application dans le Tableau de bord des Activités Cloud. Les données peuvent prendre quelques minutes à apparaître.