Collecter les journaux Symantec EDR

Compatible avec :

Ce document explique comment ingérer des journaux Symantec EDR dans Google Security Operations à l'aide de l'agent Bindplane.

Symantec Endpoint Detection and Response (EDR) est une solution de détection des menaces qui génère des messages syslog pour l'activité des points de terminaison, l'exécution des processus, les connexions réseau, les opérations sur les fichiers, les modifications du registre et les incidents de sécurité. L'analyseur extrait les champs des journaux au format JSON et CEF, puis les mappe au modèle de données unifié (UDM).

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Une instance Google SecOps
  • Windows Server 2016 ou version ultérieure, ou hôte Linux avec systemd
  • Connectivité réseau entre l'agent BindPlane et l'appliance Symantec EDR
  • 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 administrateur à l'interface utilisateur Web de Symantec EDR

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 en savoir plus sur les options d'installation et le dépannage, 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/symantec_edr:
        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: SYMANTEC_EDR
        raw_log_field: body
    
    service:
      pipelines:
        logs/symantec_edr_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/symantec_edr
    

Paramètres de configuration

Remplacez les espaces réservés suivants :

  • Configuration du récepteur :

    • listen_address : adresse IP et port d'écoute :
      • 0.0.0.0 pour écouter sur toutes les interfaces (recommandé)
      • Le port 514 est le port syslog standard (nécessite un accès racine sous Linux ; utilisez 1514 pour un accès 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 copié depuis la console 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/symantec_edr:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: SYMANTEC_EDR
        raw_log_field: body
    

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 syslog dans Symantec EDR

  1. Connectez-vous à l'UI Web de Symantec EDR.
  2. Dans la console cloud EDR, accédez à Environnement > Paramètres.
  3. Sélectionnez un appareil, puis cliquez sur Appareils.
  4. Dans la console de l'appliance EDR, cliquez sur Paramètres > Appliances.
  5. Cliquez sur Modifier l'appareil par défaut.
  6. Double-cliquez sur l'appareil dans la liste Appliances.
  7. Dans la section "Syslog", décochez Utiliser la valeur par défaut (si cette option est cochée).
  8. Cliquez sur + Ajouter un serveur Syslog.
  9. Fournissez les informations de configuration suivantes :
    • Hôte : saisissez l'adresse IP de l'agent BindPlane.
    • Protocole : sélectionnez le protocole configuré (par exemple, UDP).
    • Port : saisissez le numéro de port de l'agent BindPlane (par exemple, 514).
  10. Cliquez sur Enregistrer.

Table de mappage UDM

Champ du journal Mappage UDM Logique
actor.cmd_line principal.process.command_line Ligne de commande exécutée par le processus de l'acteur.
actor.file.md5 principal.process.file.md5 Hachage MD5 du fichier exécutable de l'acteur.
actor.file.path principal.process.file.full_path Chemin d'accès complet au fichier exécutable de l'acteur.
actor.file.sha2 principal.process.file.sha256 Hachage SHA256 du fichier exécutable de l'acteur.
actor.pid principal.process.pid ID de processus de l'acteur.
actor.uid principal.resource.id Identifiant unique de l'acteur.
actor.user.name principal.user.userid Nom d'utilisateur de l'acteur.
actor.user.sid principal.user.windows_sid SID Windows de l'utilisateur acteur.
attack.technique_name security_result.threat_name Nom de la technique MITRE ATT&CK.
attack.technique_uid security_result.description Utilisé avec attack.technique_name pour renseigner security_result.description au format : .
collector_device_ip intermediary.ip Adresse IP de l'appareil collecteur.
collector_device_name intermediary.hostname Nom d'hôte de l'appareil collecteur.
collector_name intermediary.resource.name Nom du collecteur.
collector_uid intermediary.resource.id Identifiant unique du collecteur.
connection.bytes_download network.received_bytes Nombre d'octets téléchargés dans la connexion.
connection.bytes_upload network.sent_bytes Nombre d'octets importés dans la connexion.
connection.direction_id network.direction Direction de la connexion réseau (1 pour ENTRANT, 2 pour SORTANT).
connection.dst_ip target.ip Adresse IP de destination de la connexion.
connection.dst_port target.port Port de destination de la connexion.
connection.src_ip principal.ip Adresse IP source de la connexion.
connection.src_name principal.hostname Nom d'hôte source de la connexion.
connection.src_port principal.port Port source de la connexion.
connection.url.host target.hostname Nom d'hôte dans l'URL de connexion.
connection.url.scheme network.application_protocol Schéma de l'URL de connexion (par exemple, HTTP, HTTPS).
connection.url.text target.url URL de connexion complète.
data_source_url_domain target.url Le domaine de l'URL de la source de données.
device_domain principal.administrative_domain/target.administrative_domain Le domaine de l'appareil. Mappé sur le compte principal ou la cible en fonction de la logique liée à connection.direction_id.
device_ip principal.ip/target.ip L'adresse IP de l'appareil Mappé sur le compte principal ou la cible en fonction de la logique liée à connection.direction_id.
device_name principal.hostname/target.hostname Le nom de l'appareil. Mappé sur le compte principal ou la cible en fonction de la logique liée à connection.direction_id.
device_os_name principal.platform_version/target.platform_version Système d'exploitation de l'appareil. Mappé sur le compte principal ou la cible en fonction de la logique liée à connection.direction_id.
device_uid target.asset_id Identifiant unique de l'appareil, précédé de "ID de l'appareil :".
directory.path target.file.full_path Chemin d'accès au répertoire.
domain_name target.administrative_domain Nom du domaine.
event_actor.file.path target.process.file.full_path Chemin d'accès au fichier exécutable de l'acteur de l'événement.
event_actor.pid target.process.pid ID de processus de l'acteur de l'événement.
event_desc metadata.description Description de l'événement.
externalIP target.ip L'adresse IP externe.
file.md5 target.file.md5 Hachage MD5 du fichier.
file.path target.file.full_path Chemin d'accès au fichier.
file.rep_prevalence_band additional.fields.value.number_value Bande de prévalence de la réputation du fichier, mappée avec keyprevalence_score.
file.rep_score_band additional.fields.value.number_value La tranche de score de réputation du fichier, mappée avec la clé reputation_score.
file.sha2 target.file.sha256 Hachage SHA-256 du fichier.
file.size target.file.size Taille du fichier.
internalHost principal.hostname Nom d'hôte interne.
internalIP principal.ip Adresse IP interne.
internal_port principal.port Le port interne.
kernel.name target.resource.name Nom de l'objet kernel. Le champ target.resource.type est défini sur MUTEX.
message metadata.description Le message de journal.
module.md5 target.process.file.md5 Hachage MD5 du module.
module.path target.process.file.full_path Chemin d'accès au module.
module.sha2 target.process.file.sha256 Hachage SHA256 du module.
module.size target.process.file.size Taille du module.
process.cmd_line target.process.command_line Ligne de commande du processus.
process.file.md5 target.process.file.md5 Hachage MD5 du fichier exécutable du processus.
process.file.path target.process.file.full_path Chemin d'accès au fichier exécutable du processus.
process.file.sha2 target.process.file.sha256 Hachage SHA256 du fichier exécutable du processus.
process.pid target.process.pid ID du processus.
process.uid target.resource.id Identifiant unique du processus.
process.user.name target.user.userid Nom d'utilisateur associé au processus.
process.user.sid target.user.windows_sid SID Windows de l'utilisateur du processus.
product_name metadata.product_name Nom du produit qui génère le journal.
product_ver metadata.product_version Version du produit générant le journal.
reg_key.path target.registry.registry_key Chemin d'accès de la clé de registre.
reg_value.data target.registry.registry_value_data Données de la valeur de registre.
reg_value.name target.registry.registry_value_name Nom de la valeur de registre.
reg_value.path target.registry.registry_key Chemin d'accès de la clé de registre pour la valeur.
security_result.severity security_result.severity Gravité du résultat de sécurité. Convertie d'une valeur numérique en énumération UDM (par exemple, 1 en LOW, 5 en MEDIUM, 10 en LOW, 15 en LOW).
session.id network.session_id ID de la session.
session.user.name target.user.userid Nom d'utilisateur associé à la session.
sid principal.user.userid Identifiant de sécurité (SID).
status_detail security_result.summary Informations supplémentaires sur l'état.
type_id metadata.product_event_type ID du type d'événement.
user_agent_ip target.ip Adresse IP de l'user-agent.
user_name principal.user.userid/target.user.user_display_name Nom d'utilisateur. Mappé au compte principal ou à la cible en fonction de la logique liée à l'analyse CEF ou JSON.
user_uid target.user.userid Identifiant unique de l'utilisateur.
uuid metadata.product_log_id UUID de l'événement.
event.idm.read_only_udm.metadata.event_timestamp event.idm.read_only_udm.metadata.event_timestamp Horodatage de l'événement. Dérivé de log_time ou de CEF device_time.
event.idm.read_only_udm.metadata.log_type event.idm.read_only_udm.metadata.log_type Type de journal. Codé en dur sur SYMANTEC_EDR.
event.idm.read_only_udm.metadata.vendor_name event.idm.read_only_udm.metadata.vendor_name Nom du fournisseur. Codé en dur sur Symantec.
event.idm.read_only_udm.extensions.auth.type event.idm.read_only_udm.extensions.auth.type Type d'authentification. Définissez la valeur sur MACHINE pour les événements de connexion et de déconnexion.
security_result.action security_result.action Action effectuée à la suite de l'événement lié à la sécurité. Définissez cette option sur ALLOW pour les connexions et déconnexions réussies.
log_time event.idm.read_only_udm.metadata.collected_timestamp Mappé à partir du journal des modifications
user_name event.idm.read_only_udm.target.user.user_display_name Mappé à partir du journal des modifications
severity_id event.idm.read_only_udm.security_result.severity_details Mappé à partir du journal des modifications
risk_ref_value event.idm.read_only_udm.security_result.risk_score Mappé à partir du journal des modifications
attacks.technique_uid event.idm.read_only_udm.security_result.attack_details.techniques Mappé à partir du journal des modifications
attacks.technique_uid event.idm.read_only_udm.security_result.attack_details.tactics Mappé à partir du journal des modifications
event_actor.file.normalized_path event.idm.read_only_udm.principal.file.full_path Mappé à partir du journal des modifications
event_actor.file.name event.idm.read_only_udm.principal.process.file.names Mappé à partir du journal des modifications
user_sid event.idm.read_only_udm.target.user.windows_sid Mappé à partir du journal des modifications
event_actor.file.signature_company_name event.idm.read_only_udm.principal.group.group_display_name Mappé à partir du journal des modifications
event_actor.app_name event.idm.read_only_udm.principal.application Mappé à partir du journal des modifications
event_actor.integrity_id event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
event_actor_integrity_id event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
event_actor.signature_level_id event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
event_actor_signature_level_id event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
event_actor.start_time event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
event_actor_start_time event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
event_actor.file.modified event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
event_actor_file_modified event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
operation event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
event_actor.file.signature_value_ids event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
signature_value_id_0 event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
signature_value_id_1 event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
analysis event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
amsi_data event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
log_name event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
scan_uid event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
enriched_data.category_id event.idm.read_only_udm.security_result.detection_fields Mappé à partir du journal des modifications
category_id event.idm.read_only_udm.security_result.detection_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.