Intégrer Gmail à Google SecOps

Ce document explique comment intégrer Gmail à Google Security Operations.

Cas d'utilisation

L'intégration de Gmail utilise les fonctionnalités de Google SecOps pour prendre en charge les cas d'utilisation suivants :

  • Contenir automatiquement l'hameçonnage : recherchez et supprimez les e-mails malveillants dans l'ensemble de l'organisation pour empêcher les utilisateurs d'interagir avec les acteurs malveillants.

  • Analyse d'e-mails : récupérez les en-têtes, les pièces jointes et le corps des messages pour les analyser lors d'une investigation active.

  • Notification d'incident : automatisez la communication en envoyant des alertes de sécurité, des informations sur l'enquête ou des instructions de correction aux parties prenantes directement depuis un playbook.

  • Gestion des boîtes aux lettres : listez les messages des utilisateurs ou auditez les libellés pour identifier des schémas dans les campagnes d'hameçonnage ciblées.

Avant de commencer

Avant de configurer l'intégration de Gmail dans Google SecOps, effectuez les étapes préalables suivantes :

  1. Activez l'API Gmail.

  2. Créez un compte de service.

  3. Déléguez l'autorité au niveau du domaine à votre compte de service.

  4. Choisissez et configurez l'une des méthodes d'authentification suivantes :

    • Option 1 : Workload Identity (recommandé) : cette méthode utilise des jetons d'accès temporaires de courte durée via l'emprunt d'identité d'un compte de service. Vous n'avez donc pas besoin de stocker de secrets.

    • Option 2 : Clé JSON du compte de service : cette méthode repose sur un fichier de clé secrète statique et de longue durée. N'utilisez cette méthode que si l'authentification Workload Identity n'est pas disponible dans votre environnement.

Activer l'API Gmail

Vous devez activer l'API Gmail dans votre organisation Google Cloud pour que l'intégration puisse communiquer avec Google Workspace.

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

    Accéder à la bibliothèque

  2. Recherchez et activez l'API Gmail.

Créer un compte de service

Pour créer un compte de service pour l'intégration, procédez comme suit :

  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 IAM SecOps") et une description.

  4. Cliquez sur Créer et continuer.

  5. Ignorez les étapes facultatives d'attribution de rôles et cliquez sur OK.

  6. Localisez le compte de service dans la liste, puis copiez son ID client (également appelé identifiant unique) et son adresse e-mail. Vous en aurez besoin pour la délégation au niveau du domaine.

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

Les comptes de service n'ont pas de boîte aux lettres propre. Vous devez déléguer l'autorité au niveau du domaine au compte de service afin qu'il puisse emprunter l'identité des utilisateurs de votre organisation.

  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) du compte de service que vous avez créé.

  5. Dans le champ Habilitations OAuth, saisissez les habilitations suivantes, séparées par des virgules :

    https://mail.google.com/,
https://www.googleapis.com/auth/cloud-platform,
https://www.googleapis.com/auth/admin.directory.user,
https://www.googleapis.com/auth/admin.directory.group.member,
https://www.googleapis.com/auth/admin.directory.customer.readonly,
https://www.googleapis.com/auth/admin.directory.domain.readonly,
https://www.googleapis.com/auth/admin.directory.group,
https://www.googleapis.com/auth/admin.directory.orgunit,
https://www.googleapis.com/auth/admin.directory.user.alias,
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly,
https://www.googleapis.com/auth/apps.groups.settings

  6. Cliquez sur Autoriser.

Configurer les identifiants Workload Identity

Choisissez cette méthode ou la méthode de clé JSON pour authentifier l'intégration. L'utilisation d'une Workload Identity est l'approche recommandée, car elle utilise des jetons d'accès temporaires de courte durée via l'emprunt d'identité d'un compte de service.

Identifier l'identité unique de l'instance

Pour vous authentifier à l'aide de Workload Identity, vous devez autoriser votre instance Google SecOps à emprunter l'identité de votre compte de service. Cela permet à l'instance d'accéder de manière sécurisée aux ressources Google Cloud .

  1. Dans Google SecOps, accédez à Content Hub > Intégrations de réponse.

  2. Sélectionnez l'intégration Gmail, puis saisissez l'adresse e-mail de votre compte de service dans Workload Identity Email.

  3. Cliquez sur Enregistrer > Tester. Le test devrait échouer.

  4. Cliquez sur close_small à droite de Test et recherchez dans le message d'erreur l'adresse e-mail d'identité commençant par gke-init-python@... ou soar-python@....

  5. Copiez cette adresse e-mail unique.

Autoriser l'identité de l'instance dans Google Cloud

Une fois que vous avez récupéré l'identité unique de votre instance Google SecOps, vous devez l'autoriser à accéder à vos ressourcesGoogle Cloud . Cette étape permet à la plate-forme d'emprunter l'identité du compte de service, de générer des jetons de courte durée et d'agir en votre nom sans clés statiques.

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

    Accéder à la page "Comptes de service"

  2. Sélectionnez le compte de service cible, puis accédez à Autorisations > Accorder l'accès.

  3. Collez l'adresse e-mail unique dans le champ Nouveaux comptes principaux et attribuez le rôle Créateur de jetons du compte de service (roles/iam.serviceAccountTokenCreator).

Configurer une clé JSON

Choisissez cette méthode ou la méthode Workload Identity pour authentifier l'intégration. N'utilisez la méthode de clé JSON que si Workload Identity n'est pas disponible dans votre environnement. Workload Identity est l'approche recommandée et la plus sécurisée. Cette méthode repose sur un fichier de clé secrète statique et de longue durée qui nécessite une gestion et une rotation manuelles.

