Collecter les journaux Cyolo OT

Version de l'analyseur : 3.0

Compatible avec :

Ce document explique comment ingérer les journaux Cyolo Secure Remote Access pour OT dans Google Security Operations à l'aide de l'agent Bindplane.

Cyolo fournit un accès à distance sécurisé aux environnements de technologie opérationnelle (OT). La plate-forme génère des messages syslog pour les événements d'accès, l'authentification et les activités de session. L'analyseur extrait les champs et 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 plate-forme Cyolo
  • 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 d'administration Cyolo

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/cyolo_ot:
        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: CYOLO_OT
        raw_log_field: body
    
    service:
      pipelines:
        logs/cyolo_ot_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/cyolo_ot
    

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/cyolo_ot:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: CYOLO_OT
        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 sur Cyolo

  1. Connectez-vous à la console d'administration Cyolo.
  2. Accédez à Monitoring > Paramètres.
  3. Activez l'option Exporter les journaux vers le protocole de journalisation système (Syslog).
  4. Accédez à Intégrations > Serveur Syslog.
  5. Fournissez les informations de configuration suivantes :
    • Nom du serveur : saisissez un nom explicite pour ce serveur (par exemple, Google SecOps Bindplane).
    • Sites : sélectionnez un ou plusieurs sites dans le menu déroulant.
    • Adresse IP : saisissez l'adresse IP de l'agent Bindplane.
    • Port : saisissez le numéro de port de l'agent BindPlane pour la connexion UDP.
  6. Cliquez sur Enregistrer.

Table de mappage UDM

