Collecter les journaux Forescout eyeSight

Version de l'analyseur : 33.0

Compatible avec :

Ce document explique comment ingérer des journaux Forescout eyeSight (anciennement CounterACT) dans Google Security Operations à l'aide de l'agent Bindplane.

Forescout eyeSight est une plate-forme de contrôle des accès au réseau (NAC) qui offre une visibilité, une classification et une évaluation de la conformité des appareils sans agent sur les appareils informatiques, IoT, OT et IoMT. Il détecte et profile chaque appareil connecté en temps réel, ce qui permet aux organisations d'appliquer des règles d'accès et de réduire la surface d'attaque sans nécessiter d'agents de point de terminaison.

Pour en savoir plus, consultez la documentation Forescout NAC.

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'agent derrière un proxy, assurez-vous que les ports de pare-feu sont ouverts conformément aux exigences de l'agent BindPlane.
  • Accès privilégié à la console Forescout (compte administrateur)
  • Connectivité réseau entre l'appliance Forescout et l'hôte de l'agent BindPlane

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

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

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

Installez l'agent BindPlane sur votre système d'exploitation Windows ou Linux en suivant les instructions ci-dessous.

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
    
  3. Attendez que l'installation se termine.

  4. Vérifiez l'installation en exécutant la commande suivante :

    sc query observiq-otel-collector
    

    Le service doit s'afficher comme étant EN COURS D'EXÉCUTION.

Installation sous Linux

  1. Ouvrez un terminal avec des droits d'accès racine 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
    
  3. Attendez que l'installation se termine.

  4. Vérifiez l'installation en exécutant la commande suivante :

    sudo systemctl status observiq-otel-collector
    

    Le service doit s'afficher comme actif (en cours d'exécution).

Ressources d'installation supplémentaires

Pour obtenir des options d'installation et de dépannage supplémentaires, consultez le guide d'installation de l'agent Bindplane.

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

Localiser le fichier de configuration

  • Linux :

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows :

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Modifiez le fichier de configuration

  • Remplacez l'intégralité du contenu de config.yaml par la configuration suivante :

    receivers:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/forescout_nac:
        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
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<CUSTOMER_ID>'
        endpoint: chronicle.googleapis.com
        log_type: FORESCOUT_NAC
        raw_log_field: body
        ingestion_labels:
          env: production
    
    service:
      pipelines:
        logs/forescout_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/forescout_nac
    

Paramètres de configuration

Remplacez les espaces réservés suivants :

  • Configuration du récepteur :

    • listen_address : adresse IP et port à écouter. Utilisez 0.0.0.0 pour écouter sur toutes les interfaces. Le port 514 est standard pour syslog (nécessite des droits racine sous Linux ; utilisez 1514 pour les utilisateurs non racine).
  • Configuration de l'exportateur :

    • creds_file_path : chemin d'accès complet au fichier de clé JSON du compte de service (option 1).
      • Linux : /opt/observiq-otel-collector/ingestion-auth.json
      • Windows : C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • <CUSTOMER_ID> : ID client Google SecOps.
    • location : 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. Pour obtenir la liste complète, consultez Points de terminaison régionaux.
    • project : remplacez <PROJECT_NUMBER> par le numéro de projet indiqué dans IAM et administration > Paramètres.
    • endpoint : laissez la valeur définie sur chronicle.googleapis.com.

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_file_path 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/forescout_nac:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<CUSTOMER_ID>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: FORESCOUT_NAC
        raw_log_field: body
        ingestion_labels:
          env: production
    

Enregistrez le fichier de configuration.

  • Après avoir modifié le fichier, enregistrez-le :
    • Linux : appuyez sur Ctrl+O, puis sur Enter, puis sur Ctrl+X.
    • Windows : cliquez sur Fichier > Enregistrer.

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
    
    1. Vérifiez que le service est en cours d'exécution :

      sudo systemctl status observiq-otel-collector
      
    2. Vérifiez les journaux pour détecter d'éventuelles erreurs :

      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. Recherchez observIQ OpenTelemetry Collector.
    3. Effectuez un clic droit et sélectionnez Redémarrer.
    4. Vérifiez que le service est en cours d'exécution :

      sc query observiq-otel-collector
      
    5. Vérifiez les journaux pour détecter d'éventuelles erreurs :

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