Suivez la procédure ci-dessous pour générer le fichier de clé JSON requis pour authentifier l'intégration :

  1. Dans la console Google Cloud , accédez à IAM et administration > Comptes de service, puis sélectionnez le compte de service que vous avez créé.

    Accéder à la page "Comptes de service"

  2. Accédez à l'onglet Clés.

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

  4. Sélectionnez le type de clé JSON, puis cliquez sur Créer. Le navigateur télécharge le fichier JSON sur votre ordinateur.

  5. Copiez l'intégralité du contenu de ce fichier et collez-le dans Contenu du fichier JSON du compte de service lors de la configuration de l'intégration.

Paramètres d'intégration

L'intégration Gmail nécessite les paramètres suivants :

Paramètre Description
Default Mailbox

Obligatoire.

Adresse e-mail de l'utilisateur principal que l'intégration utilise pour envoyer ou recevoir des messages lorsqu'aucune boîte aux lettres spécifique n'est fournie dans une action.
Service Account JSON File Content

Facultatif.

Contenu complet du fichier JSON de la clé du compte de service.

N'utilisez ce paramètre que si vous vous authentifiez à l'aide d'une clé JSON.
Workload Identity Email

Facultatif.

Adresse e-mail du client de votre compte de service.

N'utilisez ce paramètre que si vous vous authentifiez à l'aide de Workload Identity.
Verify SSL

Obligatoire.

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur Gmail.

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.

Ajouter un libellé d'adresse e-mail

Utilisez l'action Ajouter un libellé d'e-mail pour ajouter un libellé à l'e-mail spécifié.

Cette action est asynchrone. Ajustez le délai avant expiration de l'action dans l'environnement de développement intégré (IDE) de Google SecOps en conséquence.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Ajouter un libellé d'e-mail nécessite les paramètres suivants :

Paramètre Description
Mailbox Obligatoire

Une boîte aux lettres pour attendre une réponse, telle que user@example.com.

Par défaut, l'action utilise la boîte aux lettres par défaut que vous avez configurée pour l'intégration. Ce paramètre accepte plusieurs valeurs sous forme de liste d'éléments séparés par une virgule.
Internet Message ID Optional

ID de message Internet d'un e-mail à rechercher.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule.

Si vous fournissez l'ID du message Internet, l'action ignore les paramètres Subject Filter, Sender Filter et Time Frame (minutes).
Labels Filter Optional

Condition de filtre qui spécifie les libellés d'e-mail à rechercher.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule.

La valeur par défaut est Inbox.

Vous pouvez rechercher des e-mails associés à des libellés spécifiques, comme label1, label2. Pour rechercher des e-mails qui ne sont pas associés à un libellé spécifique, utilisez le format suivant : -label1. Vous pouvez configurer ce paramètre pour rechercher des e-mails avec et sans libellés spécifiques dans une même chaîne, par exemple label1, -label2, label3.
Subject Filter Optional

Condition de filtre qui spécifie l'objet de l'e-mail à rechercher.

Ce filtre utilise la logique contains et nécessite que vous spécifiiez les éléments de recherche en mots entiers. Ce filtre n'est pas compatible avec les correspondances partielles.
Sender Filter Optional

Condition de filtre qui spécifie l'expéditeur de l'e-mail à rechercher.

Ce filtre utilise la logique equals.
Time Frame (minutes) Optional

Condition de filtre qui spécifie la période en minutes pour rechercher des e-mails.

La valeur par défaut est de 60 minutes.
Email Status Optional

État de l'e-mail à rechercher.

Les valeurs possibles sont les suivantes :

  • Only Unread Messages
  • Only Read Messages
  • Both Read & Unread Messages

La valeur par défaut est Both Read & Unread Messages.
Label Obligatoire

Libellé permettant de mettre à jour l'e-mail.

Ce paramètre accepte plusieurs valeurs sous forme de liste d'éléments séparés par une virgule.

Si le libellé n'existe pas dans une boîte aux lettres, l'action le crée.

Sorties de l'action

L'action Ajouter un libellé d'e-mail 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 Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Ajouter un libellé d'e-mail :

[
   {
       "Entity": "email@example.com",
       "EntityResult": [
           {
               "id": "ID",
               "thread_id": "THREAD_ID",
               "label_ids": [
                   "CATEGORY_PERSONAL",
                   "INBOX"
               ],
               "snippet": "SNIPPET",
               "history_id": "10576",
               "internal_date": 1728217410000,
               "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
               "subject": "SUBJECT",
               "from": "example@example.com",
               "headers": {
                   "delivered-to": "email@example.com",
                   "received": [
                       "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
                   ],
                   "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
                   "x-received": [
                       "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
                   ],
                   "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
                   "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
                   "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
               },
               "mimetype": "text/plain",
               "text_bodies": [
                   "text\r\n"
               ],
               "html_bodies": [],
               "file_attachments": [],
               "date": "Sun, 6 Oct 2024 12:23:30 +0000",
               "to": "email@example.com",
               "cc": null,
               "bcc": null,
               "in-reply-to": null,
               "reply-to": null
           }
       ]
   }
]
Messages de sortie

L'action Ajouter un libellé d'e-mail fournit les messages de sortie suivants :

Message de sortie Description du message

Successfully updated labels for emails in the following mailboxes: MAILBOX_LIST

No emails were found based on the provided search criteria in the following mailboxes: MAILBOX_LIST

The following mailboxes were not found: MAILBOX_LIST. Check the spelling.

Update is pending for emails in the following mailboxes: MAILBOX_LIST

 L'action a réussi.
Error executing action "Add Email Label". 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 décrit les valeurs de la sortie du résultat du script lorsque vous utilisez l'action Ajouter un libellé d'e-mail :

Nom du résultat du script Valeur
is_success True ou False

Supprimer des messages

Utilisez l'action Supprimer l'e-mail pour supprimer un ou plusieurs e-mails de la boîte aux lettres en fonction des critères de recherche fournis. Par défaut, cette action déplace les e-mails vers la corbeille. Vous pouvez configurer l'action pour supprimer définitivement les e-mails au lieu de les placer dans la corbeille.

