Collecter les journaux Trend Micro Cloud One

Compatible avec :

Google SecOps SIEM

Cet analyseur gère les journaux au format Syslog et JSON de Trend Micro Cloud One. Il extrait les paires clé-valeur des messages au format LEEF, normalise les valeurs de gravité, identifie les entités principales et cibles (adresse IP, nom d'hôte, utilisateur) et mappe les données dans le schéma UDM. Si le format LEEF n'est pas détecté, l'analyseur tente de traiter l'entrée au format JSON et d'extraire les champs pertinents en conséquence.

Avant de commencer

• Assurez-vous de disposer d'une instance Google SecOps.
• Assurez-vous de disposer d'un accès privilégié à Trend Micro Cloud One.
• Assurez-vous de disposer d'un hôte Windows 2012 SP2 ou version ultérieure, ou d'un hôte Linux avec systemd.
• Si vous exécutez l'application derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts.

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).
• Anciens déploiements : continuez à utiliser le fichier d'authentification d'ingestion (option 2) jusqu'à l'arrêt de l'API Ingestion le 20 juillet 2027.

Option 1 : Créer un compte de service pour l'API Chronicle (recommandé)

1. Connectez-vous à la Google Cloud console et sélectionnez le Google Cloud projet associé à votre instance Google SecOps.
2. Accédez à IAM et administration > Comptes de service.
3. Cliquez sur Créer un compte de service.
4. 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).
5. Cliquez sur Créer et continuer.
6. Dans la section Autoriser ce compte de service à accéder au projet , cliquez sur Sélectionner un rôle , puis sélectionnez Éditeur Chronicle.
7. Cliquez sur Continuer, puis sur OK.
8. Cliquez sur le compte de service que vous avez créé, puis accédez à l'onglet Clés.
9. Cliquez sur Ajouter une clé > Créer une clé.
10. Sélectionnez JSON , puis cliquez sur Créer. Le fichier de clé est téléchargé sur votre ordinateur.
11. Enregistrez le fichier de clé sous le nom ingestion-auth.json dans le répertoire du collecteur Bindplane (/opt/observiq-otel-collector/ingestion-auth.json sous Linux ou C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json sous Windows), ou mettez à jour creds_file_path dans config.yaml pour qu'il corresponde au chemin d'accès où vous l'avez enregistré.
12. Accédez à IAM et administration > Paramètres , puis copiez le numéro de projet. Vous en aurez besoin pour la configuration de l'exportateur.

Remarque : La clé JSON est un identifiant. Limitez l'accès au fichier sur l'hôte Bindplane et faites pivoter la clé conformément à la règle de votre organisation.

Option 2 : Télécharger le fichier d'authentification d'ingestion (ancienne version)

1. Connectez-vous à la console Google SecOps.
2. Accédez à Paramètres SIEM > Agents de collecte.
3. Téléchargez le fichier d'authentification d'ingestion.
4. Enregistrez le fichier de manière sécurisée sur le système où l'agent Bindplane sera installé.

Remarque : Ce fichier authentifie l'agent auprès de l'ancienne API Ingestion (malachiteingestion-pa.googleapis.com), dont Google a prévu l'arrêt le 20 juillet 2027. Prévoyez de passer à l'option 1 avant cette date.

Obtenir l'ID client Google SecOps

1. Connectez-vous à la console Google SecOps.
2. Accédez à Paramètres SIEM > Profil.
3. Copiez et enregistrez l'ID client dans la section Informations sur l'organisation.

Installer l'agent Bindplane

1. Pour installer Windows, exécutez le script suivant : msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet.
2. Pour installer Linux, exécutez le script suivant : sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh.
3. Vous trouverez d'autres options d'installation dans ce guide d'installation.

Remarque : La configuration de l'exportateur de l'API Chronicle nécessite le collecteur Bindplane version 1.106.0 ou ultérieure. Les commandes précédentes installent la dernière version. Si vous mettez à jour une installation existante, mettez à niveau le collecteur avant de modifier la configuration.

