Collecter les journaux Trend Micro Email Security
Ce document explique comment ingérer les journaux Trend Micro Email Security dans Google Security Operations à l'aide de Bindplane. Trend Micro Email Security est une passerelle de messagerie dans le cloud qui protège les organisations contre le spam, les logiciels malveillants, l'hameçonnage, les ransomwares et les attaques ciblées avancées avant qu'ils n'atteignent les boîtes aux lettres des utilisateurs. Elle fournit un filtrage des URL, un bac à sable pour les pièces jointes et une protection contre la perte de données pour le trafic de messagerie entrant et sortant.
Avant de commencer
Assurez-vous de remplir les conditions suivantes :
- Une instance Google SecOps.
- Un hôte Windows 2016 ou version ultérieure, ou Linux avec systemd.
- Si vous exécutez l'application derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts conformément aux exigences de l'agent Bindplane.
- Un accès privilégié à la console d'administration Trend Micro Email Security.
Obtenir les identifiants Google SecOps pour l'agent Bindplane
Pour authentifier l'agent Bindplane auprès de Google SecOps, choisissez l'une des méthodes suivantes :
- Nouveaux déploiements : utilisez l'API Chronicle (option 1).
- Déploiements existants : continuez à utiliser le fichier d'authentification d'ingestion (option 2) jusqu'à l'arrêt de l'API d'ingestion le 20 juillet 2027.
Option 1 : Créer un compte de service pour l'API Chronicle (recommandé)
- Connectez-vous à la Google Cloud console et sélectionnez le Google Cloud projet associé à votre instance Google SecOps.
- Accédez à IAM et administration > Comptes de service.
- Cliquez sur Créer un compte de service.
- Fournissez les informations de configuration suivantes :
- Nom du compte de service : saisissez un nom pour le compte (par exemple,
bindplane-ingest). - Description du compte de service : saisissez une description (par exemple,
Bindplane agent log ingestion).
- Nom du compte de service : saisissez un nom pour le compte (par exemple,
- Cliquez sur Créer et continuer.
- Dans la section Autoriser ce compte de service à accéder au projet , cliquez sur Sélectionner un rôle , puis sélectionnez Éditeur Chronicle.
- Cliquez sur Continuer, puis sur OK.
- Cliquez sur le compte de service que vous avez créé, puis accédez à l'onglet Clés.
- Cliquez sur Ajouter une clé > Créer une clé.
- Sélectionnez JSON , puis cliquez sur Créer. Le fichier de clé est téléchargé sur votre ordinateur.
- Enregistrez le fichier de clé sous le nom
ingestion-auth.jsondans le répertoire du collecteur Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsonsous Linux ouC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonsous Windows), ou mettez à jourcreds_file_pathdansconfig.yamlpour qu'il corresponde au chemin d'accès où vous l'avez enregistré. - Accédez à IAM et administration > Paramètres , puis copiez le numéro de projet. Vous en aurez besoin pour la configuration de l'exportateur.
Option 2 : Télécharger le fichier d'authentification d'ingestion (hérité)
- Connectez-vous à la console Google SecOps.
- Accédez à Paramètres SIEM > Agents de collecte.
- Téléchargez le fichier d'authentification d'ingestion.
- Enregistrez le fichier de manière sécurisée sur le système où l'agent Bindplane sera installé.
Obtenir le numéro client Google SecOps
- Connectez-vous à la console Google SecOps.
- Accédez à Paramètres SIEM > Profil.
- Copiez et enregistrez le numéro client dans la section Informations sur l'organisation.
Installer l'agent Bindplane
Installez l'agent Bindplane sur votre système d'exploitation Windows ou Linux en suivant les instructions ci-dessous.
Installation sous Windows
- Ouvrez l'invite de commandes ou PowerShell en tant qu'administrateur.
Exécutez la commande suivante :
msiexec /i "[https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi](https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi)" /quiet
Installation sous Linux
- Ouvrez un terminal avec des droits root ou sudo.
Exécutez la commande suivante :
sudo sh -c "$(curl -fsSlL [https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh](https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh))" install_unix.sh
Ressources d'installation supplémentaires
Pour obtenir d'autres options d'installation, consultez ce guide d'installation.
Configurer l'agent Bindplane pour ingérer Syslog et l'envoyer à Google SecOps
Accédez au fichier de configuration :
- Recherchez le fichier
config.yaml. Il se trouve généralement dans le répertoire/opt/observiq-otel-collector/sous Linux ou dans le répertoire d'installation sous Windows. - Ouvrez le fichier à l'aide d'un éditeur de texte (par exemple,
nano,viou le Bloc-notes).
- Recherchez le fichier
Modifiez le fichier
config.yamlcomme suit :receivers: tcplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: YOUR_CUSTOMER_ID endpoint: chronicle.googleapis.com # Add optional ingestion labels for better organization log_type: 'TRENDMICRO_EMAIL_SECURITY' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - tcplog exporters: - chronicle/chronicle_w_labels
- Remplacez le port et l'adresse IP selon les besoins de votre infrastructure.
- Remplacez
<LOCATION>par la région de votre instance Google SecOps (par exemple,us,europe, ouasia-southeast1). L'exportateur préfixechronicle.googleapis.comavec cette valeur. - Remplacez
<PROJECT_NUMBER>par le numéro de projet dans IAM et administration > Paramètres. - Remplacez
YOUR_CUSTOMER_IDpar le numéro client réel. - Mettez à jour
/path/to/ingestion-authentication-file.jsonavec le chemin d'accès au fichier de clé du compte de service (option 1) enregistré à l'étape 1.
Ancien exportateur d'API d'ingestion
Si vous utilisez le fichier d'authentification d'ingestion de l'option 2, remplacez le bloc
exporterspar le code suivant. Définissezcreds_file_pathsur le chemin d'accès au fichier d'authentification d'ingestion. Si votre instance se trouve en dehors des États-Unis, remplacezmalachiteingestion-pa.googleapis.compar votre point de terminaison régional (par exemple,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: YOUR_CUSTOMER_ID endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization log_type: 'TRENDMICRO_EMAIL_SECURITY' raw_log_field: body ingestion_labels:
Redémarrer l'agent Bindplane pour appliquer les modifications
Pour redémarrer l'agent Bindplane sous Linux, exécutez la commande suivante :
sudo systemctl restart observiq-otel-collectorPour redémarrer l'agent Bindplane sous Windows, vous pouvez utiliser la console Services ou saisir la commande suivante :
net stop observiq-otel-collector && net start observiq-otel-collector
Configurer le transfert Syslog de Trend Micro Email Security
Pour configurer Trend Micro Email Security afin qu'il transfère les journaux à l'agent Bindplane via Syslog, procédez comme suit :
- Connectez-vous à la console d'administration Trend Micro Email Security.
- Accédez à Administration > Paramètres Syslog.
Cliquez sur Ajouter pour créer un profil de serveur Syslog.
Fournissez les informations de configuration suivantes :
- Adresse du serveur : saisissez l'adresse IP de l'hôte de l'agent Bindplane (par exemple,
192.168.1.100). - Port : saisissez
514(ou le port configuré dans l'agent Bindplane). - Protocole : sélectionnez TCP.
- Format : sélectionnez CEF (Common Event Format).
- Adresse du serveur : saisissez l'adresse IP de l'hôte de l'agent Bindplane (par exemple,
Dans la section Types de journaux, sélectionnez les catégories de journaux à transférer :
- Événements de règles : actions de règles de filtrage des e-mails.
- Détection du spam : événements de spam et de graymail.
- Détection de logiciels malveillants : événements de détection de virus et de logiciels malveillants.
- Détection de ransomwares : événements de détection de ransomwares.
- Analyse des URL : événements de clics sur des URL et de protection au moment du clic.
- Protection avancée contre les menaces : événements d'analyse en bac à sable.
- Protection contre la perte de données : événements de non-respect des règles de protection contre la perte de données.
- Filtrage du contenu : événements de règles de filtrage du contenu.
Cliquez sur Enregistrer.
Cliquez sur Tester la connexion pour vérifier que les journaux sont envoyés à l'agent Bindplane.
Vérifiez que les journaux arrivent en consultant les journaux de l'agent Bindplane.
Pour en savoir plus, consultez la documentation Trend Micro Email Security.
Tableau de mappage UDM
| Champ du journal | Mappage UDM | Logique |
|---|---|---|
additional_cn1 |
additional.fields |
Fusionné |
additional_cs1 |
additional.fields |
Fusionné |
additional_cs2 |
additional.fields |
Fusionné |
additional_cs3 |
additional.fields |
Fusionné |
additional_cs4 |
additional.fields |
Fusionné |
additional_cs5 |
additional.fields |
Fusionné |
additional_cs6 |
additional.fields |
Fusionné |
message |
extensions.auth.type |
Mappé : login → AUTHTYPE_UNSPECIFIED |
msg |
metadata.description |
Mappé directement |
rt |
metadata.event_timestamp |
Analysé en tant que ISO8601 |
cs1 |
metadata.event_type |
Mappé : phishing → SCAN_UNCATEGORIZED |
message |
metadata.event_type |
Mappé : CEF:0 → GENERIC_EVENT, login → USER_LOGIN |
cs1 |
metadata.product_event_type |
Mappé directement |
network_direction |
network.direction |
Mappé : INCOMING → INBOUND, OUTGOING → OUTBOUND |
cs2 |
principal.hostname |
Mappé directement |
principal_ip |
principal.hostname |
Mappé directement |
principal_ip |
principal.ip |
Fusionné |
message |
principal.user.userid |
Mappé : login → target.user.userid |
suser |
principal.user.userid |
Mappé directement |
act |
security_result.action |
Mappé : ALLOW → act, DENY → security_result_action, QUARANTINE → act |
security_result_action |
security_result.action |
Fusionné |
act |
security_result.action_details |
Mappé directement |
cs5 |
security_result.rule_name |
Mappé directement |
severity |
security_result.severity |
Mappé : "0", "1", "2", "3", "LOW" → LOW, `"4", "5", "6", "MEDIUM", "SUBSTANTIAL", "INFO"... |
cs6 |
target.url |
Mappé directement |
duser |
target.user.email_addresses |
Mappé : ; → emailId |
emailId |
target.user.email_addresses |
Fusionné |
duser |
target.user.userid |
Mappé directement |
principal.user.userid |
target.user.userid |
Renommé/mappé |
| N/A | extensions.auth.type |
Constante : AUTHTYPE_UNSPECIFIED |
| N/A | metadata.event_type |
Constante : GENERIC_EVENT |
| N/A | network.direction |
Constante : INBOUND |
| N/A | principal.user.userid |
Constante : target.user.userid |
| N/A | security_result.severity |
Constante : LOW |
Journal des modifications
Consulter le journal des modifications de ce parseur
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.