L'action Supprimer l'e-mail est asynchrone. Ajustez le délai avant expiration de l'action dans l'IDE Google SecOps en conséquence.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Supprimer l'e-mail nécessite les paramètres suivants :

Paramètre Description
Mailbox Obligatoire

Une boîte aux lettres pour attendre une réponse, telle que user@example.com.

Par défaut, l'action utilise la boîte aux lettres par défaut que vous avez configurée pour l'intégration. Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule.
Labels Filter Optional

Condition de filtre qui spécifie les libellés d'e-mail à rechercher.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule.

La valeur par défaut est Inbox.

Vous pouvez rechercher des e-mails associés à des libellés spécifiques, comme label1, label2. Pour rechercher des e-mails qui ne sont pas associés à un libellé spécifique, utilisez le format suivant : -label1. Vous pouvez configurer ce paramètre pour rechercher des e-mails avec et sans libellés spécifiques dans une même chaîne, par exemple label1, -label2, label3.
Internet Message ID Optional

ID de message Internet d'un e-mail à rechercher.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule.

Si vous fournissez l'ID du message Internet, l'action ignore les paramètres Subject Filter, Sender Filter, Labels Filter et Time Frame (minutes).
Subject Filter Optional

Condition de filtre qui spécifie l'objet de l'e-mail à rechercher.

Ce filtre utilise la logique contains et nécessite que vous spécifiiez les éléments de recherche en mots entiers. Ce filtre n'est pas compatible avec les correspondances partielles.
Sender Filter Optional

Condition de filtre qui spécifie l'expéditeur de l'e-mail à rechercher.

Ce filtre utilise la logique equals.
Time Frame (minutes) Optional

Condition de filtre qui spécifie la période en minutes pour rechercher des e-mails.

La valeur par défaut est de 60 minutes.
Email Status Optional

État de l'e-mail à rechercher.

Les valeurs possibles sont les suivantes :

  • Only Unread Messages
  • Only Read Messages
  • Both Read & Unread Messages

La valeur par défaut est Both Read & Unread Messages.
Move to Trash Optional

Si cette option est sélectionnée, l'action déplace les e-mails vers la Corbeille et ne recherche pas les e-mails portant le libellé Corbeille, sauf si vous configurez le paramètre Labels Filter pour inclure le libellé suivant : Trash. Si cette option n'est pas sélectionnée, l'action effectue une recherche dans l'ensemble de la boîte aux lettres et supprime définitivement les e-mails.

Cette option est sélectionnée par défaut.

Sorties de l'action

L'action Supprimer l'e-mail 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 Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Supprimer l'e-mail :

{
"mailbox1": [DELETED_MESSAGE_ID_LIST],
"mailbox2": [DELETED_MESSAGE_ID_LIST]
}
Messages de sortie

L'action Supprimer l'e-mail fournit les messages de sortie suivants :

Message de sortie Description du message

Successfully deleted emails in the following mailboxes: MAILBOX_LIST

No emails to delete based on the provided search criteria in the following mailboxes: MAILBOX_LIST

The following mailboxes were not found: MAILBOX_LIST. Check the spelling.

The action didn't find any emails based on the specified search criteria.

Pending deletion of emails in the following mailboxes: MAILBOX_LIST

 L'action a réussi.
Error executing action "Delete Email". 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 décrit les valeurs de la sortie du résultat du script lorsque vous utilisez l'action Supprimer l'e-mail :

Nom du résultat du script Valeur
is_success True ou False

Transférer l'e-mail

Utilisez l'action Transférer l'e-mail pour transférer des e-mails, y compris ceux contenant des fils de discussion précédents.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Transférer l'e-mail nécessite les paramètres suivants :

Paramètre Description
Mailbox Obligatoire

Une boîte aux lettres à partir de laquelle envoyer un e-mail, par exemple user@example.com.

Par défaut, l'action utilise la boîte aux lettres par défaut que vous avez configurée pour l'intégration.
Internet Message ID Obligatoire

ID de message Internet d'un e-mail à rechercher.
Send To Obligatoire

Chaîne d'adresses e-mail des destinataires, séparées par une virgule, par exemple user1@example.com, user2@example.com.

CC Optional

Chaîne d'adresses e-mail séparées par une virgule pour les destinataires de l'e-mail en copie carbone (CC), par exemple user1@example.com, user2@example.com.
BCC Optional

Chaîne d'adresses e-mail séparées par une virgule pour les destinataires de l'e-mail en copie carbone invisible (Cci), par exemple user1@example.com, user2@example.com.
Subject Obligatoire

Nouvel objet d'un e-mail à transférer.
Attachments Paths Optional

Chaîne de chemins d'accès séparés par une virgule pour les fichiers joints stockés sur le serveur Google SecOps.
Mail Content Obligatoire

Corps de l'e-mail.

Sorties de l'action

L'action Transférer l'e-mail 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 Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Transférer l'e-mail :

{
   "id": "ID",
   "thread_id": "THREAD_ID",
   "label_ids": [
       "CATEGORY_PERSONAL",
       "INBOX"
   ],
   "snippet": "SNIPPET",
   "history_id": "10576",
   "internal_date": 1728217410000,
   "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
   "subject": "SUBJECT",
   "from": "example@example.com",
   "headers": {
       "delivered-to": "email@example.com",
       "received": [
           "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
       ],
       "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
       "x-received": [
           "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
       ],
       "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
       "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
       "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
   },
   "mimetype": "text/plain",
   "text_bodies": [
       "text\r\n"
   ],
   "html_bodies": [],
   "file_attachments": [],
   "date": "Sun, 6 Oct 2024 12:23:30 +0000",
   "to": "email@example.com",
   "cc": null,
   "bcc": null,
   "in-reply-to": null,
   "reply-to": null
}
Messages de sortie

