Mimecast

Ce document explique comment intégrer Mimecast à Google SecOps.

Cas d'utilisation

  1. Ingérer les messages
  2. Effectuer une action de tri (rejeter/libérer/signaler un message)

Avant de commencer

Avant de continuer, assurez-vous que votre environnement Mimecast est préparé avec les licences produit et les rôles d'administrateur nécessaires.

Produits et services Mimecast requis

Pour que l'intégration de l'API Mimecast 2.0 fonctionne correctement, votre compte Mimecast doit disposer de licences pour les produits suivants :

Autorisations requises pour le rôle Mimecast

Pour configurer l'intégration de Mimecast, vous devez d'abord créer un rôle Mimecast avec les autorisations requises dans la console d'administration Mimecast.

Les autorisations requises sont les suivantes :

  • Account | Dashboard | Read

  • Account | Monitoring | Held | Edit

  • Archive | Search Logs | Read

  • Archive | View Logs | Read

  • Gateway | Managed Senders | Edit

  • Gateway | Policies | Edit

  • Gateway | Policies | Read

  • Gateway | Tracking | Read

Configurer l'intégration de Mimecast dans Google SecOps

Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Paramètres d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Racine de l'API Chaîne <https:/<<api root>> Oui Racine de l'API de l'instance Mimecast.
ID application Chaîne N/A Oui ID d'application de l'instance Mimecast.
Clé d'application Mot de passe N/A Oui Clé d'application de l'instance Mimecast.
Clé d'accès Mot de passe N/A Oui Clé d'accès de l'instance Mimecast.
Clé secrète Mot de passe N/A Oui Clé secrète de l'instance Mimecast.
Vérifier le protocole SSL Case à cocher Cochée Oui Si cette option est activée, vérifiez que le certificat SSL de la connexion au serveur Mimecast est valide.

Actions

Ping

Description

Testez la connectivité à Mimecast avec les paramètres fournis sur la page de configuration de l'intégration dans la page Google SecOps Content Hub.

Paramètres

N/A

Exécuter sur

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

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
En cas de réussite : "Successfully connected to the Mimecast server with the provided connection parameters!"

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'échec : "Échec de la connexion au serveur Mimecast ! Error is {0}".format(exception.stacktrace)

Général

Description

Recherchez des e-mails archivés à l'aide de paramètres définis dans Mimecast.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Champs à renvoyer CSV

attachmentcount,status,subject,
size,receiveddate,displayfrom,
displayfromaddress,id,displayto,
displaytoaddresslist,smash

Oui Spécifiez une liste de champs à renvoyer, séparés par une virgule.
Boîtes aux lettres CSV N/A Non Spécifiez une liste de boîtes aux lettres à rechercher, séparées par une virgule.
De CSV N/A Non Spécifiez une liste d'adresses e-mail à partir desquelles les e-mails ont été envoyés, séparées par une virgule.
À CSV N/A Non Spécifiez une liste d'adresses e-mail auxquelles les e-mails ont été envoyés, séparées par une virgule.
Objet Chaîne N/A Non Spécifiez un sujet à rechercher.
Période LDD

La dernière heure

Valeurs possibles :

La dernière heure

Les 6 dernières heures

Dernières 24 heures

La semaine dernière

Le mois dernier

Personnalisé

Oui Spécifiez une période pour la recherche. Si vous sélectionnez "Personnalisé", vous devez également indiquer une "heure de début".
Heure de début Chaîne N/A Non Spécifiez l'heure de début de la recherche. Ce paramètre est obligatoire si "Personnalisé" est sélectionné pour le paramètre "Période". Format : ISO 8601
Heure de fin Chaîne N/A Non Spécifiez l'heure de fin de la recherche. Format : ISO 8601. Si aucune valeur n'est fournie et que "Personnalisé" est sélectionné pour le paramètre "Période", ce paramètre utilisera l'heure actuelle.
Nombre maximal d'e-mails à renvoyer Intégration 50 Non Spécifiez le nombre d'e-mails à renvoyer. Valeur par défaut : 50.