Champ du journal Mappage UDM Logique
_field additional.fields Fusionné
authority_id_label additional.fields Fusionné
authority_kind_label additional.fields Fusionné
authority_name_label additional.fields Fusionné
data_field additional.fields Fusionné
duration_label additional.fields Fusionné
kind_label additional.fields Fusionné
log_level_label additional.fields Fusionné
object_id_label additional.fields Fusionné
object_kind_label additional.fields Fusionné
object_name_label additional.fields Fusionné
rules_label additional.fields Fusionné
site_id_label additional.fields Fusionné
subject_id_label additional.fields Fusionné
subject_kind_label additional.fields Fusionné
message extensions.auth.type Mappé : user disconnected → MACHINE
syslog_object_name extensions.auth.type Mappé : login → MACHINE
inter_host intermediary.asset.hostname Mappage direct
inter_host intermediary.hostname Mappage direct
message metadata.description Mappage direct
msg metadata.description Mappage direct
syslog_message metadata.description Mappage direct
syslog_timestamp metadata.event_timestamp Analysé en tant que ISO8601
time metadata.event_timestamp Analysé en tant que MMM d HH:mm:ss
timestamp metadata.event_timestamp Analysé en tant que ISO8601
event_type metadata.event_type Mappage direct
kind metadata.product_event_type Mappage direct
prod_type metadata.product_event_type Mappage direct
id metadata.product_log_id Mappage direct
syslog_event_id metadata.product_log_id Mappage direct
product_version metadata.product_version Mappage direct
message network.application_protocol Mappé : rdp → RDP
client network.http.parsed_user_agent Mappage direct
cyolouagent network.http.parsed_user_agent Mappage direct
client network.http.user_agent Mappage direct
cyolouagent network.http.user_agent Mappage direct
syslog_client network.http.user_agent Mappage direct
cyolosessionid network.session_id Mappage direct
session_id network.session_id Mappage direct
hostname observer.hostname Mappage direct
container_id_label observer.resource.attribute.labels Fusionné
internal_event_id_label observer.resource.attribute.labels Fusionné
log_source_label observer.resource.attribute.labels Fusionné
site_id_label observer.resource.attribute.labels Fusionné
site_name_label observer.resource.attribute.labels Fusionné
transaction_id_label observer.resource.attribute.labels Fusionné
node_id observer.resource.product_object_id Mappage direct
syslog_hostname principal.asset.hostname Mappage direct
remote_address principal.asset.ip Fusionné
syslog_remote_address principal.asset.ip Fusionné
syslog_hostname principal.hostname Mappage direct
remote_address principal.ip Fusionné
syslog_remote_address principal.ip Fusionné
country_code principal.location.country_or_region Mappage direct
cyolocountrycode principal.location.country_or_region Mappage direct
syslog_country_code principal.location.country_or_region Mappage direct
node_id_label principal.resource.attribute.labels Fusionné
site_name_label principal.resource.attribute.labels Fusionné
transaction_id_label principal.resource.attribute.labels Fusionné
cyolosubjectkind principal.resource.resource_subtype Mappage direct
credentials_id_label principal.user.attribute.labels Fusionné
credentials_name_label principal.user.attribute.labels Fusionné
credentials_origin_label principal.user.attribute.labels Fusionné
cyolosubjectid principal.user.product_object_id Mappage direct
subject_id principal.user.product_object_id Mappage direct
syslog_session_id principal.user.product_object_id Mappage direct
cyolosubjectname principal.user.userid Mappage direct
subject_name principal.user.userid Mappage direct
syslog_id principal.user.userid Mappage direct
action security_result.action Fusionné
result security_result.action Mappé : failure → sr_action, success → sr_action
sr_action security_result.action Fusionné
syslog_result security_result.action_details Mappage direct
_field security_result.detection_fields Fusionné
field security_result.detection_fields Fusionné
key security_result.detection_fields Mappé : "cyoloauthkind", "cyolokind","cyoloresult" → _field
result security_result.outcome Mappé : failure → FAIL, success → PASS
authority_id security_result.rule_id Mappage direct
cyoloauthid security_result.rule_id Mappage direct
authority_name security_result.rule_name Mappage direct
cyoloauthname security_result.rule_name Mappage direct
severity security_result.severity Mappé : 1 → LOW
cyoloobjname target.application Mappage direct
object_name target.application Mappage direct
asset_id target.asset.asset_id Mappage direct
destination_host target.asset.hostname Mappage direct
dst target.asset.ip Fusionné
asset_name target.asset.product_object_id Mappage direct
destination_host target.hostname Mappage direct
dst target.ip Fusionné
destination_port target.port Mappage direct
_field target.resource.attribute.labels Fusionné
key target.resource.attribute.labels Mappé : cyolodstid → _field
cyoloobjid target.resource.product_object_id Mappage direct
object_id target.resource.product_object_id Mappage direct
cyoloobjkind target.resource.resource_subtype Mappage direct
syslog_subject_name target.user.userid Mappage direct
N/A extensions.auth.type Constante : MACHINE
N/A metadata.product_name Constante : CYOLO_OT
N/A metadata.vendor_name Constante : CYOLO_OT
N/A network.application_protocol Constante : RDP
N/A network.http.parsed_user_agent Constante : parseduseragent
N/A security_result.outcome Constante : FAIL
N/A security_result.severity Constante : LOW
inter_host event.idm.read_only_udm.intermediary.hostname et event.idm.read_only_udm.intermediary.asset.hostname Mappé à partir du journal des modifications
cyolosubjectname event.idm.read_only_udm.principal.user.userid Mappé à partir du journal des modifications
cyolocountrycode event.idm.read_only_udm.principal.location.country_or_region Mappé à partir du journal des modifications
cyolosubjectid event.idm.read_only_udm.principal.user.product_object_id Mappé à partir du journal des modifications
dst event.idm.read_only_udm.target.ipet event.idm.read_only_udm.target.asset.ip Mappé à partir du journal des modifications
cyoloobjname event.idm.read_only_udm.target.application Mappé à partir du journal des modifications
cyoloobjid event.idm.read_only_udm.target.resource.product_object_id Mappé à partir du journal des modifications
cyolosessionid event.idm.read_only_udm.network.session_id Mappé à partir du journal des modifications
cyolouagent event.idm.read_only_udm.network.http.user_agent et event.idm.read_only_udm.network.http.parsed_user_agent Mappé à partir du journal des modifications
cyoloauthid event.idm.read_only_udm.security_result.rule_id Mappé à partir du journal des modifications
cyoloauthname event.idm.read_only_udm.security_result.rule_name Mappé à partir du journal des modifications
cyolosubjectkind event.idm.read_only_udm.principal.resource.resource_subtype Mappé à partir du journal des modifications
cyoloobjkind event.idm.read_only_udm.target.resource.resource_subtype Mappé à partir du journal des modifications
prod_type event.idm.read_only_udm.metadata.product_event_type Mappé à partir du journal des modifications
cyoloauthkind event.idm.read_only_udm.security_result.detection_fields Mappé à partir du journal des modifications
cyolokind event.idm.read_only_udm.security_result.detection_fields Mappé à partir du journal des modifications
cyoloresult event.idm.read_only_udm.security_result.detection_fields Mappé à partir du journal des modifications
cyolodstid event.idm.read_only_udm.target.resource.attribute.labels Mappé à partir du journal des modifications
cef_version event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
Signature_id event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
cef_severity event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
start event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
act event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
cyolotransid event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
cyolocredentialsorigin event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
cyolocredentialsid event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
cyolocredentialsname event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
time event.idm.read_only_udm.metadata.event_timestamp Mappé à partir du journal des modifications
id event.idm.read_only_udm.metadata.product_log_id Mappé à partir du journal des modifications
remote_address event.idm.read_only_udm.principal.ip Mappé à partir du journal des modifications
remote_address event.idm.read_only_udm.principal.asset.ip Mappé à partir du journal des modifications
country_code event.idm.read_only_udm.principal.location.country_or_region Mappé à partir du journal des modifications
destination_host event.idm.read_only_udm.target.hostname Mappé à partir du journal des modifications
destination_host event.idm.read_only_udm.target.asset.hostname Mappé à partir du journal des modifications
destination_port event.idm.read_only_udm.target.port Mappé à partir du journal des modifications
message event.idm.read_only_udm.metadata.description Mappé à partir du journal des modifications
subject_name event.idm.read_only_udm.principal.user.userid Mappé à partir du journal des modifications
subject_id event.idm.read_only_udm.principal.user.product_object_id Mappé à partir du journal des modifications
timestamp event.idm.read_only_udm.metadata.event_timestamp Mappé à partir du journal des modifications
object_name event.idm.read_only_udm.target.application Mappé à partir du journal des modifications
object_id event.idm.read_only_udm.target.resource.product_object_id Mappé à partir du journal des modifications
session_id event.idm.read_only_udm.network.session_id Mappé à partir du journal des modifications
duration_str event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
message event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
subject_kind event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
authority_kind event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
log_level event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
object_kind event.idm.read_only_udm.additional.fields Mappé à partir du journal des modifications
client event.idm.read_only_udm.network.http.user_agent Mappé à partir du journal des modifications
client event.idm.read_only_udm.network.http.parsed_user_agent Mappé à partir du journal des modifications
authority_id event.idm.read_only_udm.security_result.rule_id Mappé à partir du journal des modifications
authority_name event.idm.read_only_udm.security_result.rule_name Mappé à partir du journal des modifications
severity event.idm.read_only_udm.security_result.severity Mappé à partir du journal des modifications
rules event.idm.read_only_udm.security_result.detection_fields Mappé à partir du journal des modifications
hostname event.idm.read_only_udm.observer.hostname Mappé à partir du journal des modifications
node_id event.idm.read_only_udm.observer.resource.product_object_id Mappé à partir du journal des modifications
site_id event.idm.read_only_udm.observer.resource.attribute.labels Mappé à partir du journal des modifications
log_source event.idm.read_only_udm.observer.resource.attribute.labels Mappé à partir du journal des modifications
site_name event.idm.read_only_udm.observer.resource.attribute.labels Mappé à partir du journal des modifications
container_id event.idm.read_only_udm.observer.resource.attribute.labels Mappé à partir du journal des modifications
transaction_id event.idm.read_only_udm.observer.resource.attribute.labels Mappé à partir du journal des modifications
event_id event.idm.read_only_udm.observer.resource.attribute.labels Mappé à partir du journal des modifications
kind event.idm.read_only_udm.metadata.product_event_type Mappé à partir du journal des modifications
syslog_timestamp event.idm.read_only_udm.metadata.collected_timestamp 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.