L'action Transférer l'e-mail fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully forwarded the MESSAGE_ID email. L'action a réussi.
Error executing action "Forward Email". 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 décrit les valeurs de la sortie du résultat du script lors de l'utilisation de l'action Transférer l'e-mail :

Nom du résultat du script Valeur
is_success True ou False

Ping

Utilisez l'action Ping pour tester la connectivité à Gmail.

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 fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully connected to the Google Gmail service with the provided connection parameters! L'action a réussi.
Failed to connect to the Google Gmail service! 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 décrit les valeurs 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

Supprimer le libellé d'e-mail

Utilisez l'action Supprimer le libellé de l'e-mail pour supprimer un libellé de l'e-mail spécifié.

Cette action est asynchrone. Ajustez le délai avant expiration de l'action dans l'IDE Google SecOps en conséquence.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Supprimer le libellé de l'e-mail nécessite les paramètres suivants :

Paramètre Description
Mailbox Obligatoire

Une boîte aux lettres pour attendre une réponse, telle que user@example.com.

Par défaut, l'action utilise la boîte aux lettres par défaut que vous avez configurée pour l'intégration. Ce paramètre accepte plusieurs valeurs sous forme de liste d'éléments séparés par une virgule.
Internet Message ID Optional

ID de message Internet d'un e-mail à rechercher.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule.

Si vous fournissez l'ID du message Internet, l'action ignore les paramètres Subject Filter, Sender Filter et Time Frame (minutes).
Labels Filter Optional

Condition de filtre qui spécifie les libellés d'e-mail à rechercher.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule.

La valeur par défaut est Inbox.

Vous pouvez rechercher des e-mails associés à des libellés spécifiques, comme label1, label2. Pour rechercher des e-mails qui ne sont pas associés à un libellé spécifique, utilisez le format suivant : -label1. Vous pouvez configurer ce paramètre pour rechercher des e-mails avec et sans libellés spécifiques dans une même chaîne, par exemple label1, -label2, label3.
Subject Filter Optional

Condition de filtre qui spécifie l'objet de l'e-mail à rechercher.

Ce filtre utilise la logique contains et nécessite que vous spécifiiez les éléments de recherche en mots entiers. Ce filtre n'est pas compatible avec les correspondances partielles.
Sender Filter Optional

Condition de filtre qui spécifie l'expéditeur de l'e-mail à rechercher.

Ce filtre utilise la logique equals.
Time Frame (minutes) Optional

Condition de filtre qui spécifie la période en minutes pour rechercher des e-mails.

La valeur par défaut est de 60 minutes.
Email Status Optional

État de l'e-mail à rechercher.

Les valeurs possibles sont les suivantes :

  • Only Unread Messages
  • Only Read Messages
  • Both Read & Unread Messages

La valeur par défaut est Both Read & Unread Messages.
Label Obligatoire

Libellé à supprimer d'un e-mail.

Ce paramètre accepte plusieurs valeurs sous forme de liste d'éléments séparés par une virgule. Pour supprimer tous les libellés de l'e-mail, définissez la valeur du paramètre sur All.

Sorties de l'action

L'action Supprimer le libellé de l'e-mail 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 Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Supprimer le libellé de l'e-mail :

[
   {
       "Entity": "email@example.com",
       "EntityResult": [
           {
               "id": "ID",
               "thread_id": "THREAD_ID",
               "label_ids": [
                   "CATEGORY_PERSONAL",
                   "INBOX"
               ],
               "snippet": "SNIPPET",
               "history_id": "10576",
               "internal_date": 1728217410000,
               "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@mail.gmail.com>",
               "subject": "SUBJECT",
               "from": "example@example.com",
               "headers": {
                   "delivered-to": "email@example.com",
                   "received": [
                       "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
                   ],
                   "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
                   "x-received": [
                       "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
                   ],
                   "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
                   "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
                   "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
               },
               "mimetype": "text/plain",
               "text_bodies": [
                   "text\r\n"
               ],
               "html_bodies": [],
               "file_attachments": [],
               "date": "Sun, 6 Oct 2024 12:23:30 +0000",
               "to": "email@example.com",
               "cc": null,
               "bcc": null,
               "in-reply-to": null,
               "reply-to": null
           }
       ]
   }
]
Messages de sortie

L'action Supprimer le libellé de l'e-mail fournit les messages de sortie suivants :

Message de sortie Description du message

Successfully updated labels for EMAIL_NUMBER emails in the MAILBOX_NAME mailbox.

The following labels don't exist in the MAILBOX_NAME mailbox: LABEL_LIST

None of the provided labels exists in the MAILBOX_NAME mailbox.

 L'action a réussi.
Error executing action "Remove Email Label". 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 décrit les valeurs de la sortie du résultat du script lorsque vous utilisez l'action Supprimer le libellé de l'e-mail :

Nom du résultat du script Valeur
is_success True ou False

Enregistrer l'e-mail dans la demande

Utilisez l'action Save Email To The Case (Enregistrer l'e-mail dans la demande) pour enregistrer un e-mail ou des pièces jointes dans le mur de la demande dans Google SecOps.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Enregistrer l'e-mail dans la demande nécessite les paramètres suivants :

Paramètre Description
Mailbox Obligatoire

Une boîte aux lettres pour attendre une réponse, telle que user@example.com.

Par défaut, l'action utilise la boîte aux lettres par défaut que vous avez configurée pour l'intégration.
Internet Message ID Obligatoire

ID de message Internet d'un e-mail à rechercher.
Save Only Email Attachments Optional

Si cette option est sélectionnée, l'action n'enregistre que les pièces jointes de l'e-mail spécifié.

Non sélectionné par défaut.
Attachment To Save Optional

