Collecter les journaux Carbon Black App Control

Ce document explique comment collecter les journaux Carbon Black App Control. L'analyseur est compatible avec les formats CEF et JSON. Il tente d'abord d'analyser l'entrée au format JSON. En cas d'échec, il traite l'entrée en tant que CEF, effectue des substitutions de texte, extrait les champs CEF, les met en correspondance avec l'UDM et définit le type d'événement sur GENERIC_EVENT. Sinon, il utilise un fichier d'inclusion de mappage UDM spécifique au format JSON.

Avant de commencer

• Assurez-vous de disposer d'une instance Google Security Operations.
• Assurez-vous d'utiliser Windows 2016 ou une version ultérieure, ou 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.
• Serveur Carbon Black App Control (CB Protection) (version 8.x ou ultérieure recommandée)
• Assurez-vous de disposer d'un accès privilégié à Carbon Black App Control.

Obtenir le fichier d'authentification d'ingestion Google SecOps

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

Obtenir le numéro client Google SecOps

1. Connectez-vous à la console Google SecOps.
2. Accédez à Paramètres du SIEM > Profil.
3. Copiez et sauvegardez le numéro client dans la section Détails de l'organisation.

Installer l'agent Bindplane

Installation de Windows

1. Ouvrez l'invite de commande ou PowerShell en tant qu'administrateur.

2. Exécutez la commande suivante :

   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
   

Installation de Linux

1. Ouvrez un terminal avec des droits root ou sudo.

2. Exécutez la commande suivante :

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

Autres ressources d'installation

• Pour plus d'options d'installation, consultez ce guide d'installation.

Configurer l'agent Bindplane pour qu'il ingère les journaux Syslog et les envoie à Google SecOps

1. Accédez au fichier de configuration:

   1. Recherchez le fichier config.yaml. En règle générale, il se trouve dans le répertoire /etc/bindplane-agent/ sous Linux ou dans le répertoire d'installation sous Windows.
   2. Ouvrez le fichier à l'aide d'un éditeur de texte (nano, vi ou Bloc-notes, par exemple).

2. Modifiez le fichier config.yaml comme suit :

   receivers:
       tcplog:
           # Replace the port and IP address as required
           listen_address: "0.0.0.0:11592"
   
   exporters:
       chronicle/chronicle_w_labels:
           compression: gzip
           # Adjust the path to the credentials file you downloaded in Step 1
           creds: '/path/to/ingestion-authentication-file.json'
           # Replace with your actual customer ID from Step 2
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # Add optional ingestion labels for better organization
           ingestion_labels:
               log_type: JSON
               namespace: cb_app_control
               raw_log_field: body
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - tcplog
               exporters:
                   - chronicle/chronicle_w_labels
   
   

3. Remplacez le port et l'adresse IP dans votre infrastructure si nécessaire.

4. Remplacez <customer_id> par le numéro client réel.

5. Remplacez /path/to/ingestion-authentication-file.json par le chemin d'accès où le fichier d'authentification a été enregistré dans la section Obtenir le fichier d'authentification d'ingestion Google SecOps.

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 bindplane-agent
  

• Pour redémarrer l'agent Bindplane sous Windows, vous pouvez utiliser la console Services ou saisir la commande suivante:

  net stop BindPlaneAgent && net start BindPlaneAgent
  

Configurer CB App Control pour envoyer des journaux Syslog

1. Connectez-vous à la console de contrôle des applications CB avec un compte administrateur.
2. Accédez à Administration > Configuration système > Journalisation externe.
3. Dans la section "Enregistrement des événements externes" :
   • Activer la journalisation Syslog: cochez la case Syslog activé.
   • Server Address (Adresse du serveur) : <Bindplane Server IP>.
   • Port : <Bindplane Server PORT>.
   • Protocole: sélectionnez TCP.
   • Format Syslog: sélectionnez JSON.
4. Sous Options de journalisation des événements, sélectionnez les types de journaux à envoyer :
   • Non-respect des règles
   • Événements de surveillance de l'intégrité des fichiers (FIM)
   • Événements d'authentification des utilisateurs
   • Données de renseignement sur les menaces
5. Cliquez sur Enregistrer.

Tableau de mappage UDM

Modifications

2022-07-01

• Amélioration
• Mappage du champ "agent.type" sur "observer.application".
• Mappage du champ "agent.name" sur "observer.user.userid".
• Mappage du champ "host.name" sur "observer.hostname".
• Mappage des champs "agent.type" et "agent.name" sur "observer.asset_id".
• Mise en correspondance du champ "agent.ephemeral_id" avec "observer.labels".
• Mappage du champ "host.os.platform" sur "target.platform".
• Mappage du champ "host.os.version" sur "target.platform_version".
• Mappage du champ "host.os.kernel" sur "target.platform_patch_level".
• Le champ "cloud.instance.id" a été mappé sur "principal.resource.product_object_id".
• Mappage du champ "cloud.instance.name" sur "principal.resource.name".
• Le champ "host.mac" a été mappé sur "target.mac".
• Mappage du champ "host.ip" sur "target.asset.ip".
• Mappage du champ "host.id" sur "target.asset.asset_id".
• Mappage du champ "host.architecture" sur "target.asset.hardware".
• Mappage du champ "message.UserSID" sur "principal.user.userid".
• Mappage du champ "message.ProcessPath" sur "about.process.command_line".
• Mappage des champs "cloud.machine.type" et "cloud.provider" sur "principal.resource.attribute.labels".
• Ajout de vérifications conditionnelles pour "message.Bit9Server" et "message.HostId" mappés sur "metadata.url_back_to_product".

2022-06-22

• Correction de bugs
• Mappage de l'ID d'hôte sur principal.asset_id
• Association de la combinaison Bit9Server et HostId à metadata.url_back_to_product

2022-05-19

• Correction de bugs
• analysé les journaux demandés dans le bug ;
• journaux d'échec de l'API analysés

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