Configurer l'agent Bindplane pour ingérer Syslog et l'envoyer à Google SecOps

1. Accédez à la machine avec l'agent Bindplane.

2. Modifiez le fichier config.yaml comme suit :

   receivers:
     udplog:
       # Replace the below port <5514> and IP (0.0.0.0) with your specific values
       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 saved in Step 1
       creds: '{ json file for creds }'
       # Replace <customer_id> below with your actual ID that you copied
       customer_id: <customer_id>
       endpoint: chronicle.googleapis.com
       # You can apply ingestion labels below as preferred
       ingestion_labels:
       log_type: SYSLOG
       namespace:
       raw_log_field: body
   service:
     pipelines:
       logs/source0__chronicle_w_labels-0:
         receivers:
           - udplog
         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, ou asia-southeast1). L'exportateur préfixe chronicle.googleapis.com avec cette valeur.
   • Remplacez <PROJECT_NUMBER> par le numéro de projet dans IAM et administration > Paramètres.
   • Remplacez <customer_id> par l'ID client réel.
   • Mettez à jour { json file for creds } avec le chemin d'accès où le fichier de clé du compte de service (option 1) a été enregistré.

3. Redémarrez l'agent Bindplane pour appliquer les modifications à l'aide de la commande suivante : sudo systemctl bindplane restart

Ancien exportateur d'API d'ingestion

• Si vous utilisez le fichier d'authentification d'ingestion de l'option 2, remplacez le bloc exporters par le code suivant. Définissez creds sur le chemin d'accès au fichier d'authentification d'ingestion. Si votre instance se trouve en dehors des États-Unis, remplacez malachiteingestion-pa.googleapis.com par 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 saved in Step 1
      creds: '{ json file for creds }'
      # Replace <customer_id> below with your actual ID that you copied
      customer_id: <customer_id>
      endpoint: malachiteingestion-pa.googleapis.com
      # You can apply ingestion labels below as preferred
      ingestion_labels:
      log_type: SYSLOG
      namespace:
      raw_log_field: body
  

Remarque : Cet exportateur cessera de fonctionner lorsque l'API Ingestion sera arrêtée le 20 juillet 2027.

Configurer Syslog à partir de Trend Micro Cloud One

1. Accédez à Policies > Common Objects > Other > Syslog Configurations.
2. Cliquez sur New > New Configuration > General.
3. Spécifiez les valeurs des paramètres suivants :
   • Nom : nom unique qui identifie la configuration (par exemple, Google SecOps BindPlance server).
   • Nom du serveur : saisissez l'adresse IP de l'agent Bindplane.
   • Server Port : saisissez le port de l'agent Bindplane (par exemple, 514).
   • Transport : sélectionnez UDP.
   • Format d'événement : sélectionnez Syslog.
   • Inclure le fuseau horaire dans les événements : laissez l'option désélectionnée.
   • Facility : type de processus auquel les événements seront associés.
   • Agents should forward logs : sélectionnez le serveur Syslog.
   • Cliquez sur Enregistrer.

Exporter les événements système dans Trend Micro Cloud One