Si vous avez sélectionné le paramètre Save Only Email Attachments, l'action n'enregistre que les pièces jointes que vous spécifiez dans ce paramètre.

Ce paramètre accepte plusieurs valeurs sous la forme d'une chaîne d'éléments séparés par une virgule.
Base64 Encode Optional

Si cette option est sélectionnée, l'action encode le fichier d'e-mail au format base64.

Non sélectionné par défaut.

Sorties de l'action

L'action Enregistrer l'e-mail dans la demande fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Pièce jointe du mur des cas

L'action Enregistrer l'e-mail dans la demande enregistre les e-mails et les pièces jointes en tant que preuves de demande dans Google SecOps.

Le tableau suivant décrit les fichiers enregistrés par l'action :

Fichier enregistré Nom et format
E-mail EMAIL_SUBJECT.eml
Email attachment ATTACHMENT_NAME. ATTACHMENT_EXTENSION
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Enregistrer l'e-mail dans la demande :

{
   "id": "ID",
   "thread_id": "THREAD_ID",
   "label_ids": [
       "CATEGORY_PERSONAL",
       "INBOX"
   ],
   "snippet": "SNIPPET",
   "history_id": "10576",
   "internal_date": 1728217410000,
   "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
   "subject": "SUBJECT",
   "from": "example@example.com",
   "headers": {
       "delivered-to": "email@example.com",
       "received": [
           "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
       ],
       "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
       "x-received": [
           "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
       ],
       "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
       "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
       "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
   },
   "mimetype": "text/plain",
   "text_bodies": [
       "example\r\n"
   ],
   "html_bodies": [],
   "file_attachments": [],
   "date": "Sun, 6 Oct 2024 12:23:30 +0000",
   "to": "email@example.com",
   "cc": null,
   "bcc": null,
   "in-reply-to": null,
   "reply-to": null
}
Messages de sortie

L'action Enregistrer l'e-mail dans la demande fournit les messages de sortie suivants :

Message de sortie Description du message

Successfully saved the INTERNET_MESSAGE_ID email.

Successfully saved the following attachments from the INTERNET_MESSAGE_ID email: ATTACHMENT_NAMES

The following attachments were not found in the INTERNET_MESSAGE_ID email: ATTACHMENT_NAMES

 L'action a réussi.
Error executing action "Save Email To The Case". 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 décrit les valeurs de la sortie du résultat du script lorsque vous utilisez l'action Enregistrer l'e-mail dans la demande :

Nom du résultat du script Valeur
is_success True ou False

Rechercher des e-mails

Utilisez l'action Rechercher des e-mails pour rechercher des e-mails dans une boîte aux lettres spécifiée à l'aide des critères de recherche fournis.

Cette action est asynchrone. Ajustez le délai avant expiration de l'action dans l'IDE Google SecOps en conséquence.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Rechercher des e-mails nécessite les paramètres suivants :

Paramètre Description
Mailbox Obligatoire

Une boîte aux lettres pour attendre une réponse, telle que user@example.com.

Par défaut, l'action utilise la boîte aux lettres par défaut que vous avez configurée pour l'intégration. Ce paramètre accepte plusieurs valeurs sous forme de liste d'éléments séparés par une virgule.
Labels Filter Optional

Condition de filtre qui spécifie les libellés d'e-mail à rechercher.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule.

La valeur par défaut est Inbox.

Vous pouvez rechercher des e-mails associés à des libellés spécifiques, comme label1, label2. Pour rechercher des e-mails qui ne sont pas associés à un libellé spécifique, utilisez le format suivant : -label1. Vous pouvez configurer ce paramètre pour rechercher des e-mails avec et sans libellés spécifiques dans une même chaîne, par exemple label1, -label2, label3.
Internet Message ID Optional

ID de message Internet d'un e-mail à rechercher.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule.

Si vous fournissez l'ID de message Internet, l'action ignore les paramètres Subject Filter, Sender Filter, Labels Filter, Recipient Filter, Time Frame (minutes) et Email Status.
Subject Filter Optional

Condition de filtre qui spécifie l'objet de l'e-mail à rechercher.
Sender Filter Optional

Condition de filtre qui spécifie l'expéditeur de l'e-mail à rechercher.
Recipient Filter Optional

Condition de filtre qui spécifie le destinataire de l'e-mail à rechercher.
Time Frame (minutes) Optional

Condition de filtre qui spécifie la période en minutes pour rechercher des e-mails.

La valeur par défaut est de 60 minutes.
Email Status Optional

État de l'e-mail à rechercher.

Les valeurs possibles sont les suivantes :

  • Only Unread Messages
  • Only Read Messages
  • Both Read & Unread Messages

La valeur par défaut est Both Read & Unread Messages.
Headers To Return Optional

Liste d'en-têtes séparés par une virgule à renvoyer dans la sortie de l'action.

L'action renvoie toujours les en-têtes suivants : date, from, to, cc, bcc, in-reply-to, reply-to, message-id et subject.

Si vous ne fournissez aucune valeur, l'action renvoie tous les en-têtes.

Ce paramètre n'est pas sensible à la casse.
Return Email Body Optional

Si cette option est sélectionnée, l'action renvoie l'intégralité du contenu du corps d'un e-mail dans le résultat de l'action. Si cette option n'est pas sélectionnée, les informations sur les noms des pièces jointes dans l'e-mail ne sont pas disponibles.

Non sélectionné par défaut.
Max Emails To Return Optional

Nombre maximal d'e-mails à renvoyer pour l'action.

La valeur par défaut est 50.

Sorties de l'action

L'action Rechercher des e-mails 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 Disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Tableau du mur des cas

L'action Rechercher des e-mails fournit le tableau suivant :

Titre du tableau : E-mails trouvés

Colonnes :

  • Message_id
  • Received Date
  • Sender
  • Destinataires
  • Subject
  • Extrait du corps de l'e-mail
  • Nom des pièces jointes
  • Facultatif : Trouvé dans la boîte aux lettres
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Rechercher des e-mails :

