Collecter les journaux Symantec VIP Enterprise Gateway

Compatible avec :

Ce document explique comment ingérer les journaux Symantec VIP Enterprise Gateway dans Google Security Operations à l'aide de l'agent Bindplane.

Symantec VIP (Validation and ID Protection) Enterprise Gateway est une solution d'authentification multifacteur qui génère des messages syslog pour les événements d'authentification, la validation des identifiants, la synchronisation LDAP et l'activité de vérification de l'état. L'analyseur extrait les champs des journaux au format JSON et syslog, 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 la passerelle Symantec VIP
  • 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 VIP Gateway

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_vip:
        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_VIP
        raw_log_field: body
    
    service:
      pipelines:
        logs/symantec_vip_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/symantec_vip
    

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_vip:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: SYMANTEC_VIP
        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 VIP Enterprise Gateway

  1. Connectez-vous à l'UI Web de la passerelle Symantec VIP.
  2. Accédez à Journaux > Configuration Syslog.
  3. Si vous configurez Syslog pour la première fois, sélectionnez Yes (Oui) lorsque vous y êtes invité. Si le paramètre est déjà configuré, cliquez sur Modifier.
  4. Fournissez les informations de configuration suivantes :
    • Fonctionnalité Syslog : sélectionnez LOG_LOCAL0.
    • Hôte Syslog : saisissez l'adresse IP de l'agent BindPlane.
    • Port Syslog : saisissez le numéro de port de l'agent Bindplane (par exemple, 514 pour UDP).
  5. Cliquez sur Enregistrer.
  6. Accédez à Paramètres > Paramètres de la console.
  7. Fournissez les informations de configuration suivantes :
    • Niveau de journalisation : sélectionnez Info.
    • Enable Syslog (Activer Syslog) : sélectionnez Yes (Oui).
  8. Cliquez sur Envoyer.
  9. Accédez à Paramètres > Paramètres du bilan de santé.
  10. Sélectionnez Oui pour activer le service de vérification d'état.
  11. Fournissez les informations de configuration suivantes :
    • Niveau de journalisation : sélectionnez Info.
    • Enable Syslog (Activer Syslog) : sélectionnez Yes (Oui).
  12. Cliquez sur Envoyer.
  13. Accédez à User Store > LDAP Directory Synchronization (Magasin d'utilisateurs > Synchronisation d'annuaire LDAP).
  14. Modifiez les détails de configuration suivants :
    • Niveau de journalisation : sélectionnez Info.
    • Enable Syslog (Activer Syslog) : sélectionnez Yes (Oui).
  15. Cliquez sur Envoyer.

Table de mappage UDM

Champ du journal mappage UDM Logique
application read_only_udm.principal.application Valeur extraite du champ application par le filtre JSON.
commande read_only_udm.target.process.command_line Valeur extraite du champ command par le modèle grok.
credentialType Ce champ n'est pas directement mappé sur l'UDM. Il est utilisé pour dériver la valeur de read_only_udm.extensions.auth.mechanism.
données Ce champ n'est pas directement mappé sur l'UDM. Il est analysé pour extraire d'autres champs.
données2 Ce champ n'est pas directement mappé sur l'UDM. Il est analysé pour extraire d'autres champs.
Date/Heure read_only_udm.metadata.event_timestamp.seconds
read_only_udm.metadata.event_timestamp.nanos
Secondes et nanosecondes depuis l'epoch extraites du champ datetime.
décroiss. read_only_udm.metadata.description Valeur extraite du champ desc par le filtre JSON.
description read_only_udm.security_result.description Valeur extraite du champ description par le filtre JSON.
filename read_only_udm.target.process.file.full_path Valeur extraite du champ filename par le modèle grok.
nom d'hôte read_only_udm.principal.hostname Valeur extraite du champ hostname par le filtre JSON.
host_name read_only_udm.intermediary.hostname Valeur extraite du champ host_name par le filtre JSON.
log_level Ce champ n'est pas directement mappé sur l'UDM. Il est utilisé pour dériver la valeur de read_only_udm.security_result.severity.
log_type read_only_udm.metadata.product_event_type Valeur extraite du champ log_type par le filtre JSON.
Message Ce champ n'est pas directement mappé sur l'UDM. Il est analysé pour extraire d'autres champs.
opération read_only_udm.security_result.summary Valeur extraite du champ operation par le modèle grok.
processid read_only_udm.target.process.pid Valeur extraite du champ processid par le modèle grok.
produit read_only_udm.metadata.product_name Valeur extraite du champ product par le filtre JSON.
reason read_only_udm.metadata.description Valeur extraite du champ reason par le modèle grok.
request_id read_only_udm.target.resource.id Valeur extraite du champ request_id par le modèle grok.
src_ip read_only_udm.principal.ip Valeur extraite du champ src_ip par le modèle grok.
état read_only_udm.metadata.description Valeur extraite du champ status par le modèle grok.
résumé read_only_udm.security_result.summary Valeur extraite du champ summary par le filtre JSON.
timestamp.nanos read_only_udm.metadata.event_timestamp.nanos Nanosecondes à partir du code temporel du journal d'origine.
timestamp.seconds read_only_udm.metadata.event_timestamp.seconds Secondes à partir du code temporel du journal d'origine.
heure Ce champ n'est pas directement mappé sur l'UDM. Il permet de dériver les valeurs de read_only_udm.metadata.event_timestamp.seconds et read_only_udm.metadata.event_timestamp.nanos.
utilisateur read_only_udm.target.user.userid Valeur extraite du champ user par un filtre JSON ou un modèle Grok.
vendor read_only_udm.metadata.vendor_name Valeur extraite du champ vendor par le filtre JSON.
read_only_udm.extensions.auth.mechanism Déterminé par le champ credentialType. Si credentialType est SMS_OTP ou STANDARD_OTP, OTP est utilisé. Si credentialType correspond à l'expression régulière PASSWORD, USERNAME_PASSWORD est utilisé.
read_only_udm.extensions.auth.type Si le champ reason correspond à l'expression régulière LDAP, SSO est utilisé. Sinon, AUTHTYPE_UNSPECIFIED est utilisé.
read_only_udm.metadata.event_type Déterminé par la présence de certains champs. Si user ou processid n'est pas vide, USER_LOGIN est utilisé. Si user est vide et que src_ip n'est pas vide ou est 0.0.0.0, alors STATUS_UPDATE est utilisé. Sinon, GENERIC_EVENT est utilisé.
read_only_udm.metadata.log_type Codé en dur sur SYMANTEC_VIP.
read_only_udm.security_result.action Déterminé par le champ status. Si status est Authentication Success, GRANTED, Authentication Completed, After Services Authenticate call ou CHALLENGED, alors ALLOW est utilisé. Si status est DENIED, Acces-Reject, Unknown Error, Service Unavailable ou FAILED, alors BLOCK est utilisé. Si status est PUSH request sent for user ou Trying to fetch attribute, QUARANTINE est utilisé.
read_only_udm.security_result.severity Déterminé par le champ log_level. Si log_level est DEBUG, INFO ou AUDIT, INFORMATIONAL est utilisé. Si log_level est ERROR, alors ERROR est utilisé. Si log_level est défini sur WARNING, MEDIUM est utilisé.

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.