Mimecast
Ce document explique comment intégrer Mimecast à Google SecOps.
Cas d'utilisation
- Ingérer les messages
- 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 | ReadAccount | Monitoring | Held | EditArchive | Search Logs | ReadArchive | View Logs | ReadGateway | Managed Senders | EditGateway | Policies | EditGateway | Policies | ReadGateway | 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 : L'action doit échouer et arrêter l'exécution d'un playbook : |
Général |
Recherche simple dans les archives
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, |
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 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)
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 |
Recherche avancée dans les archives
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 les données ne sont pas disponibles (is_success=true) : "No archive emails were found for the provided criteria in Mimecast". 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 : L'action doit échouer et arrêter l'exécution d'un playbook : 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 "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 :
|
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 :
L'action doit échouer et arrêter l'exécution d'un playbook :
|
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 : L'action doit échouer et arrêter l'exécution d'un playbook 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 : L'action doit échouer et arrêter l'exécution d'un playbook 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 :
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.