[
   {
       "Entity": "email@example.com",
       "EntityResult": [
           {
               "id": "ID",
               "thread_id": "THREAD_ID",
               "label_ids": [
                   "CATEGORY_PERSONAL",
                   "INBOX"
               ],
               "snippet": "SNIPPET",
               "history_id": "10576",
               "internal_date": 1728217410000,
               "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
               "subject": "SUBJECT",
               "from": "example@example.com",
               "headers": {
                   "delivered-to": "email@example.com",
                   "received": [
                       "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
                   ],
                   "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
                   "x-received": [
                       "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
                   ],
                   "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
                   "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
                   "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
               },
               "mimetype": "text/plain",
               "text_bodies": [
                   "text\r\n"
               ],
               "html_bodies": [],
               "file_attachments": [],
               "date": "Sun, 6 Oct 2024 12:23:30 +0000",
               "to": "email@example.com",
               "cc": null,
               "bcc": null,
               "in-reply-to": null,
               "reply-to": null
           }
       ]
   }
]
Messages de sortie

L'action Rechercher des e-mails fournit les messages de sortie suivants :

Message de sortie Description du message

Successfully found emails in the following mailboxes: MAILBOX_LIST

No emails found in the following mailboxes: MAILBOX_LIST

Pending search for emails in the following mailboxes: MAILBOX_LIST

The following mailboxes were not found: MAILBOX_LIST. Please check the spelling.

The action was not able to find any emails based on the specified search criteria.

 L'action a réussi.
Error executing action "Search For Emails". 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 décrit les valeurs de la sortie du résultat du script lorsque vous utilisez l'action Rechercher des e-mails :

Nom du résultat du script Valeur
is_success True ou False

Envoyer un e-mail

Utilisez l'action Envoyer un e-mail pour envoyer un e-mail en fonction des paramètres fournis.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Envoyer un e-mail nécessite les paramètres suivants :

Paramètre Description
Mailbox Obligatoire

Une boîte aux lettres à partir de laquelle envoyer un e-mail, par exemple user@example.com.

Par défaut, l'action utilise la boîte aux lettres par défaut que vous avez configurée pour l'intégration.
Subject Obligatoire

Objet d'un e-mail à envoyer.
Send To Obligatoire

Chaîne d'adresses e-mail des destinataires, séparées par une virgule, par exemple user1@example.com, user2@example.com.

CC Optional

Chaîne d'adresses e-mail séparées par une virgule pour les destinataires de l'e-mail en copie carbone (CC), par exemple user1@example.com, user2@example.com.
BCC Optional

Chaîne d'adresses e-mail séparées par une virgule pour les destinataires de la copie carbone invisible (CCI), par exemple user1@example.com, user2@example.com.
Attachments Paths Optional

Chaîne de chemins d'accès séparés par une virgule pour les fichiers joints stockés sur le serveur Google SecOps.
Mail Content Obligatoire

Corps de l'e-mail.
Reply-To Recipients Optional

Liste de destinataires séparés par une virgule à utiliser dans l'en-tête Reply-To.

Utilisez l'en-tête Reply-To pour rediriger les réponses vers l'adresse e-mail spécifique au lieu de l'adresse de l'expéditeur indiquée dans le champ From.

Sorties de l'action

L'action Envoyer un e-mail 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 Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Envoyer un e-mail :

{
   "id": "ID",
   "thread_id": "THREAD_ID",
   "label_ids": [
       "CATEGORY_PERSONAL",
       "INBOX"
   ],
   "snippet": "SNIPPET",
   "history_id": "10576",
   "internal_date": 1728217410000,
   "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
   "subject": "SUBJECT",
   "from": "example@example.com",
   "headers": {
       "delivered-to": "email@example.com",
       "received": [
           "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
       ],
       "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
       "x-received": [
           "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
       ],
       "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
       "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
       "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
   },
   "mimetype": "text/plain",
   "text_bodies": [
       "example\r\n"
   ],
   "html_bodies": [],
   "file_attachments": [],
   "date": "Sun, 6 Oct 2024 12:23:30 +0000",
   "to": "email@example.com",
   "cc": null,
   "bcc": null,
   "in-reply-to": null,
   "reply-to": null
}
Messages de sortie

L'action Envoyer un e-mail fournit les messages de sortie suivants :

Message de sortie Description du message
Email was sent successfully. L'action a réussi.
Error executing action "Send Email". 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 décrit les valeurs de la sortie du résultat du script lorsque vous utilisez l'action Envoyer un e-mail :

Nom du résultat du script Valeur
is_success True ou False

Envoyer une réponse au fil de discussion

Utilisez l'action Envoyer une réponse au fil de discussion pour envoyer un message en réponse au fil de discussion.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Envoyer une réponse au fil de discussion nécessite les paramètres suivants :

Paramètre Description
Mailbox Obligatoire

Une boîte aux lettres pour attendre une réponse, telle que user@example.com.

Par défaut, l'action utilise la boîte aux lettres par défaut que vous avez configurée pour l'intégration.
Internet Message ID Obligatoire

ID de message Internet d'un e-mail à rechercher.
Reply To Optional

Liste d'adresses e-mail auxquelles envoyer la réponse, séparées par une virgule.

Si vous ne fournissez aucune valeur et que la case Reply All n'est pas cochée, l'action n'envoie une réponse qu'à l'expéditeur de l'e-mail d'origine. Si vous sélectionnez le paramètre Reply All, l'action l'ignore.
Reply All Optional

Si cette option est sélectionnée, l'action envoie une réponse à tous les destinataires de l'e-mail d'origine.

Ce paramètre est prioritaire sur le paramètre Reply To.

Non sélectionné par défaut.
Attachments Paths Optional

