Exécutable du redirecteur Chronicle pour Windows

Ce document explique comment installer et configurer le redirecteur Chronicle sur Microsoft Windows.

Personnaliser les fichiers de configuration

Sur la base des informations que vous avez envoyées avant le déploiement, Google Cloud vous fournit un fichier exécutable et un fichier de configuration facultatif pour le redirecteur Chronicle. Le fichier exécutable ne doit être exécuté que sur l'hôte pour lequel il a été configuré. Chaque fichier exécutable inclut une configuration spécifique à l'instance de redirecteur Chronicle sur votre réseau. Si vous devez modifier la configuration, contactez l'assistance Chronicle.

Configuration requise

Vous trouverez ci-dessous des recommandations générales. Pour obtenir des recommandations spécifiques à votre système, contactez l'assistance Chronicle.

  • Version de Windows Server: le redirecteur Chronicle est compatible avec les versions suivantes de Microsoft Windows Server:

    • 2008 R2

    • 2012 R2

    • 2016

  • RAM: 1,5 Go pour chaque type de données collectées. Par exemple, la détection et la réponse sur les points de terminaison (EDR), le DNS et le DHCP sont tous des types de données distincts. Vous avez besoin de 4,5 Go de RAM pour collecter des données pour ces trois appareils.

  • Processeur: deux processeurs suffisent pour gérer moins de 10 000 événements par seconde (EPS) (au total pour tous les types de données). Si vous prévoyez de transférer plus de 10 000 EPS, 4 à 6 processeurs sont nécessaires.

  • Disque: 100 Mo d'espace disque suffisent, quelle que soit la quantité de données traitées par le redirecteur Chronicle. Par défaut, le redirecteur Chronicle ne met pas en mémoire tampon sur disque. Vous pouvez mettre le disque en mémoire tampon en ajoutant les paramètres write_to_disk_buffer_enabled et write_to_disk_dir_path dans le fichier de configuration.

    Exemple :

    - <collector>:
     common:
         ...
         write_to_disk_buffer_enabled: true
         write_to_disk_dir_path: <var>your_path</var>
         ...

Plages d'adresses IP utilisées par Google

Vous aurez peut-être besoin que la plage d'adresses IP s'ouvre lors de la configuration d'un redirecteur Chronicle, par exemple lors de la configuration de votre pare-feu. Google ne peut pas fournir une liste spécifique d'adresses IP. Toutefois, vous pouvez obtenir des plages d'adresses IP Google.

Vérifier la configuration du pare-feu

Si vous disposez de pare-feu ou de proxys authentifiés entre le conteneur de redirecteur Chronicle et Internet, ils nécessitent des règles pour autoriser l'accès aux hôtes Google Cloud suivants:

Type de connexion Destination Port
TCP malachiteingestion-pa.googleapis.com 443
TCP asia-northeast1-malachiteingestion-pa.googleapis.com 443
TCP asia-south1-malachiteingestion-pa.googleapis.com 443
TCP asia-southeast1-malachiteingestion-pa.googleapis.com 443
TCP australia-southeast1-malachiteingestion-pa.googleapis.com 443
TCP europe-malachiteingestion-pa.googleapis.com 443
TCP europe-west2-malachiteingestion-pa.googleapis.com 443
TCP europe-west3-malachiteingestion-pa.googleapis.com 443
TCP europe-west6-malachiteingestion-pa.googleapis.com 443
TCP me-central2-malachiteingestion-pa.googleapis.com 443
TCP me-west1-malachiteingestion-pa.googleapis.com 443
TCP northamerica-northeast2-malachiteingestion-pa.googleapis.com 443
TCP accounts.google.com 443
TCP gcr.io 443
TCP oauth2.googleapis.com 443
TCP storage.googleapis.com 443

Pour vérifier la connectivité réseau à Google Cloud, procédez comme suit:

  1. Démarrez Windows PowerShell avec des droits d'administrateur (cliquez sur Démarrer, saisissez PowerShell, effectuez un clic droit sur Windows PowerShell, puis cliquez sur Exécuter en tant qu'administrateur).

  2. Exécutez la commande suivante : TcpTestSucceeded doit renvoyer la valeur "true".

    C:\> test-netconnection <host> -port <port>

    Exemple :

    C:\> test-netconnection malachiteingestion-pa.googleapis.com -port 443
