Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Collecter les journaux Carbon Black App Control (anciennement CB Protection)

Version de l'analyseur : 28.0

Compatible avec :

Google SecOps SIEM

Ce document explique comment ingérer les journaux Carbon Black App Control (anciennement CB Protection, désormais intégré à Broadcom) dans Google Security Operations à l'aide de Bindplane. L'analyseur est compatible avec les formats CEF et JSON. Il tente d'abord d'analyser l'entrée en tant que JSON. Si cela échoue, il traite l'entrée en tant que CEF, effectue des substitutions de texte, extrait les champs CEF, les mappe à l'UDM et définit le type d'événement sur GENERIC_EVENT.

Carbon Black App Control est une solution de contrôle des applications et de mise sur liste blanche qui permet aux entreprises de verrouiller les serveurs et les systèmes critiques. Il empêche l'exécution de logiciels malveillants et non autorisés en appliquant des règles basées sur la confiance, en surveillant les modifications de l'intégrité des fichiers et en offrant une visibilité en temps réel sur l'activité des points de terminaison.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

Une instance Google SecOps.
Un hôte Windows Server 2016 ou version ultérieure, ou un hôte Linux avec systemd.
Si vous exécutez le programme derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts.
Serveur Carbon Black App Control version 8.x ou ultérieure.
Un accès privilégié (compte administrateur) à la console Carbon Black App Control.

Obtenir le fichier d'authentification d'ingestion Google SecOps

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 sur lequel Bindplane sera installé.

Obtenir l'ID 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 de 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" /quiet

Installation de Linux

Ouvrez un terminal avec des privilèges 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)" install_unix.sh

Autres ressources d'installation

Pour obtenir d'autres options d'installation, consultez le guide d'installation de l'agent Bindplane.

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

Accédez au fichier de configuration :
- Trouvez le fichier config.yaml. Il se trouve généralement dans le répertoire /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, vi ou Bloc-notes).

Modifiez le fichier config.yaml comme suit :

receivers:
    tcplog:
        # Replace the port and IP address as required
        listen_address: "0.0.0.0:514"

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: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: CB_APP_CONTROL
        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 <customer_id> par le numéro client réel.
Mettez à jour /path/to/ingestion-authentication-file.json avec le chemin d'accès au fichier où le fichier d'authentification a été enregistré dans la section Obtenir le fichier d'authentification pour l'ingestion Google SecOps.

Redémarrez 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-collector

Vérifiez que le service est en cours d'exécution :
```
sudo systemctl status observiq-otel-collector
```

Recherchez les erreurs dans les journaux :

sudo journalctl -u observiq-otel-collector -f

Pour redémarrer l'agent Bindplane sous Windows :

Choisissez l'une des options suivantes :
- Invite de commande ou PowerShell en tant qu'administrateur :
```
net stop observiq-otel-collector && net start observiq-otel-collector
```
- Console Services :
  1. Appuyez sur Win+R, saisissez services.msc, puis appuyez sur Entrée.
  2. Localisez observIQ OpenTelemetry Collector.
  3. Effectuez un clic droit, puis sélectionnez Redémarrer.
Vérifiez que le service est en cours d'exécution :
```
sc query observiq-otel-collector
```

Recherchez les erreurs dans les journaux :

type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"

Configurer le transfert Syslog de Carbon Black App Control

Connectez-vous à la console Carbon Black App Control avec un compte administrateur.
Cliquez sur l'icône Paramètres (en forme de roue dentée), puis sur Configuration du système.
Sur la page Configuration du système, cliquez sur l'onglet Événements.
Cliquez sur le bouton Modifier en bas de la page.
Dans le panneau Journalisation des événements externes, cochez la case Syslog activé.
Fournissez les informations de configuration suivantes :
- Adresse Syslog : saisissez l'adresse IP ou le nom de domaine complet de l'hôte de l'agent Bindplane (par exemple, 192.168.1.100).
- Port Syslog : saisissez 514 (ou le port configuré dans Bindplane).
- Format Syslog : sélectionnez le format de sortie dans le menu Format Syslog :
  - CEF (ArcSight) : recommandé pour l'ingestion Google SecOps.
  - Amélioré (RFC 5424) : option par défaut pour les nouvelles installations de la version 6.0.1 et ultérieures.
  - De base (RFC 3164) : option par défaut pour les mises à niveau à partir de versions antérieures à la version 6.0.1.
  - LEEF (Q1 Labs) : pour l'intégration à QRadar.
Cliquez sur Mettre à jour, puis sur Oui dans la boîte de dialogue de confirmation.

Remarque : Pour en savoir plus sur les formats syslog compatibles et le mappage des événements, consultez la documentation Carbon Black App Control.

Table de mappage UDM

