Intégrer le Centre d'alerte Google à Google SecOps
Ce document explique comment intégrer le centre d'alerte Google Workspace à Google Security Operations.
Cas d'utilisation
L'intégration du Centre d'alerte Google utilise les fonctionnalités de Google SecOps pour prendre en charge les cas d'utilisation suivants :
Réponse à une campagne d'hameçonnage : ingérez les notifications du centre d'alerte concernant les tentatives d'hameçonnage potentielles ciblant votre organisation. Déclenchez des workflows automatisés pour examiner les e-mails, bloquer les URL malveillantes et mettre en quarantaine les comptes concernés.
Contenir l'exfiltration de données : déclenchez une réponse automatisée aux incidents lorsqu'un mouvement de données suspect est détecté. Isoler les systèmes concernés et lancer une analyse d'investigation.
Correction automatisée des logiciels malveillants : mettez en quarantaine les appareils infectés identifiés par les alertes Google Workspace, et lancez des analyses obligatoires des logiciels malveillants ou des déploiements de correctifs.
Gestion des failles : traitez automatiquement les alertes concernant les failles récemment découvertes qui affectent votre environnement Google Workspace afin de prioriser l'application de correctifs et d'informer les équipes concernées.
Avant de commencer
Avant de configurer l'intégration du Centre d'alerte Google dans Google SecOps, effectuez les étapes préalables suivantes :
Activer l'API Google Workspace Alert Center
L'activation de l'API permet à Google SecOps de communiquer avec vos données de sécurité Google Workspace.
Dans la console Google Cloud , accédez à la page Bibliothèque.
Cliquez sur Activer.
Créer un compte de service
Un compte de service sert d'identité sécurisée pour l'intégration afin d'accéder à vos données Google Workspace.
Dans la console Google Cloud , accédez à IAM et administration > Comptes de service.
Cliquez sur addCréer un compte de service.
Indiquez un nom (par exemple, "Intégration du centre d'alerte SecOps") et une description.
Cliquez sur Créer et continuer.
Ignorez les étapes facultatives d'attribution de rôles IAM, puis cliquez sur OK. Les autorisations du centre d'alerte sont accordées à l'utilisateur Google Workspace dont l'identité est empruntée dans la console d'administration Google de votre domaine, et non au compte de service dans Google Cloud IAM.
Recherchez le compte de service dans la liste, puis copiez son ID client (ID unique) et son adresse e-mail.
Configurer une clé JSON
Cette intégration utilise un fichier de clé JSON statique pour l'authentification.
Sélectionnez votre compte de service dans la console Google Cloud , puis accédez à l'onglet Clés.
Cliquez sur Ajouter une clé > Créer une clé.
Sélectionnez JSON, puis cliquez sur Créer. Le fichier de clé est automatiquement téléchargé sur votre ordinateur.
Copiez l'intégralité du contenu de ce fichier et collez-le dans
Service Account JSON Secretlors de la configuration de l'intégration.
Déléguer l'autorité au niveau du domaine
L'octroi d'une autorité à l'échelle du domaine permet au compte de service d'accéder aux alertes de vos utilisateurs en empruntant l'identité d'un administrateur.
Dans la console d'administration Google de votre domaine, accédez à Menu principal > Sécurité > Contrôle des accès et des données > Commandes des API.
Dans le volet Délégation au niveau du domaine, sélectionnez Gérer la délégation au niveau du domaine.
Cliquez sur Ajouter.
Dans le champ ID client, saisissez l'identifiant unique (ID client) que vous avez copié à partir du compte de service.
Dans le champ Niveaux d'accès OAuth, saisissez le niveau d'accès suivant :
https://www.googleapis.com/auth/apps.alertsCliquez sur Autoriser.
Accorder l'accès au centre d'alerte à l'utilisateur dont l'identité est empruntée
L'utilisateur Google Workspace que vous spécifiez dans le paramètre Impersonation Email Address doit disposer de droits d'administrateur du Centre d'alerte dans la console d'administration Google de votre domaine.
Pour accorder l'accès au centre d'alerte dans la console d'administration Google, attribuez l'un des rôles suivants à l'utilisateur emprunté :
Rôle d'administrateur prédéfini : attribuez le rôle de super-administrateur ou d'administrateur des services, qui inclut par défaut un accès complet au centre d'alerte.
Rôle d'administrateur personnalisé : créez un rôle d'administrateur personnalisé dans Compte > Rôles d'administrateur avec le droit Centre d'alerte > Accès complet (requis pour exécuter l'action "Supprimer l'alerte") ou le droit Centre d'alerte > Accès en lecture (suffisant pour l'ingestion d'alertes en lecture seule), puis attribuez ce rôle à l'utilisateur dont l'identité est empruntée.
Pour en savoir plus sur la configuration des droits d'administrateur et des rôles personnalisés du centre d'alerte, consultez Accorder l'accès au centre d'alerte.
Paramètres d'intégration
L'intégration Centre d'alerte Google nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Service Account JSON Secret |
Obligatoire. Le contenu complet du fichier JSON de la clé de compte de service que vous avez téléchargé. |
Impersonation Email Address |
Obligatoire. Adresse e-mail d'un utilisateur Google Workspace disposant de droits d'administrateur du centre d'alerte (par exemple, le rôle de super-administrateur ou d'administrateur des services, ou un rôle d'administrateur personnalisé avec des droits d'accès au centre d'alerte) dans votre domaine Google Workspace. L'intégration utilise la délégation au niveau du domaine pour emprunter l'identité de cet utilisateur et récupérer ou gérer les alertes. |
Verify SSL |
Facultatif. Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur du Centre d'alerte Google. Cette option est activée par défaut. |
Pour savoir comment configurer une intégration dans Google SecOps, consultez Configurer des intégrations.
Vous pourrez apporter des modifications ultérieurement si nécessaire. Après avoir configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour en savoir plus sur la configuration et la prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.
Actions
Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis votre bureau et Exécuter une action manuelle dans votre demande.
Supprimer l'alerte
Utilisez l'action Supprimer l'alerte pour supprimer une alerte dans le centre d'alerte.
Après avoir supprimé une alerte, vous pouvez la récupérer pendant 30 jours. Vous ne pouvez pas récupérer une alerte que vous avez supprimée il y a plus de 30 jours.
Cette action ne s'exécute pas sur les entités Google SecOps.
Entrées de l'action
L'action Supprimer l'alerte nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Alert ID |
Obligatoire
ID de l'alerte à supprimer. |
Sorties de l'action
L'action Supprimer l'alerte fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe du mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Non disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Messages de sortie
L'action Supprimer l'alerte peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Error executing action "Delete Alert". Reason:
ERROR_REASON |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Supprimer l'alerte :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Ping
Utilisez l'action Ping pour tester la connectivité au centre d'alerte.
Cette action ne s'exécute pas sur les entités Google SecOps.
Entrées de l'action
Aucune.
Sorties de l'action
L'action Ping fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe du mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Non disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Messages de sortie
L'action Ping peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
Successfully connected to the alert center server with the
provided connection parameters! |
L'action a réussi. |
Failed to connect to the alert center server! Error is
ERROR_REASON |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Ping :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Connecteurs
Pour en savoir plus sur la configuration des connecteurs dans Google SecOps, consultez Ingérer vos données (connecteurs).
Centre d'alerte Google – Connecteur d'alertes
Utilisez le connecteur Google Alertes – Centre d'alertes pour récupérer des informations sur les alertes du Centre d'alerte.
Le filtre de liste dynamique fonctionne avec le paramètre type.
Entrées du connecteur
Le connecteur Google Alert Center – Alerts nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Product Field Name |
Obligatoire Nom du champ dans lequel le nom du produit est stocké. La valeur par défaut est |
Event Field Name |
Obligatoire Nom du champ utilisé pour déterminer le nom de l'événement (sous-type). La valeur par défaut est |
Environment Field Name |
Optional
Nom du champ dans lequel le nom de l'environnement est stocké. Si le champ d'environnement n'est pas trouvé, l'environnement est défini sur l'environnement par défaut. La valeur par défaut est |
Environment Regex Pattern |
Optional
Modèle d'expression régulière à exécuter sur la valeur trouvée dans le champ Utilisez la valeur par défaut Si le modèle d'expression régulière est nul ou vide, ou si la valeur de l'environnement est nulle, le résultat de l'environnement final est l'environnement par défaut. |
PythonProcessTimeout |
Obligatoire
Délai avant expiration (en secondes) du processus Python qui exécute le script actuel. La valeur par défaut est |
Service Account JSON Secret |
Obligatoire
Contenu JSON complet du fichier de compte de service que vous avez utilisé pour vous authentifier auprès du centre d'alerte. |
Impersonation Email Address |
Obligatoire
Adresse e-mail d'un utilisateur Google Workspace disposant de droits d'administrateur du centre d'alerte (par exemple, le rôle de super-administrateur ou d'administrateur des services, ou un rôle d'administrateur personnalisé avec des droits d'accès au centre d'alerte). |
Verify SSL |
Optional Si cette option est sélectionnée, l'intégration vérifie que le certificat SSL de connexion au centre d'alerte est valide. Cette option est sélectionnée par défaut. |
Max Hours Backwards |
Optional Nombre d'heures avant la première itération du connecteur pour récupérer les réponses. Ce paramètre s'applique soit à l'itération initiale du connecteur après l'avoir activé pour la première fois, soit à la valeur de remplacement d'un code temporel de connecteur expiré. La valeur par défaut est de 1 heure. |
Max Alerts To Fetch |
Optional
Nombre maximal d'alertes à récupérer pour chaque itération de connecteur. Le nombre maximal est de 100. |
Lowest Severity To Fetch |
Optional
Niveau de gravité le plus faible des alertes à récupérer. |
Use whitelist as a blacklist |
Optional
Si cette option est sélectionnée, le connecteur utilise la liste dynamique comme liste de blocage. Non sélectionné par défaut. |
Proxy Server Address |
Optional Adresse du serveur proxy à utiliser. |
Proxy Username |
Optional Nom d'utilisateur du proxy pour l'authentification. |
Proxy Password |
Optional Mot de passe du proxy pour l'authentification. |
Règles du connecteur
Les règles suivantes définissent la logique opérationnelle, le comportement de traitement des données et les mécanismes de sécurité du connecteur.
Proxys : le connecteur est compatible avec les proxys.
Création d'événements : si une alerte contient une clé
data/messages(une liste d'objets JSON), le connecteur crée un événement distinct pour chaque objet de la liste.Délai avant expiration de sécurité : si le connecteur atteint 90 % de son délai avant expiration d'exécution (en fonction de
PythonProcessTimeout), il s'arrête et ne crée pas d'alerte pour cette itération afin d'éviter l'ingestion partielle de données.Gestion des filigranes : le connecteur suit les alertes traitées à l'aide de
alertId. Il stocke jusqu'à 1 000 ID dansids.json. Lorsque la limite est dépassée, il supprime les 100 ID les plus anciens.
Exemple d'événement JSON
L'exemple JSON suivant représente la structure de réponse type de l'API Google Alert Center, illustrant les champs de données spécifiques disponibles pour l'ingestion.
{
"customerId": "038judqw",
"alertId": "e37415f1-7c39-44a5-b43c-4f8159638a2a",
"createTime": "2020-07-22T11:50:08.353Z",
"startTime": "2020-07-22T10:54:54.059475Z",
"endTime": "2020-07-22T11:46:51.020063Z",
"type": "User reported phishing",
"source": "Gmail phishing",
"data": {
"@type": "[type.googleapis.com/google.apps.alertcenter.type.MailPhishing](https://type.googleapis.com/google.apps.alertcenter.type.MailPhishing)",
"domainId": {
"customerPrimaryDomain": "smplylab.com"
},
"maliciousEntity": {
"fromHeader": "crazywiz7@abv.bg"
},
"messages": [
{
"messageId": "1753474999.350456.1595412914645@nm22.abv.bg",
"messageBodySnippet": " eicar com http malware wicar org data ms14_064_ole_not_xp html",
"md5HashSubject": "c93d4454877e844fdfcb4401472204f2",
"subjectText": "Re: App Store - Support. 17/07/2020 12:50:36",
"attachmentsSha256Hash": [
"77c2aed70c3b20c50dbf071f8688580e02463c213e7a65ccab1acc2f8a9769a3",
"f5e1b1bf12b71c54f68a719e0c45df5806a8b8d57bf3967d9bd4a071cfc5abbe"
],
"recipient": "lab3@smplylab.com",
"date": "2020-07-22T10:54:54.059475Z"
}
]
},
"securityInvestigationToolLink": "[admin.google.com/ac/ac/investigate?alert=CiRlMzc0MTVmMS03YzM5LTQ0YTUtYjQzYy00ZjgxNTk2MzhhMmE](https://admin.google.com/ac/ac/investigate?alert=CiRlMzc0MTVmMS03YzM5LTQ0YTUtYjQzYy00ZjgxNTk2MzhhMmE)",
"metadata": {
"customerId": "038judqw",
"alertId": "e37415f1-7c39-44a5-b43c-4f8159638a2a",
"status": "NOT_STARTED",
"updateTime": "2020-07-22T11:50:08.353Z",
"severity": "HIGH",
"etag": "rrXycg7VpUA="
},
"updateTime": "2020-07-22T11:50:08.353Z",
"etag": "rrXycg7VpUA="
}
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.