Configurer le transfert syslog Forescout eyeSight

  1. Connectez-vous à la console Forescout avec un compte administrateur.
  2. Accédez à Outils > Options.
  3. Dans l'arborescence des options, développez Modules > Syslog (ou Plug-in Syslog selon la version).
  4. Cliquez sur Ajouter pour créer une cible syslog.
  5. Fournissez les informations de configuration suivantes :
    • Nom : saisissez un nom descriptif (par exemple, SecOps-Bindplane).
    • 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 UDP.
    • Format : sélectionnez CEF (Common Event Format) ou Syslog (RFC 3164) en fonction de vos exigences d'analyse.
    • Facility (Fonction) : sélectionnez LOCAL0 (ou la fonction correspondant à la règle syslog de votre organisation).
    • Gravité : sélectionnez Informations ou le niveau de gravité minimal souhaité.
  6. Dans la section Types d'événements, sélectionnez les catégories de journaux à transférer :
    • Modifications des propriétés de l'hôte : classification des appareils et mises à jour des propriétés.
    • Non-respect des règles : cas de non-respect des règles de conformité et mesures coercitives du NAC.
    • Événements d'accès au réseau : événements de connexion et de déconnexion des points de terminaison.
    • Événements d'authentification : événements d'authentification 802.1X et utilisateur.
    • Résultats des actions : résultats des actions de correction et de réponse.
  7. Cliquez sur OK pour enregistrer la configuration de la cible syslog.
  8. Cliquez sur Appliquer pour activer les modifications.
  9. Vérifiez que les messages syslog sont bien reçus en consultant les journaux de l'agent BindPlane.

Table de mappage UDM