ComputerName     : malchiteingestion-pa.googleapis.com
RemoteAddress    : 198.51.100.202
RemotePort       : 443
InterfaceAlias   : Ethernet
SourceAddress    : 10.168.0.2
TcpTestSucceeded : True

Vous pouvez également vérifier la connectivité réseau à l'aide du redirecteur Chronicle:

  1. Lancez l'invite de commande avec les droits d'administrateur (cliquez sur Démarrer, saisissez Command Prompt, effectuez un clic droit sur Invite de commande, puis cliquez sur Exécuter en tant qu'administrateur).

  2. Pour vérifier la connectivité réseau, exécutez le redirecteur Chronicle avec l'option -test.

    C:\> .\chronicle_forwarder.exe -test
Verify network connection succeeded!

Installer le redirecteur Chronicle sur Windows

Sous Windows, l'exécutable du redirecteur Chronicle doit être installé en tant que service.

  1. Copiez le fichier chronicle_forwarder.exe et le fichier de configuration dans un répertoire de travail.

  2. Lancez l'invite de commande avec les droits d'administrateur (cliquez sur Démarrer, saisissez Command Prompt, effectuez un clic droit sur Invite de commande, puis cliquez sur Exécuter en tant qu'administrateur).

  3. Pour installer le service, accédez au répertoire de travail que vous avez créé à l'étape 1 et exécutez la commande suivante:

    C:\> .\chronicle_forwarder.exe -install -config FILE_NAME

    Remplacez FILE_NAME par le nom du fichier de configuration qui vous a été fourni.

    Le service est installé dans C:\Windows\system32\ChronicleForwarder.

  4. Pour démarrer le service, exécutez la commande suivante:

    C:\> sc.exe start chronicle_forwarder

Vérifier que le redirecteur Chronicle est en cours d'exécution

Une connexion réseau doit être ouverte sur le port 443 pour le redirecteur Chronicle, et vos données devraient s'afficher dans l'interface Web Chronicle au bout de quelques minutes.

Vous pouvez vérifier que le redirecteur Chronicle est en cours d'exécution à l'aide de l'une des méthodes suivantes:

  • Gestionnaire de tâches: accédez à l'onglet Processus > Processus en arrière-plan > chronicle_forwarder.

  • Surveillance des ressources: dans l'onglet Réseau, l'application chronicle_forwarder.exe doit apparaître sous Activité du réseau (chaque fois que l'application chronicle_forwarder.exe se connecte à Google Cloud), sous Connexions TCP et sous Ports d'écoute.

Afficher les journaux du redirecteur

Les fichiers journaux du redirecteur Chronicle sont stockés dans le dossier C:\Windows\Temp. Les fichiers journaux commencent par chronicle_forwarder.exe.win-forwarder. Les fichiers journaux fournissent diverses informations, y compris la date de démarrage du système de transfert et la date à laquelle il a commencé à envoyer des données à Google Cloud.

Désinstaller le redirecteur Chronicle

Pour désinstaller le service de redirecteur Chronicle, procédez comme suit:

  1. Ouvrez l'invite de commande en mode administrateur.

  2. Arrêtez le service de redirecteur Chronicle:

    SERVICE_NAME: chronicle_forwarder
TYPE               : 10  WIN32_OWN_PROCESS
STATE              : 4  RUNNING (STOPPABLE, PAUSABLE, ACCEPTS_SHUTDOWN)
WIN32_EXIT_CODE    : 0  (0x0)
SERVICE_EXIT_CODE  : 0  (0x0)
CHECKPOINT         : 0x0
WAIT_HINT          : 0x0

  3. Accédez au répertoire C:\Windows\system32\ChronicleForwarder et désinstallez le service de redirecteur Chronicle: C:\> .\chronicle_forwarder.exe -uninstall

Mettre à niveau le redirecteur Chronicle

Pour mettre à niveau le redirecteur Chronicle tout en continuant à utiliser votre fichier de configuration actuel, procédez comme suit:

  1. Ouvrez l'invite de commande en mode administrateur.

  2. Copiez le fichier de configuration du répertoire C:\Windows\system32\ChronicleForwarder vers un autre répertoire.

  3. Arrêtez le redirecteur Chronicle:

    C:\> sc.exe stop chronicle_forwarder

  4. Désinstallez le service de transfert et l'application Chronicle:

    C:\> .\chronicle_forwarder.exe --uninstall

  5. Supprimez tous les fichiers du répertoire C:\windows\system32\ChronicleForwarder.

  6. Copiez la nouvelle application chronicle_forwarder.exe et le fichier de configuration d'origine dans un répertoire de travail.

  7. Dans le répertoire de travail, exécutez la commande suivante:

    C:\> .\chronicle_forwarder.exe -install -config configFileProvidedToYou

  8. Démarrez le service :

    C:\ sc.exe start chronicle_forwarder

Collecter les données Splunk

Contactez l'assistance Chronicle pour mettre à jour votre fichier de configuration du redirecteur Chronicle afin de transférer vos données Splunk vers Google Cloud.

Collecter des données syslog

Le redirecteur Chronicle peut fonctionner comme un serveur syslog. Cela signifie que vous pouvez configurer n'importe quel dispositif ou serveur compatible avec l'envoi de données syslog via une connexion TCP ou UDP pour transférer leurs données au redirecteur Chronicle. Vous pouvez contrôler précisément les données que le dispositif ou le serveur envoie au redirecteur Chronicle, qui peut ensuite les transférer vers Google Cloud.

Le fichier de configuration du redirecteur Chronicle spécifie les ports à surveiller pour chaque type de données transférées (par exemple, le port 10514). Par défaut, le redirecteur Chronicle accepte les connexions TCP et UDP. Contactez l'assistance Chronicle pour mettre à jour le fichier de configuration du redirecteur Chronicle afin de prendre en charge syslog.

Activer/Désactiver la compression des données

La compression des journaux réduit la consommation de la bande passante réseau lors du transfert des journaux vers Chronicle. Cependant, la compression peut entraîner une augmentation de l'utilisation du processeur. Le compromis entre l'utilisation du processeur et la bande passante dépend de nombreux facteurs, y compris du type de données de journal, de la compressibilité de ces données, de la disponibilité des cycles de processeur sur l'hôte qui exécute le redirecteur et de la nécessité de réduire l'utilisation de la bande passante réseau.

Par exemple, les journaux textuels se compressent bien et peuvent permettre d'économiser considérablement la bande passante avec une faible utilisation du processeur. Toutefois, les charges utiles chiffrées des paquets bruts ne sont pas correctement compressées et entraînent une utilisation plus élevée du processeur.

Étant donné que la plupart des types de journaux ingérés par le redirecteur sont efficacement compressibles, la compression des journaux est activée par défaut pour réduire l'utilisation de la bande passante. Toutefois, si l'augmentation de l'utilisation du processeur est plus importante que les avantages liés aux économies de bande passante, vous pouvez désactiver la compression en définissant le champ compression sur false dans le fichier de configuration du redirecteur Chronicle, comme illustré dans l'exemple suivant:

  compression: false
  url: malachiteingestion-pa.googleapis.com:443
  identity:
  identity:
  collector_id: 10479925-878c-11e7-9421-10604b7abba1
  customer_id: abcd4bb9-878b-11e7-8455-12345b7cb5c1
  secret_key: |
  {
    "type": "service_account",
  ...

Activer le protocole TLS pour les configurations syslog

Vous pouvez activer le protocole TLS (Transport Layer Security) pour la connexion syslog au redirecteur Chronicle. Dans le fichier de configuration du redirecteur Chronicle, spécifiez l'emplacement du certificat et de la clé de certificat, comme indiqué dans l'exemple suivant:

certificat C:/opt/chronicle/external/certs/edb3ae966a7bbe1f.pem
certificate_key C:/opt/chronicle/external/certs/forwarder.key

D'après l'exemple indiqué, la configuration du redirecteur Chronicle doit être modifiée comme suit:

  collectors:
- syslog:
    common:
      enabled: true
      data_type: WINDOWS_DNS
      data_hint:
      batch_n_seconds: 10
      batch_n_bytes: 1048576
  tcp_address: 0.0.0.0:10515
  connection_timeout_sec: 60
  certificate: "C:/opt/chronicle/external/certs/edb3ae966a7bbe1f.pem"
  certificate_key: "C:/opt/chronicle/external/certs/forwarder.key"

Vous pouvez créer un répertoire de certificats dans le répertoire de configuration et y stocker les fichiers de certificats.

Collecter les données des paquets

Le redirecteur Chronicle peut capturer des paquets directement à partir d'une interface réseau à l'aide de Npcap sur les systèmes Windows.

Les paquets sont capturés et envoyés à Google Cloud à la place des entrées de journal. La capture s'effectue uniquement à partir d'une interface locale.

Contactez l'assistance Chronicle pour mettre à jour le fichier de configuration du redirecteur Chronicle afin de prendre en charge la capture de paquets.

Pour exécuter un redirecteur de capture de paquets (PCAP), vous avez besoin des éléments suivants:

  • Installez Npcap sur l'hôte Microsoft Windows.

  • Accordez au système de transfert Chronicle des droits racine ou d'administrateur pour surveiller l'interface réseau.

  • Aucune option de ligne de commande n'est nécessaire.

  • Sur l'installation Npcap, activez le mode de compatibilité WinPcap.

Pour configurer un redirecteur PCAP, Google Cloud a besoin du GUID de l'interface utilisée pour capturer les paquets. Exécutez getmac.exe sur la machine sur laquelle vous prévoyez d'installer le redirecteur Chronicle (soit le serveur, soit la machine qui écoute le port span), puis envoyez la sortie à Chronicle.

Vous pouvez également modifier le fichier de configuration. Recherchez la section PCAP et remplacez la valeur GUID affichée à côté de l'interface avec le GUID affiché lors de l'exécution de getmac.exe.

Par exemple, voici une section PCAP d'origine:

 common:
       enabled: true
 data_type: PCAP_DNS
       batch_n_seconds: 10
   batch_n_bytes: 1048576
     interface: \Device\NPF_{1A7E7C8B-DD7B-4E13-9637-0437AB1A12FE}
   bpf: udp port 53

Voici le résultat de l'exécution de getmac.exe:

C:\>getmac.exe
  Physical Address    Transport Name
  ===========================================================================
  A4-73-9F-ED-E1-82   \Device\Tcpip_{2E0E9440-ABFF-4E5B-B43C-E188FCAD1234}

Et enfin, voici la section PCAP révisée avec le nouveau GUID:

- pcap:
       common:
     enabled: true
         data_type: PCAP_DNS
     batch_n_seconds: 10
         batch_n_bytes: 1048576
       interface: \Device\NPF_{2E0E9440-ABFF-4E5B-B43C-E188FCAD9734}
     bpf: udp port 53

Collecter des données WebProxy

Le redirecteur Chronicle peut capturer les données WebProxy directement à partir d'une interface réseau à l'aide de Npcap et les envoyer à Google Cloud.

Pour activer la capture de données WebProxy pour votre système, contactez l'assistance Chronicle.

Avant d'exécuter un redirecteur WebProxy, procédez comme suit:

  1. Installez Npcap sur l'hôte Microsoft Windows. Activez le mode de compatibilité WinPcap pendant l'installation.

  2. Accordez des droits racine ou d'administrateur au redirecteur Chronicle pour surveiller l'interface réseau.

  3. Pour configurer un redirecteur WebProxy, Google Cloud a besoin du GUID de l'interface utilisée pour capturer les paquets WebProxy.

    Exécutez getmac.exe sur la machine sur laquelle vous souhaitez installer le redirecteur Chronicle et envoyez la sortie à Chronicle. Vous pouvez également modifier le fichier de configuration. Recherchez la section WebProxy et remplacez le GUID affiché à côté de l'interface par celui affiché après l'exécution de getmac.exe.

    Modifiez le fichier de configuration du redirecteur Chronicle (FORWARDER_NAME.conf) comme suit:

      - webproxy:
    common:
        enabled : true
        data_type: <Your LogType>
        batch_n_seconds: 10
        batch_n_bytes: 1048576
      interface: \Device\NPF_{2E0E9440-ABFF-4E5B-B43C-E188FCAD9734}
      bpf: tcp and dst port 80