Chaîne de chemins d'accès séparés par une virgule pour les fichiers joints stockés sur le serveur Google SecOps.
Mail Content Obligatoire

Corps de l'e-mail.

Sorties de l'action

L'action Envoyer une réponse au fil de discussion 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 Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Envoyer une réponse au fil de discussion :

{
   "id": "ID",
   "thread_id": "THREAD_ID",
   "label_ids": [
       "CATEGORY_PERSONAL",
       "INBOX"
   ],
   "snippet": "SNIPPET",
   "history_id": "10576",
   "internal_date": 1728217410000,
   "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
   "subject": "SUBJECT",
   "from": "example@example.com",
   "headers": {
       "delivered-to": "email@example.com",
       "received": [
           "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
       ],
       "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
       "x-received": [
           "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
       ],
       "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
       "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
       "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
   },
   "mimetype": "text/plain",
   "text_bodies": [
       "text\r\n"
   ],
   "html_bodies": [],
   "file_attachments": [],
   "date": "Sun, 6 Oct 2024 12:23:30 +0000",
   "to": "email@example.com",
   "cc": null,
   "bcc": null,
   "in-reply-to": null,
   "reply-to": null
}
Messages de sortie

L'action Envoyer une réponse au fil de discussion fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully sent a thread reply to the INTERNET_MESSAGE_ID email. L'action a réussi.
Error executing action "Sent Thread Reply". 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 décrit les valeurs de la sortie du résultat du script lors de l'utilisation de l'action Envoyer une réponse au fil de discussion :

Nom du résultat du script Valeur
is_success True ou False

Attendre la réponse du thread

Utilisez l'action Attendre une réponse au fil de discussion pour attendre la réponse de l'utilisateur en fonction d'un e-mail envoyé à l'aide de l'action Envoyer un e-mail.

Cette action est asynchrone. Ajustez le délai avant expiration de l'action dans l'IDE Google SecOps en conséquence.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Attendre une réponse au fil de discussion nécessite les paramètres suivants :

Paramètre Description
Mailbox Obligatoire

Une boîte aux lettres pour attendre une réponse, telle que user@example.com.

Par défaut, l'action utilise la boîte aux lettres par défaut que vous avez configurée pour l'intégration. Ce paramètre accepte plusieurs valeurs sous forme de liste d'éléments séparés par une virgule.
Internet Message ID Obligatoire

ID de message Internet d'un e-mail pour l'action à attendre. Si le message a été envoyé à l'aide de l'action Envoyer un e-mail, configurez ce paramètre à l'aide de l'espace réservé SendEmail.JSONResult|message_id.

Pour récupérer un ID de message Internet, utilisez l'action Rechercher des e-mails.
Wait for All Recipients to Reply Optional

Si cette option est sélectionnée, l'action attend les réponses de tous les destinataires jusqu'à l'expiration du délai.

Non sélectionné par défaut.
Fetch Response Attachments Optional

Si cette option est sélectionnée et que la réponse du destinataire contient des pièces jointes, l'action récupère les pièces jointes de l'e-mail et les ajoute en tant que pièces jointes au mur de la demande dans Google SecOps.

Non sélectionné par défaut.

Sorties de l'action

L'action Attendre une réponse au fil de discussion 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 Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Attendre une réponse au fil de discussion :

[
   {
       "Entity": "reply@example.com",
       "EntityResult": [
           {
               "id": "ID",
               "thread_id": "THREAD_ID",
               "label_ids": [
                   "CATEGORY_PERSONAL",
                   "INBOX"
               ],
               "snippet": "SNIPPET",
               "history_id": "10576",
               "internal_date": 1728217410000,
               "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
               "subject": "SUBJECT",
               "from": "example@example.com",
               "headers": {
                   "delivered-to": "reply@example.com",
                   "received": [
                       "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
                   ],
                   "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
                   "x-received": [
                       "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
                   ],
                   "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
                   "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
                   "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
               },
               "mimetype": "text/plain",
               "text_bodies": [
                   "text\r\n"
               ],
               "html_bodies": [],
               "file_attachments": [],
               "date": "Sun, 6 Oct 2024 12:23:30 +0000",
               "to": "reply@example.com",
               "cc": null,
               "bcc": null,
               "in-reply-to": null,
               "reply-to": null
           }
       ]
   }
]
Messages de sortie

L'action Attendre une réponse au fil de discussion fournit les messages de sortie suivants :

Message de sortie Description du message

Found replies from the following users: USERS

Waiting for replies from the following users: USERS

 L'action a réussi.
Error executing action "Wait For Thread Reply". 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 décrit les valeurs de la sortie du résultat du script lorsque vous utilisez l'action Attendre la réponse du fil de discussion :

Nom du résultat du script Valeur
is_success True ou False

Connecteurs

Pour obtenir des instructions détaillées sur la configuration d'un connecteur dans Google SecOps, consultez Ingérer vos données (connecteurs).

Connecteur Gmail

Utilisez le connecteur Gmail pour récupérer les e-mails Gmail d'une boîte aux lettres spécifiée.

Le connecteur Gmail n'ingère pas les e-mails portant l'étiquette Planifié pour les raisons suivantes :

  • Le connecteur n'ingère que les e-mails envoyés. Le libellé Planifié signifie que les e-mails sont seulement planifiés, et non envoyés.
  • Le connecteur nécessite des codes temporels pour récupérer les e-mails. Les e-mails programmés n'ont pas de code temporel.

Entrées du connecteur

Le connecteur Gmail 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 device_product.
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 event_name.
Environment Field Name Optional

Nom du champ dans lequel le nom de l'environnement est stocké.

Si le champ d'environnement est introuvable, l'environnement est défini sur "".

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 final de l'environnement est "".
Email Exclude Pattern Optional

Expression régulière permettant d'exclure des e-mails spécifiques de l'ingestion, tels que les spams ou les actualités.