Champ du journal Mappage UDM Logique
about about Fusionné
deviceNtDomain about.administrative_domain Renommé/Mappé
deviceExternalId about.asset.asset_id Mappage direct
device_product about.asset.asset_id Mappage direct
device_vendor about.asset.asset_id Mappage direct
fileHash about.file.full_path Mappage direct
filePath about.file.full_path Renommé/Mappé
_hash about.file.sha256 Renommé/Mappé
fileHash about.file.sha256 Renommé/Mappé
fsize about.file.size Renommé/Mappé
dvchost about.hostname Renommé/Mappé
ips about.ip Fusionné
dvcmac about.mac Fusionné
mac_address about.mac Fusionné
deviceTranslatedAddress about.nat_ip Fusionné
Emne about.process.command_line Mappage direct
Path about.process.command_line Mappage direct
Subject about.process.command_line Mappage direct
deviceProcessName about.process.command_line Renommé/Mappé
dvcpid about.process.pid Renommé/Mappé
permissions about.resource.attribute.permissions Fusionné
Assigned_hosts_label additional.fields Fusionné
Available_memory_label additional.fields Fusionné
Available_swap_label additional.fields Fusionné
Connected_clients_label additional.fields Fusionné
EM_connection_status_label additional.fields Fusionné
Engine_status_label additional.fields Fusionné
Installed_Plugins_label additional.fields Fusionné
Used_memory_label additional.fields Fusionné
Used_swap_label additional.fields Fusionné
additional_cfp1 additional.fields Fusionné
additional_cfp2 additional.fields Fusionné
additional_cfp3 additional.fields Fusionné
additional_cfp4 additional.fields Fusionné
additional_cn1 additional.fields Fusionné
additional_cn2 additional.fields Fusionné
additional_cn3 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é
additional_cs7 additional.fields Fusionné
additional_devicePayloadId additional.fields Fusionné
additional_eventId additional.fields Fusionné
additional_flexString1 additional.fields Fusionné
additional_fname additional.fields Fusionné
application_status_label additional.fields Fusionné
cpu_usage_label additional.fields Fusionné
cs5_label additional.fields Fusionné
type_label additional.fields Fusionné
intermediary intermediary Fusionné
iporhost intermediary.asset.hostname Mappage direct
middle_ip intermediary.asset.ip Fusionné
iporhost intermediary.hostname Mappage direct
middle_ip intermediary.ip Fusionné
pid intermediary.process.pid Mappage direct
desc metadata.description Mappage direct
event_type metadata.description Mappage direct
msg metadata.description Renommé/Mappé
device_event_class_id metadata.product_event_type Mappage direct
engineName metadata.product_event_type Mappage direct
event_name metadata.product_event_type Mappage direct
eventtype metadata.product_event_type Mappage direct
externalId metadata.product_log_id Mappage direct
device_product metadata.product_name Mappage direct
product metadata.product_name Mappage direct
device_version metadata.product_version Mappage direct
device_vendor metadata.vendor_name Renommé/Mappé
vendor_name metadata.vendor_name Mappage direct
app_protocol_output network.application_protocol Mappage direct
mail_from network.email.from Mappage direct
mail_subject network.email.subject Fusionné
mail_to network.email.to Fusionné
requestMethod network.http.method Renommé/Mappé
requestClientApplication network.http.user_agent Renommé/Mappé
ip_protocol_out network.ip_protocol Mappage direct
protocol network.ip_protocol Mappage direct
protocol1 network.ip_protocol Mappage direct
in network.received_bytes Renommé/Mappé
out network.sent_bytes Renommé/Mappé
session_id network.session_id Mappage direct
sntdom principal.administrative_domain Renommé/Mappé
sourceServiceName principal.application Renommé/Mappé
Host principal.asset.hostname Mappage direct
Hostname principal.asset.hostname Mappage direct
Source principal.asset.hostname Mappage direct
Source_1 principal.asset.hostname Mappage direct
host_ip principal.asset.ip Fusionné
source_ip principal.asset.ip Fusionné
src_ip principal.asset.ip Fusionné
Group_name principal.group.group_display_name Mappage direct
Gruppenavn principal.group.group_display_name Mappage direct
Device_name principal.hostname Mappage direct
Enhetsnavn principal.hostname Mappage direct
Host principal.hostname Mappage direct
Hostname principal.hostname Mappage direct
Source principal.hostname Mappage direct
Source_1 principal.hostname Mappage direct
shost principal.hostname Renommé/Mappé
host_ip principal.ip Fusionné
principal_ip principal.ip Fusionné
shost principal.ip Fusionné
source_ip principal.ip Fusionné
src_ip principal.ip Fusionné
MAC principal.mac Fusionné
mac principal.mac Fusionné
mac_addr principal.mac Fusionné
src_mac principal.mac Fusionné
sourceTranslatedAddress principal.nat_ip Fusionné
sourceTranslatedPort principal.nat_port Renommé/Mappé
source_port principal.port Renommé/Mappé
spt principal.port Renommé/Mappé
src_port principal.port Mappage direct
command principal.process.command_line Mappage direct
sproc principal.process.command_line Renommé/Mappé
spid principal.process.pid Renommé/Mappé
resource principal.resource.name Mappage direct
principal_role principal.user.attribute.roles Fusionné
suser principal.user.user_display_name Mappage direct
User principal.user.userid Mappage direct
suid principal.user.userid Renommé/Mappé
user_id principal.user.userid Mappage direct
user_name principal.user.userid Mappage direct
username principal.user.userid Mappage direct
sec_result security_result Fusionné
security_result security_result Fusionné
res_label security_result.about.resource.attribute.labels Fusionné
_action security_result.action Fusionné
sec_action security_result.action Fusionné
security_result_action security_result.action Fusionné
Action_Taken security_result.action_details Mappage direct
act security_result.action_details Mappage direct
cat security_result.category_details Fusionné
Category security_result.description Mappage direct
Reason security_result.description Mappage direct
Scan_Type security_result.description Mappage direct
Type security_result.description Mappage direct
act security_result.description Mappage direct
description security_result.description Mappage direct
details security_result.description Mappage direct
et_lower security_result.description Mappage direct
event_type security_result.description Mappage direct
kv_data security_result.description Mappage direct
msg_data_2 security_result.description Mappage direct
policy_details security_result.description Mappage direct
rnmsg security_result.description Mappage direct
infection_channel_label security_result.detection_fields Fusionné
operasjon_label security_result.detection_fields Fusionné
operation_label security_result.detection_fields Fusionné
permission_label security_result.detection_fields Fusionné
protocol_label security_result.detection_fields Fusionné
spyware_Grayware_Type_label security_result.detection_fields Fusionné
threat_probability_label security_result.detection_fields Fusionné
tillatelse_label security_result.detection_fields Fusionné
Rule security_result.rule_id Mappage direct
alart_id security_result.rule_id Mappage direct
device_event_class_id security_result.rule_id Mappage direct
Match security_result.rule_name Mappage direct
mwProfile security_result.rule_name Mappage direct
severity security_result.severity_details Mappage direct
Result security_result.summary Mappage direct
appcategory security_result.summary Mappage direct
event_name security_result.summary Mappage direct
event_type security_result.summary Mappage direct
log_description security_result.summary Mappage direct
reason security_result.summary Renommé/Mappé
Spyware security_result.threat_name Mappage direct
Unknown_Threat security_result.threat_name Mappage direct
Virus_Malware_Name security_result.threat_name Mappage direct
threat security_result.threat_name Mappage direct
oldFilePath src.file.full_path Renommé/Mappé
oldFileSize src.file.size Renommé/Mappé
old_permissions src.resource.attribute.permissions Fusionné
dntdom target.administrative_domain Renommé/Mappé
destinationServiceName target.application Renommé/Mappé
Destination target.asset.hostname Mappage direct
Target target.asset.hostname Mappage direct
Target_1 target.asset.hostname Mappage direct
computer_name target.asset.hostname Mappage direct
Destination target.asset.ip Fusionné
dest_ip target.asset.ip Fusionné
destination_ip target.asset.ip Fusionné
target_ip target.asset.ip Fusionné
Destination target.hostname Mappage direct
Target target.hostname Mappage direct
Target_1 target.hostname Mappage direct
computer_name target.hostname Mappage direct
temp_dhost target.hostname Mappage direct
Destination target.ip Fusionné
IPv6_Address target.ip Fusionné
dest_ip target.ip Fusionné
destination_ip target.ip Fusionné
dst_ip target.ip Fusionné
target_ip target.ip Fusionné
dest_mac target.mac Fusionné
mac_address target.mac Fusionné
destination_translated_address target.nat_ip Fusionné
destinationTranslatedPort target.nat_port Renommé/Mappé
dest_port target.port Mappage direct
dpt target.port Renommé/Mappé
port target.port Renommé/Mappé
dproc target.process.command_line Renommé/Mappé
File_name target.process.file.full_path Mappage direct
Infected_Resource target.process.file.full_path Mappage direct
Object target.process.file.full_path Mappage direct
Objekt target.process.file.full_path Mappage direct
dpid target.process.pid Renommé/Mappé
resource_Type_label target.resource.attribute.labels Fusionné
request target.url Mappage direct
target_role target.user.attribute.roles Fusionné
CustomerName target.user.user_display_name Mappage direct
temp_duser target.user.user_display_name Mappage direct
Bruker target.user.userid Mappage direct
User_value target.user.userid Mappage direct
temp_duid target.user.userid Mappage direct
username target.user.userid Mappage direct
N/A about Constante : about
N/A about.ip Constante : ips
N/A about.mac Constante : mac_address
N/A about.nat_ip Constante : deviceTranslatedAddress
N/A about.resource.attribute.permissions Constante : permissions
N/A additional.fields Constante : additional_eventId
N/A extensions.auth.type Constante : MACHINE
N/A intermediary Constante : intermediary
N/A intermediary.asset.ip Constante : middle_ip
N/A intermediary.ip Constante : middle_ip
N/A metadata.event_type Constante : USER_LOGIN
N/A metadata.product_name Constante : FORESCOUT NAC
N/A metadata.vendor_name Constante : FORESCOUT
N/A network.direction Constante : INBOUND
N/A network.email.subject Constante : mail_subject
N/A network.email.to Constante : mail_to
N/A principal.asset.ip Constante : source_ip
N/A principal.ip Constante : principal_ip
N/A principal.mac Constante : mac
N/A principal.nat_ip Constante : sourceTranslatedAddress
N/A principal.user.attribute.roles Constante : principal_role
N/A security_result Constante : security_result
N/A security_result.about.resource.attribute.labels Constante : res_label
N/A security_result.action Constante : _action
N/A security_result.alert_state Constante : ALERTING
N/A security_result.category_details Constante : cat
N/A security_result.detection_fields Constante : operation_label
N/A security_result.rule_name Constante : Virtual Firewall blocking
N/A security_result.severity Constante : LOW
N/A src.resource.attribute.permissions Constante : old_permissions
N/A target.asset.ip Constante : target_ip
N/A target.ip Constante : dst_ip
N/A target.mac Constante : mac_address
N/A target.nat_ip Constante : destination_translated_address
N/A target.resource.attribute.labels Constante : resource_Type_label
N/A target.user.attribute.roles Constante : target_role
facility event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
priority event.idm.read_only_udm.security_result.priority_details Mappé à partir du journal des modifications
appname event.idm.read_only_udm.metadata.product_name 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
proc_id event.idm.read_only_udm.principal.process.pid Mappé à partir du journal des modifications
resource_name event.idm.read_only_udm.target.resource.name Mappé à partir du journal des modifications
CPU usage", "Available memory", "Used memory", "Available swap", "Used swap", "Application status", "Connected Clients", "EM connection status", "Assigned hosts", "Engine status" and "Installed plugins additional.fields Mappé à partir du journal des modifications

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.