1. Accédez à Administration > System Settings > Event Forwarding.
2. Forward System Events to a remote computer (via Syslog) using configuration (Transférer les événements système vers un ordinateur distant (via Syslog) à l'aide de la configuration) : sélectionnez la configuration créée à l'étape précédente.
3. Cliquez sur Enregistrer.

Exporter les événements de sécurité dans Trend Micro Cloud One

1. Accédez à Policies.
2. Cliquez sur la règle utilisée par les ordinateurs.
3. Accédez à Settings > Event Forwarding.
4. Event Forwarding Frequency (from the Agent/Appliance) (Fréquence de transfert des événements (à partir de l'agent/de l'appliance)) : choisissez Period between sending of events (Période entre l'envoi des événements) et sélectionnez la fréquence à laquelle les événements liés à la sécurité seront transférés.
5. Event Forwarding Configuration (from the Agent/Appliance) (Configuration du transfert des événements (à partir de l'agent/de l'appliance)) : choisissez Anti-Malware Syslog Configuration (Configuration Syslog anti-malware) et sélectionnez la configuration créée à l'étape précédente.
6. Cliquez sur Enregistrer.

Table de mappage UDM

Champ du journal	Mappage UDM	Logique
act	security_result.action	Si act est "deny" ou "block" (non sensible à la casse), alors BLOCK. Si act est "pass" ou "allow" (non sensible à la casse), alors ALLOW. Si act est "update" ou "rename" (non sensible à la casse), alors ALLOW_WITH_MODIFICATION. Si act est "quarantine" (non sensible à la casse), alors QUARANTINE. Sinon, UNKNOWN_ACTION.
act	security_result.action_details	Mappé directement.
cat	security_result.category_details	Mappé directement.
cn1	target.asset_id	Préfixé par "Host Id:" si cn1Label est "Host ID".
desc	metadata.description	Mappé directement.
dvchost	target.asset.hostname	Mappé directement.
dvchost	target.hostname	Mappé directement.
log_type	metadata.product_name	Mappé directement.
msg	security_result.description	Mappé directement.
name	security_result.summary	Mappé directement.
organization	target.administrative_domain	Mappé directement.
proto	additional.fields.key	Défini sur "Protocol" si le champ proto ne peut pas être converti en entier.
proto	additional.fields.value.string_value	Mappé directement si le champ proto ne peut pas être converti en entier.
proto	network.ip_protocol	Mappé à l'aide de la logique parse_ip_protocol.include, qui convertit le numéro de protocole en nom correspondant (par exemple, "6" devient "TCP").
product_version	metadata.product_version	Mappé directement.
sev	security_result.severity	Si sev est "0", "1", "2", "3" ou "low" (non sensible à la casse), alors LOW. Si sev est "4", "5", "6" ou "medium" (non sensible à la casse), alors MEDIUM. Si sev est "7", "8" ou "high" (sans tenir compte de la casse), alors HIGH. Si sev est "9", "10" ou "very high" (non sensible à la casse), alors CRITICAL.
sev	security_result.severity_details	Mappé directement.
src	principal.asset.hostname	Mappé directement s'il ne s'agit pas d'une adresse IP valide.
src	principal.asset.ip	Mappé directement s'il s'agit d'une adresse IP valide.
src	principal.hostname	Mappé directement s'il ne s'agit pas d'une adresse IP valide.
src	principal.ip	Mappé directement s'il s'agit d'une adresse IP valide.
TrendMicroDsTenant	security_result.detection_fields.key	Défini sur "TrendMicroDsTenant".
TrendMicroDsTenant	security_result.detection_fields.value	Mappé directement.
TrendMicroDsTenantId	security_result.detection_fields.key	Défini sur "TrendMicroDsTenantId".
TrendMicroDsTenantId	security_result.detection_fields.value	Mappé directement.
usrName	principal.user.userid	Mappé directement. Si has_principal est "true" et has_target est "true", alors NETWORK_CONNECTION. Sinon, si has_principal est "true", alors STATUS_UPDATE. Sinon, si has_target est "true" et has_principal est "false", alors USER_UNCATEGORIZED. Sinon, GENERIC_EVENT. Défini sur AUTHTYPE_UNSPECIFIED si event_type est USER_UNCATEGORIZED. Défini sur "true" si une adresse IP, un nom d'hôte ou une adresse MAC principale sont extraits. Sinon, initialisé sur "false". Défini sur "true" si une adresse IP, un nom d'hôte ou une adresse MAC cible sont extraits. Sinon, initialisé sur "false". Identique au code temporel de l'événement de premier niveau. Défini sur "Trend Micro".

Journal des modifications

Consulter le journal des modifications de cet analyseur

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