Exécuter sur

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

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
Si des données sont disponibles(is_success = true) : "Successfully found archive emails for the provided criteria in Mimecast".

Si les données ne sont pas disponibles (is_success=true) : "No archive emails were found for the provided criteria in Mimecast" (Aucun e-mail archivé n'a été trouvé pour les critères fournis dans Mimecast)



L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Error executing action "Simple Archive Search". Reason: {0}''.format(error.Stacktrace)

Si l'heure de début est vide et que la période est définie sur "Personnalisée" : "Erreur lors de l'exécution de l'action "Recherche simple dans l'archive". Motif : "Heure de début" doit être indiqué lorsque "Personnalisé" est sélectionné dans le paramètre "Période"."

Si des échecs/erreurs sont signalés : erreur lors de l'exécution de l'action "Recherche simple dans l'archive". Motif : fail/errors/message".

Général
Tableau du mur des cas

Nom : Résultats

Colonnes :

Toutes les clés de la réponse

Général

Description

Recherchez les e-mails archivés à l'aide d'une requête XML personnalisée dans Mimecast.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
XML Query XML N/A Oui Spécifiez une requête XML à utiliser lors de la recherche d'e-mails archivés. Pour en savoir plus, veuillez consulter la documentation.

Exécuter sur

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

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
Si des données sont disponibles(is_success = true) : "Successfully found archive emails for the provided criteria in Mimecast".

Si les données ne sont pas disponibles (is_success=true) : "No archive emails were found for the provided criteria in Mimecast".

L'action doit échouer et arrêter l'exécution du playbook :
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Error executing action "Advanced Archive Search". Reason: {0}''.format(error.Stacktrace)

Si "fail/errors" contient des valeurs : erreur lors de l'exécution de l'action "Recherche avancée dans les archives". Motif : fail/errors/message".

Général
Tableau du mur des cas

Nom : Résultats

Colonnes :

Toutes les clés de la réponse

Général

Rejeter le message

Description

Rejetez le message dans Mimecast. Remarque : Seuls les messages dont l'état est "En attente" peuvent être refusés.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID du message Chaîne N/A Oui Spécifiez l'ID du message à rejeter.
Remarque Chaîne N/A Non Spécifiez une note supplémentaire expliquant pourquoi le message a été refusé.
Motif DLL

Sélectionnez une réponse

Valeurs possibles :

Sélectionnez une réponse

Communication inappropriée

Informations confidentielles

Contraire aux règles concernant les e-mails

Contenu soumis à restriction

Non Indiquez le motif du refus.
Informer l'expéditeur Case à cocher Décochée Non Si cette option est activée, l'action informe l'expéditeur du rejet.

Exécuter sur

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

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
Si la réponse ne contient pas d'erreur (is_success = true) : "Successfully rejected message with ID "{ID}" in Mimecast".

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Error executing action "Reject Message". Reason: {0}''.format(error.Stacktrace)

Si "fail/errors" contient des valeurs : erreur lors de l'exécution de l'action "Reject Message". Motif : fail/errors/message".

Général

Message de publication

Description

Libérez le message dans Mimecast. Remarque : Seuls les messages dont l'état est "En attente" peuvent être libérés.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID du message Chaîne N/A Oui Spécifiez l'ID du message à libérer.
Publier dans le bac à sable Case à cocher N/A Non Si cette option est activée, l'action libère le message dans le bac à sable.

Exécuter sur

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

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
Si aucune erreur n'est renvoyée (is_success = true) : "Successfully released message with ID "{ID}" in Mimecast".

L'action doit échouer et arrêter l'exécution d'un playbook :
En cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Error executing action "Release Message". Reason: {0}''.format(error.Stacktrace)

Si "fail/errors" contient des valeurs : erreur lors de l'exécution de l'action "Libérer le message". Motif : fail/errors/message".

Général

Signaler un message (obsolète)

Signalez le message dans Mimecast.

Entrées de l'action

Paramètre Description
Message IDs

Obligatoire.

Spécifiez l'ID du message à signaler.

Report as

Facultatif.

Spécifiez le type de rapport pour le message.

Les valeurs possibles sont les suivantes :

  • Spam
  • Malware
  • Phishing
Comment

Facultatif.

Spécifiez le commentaire du rapport.

Exécuter sur

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

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False/is_success=True
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

  • Si des données sont disponibles (is\_success = true) : afficher "Successfully reported the following messages with ID "{ID}" in Mimecast".
  • Si fail/errors contient des valeurs : affichez "Error executing action "Report Message". Motif : fail/errors/message".

L'action doit échouer et arrêter l'exécution d'un playbook :

  • En cas d'erreur fatale (identifiants incorrects, aucune connexion au serveur, etc.) : affichez "Erreur lors de l'exécution de l'action 'Signaler un message'. Reason: {0}''.format(error.Stacktrace).
Général

Bloquer l'expéditeur

Description

Bloquez l'expéditeur dans Mimecast.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Expéditeur Chaîne N/A Oui Spécifiez l'adresse e-mail de l'expéditeur à bloquer.
Destinataire Chaîne N/A Oui Spécifiez l'adresse e-mail du destinataire à bloquer.

Exécuter sur

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

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
Si aucune erreur n'est renvoyée (is_success = true) : "Successfully blocked sender {sender} for recipient {recipient} in Mimecast".

L'action doit échouer et arrêter l'exécution d'un playbook
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Error executing action "Block Sender". Reason: {0}''.format(error.Stacktrace)

Si le champ "Échec/Erreurs" contient des valeurs : erreur lors de l'exécution de l'action "Bloquer l'expéditeur". Motif : fail/errors/message".

Général

Autoriser l'expéditeur

Description

Autorisez l'expéditeur dans Mimecast.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Expéditeur Chaîne N/A Oui Spécifiez l'adresse e-mail de l'expéditeur à autoriser.
Destinataire Chaîne N/A Oui Spécifiez l'adresse e-mail du destinataire à autoriser.

Exécuter sur

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

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
Si aucune erreur n'est renvoyée (is_success = true) : "Successfully permitted sender {sender} for recipient {recipient} in Mimecast".

L'action doit échouer et arrêter l'exécution d'un playbook
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Error executing action "Permit Sender". Reason: {0}''.format(error.Stacktrace)

Si le champ "Échec/Erreurs" contient des valeurs : erreur lors de l'exécution de l'action "Autoriser l'expéditeur". Motif : fail/errors/message".

Général

Créer une règle de blocage d'expéditeur

Créez une règle de blocage d'expéditeur dans Mimecast.

Exécuter sur

Cette action ne s'exécute sur aucune entité.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Filigrane Est obligatoire Description
Réponse LDD N/A N/A Non Indiquez le type de réponse qui sera associé à la stratégie créée.
Description Chaîne N/A N/A Oui Description de la règle.
Données extraites LDD N/A N/A Définissez l'emplacement à partir duquel les informations sur l'expéditeur et le destinataire doivent être extraites.
Expéditeur Chaîne N/A N/A Non Expéditeur du message à bloquer. Nécessaire uniquement si le "Type d'expéditeur" est l'un des suivants : domaine de messagerie, adresse e-mail, nom à afficher dans l'en-tête. Ce paramètre est ignoré si une autre valeur "Type de départ" est sélectionnée.
Type d'expéditeur LDD N/A N/A Non Type d'expéditeur pour la règle.
Destinataire Chaîne N/A N/A Non Destinataire du message à bloquer. Obligatoire uniquement si "Type de destinataire" est l'un des éléments suivants : domaine de messagerie, adresse e-mail, nom à afficher dans l'en-tête. Ce paramètre est ignoré si une autre valeur est sélectionnée pour "Type de destinataire".
Type de destinataire LDD N/A N/A Non Type de destinataire de la règle.
Commentaire Chaîne N/A N/A Non Commentaire pour une règle.
Bidirectionnelle Bool N/A N/A Non Si elle est activée, la règle sera définie de manière bidirectionnelle.
Appliquée Bool N/A N/A Non Si elle est activée, la règle est appliquée.
Heure de début Chaîne N/A N/A Non Heure de début de la règle. Si aucune valeur n'est fournie, l'heure de début sera définie sur "eternal". Format ISO 8601 attendu. Exemple : 2025-03-07T16:03:00Z
Heure de fin Chaîne N/A N/A Non Heure de fin de la règle. Si aucune valeur n'est fournie, l'heure de fin est définie sur "eternal". Format ISO 8601 attendu. Exemple : 2025-03-07T16:03:00Z

Résultats de l'action

Type Disponible
Résultat du script Vrai
Résultat JSON Vrai
Table d'enrichissement Faux
Tableau du mur des cas Faux
Lien vers le mur des cas Faux
Pièce jointe au mur des cas Faux
Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat JSON
{
   "option": "block_sender",
   "id": "eNo1jr0OgjAYAN-lqw79QKyYOCCSiCJGqSCjlmqQn2ILNmp8d3Fwv8vdGynOOsnzDE3RSsP4ZTT0tPUMO3DL1pK-LrFZzzfJ9XJTrC78yPZgcc7CW1QdSLuUo11Mfc2rpIsfxlxQHFsDFXKPdkeq10ym7uJeDIKLA6Z66T1NUklI4c3QEDWizNnzVzYnBthDxDrViopLJjLe77iHyAEgjkmgpx9cqlzUaAp_kz4b7vc2YDzCny9vYUEo",
   "policy": {
       "description": "Description",
       "fromPart": "both",
       "from": {
           "type": "individual_email_address",
           "emailAddress": "example@exampl.com"
       },
       "to": {
           "type": "individual_email_address",
           "emailAddress": "exampleto@exampl.com"
       },
       "fromType": "individual_email_address",
       "fromValue": "example@exampl.com",
       "toType": "individual_email_address",
       "toValue": "exampleto@exampl.com",
       "fromEternal": true,
       "toEternal": true,
       "fromDate": "1900-01-01T00:00:00+0000",
       "toDate": "2100-01-01T23:59:59+0000",
       "override": false,
       "bidirectional": false,
       "conditions": {},
       "enabled": true,
       "enforced": true,
       "createTime": "2025-03-27T12:51:46+0000",
       "lastUpdated": "2025-03-27T12:51:46+0000"
   }
}
Mur des cas
Type de résultat Valeur/Description Type (Entity \ General)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :


Si aucune erreur n'est renvoyée (is_success = true) : afficher "Successfully created a block sender policy in Mimecast".

L'action doit échouer et arrêter l'exécution d'un playbook :

if fatal error, like wrong credentials, no connection to server, other:print "Error executing action "{action name}". Reason: {0}''.format(error.Stacktrace)

Si "fail/errors" contient des valeurs : erreur lors de l'exécution de l'action "{action name}". Motif : fail/errors/message".

Connecteur

Mimecast - Connecteur de suivi des messages

Description

Récupérez les informations sur les messages dans l'onglet "Message Tracking" (Suivi des messages) de Mimecast. Remarque : La liste d'autorisation fonctionne sur le paramètre "queueDetailStatus/bounceType".

Configurer le connecteur Mimecast - Message Tracking dans Google SecOps

Pour obtenir des instructions détaillées sur la configuration d'un connecteur dans Google SecOps, consultez Configurer le connecteur.

Paramètres du connecteur

Utilisez les paramètres suivants pour configurer le connecteur :

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Nom du champ de produit Chaîne Nom du produit Oui Saisissez le nom du champ source pour récupérer le nom du champ produit.
Nom du champ d'événement Chaîne event_type Oui Saisissez le nom du champ source pour récupérer le nom du champ d'événement.
Nom du champ d'environnement Chaîne "" Non

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

Si le champ d'environnement n'est pas trouvé, l'environnement par défaut est utilisé.

Modèle d'expression régulière de l'environnement Chaîne .* Non

Modèle d'expression régulière à exécuter sur la valeur trouvée dans le champ "Nom du champ d'environnement".

La valeur par défaut est ".*" pour tout récupérer et renvoyer la valeur inchangée.

Permet à l'utilisateur de manipuler le champ "environment" à l'aide d'une logique d'expression régulière.

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 est l'environnement par défaut.

Délai avant expiration du script (en secondes) Int 180 Oui Délai avant expiration du processus Python exécutant le script actuel.
Racine de l'API Chaîne <https:/<<api root>> Oui Racine de l'API de l'instance Mimecast.
ID application Chaîne N/A Oui ID d'application de l'instance Mimecast.
Clé d'application Mot de passe N/A Oui Clé d'application de l'instance Mimecast.
Clé d'accès Mot de passe N/A Oui Clé d'accès de l'instance Mimecast.
Clé secrète Mot de passe N/A Oui Clé secrète de l'instance Mimecast.
Domaines CSV N/A Oui Liste de domaines pour lesquels interroger les messages, séparés par une virgule.
Risque le plus faible à récupérer Chaîne N/A Non

Risque le plus faible qui sera utilisé pour récupérer les messages. Valeurs possibles :

Négligeable, Faible, Moyen, Élevé.

Si rien n'est fourni, le connecteur ingère tous les messages.

Filtrage par état CSV conservé

Liste de filtres d'état pour les messages, séparés par une virgule. Valeurs possibles : delivery, held, accepted, bounced, deferred, rejected, archived.

Si rien n'est fourni, le connecteur ingère tous les messages.

Filtre de route CSV N/A

Filtres de routage séparés par une virgule pour les messages. Valeurs possibles : internal, outbound, inbound.

Si rien n'est fourni, le connecteur ingère tous les messages.

Filtre "Motif de la mise en file d'attente" CSV N/A

Liste de motifs de mise en file d'attente séparés par une virgule qui doivent filtrer les messages. Si aucune valeur n'est fournie, ce filtre est ignoré.

Ingérer des messages sans risque Case à cocher Si cette option est activée, le connecteur ingère les messages même s'il n'y a aucune information sur le risque. Les alertes Google SecOps générées à partir de ces messages auront une priorité définie sur "Informations".
Nombre maximal d'heures en arrière Entier 1 Non Nombre d'heures dans le passé à partir desquelles récupérer les messages. par défaut : 1 heure). Maximum : 30 jours.
Nombre maximal de messages à renvoyer Integer 100 Non Nombre de messages à traiter par itération de connecteur. Valeur par défaut : 100.
Utiliser la liste d'autorisation comme liste de blocage Case à cocher Cochée Oui Si cette option est activée, la liste d'autorisation sera utilisée comme liste de blocage.
Vérifier le protocole SSL Case à cocher Cochée Oui Si cette option est activée, vérifiez que le certificat SSL de la connexion au serveur Mimecast est valide.
Adresse du serveur proxy Chaîne N/A Non Adresse du serveur proxy à utiliser.
Nom d'utilisateur du proxy Chaîne N/A Non Nom d'utilisateur du proxy pour l'authentification.
Mot de passe du proxy Mot de passe N/A Non Mot de passe du proxy pour l'authentification.

Règles du connecteur

Assistance de proxy

Le connecteur est compatible avec les proxys.

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