Champ de journal	Mappage UDM	Logique
`ABId`	`principal.asset.asset_id`	Le `ABId` du journal JSON est utilisé dans l'ID d'élément au format `PRODUCT_SPECIFIC_ID:{ABId}-{Bit9Server}`.
`Bit9Server`	`principal.asset.asset_id`	Utilisé dans l'ID d'élément du principal, associé à `ABId`. Il est également utilisé pour construire le champ `metadata.url_back_to_product`.
`CommandLine`	`about.process.command_line`	Mappé directement.
`EventType`	`metadata.product_event_type`	Mappé avec le `EventTypeId` correspondant entre crochets (par exemple, `[5] - Discovery`).
`EventTypeId`	`metadata.product_event_type`	Utilisé avec `EventType` pour remplir `metadata.product_event_type`.
`EventSubType`	`metadata.description`	Ajouté au champ `metadata.description`.
`EventSubTypeId`	`metadata.description`	Non mappé explicitement, mais peut contribuer à la description en fonction de la logique interne de l'analyseur.
`externalId`	`metadata.product_log_id`	Mappé directement.
`FileHash`	`about.file.sha256`	Mappé directement.
`FileName`	`additional.fields` (avec la clé `FileName`)	Ajouté en tant que champ supplémentaire. Également utilisé dans les informations sur les fichiers dans `metadata.description` pour certains événements.
`FilePath`	`about.file.full_path`	Mappé directement.
`FileThreat`	`additional.fields` (avec la clé `fileThreat`)	Ajouté en tant que champ supplémentaire.
`FileTrust`	`additional.fields` (avec la clé `fileTrust`)	Ajouté en tant que champ supplémentaire.
`HostId`	`principal.asset.asset_id`	Permet de créer l'URL de retour vers le produit dans `metadata.url_back_to_product`.
`HostName`	`target.hostname`	Mappé directement.
`HostIP`	`target.ip`	Mappé directement.
`Message`	`metadata.description`	Mappé directement.
`PathName`	`about.file.full_path`	Mappé directement.
`Platform`	`target.platform`	Correspond à la valeur d'énumération `WINDOWS`.
`Policy`	`additional.fields` (avec la clé `Policy`)	Ajouté en tant que champ supplémentaire.
`PolicyId`	`additional.fields` (avec la clé `PolicyId`)	Ajouté en tant que champ supplémentaire.
`ProcessKey`	`additional.fields` (avec la clé `ProcessKey`)	Ajouté en tant que champ supplémentaire.
`ProcessPath`	`about.process.command_line`	Mappé directement.
`ProcessPathName`	`about.process.command_line`	Mappé directement.
`ProcessThreat`	`additional.fields` (avec la clé `ProcessThreat`)	Ajouté en tant que champ supplémentaire.
`ProcessTrust`	`additional.fields` (avec la clé `ProcessTrust`)	Ajouté en tant que champ supplémentaire.
`RuleName`	`additional.fields` (avec la clé `ruleName`)	Ajouté en tant que champ supplémentaire.
`Timestamp`	`metadata.event_timestamp`	Mappé directement.
`UserName`	`target.user.user_display_name`	Mappé directement.
`UserSid`	`principal.user.userid`	Mappé directement.
`agent.ephemeral_id`	`observer.labels` (avec la clé `ephemeral_id`)	Libellé "Ajouté en tant qu'observateur".
`agent.name`	`principal.hostname`, `observer.hostname`, `observer.user.userid`	Mappé à plusieurs champs.
`agent.type`	`observer.application`	Mappé directement.
`agent.version`	`metadata.product_version`	Directement mappé pour les journaux JSON. Pour les journaux CEF, extraits du message CEF.
`cat`	`security_result.category_details`	Mappé directement.
`process`	`event.idm.read_only_udm.principal.file.full_path`	Mappé à partir du journal des modifications
`text`	`event.idm.read_only_udm.metadata.description`	Mappé à partir du journal des modifications
`type`	`event.idm.read_only_udm.security_result.category_details`	Mappé à partir du journal des modifications
`subtype`	`event.idm.read_only_udm.security_result.category_details`	Mappé à partir du journal des modifications
`hostname`	`event.idm.read_only_udm.principal.hostname` et `event.idm.read_only_udm.principal.asset.hostname`	Mappé à partir du journal des modifications
`username`	`event.idm.read_only_udm.target.user.userid`	Mappé à partir du journal des modifications
`date`	`event.idm.read_only_udm.metadata.collected_timestamp`	Mappé à partir du journal des modifications
`ip_address`	`event.idm.read_only_udm.principal.ip` et `event.idm.read_only_udm.principal.asset.ip`	Mappé à partir du journal des modifications
`file_path`	`event.idm.read_only_udm.target.file.full_path`	Mappé à partir du journal des modifications
`file_name`	`event.idm.read_only_udm.target.process.file.names`	Mappé à partir du journal des modifications
`file_hash`	`event.idm.read_only_udm.target.file.sha256`	Mappé à partir du journal des modifications
`policy`	`event.idm.read_only_udm.security_result.rule_name`	Mappé à partir du journal des modifications
`server_version`	`event.idm.read_only_udm.metadata.product_version`	Mappé à partir du journal des modifications
`file_trust`	`event.idm.read_only_udm.security_result.about.labels`	Mappé à partir du journal des modifications
`file_threat`	`event.idm.read_only_udm.security_result.about.labels`	Mappé à partir du journal des modifications

Journal des modifications

Afficher le journal des modifications pour ce parseur

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