Collecter les journaux du routeur Yamaha

Compatible avec :

Ce document explique comment ingérer des journaux de routeur Yamaha dans Google Security Operations à l'aide de Bindplane. L'analyseur utilise des modèles Grok pour extraire des champs tels que l'horodatage, le nom d'hôte, l'utilisateur, la description, les adresses IP source et de destination des messages syslog. Il mappe ensuite ces champs extraits à l'UDM, en classant le type d'événement en fonction de la présence d'informations sur le principal, la cible et l'utilisateur.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Instance Google SecOps
  • Windows 2016 ou version ultérieure, ou un hôte Linux avec systemd
  • Si vous exécutez le programme derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts.
  • Accès privilégié à l'appliance de routeur Yamaha

Obtenir le fichier d'authentification d'ingestion Google SecOps

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres du SIEM > Agents de collecte.
  3. Téléchargez le fichier d'authentification d'ingestion. 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 SIEM> Profil.
  3. Copiez et enregistrez le numéro client de 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 fenêtres

  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

Installation de Linux

  1. Ouvrez un terminal avec les droits 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

Ressources d'installation supplémentaires

Pour plus d'options d'installation, consultez le guide d'installation.

Configurer l'agent Bindplane pour ingérer Syslog et l'envoyer à Google SecOps

  1. Accédez au fichier de configuration :
    • Trouvez le fichier config.yaml. En règle générale, il se trouve dans le répertoire /etc/bindplane-agent/ sous Linux ou dans le répertoire d'installation sous Windows.
    • Ouvrez le fichier à l'aide d'un éditeur de texte (par exemple, nano, vi ou le Bloc-notes).

  2. Modifiez le fichier config.yaml comme suit :

    receivers:
    udplog:
        # Replace the port and IP address as required
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/chronicle_w_labels:
        compression: gzip
        # Adjust the path to the credentials file you downloaded in Step 1
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: <customer_id>
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'YAMAHA_ROUTER'
        raw_log_field: body
        ingestion_labels:

service:
    pipelines:
        logs/source0__chronicle_w_labels-0:
            receivers:
                - udplog
            exporters:
                - chronicle/chronicle_w_labels
    • Remplacez le port et l'adresse IP selon les besoins de votre infrastructure.
    • Remplacez <customer_id> par le numéro client réel.
    • Mettez à jour /path/to/ingestion-authentication-file.json en indiquant le chemin d'accès où le fichier d'authentification a été enregistré dans la section Obtenir le fichier d'authentification pour l'ingestion Google SecOps.

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 bindplane-agent

  • Pour redémarrer l'agent Bindplane sous Windows, vous pouvez utiliser la console Services ou saisir la commande suivante :

    net stop BindPlaneAgent && net start BindPlaneAgent

Configurer Syslog pour le routeur Yamaha

  1. Connectez-vous au routeur à l'aide de SSH ou de CLI;interface de ligne de commande.

  2. Définissez l'hôte Syslog sur l'adresse IP de l'agent Bindplane :

    • Le port par défaut est 514/UDP.
    • Remplacez <BINDPLANE_IP> par l'adresse IP réelle de l'agent Bindplane.
    syslog host <BINDPLANE_IP>

  3. Facultatif : Définissez le niveau et la fonctionnalité Syslog :

    syslog facility local0
syslog info

  4. Enregistrez la configuration pour que les modifications soient conservées après le redémarrage :

    save

Activer la sortie Syslog pour les modules requis

  1. Activez la journalisation pour des fonctionnalités spécifiques :

    • Journalisation du pare-feu (filtre d'adresses IP) :

      ip filter log on

    • Journalisation NAT :

      • Où 1000 est le numéro du descripteur NAT que vous utilisez (ajustez-le si nécessaire).
      nat descriptor log on 1000

    • Journalisation de la connexion PPPoE / WAN :

      pppoe use log on

    • Si vous utilisez le réseau étendu DHCP (au lieu de PPPoE), enregistrez les événements DHCP :

      dhcp service log on

    • Pour la journalisation VPN IPsec :

      ipsec log on

    • Pour L2TP et PPTP :

      l2tp log on
pptp log on

    • Enregistrer les événements d'activation/désactivation de l'interface :

      log state on

    • Vous pouvez également activer la journalisation pour le ping keepalive si vous utilisez la surveillance des liens :

      ping keepalive log on

    • Activez la journalisation pour l'accès administratif (SSH ou Telnet, par exemple) :

      console notice
ssh notice
telnet notice

    • Enregistrez les attributions DHCP :

      dhcp service log on

    • Journalisation DNS (si vous utilisez le système de transfert DNS intégré) :

      dns service log on

    • Journalisation du transfert d'e-mails (si vous utilisez des alertes par e-mail) :

      smtp service log on

    • Journalisation du DNS dynamique :

      ddns service log on

    • Événements NTP :

      ntpdate log on

    • Journalisation de l'authentification :

      auth log on

    • Journalisation du rayon :

      ppp use radius log on

  2. Enregistrez la configuration pour que les modifications soient conservées après le redémarrage :

    save

Table de mappage UDM

Champ de journal Mappage UDM Logique
data metadata.description La description est extraite du champ data du journal brut à l'aide de modèles Grok. Différents modèles sont utilisés en fonction du format du message de journal. Exemples : "initiate ISAKMP phase", "Connection closed", "succeeded for SSH".
data metadata.event_timestamp L'horodatage est extrait du champ data du journal brut à l'aide de modèles Grok, puis converti en objet d'horodatage à l'aide du filtre date. Les formats MMM dd HH:mm:ss et MMM d HH:mm:ss sont acceptés.
data principal.asset.hostname Le nom d'hôte est extrait du champ data du journal brut à l'aide de modèles Grok.
data principal.asset.ip L'adresse IP du principal est extraite du champ data du journal brut à l'aide de modèles Grok. Il est mappé à principal.asset.ip et principal.ip.
data principal.hostname Le nom d'hôte est extrait du champ data du journal brut à l'aide de modèles Grok.
data principal.ip L'adresse IP du principal est extraite du champ data du journal brut à l'aide de modèles Grok. Il est mappé à principal.asset.ip et principal.ip.
data principal.user.userid L'ID utilisateur est extrait du champ data du journal brut à l'aide de modèles Grok.
data target.asset.ip L'adresse IP cible est extraite du champ data du journal brut à l'aide de modèles Grok.
data target.ip L'adresse IP cible est extraite du champ data du journal brut à l'aide de modèles Grok. Le type d'événement est déterminé par la logique de l'analyseur en fonction de la présence de certains champs. Si principal et target sont tous deux présents, le type d'événement est NETWORK_CONNECTION. Si user est présent, le type d'événement est USER_UNCATEGORIZED. Si seul principal est présent, le type d'événement est STATUS_UPDATE. Sinon, la valeur par défaut est GENERIC_EVENT. Codé en dur sur "YAMAHA_ROUTER". Codé en dur sur "YAMAHA_ROUTER". Codé en dur sur "YAMAHA_ROUTER".
log_type metadata.log_type Copié directement à partir du champ log_type du journal brut.
timestamp timestamp Il s'agit du temps d'ingestion du journal, qui est ajouté automatiquement par la plate-forme Chronicle. Elle n'est pas analysée à partir du journal brut.

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.