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 :

  1. Activez l'API Google Workspace Alert Center.

  2. Créez un compte de service.

  3. Configurez une clé JSON.

  4. Déléguer l'autorité au niveau du domaine

  5. Accordez l'accès au centre d'alerte à l'utilisateur dont l'identité est empruntée.

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.

  1. Dans la console Google Cloud , accédez à la page Bibliothèque.

    Accéder à la bibliothèque

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

  1. Dans la console Google Cloud , accédez à IAM et administration > Comptes de service.

    Accéder à la page "Comptes de service"

  2. Cliquez sur addCréer un compte de service.

  3. Indiquez un nom (par exemple, "Intégration du centre d'alerte SecOps") et une description.

  4. Cliquez sur Créer et continuer.

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

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

  1. Sélectionnez votre compte de service dans la console Google Cloud , puis accédez à l'onglet Clés.

  2. Cliquez sur Ajouter une clé > Créer une clé.

  3. Sélectionnez JSON, puis cliquez sur Créer. Le fichier de clé est automatiquement téléchargé sur votre ordinateur.

  4. Copiez l'intégralité du contenu de ce fichier et collez-le dans Service Account JSON Secret lors 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.

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

  2. Dans le volet Délégation au niveau du domaine, sélectionnez Gérer la délégation au niveau du domaine.

  3. Cliquez sur Ajouter.

  4. Dans le champ ID client, saisissez l'identifiant unique (ID client) que vous avez copié à partir du compte de service.

  5. Dans le champ Niveaux d'accès OAuth, saisissez le niveau d'accès suivant :

    https://www.googleapis.com/auth/apps.alerts
    
  6. Cliquez 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

Successfully deleted alert with ID RECORD_ID in the alert center.

Alert with ID RECORD_ID doesn't exist in the alert center.

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

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

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 Environment Field Name. Ce paramètre vous permet de manipuler le champ "environment" à l'aide d'une logique d'expression régulière.

Utilisez la valeur par défaut .* pour récupérer la valeur Environment Field Name brute requise.

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

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 dans ids.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.