Ce paramètre fonctionne à la fois avec l'objet et le corps d'un e-mail. Par exemple, pour exclure les e-mails de réponse automatique de l'ingestion, vous pouvez configurer l'expression régulière suivante : (?i)(auto|no)(\s|-)?re(ply|sponse|sponder).
Script Timeout (Seconds) Obligatoire

Délai avant expiration (en secondes) du processus Python exécutant le script actuel.

La valeur par défaut est de 300 secondes.
Service Account JSON File Content Optional

Contenu du fichier JSON de la clé du compte de service.

Vous pouvez configurer ce paramètre ou le paramètre Workload Identity Email.

Pour configurer ce paramètre, fournissez l'intégralité du contenu du fichier JSON de la clé du compte de service que vous avez téléchargé lors de la création d'un compte de service.
Workload Identity Email Optional

Adresse e-mail du client de votre compte de service.

Vous pouvez configurer ce paramètre ou le paramètre Service Account JSON File Content.

Pour emprunter l'identité de comptes de service avec des charges de travail, attribuez le rôle Service Account Token Creator à votre compte de service Google SecOps.
Disable Overflow Optional

Si cette option est sélectionnée, le connecteur ignore le mécanisme de dépassement de Google SecOps lors de la création de l'alerte.

Non sélectionné par défaut.
Default Mailbox Obligatoire

Adresse e-mail à utiliser comme boîte aux lettres par défaut pour l'intégration, par exemple user@example.com.
Labels Filter Optional

Libellés des e-mails à ingérer dans Google SecOps.

Le connecteur est compatible avec les libellés imbriqués. Fournissez les libellés dans un format accepté par Gmail, tel que Inbox-label1-label2.
Email Status Optional

État de l'e-mail à rechercher.

Les valeurs possibles sont les suivantes :

  • Both
  • Read
  • Unread
La valeur par défaut est Both.
Extract Headers Optional

Valeurs d'en-tête à filtrer dans la liste internetMessageHeaders et à ajouter à un événement Google SecOps.

Par défaut, le connecteur ajoute tous les en-têtes à l'événement. Pour n'ajouter que des en-têtes spécifiques, saisissez-les sous forme de liste d'éléments séparés par une virgule, par exemple DKIM-Siganture, Received, From. Pour empêcher le connecteur d'ajouter un en-tête, saisissez la valeur None.

Ce paramètre n'est pas sensible à la casse.
Attached Mail File Prefix Optional

Préfixe à ajouter aux clés d'événement extraites (par exemple, to, from ou subject) du fichier d'e-mail joint reçu dans la boîte aux lettres surveillée.

La valeur par défaut est attach.
Original Received Mail Prefix Optional

Préfixe à ajouter aux clés d'événement extraites (par exemple, to, from ou subject) de l'e-mail d'origine reçu dans la boîte aux lettres surveillée.

La valeur par défaut est orig.
Attach Original EML Optional

Si cette option est sélectionnée, le connecteur joint l'e-mail d'origine aux informations de la demande sous la forme d'un fichier EML (Elements Markup Language).

Non sélectionné par défaut.

Create Alert Per Attachment File Optional

Si cette option est sélectionnée, le connecteur crée plusieurs alertes, une pour chaque fichier d'e-mail joint.

Ce comportement est utile lorsque vous traitez des e-mails contenant plusieurs fichiers d'e-mails joints et que vous définissez le mappage d'événements Google SecOps pour créer des entités à partir des fichiers d'e-mails joints.

Non sélectionné par défaut.
Max Emails Per Cycle Optional

Nombre maximal d'e-mails à récupérer pour chaque itération du connecteur.

Le nombre maximal est de 100. La valeur par défaut est 10.
Max Hours Backwards Optional

Nombre d'heures avant la première itération du connecteur à partir de laquelle récupérer les incidents. Ce paramètre s'applique à l'itération initiale du connecteur après l'activation du connecteur pour la première fois ou à la valeur de remplacement d'un code temporel de connecteur expiré.

La valeur par défaut est 24.
Case Name Template Optional

Un nom de cas personnalisé.

Lorsque vous configurez ce paramètre, le connecteur ajoute une clé appelée custom_case_name à l'événement Google SecOps.

Vous pouvez fournir des espaces réservés au format suivant : [name of the field].

Exemple : Phishing - [event_mailbox].

Pour les espaces réservés, le connecteur utilise le premier événement Google SecOps. Le connecteur ne gère que les clés contenant la valeur de chaîne. Pour configurer ce paramètre, spécifiez les champs d'événement sans préfixe.
Alert Name Template Optional

Nom d'alerte personnalisé.

Vous pouvez fournir des espaces réservés au format suivant : [name of the field].

Exemple : Phishing - [event_mailbox].

Pour les espaces réservés, le connecteur utilise le premier événement Google SecOps SOAR. Le connecteur ne gère que les clés contenant la valeur de chaîne. Si vous ne fournissez aucune valeur ou un modèle non valide, le connecteur utilise le nom d'alerte par défaut. Pour configurer ce paramètre, spécifiez les champs d'événement sans préfixe.
Verify SSL Obligatoire

Si cette option est sélectionnée, l'intégration vérifie que le certificat SSL de connexion à Gmail est valide. Cette option est sélectionnée 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

Le connecteur Gmail est compatible avec la liste dynamique.

Pour filtrer des valeurs spécifiques du corps et de l'objet de l'e-mail, utilisez les expressions régulières de la liste dynamique au format suivant : key: regex, par exemple subject: (?<=Subject: ).*. Par exemple, après avoir trouvé une correspondance pour l'expression régulière subject: (?<=Subject: ).*, le connecteur crée un événement d'alerte Google SecOps et y ajoute une nouvelle clé portant le nom subject. La nouvelle valeur de clé correspond à l'expression régulière.

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.