Collecter les journaux ReviveSec

Compatible avec :

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

ReviveSec est une plate-forme d'analyse de la sécurité de Revive Security Ltd (Israël) spécialisée dans la surveillance de l'état des pare-feu Check Point, la détection proactive des défaillances et la surveillance des points de terminaison. La plate-forme déploie des agents légers sur les machines Windows et Linux qui surveillent les processus, les fichiers, les connexions réseau, le DNS et les périphériques USB.

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 le serveur ReviveSec

  • 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é au portail ReviveSec avec des autorisations d'administrateur

Obtenir le fichier d'authentification d'ingestion Google SecOps

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres SIEM> 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 sur lequel Bindplane sera installé.

Obtenir l'ID client Google SecOps

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres du SIEM > Profil.
  3. 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

  1. Ouvrez l'invite de commandes 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 la fin de l'installation.

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

    sc query observiq-otel-collector
    

    Le service doit être indiqué comme RUNNING (EN COURS D'EXÉCUTION).

Installation de Linux

  1. Ouvrez un terminal avec des privilèges 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
    
  3. Attendez la fin de l'installation.

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

    sudo systemctl status observiq-otel-collector
    

    Le service doit être indiqué comme actif (en cours d'exécution).

Autres ressources d'installation

Pour obtenir d'autres options d'installation et de 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:
        filelog:
            include:
                - /path/to/revivesec/logs/*.json
                - /path/to/revivesec/logs/*.csv
            start_at: beginning
    
    exporters:
        chronicle/revivesec:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: REVIVESEC
            raw_log_field: body
            ingestion_labels:
                env: production
    
    service:
        pipelines:
            logs/revivesec_to_chronicle:
                receivers:
                    - filelog
                exporters:
                    - chronicle/revivesec
    

Paramètres de configuration

Remplacez les espaces réservés suivants :

  • Configuration du récepteur :

    • filelog : type de récepteur pour la collecte des fichiers journaux à partir du disque
    • include : liste des chemins d'accès aux fichiers ou des modèles glob à surveiller :
      • Ajustez le chemin d'accès pour qu'il corresponde à l'emplacement de votre fichier journal ReviveSec.
      • Utilisez des schémas glob (par exemple, *.json, *.csv) pour faire correspondre plusieurs fichiers.
    • start_at : définissez la valeur sur beginning pour lire les fichiers journaux existants depuis le début ou sur end pour ne lire que les nouvelles entrées.
  • Configuration de l'exportateur :

    • revivesec : nom descriptif de l'exportateur.
    • creds_file_path : chemin d'accès complet au fichier d'authentification de l'ingestion :
      • Linux : /etc/bindplane-agent/ingestion-auth.json
      • Windows : C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • <customer_id> : ID client de l'étape précédente
    • endpoint : URL du point de terminaison régional :
      • États-Unis : malachiteingestion-pa.googleapis.com
      • Europe : europe-malachiteingestion-pa.googleapis.com
      • Asie : asia-southeast1-malachiteingestion-pa.googleapis.com
      • Pour obtenir la liste complète, consultez Points de terminaison régionaux.
    • REVIVESEC : type de journal tel qu'il apparaît dans Chronicle
    • ingestion_labels : étiquettes facultatives au format YAML (par exemple, env: production)
  • Configuration du pipeline :

    • revivesec_to_chronicle : nom descriptif du pipeline.

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. Recherchez les erreurs dans les journaux :

      sudo journalctl -u observiq-otel-collector -f
      
  • Pour redémarrer l'agent Bindplane dans 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.
      4. Vérifiez que le service est en cours d'exécution :

        sc query observiq-otel-collector
        
      5. Recherchez les erreurs dans les journaux :

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

Exporter les journaux ReviveSec pour la collecte

  1. Connectez-vous au portail d'administration ReviveSec.
  2. Accédez à la section Données analytiques ou Rapports.
  3. Sélectionnez le type de rapport souhaité (vérification de l'état, conformité, activité des points de terminaison ou analyses du pare-feu).
  4. Appliquez des filtres de plage de dates si nécessaire.
  5. Cliquez sur Exporter, puis sélectionnez le format de sortie :
    • JSON : recommandé pour l'ingestion SIEM.
    • CSV : format tabulaire pour les données structurées.
  6. Enregistrez les fichiers exportés dans le répertoire surveillé par l'agent BindPlane (par exemple, /path/to/revivesec/logs/).
  7. (Facultatif) Configurez des rapports planifiés (quotidiens, hebdomadaires ou mensuels) pour exporter automatiquement les données vers le répertoire surveillé. Contactez l'assistance ReviveSec pour en savoir plus sur les options d'exportation automatique et l'accès à l'API.

Table de mappage UDM

Champ de journal Mappage UDM Logique
country_label additional.fields Fusionné
hit_count_label additional.fields Fusionné
linkInfo_label additional.fields Fusionné
proxy_label additional.fields Fusionné
signature_label additional.fields Fusionné
signature_status_label additional.fields Fusionné
svc_num_label additional.fields Fusionné
desc metadata.description Mappé directement
description metadata.description Mappé directement
description_gateway metadata.description Mappé directement
description_signature metadata.description Mappé directement
has_principal metadata.event_type Mappé : true → NETWORK_CONNECTION, true → STATUS_UPDATE
has_user metadata.event_type Mappé : true → USER_UNCATEGORIZED
product_event metadata.product_event_type Mappé directement
domain principal.asset.hostname Mappé directement
info_ip principal.asset.ip Fusionné
ipadd principal.asset.ip Fusionné
src_ip principal.asset.ip Fusionné
domain principal.hostname Mappé directement
info_ip principal.ip Fusionné
ipadd principal.ip Fusionné
src_ip principal.ip Fusionné
country_name principal.location.country_or_region Mappé directement
port principal.port Mappé directement
link_url principal.url Mappé directement
display_name principal.user.user_display_name Mappé directement
username principal.user.userid Mappé directement
domain_name target.asset.hostname Mappé directement
ipadd target.asset.ip Fusionné
domain_name target.hostname Mappé directement
ipadd target.ip Fusionné
N/A metadata.event_type Constante : NETWORK_CONNECTION
N/A metadata.product_name Constante : REVIVESEC
N/A metadata.vendor_name Constante : REVIVESEC

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.