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'outil derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts.

Obtenir des 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 consoleGoogle Cloud et sélectionnez le projet Google Cloud 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 Continue (Continuer), puis sur Done (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'enregistrez.
12. Accédez à IAM et administration > Paramètres, puis copiez le numéro du projet. Vous en aurez besoin pour configurer l'exportateur.

Remarque : La clé JSON est un identifiant. Limitez l'accès au fichier sur l'hôte BindPlane et effectuez une rotation de la clé conformément aux règles de votre organisation.

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

1. Connectez-vous à la console Google SecOps.
2. Accédez à Paramètres > Gestion des données > Agents de collecte. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > 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 d'ingestion (malachiteingestion-pa.googleapis.com), dont Google a prévu la fin de vie le 20 juillet 2027. Prévoyez de passer à l'option 1 avant cette date.

Obtenir le numéro client Google SecOps

1. Connectez-vous à la console Google SecOps.
2. Accédez à Paramètres > Administration > Profil. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Profil.
3. Copiez et enregistrez le numéro client de la section Détails de l'organisation.

Installer l'agent BindPlane

1. Pour l'installation sous Windows, exécutez le script suivant : msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet.
2. Pour l'installation sous 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. Pour en savoir plus sur les options d'installation, consultez ce guide d'installation.

Remarque : La configuration de l'exportateur de l'API Chronicle nécessite le collecteur Bindplane v1.106.0 ou version 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 ajoute cette valeur en préfixe à chronicle.googleapis.com.
   • Remplacez <PROJECT_NUMBER> par le numéro de projet indiqué dans IAM et administration > Paramètres.
   • Remplacez <customer_id> par le numéro client réel.
   • Remplacez { json file for creds } par 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 abandonnée le 20 juillet 2027.

Configurer Syslog à partir de Trend Micro Cloud One

1. Accédez à Policies > Common Objects > Other > Syslog Configurations (Règles > Objets communs > Autre > Configurations Syslog).
2. Cliquez sur New > New Configuration > General (Nouveau > Nouvelle configuration > Général).
3. Spécifiez les valeurs des paramètres suivants :
   • Nom : nom unique qui identifie la configuration (par exemple, Serveur BindPlane Google SecOps).
   • Nom du serveur : saisissez l'adresse IP de l'agent BindPlane.
   • Port du serveur : 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 cette option désactivée.
   • Facility : type de processus auquel les événements seront associés.
   • Les agents doivent transférer les journaux : sélectionnez le serveur Syslog.
   • Cliquez sur Enregistrer.

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

1. Accédez à Administration > System Settings (Paramètres système) > Event Forwarding (Transfert d'événements).
2. 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 des événements de sécurité dans Trend Micro Cloud One

1. Accédez à Règles.
2. Cliquez sur la règle utilisée par les ordinateurs.
3. Accédez à Paramètres > Transfert d'événements.
4. Fréquence de transfert des événements (depuis l'agent/l'appareil) : choisissez Période entre l'envoi des événements, puis 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 d'événements (depuis l'agent/l'appareil)) : choisissez Anti-Malware Syslog Configuration (Configuration Syslog de l'antimalware) 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
agir	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 défini sur "quarantine" (non sensible à la casse), alors QUARANTINE. Sinon, UNKNOWN_ACTION.
agir	security_result.action_details	Mappage direct.
cat	security_result.category_details	Mappage direct.
cn1	target.asset_id	Précédé de "ID de l'hôte :" si cn1Label est "ID de l'hôte".
décroiss.	metadata.description	Mappage direct.
dvchost	target.asset.hostname	Mappage direct.
dvchost	target.hostname	Mappage direct.
log_type	metadata.product_name	Mappage direct.
Message	security_result.description	Mappage direct.
nom	security_result.summary	Mappage direct.
organisation	target.administrative_domain	Mappage direct.
proto	additional.fields.key	Définissez cette option sur "Protocole" 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	Mappage direct.
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" (non sensible à la casse), alors HIGH. Si sev est "9", "10" ou "very high" (non sensible à la casse), alors CRITICAL.
sev	security_result.severity_details	Mappage direct.
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éfinissez cette valeur sur "TrendMicroDsTenant".
TrendMicroDsTenant	security_result.detection_fields.value	Mappage direct.
TrendMicroDsTenantId	security_result.detection_fields.key	Définissez cette valeur sur "TrendMicroDsTenantId".
TrendMicroDsTenantId	security_result.detection_fields.value	Mappage direct.
usrName	principal.user.userid	Mappage direct. Si has_principal est vrai et has_target est vrai, alors NETWORK_CONNECTION. Sinon, si has_principal est "true", alors STATUS_UPDATE. Sinon, si has_target est vrai et has_principal est faux, alors USER_UNCATEGORIZED. Sinon, GENERIC_EVENT. Définie sur AUTHTYPE_UNSPECIFIED, si event_type est USER_UNCATEGORIZED. Définissez cette option sur "true" si une adresse IP, un nom d'hôte ou une adresse MAC principaux sont extraits. Sinon, initialisé sur "false". Définissez cette option 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

Afficher 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.