Raccogliere i log del router Yamaha

Supportato in:

Questo documento spiega come importare i log del router Yamaha in Google Security Operations utilizzando Bindplane. Il parser utilizza i pattern grok per estrarre dai messaggi syslog campi come timestamp, nome host, utente, descrizione, indirizzi IP di origine e di destinazione. Quindi, mappa questi campi estratti nell'UDM, classificando il tipo di evento in base alla presenza di informazioni su principal, target e utente.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Istanza Google SecOps
  • Windows 2016 o versioni successive o un host Linux con systemd
  • Se l'esecuzione avviene tramite un proxy, assicurati che le porte del firewall siano aperte.
  • Accesso con privilegi all'appliance router Yamaha

Recuperare il file di autenticazione importazione di Google SecOps

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni SIEM > Agenti di raccolta.
  3. Scarica il file di autenticazione importazione. Salva il file in modo sicuro sul sistema in cui verrà installato Bindplane.

Recuperare l'ID cliente Google SecOps

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni SIEM > Profilo.
  3. Copia e salva l'ID cliente dalla sezione Dettagli dell'organizzazione.

Installa l'agente Bindplane

Installa l'agente Bindplane sul sistema operativo Windows o Linux seguendo le istruzioni riportate di seguito.

Installazione di Windows

  1. Apri il prompt dei comandi o PowerShell come amministratore.

  2. Esegui questo comando:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet

Installazione di Linux

  1. Apri un terminale con privilegi root o sudo.

  2. Esegui questo comando:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh

Risorse aggiuntive per l'installazione

Per ulteriori opzioni di installazione, consulta la guida all'installazione.

Configura l'agente Bindplane per importare Syslog e inviarli a Google SecOps

  1. Accedi al file di configurazione:
    • Individua il file config.yaml. In genere, si trova nella directory /etc/bindplane-agent/ su Linux o nella directory di installazione su Windows.
    • Apri il file utilizzando un editor di testo (ad esempio nano, vi o Blocco note).

  2. Modifica il file config.yaml come segue:

    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

Riavvia l'agente Bindplane per applicare le modifiche

  • Per riavviare l'agente Bindplane in Linux, esegui questo comando:

    sudo systemctl restart bindplane-agent

  • Per riavviare l'agente Bindplane in Windows, puoi utilizzare la console Servizi o inserire il seguente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent

Configurare Syslog per il router Yamaha

  1. Connettiti al router utilizzando SSH o l'interfaccia a riga di comando.

  2. Imposta l'host syslog sull'IP dell'agente Bindplane:

    • La porta predefinita è 514/UDP.
    • Sostituisci <BINDPLANE_IP> con l'indirizzo IP effettivo dell'agente Bindplane.
    syslog host <BINDPLANE_IP>

  3. (Facoltativo) Imposta la struttura e il livello di Syslog:

    syslog facility local0
syslog info

  4. Salva la configurazione per assicurarti che le modifiche vengano mantenute dopo il riavvio:

    save

Abilita l'output Syslog per i moduli richiesti

  1. Abilitare il logging per funzionalità specifiche:

    • Logging del firewall (filtro IP):

      ip filter log on

    • Logging di NAT:

      • dove 1000 è il numero del descrittore NAT che stai utilizzando (modifica in base alle esigenze).
      nat descriptor log on 1000

    • Registrazione della connessione PPPoE / WAN:

      pppoe use log on

    • Se utilizzi DHCP WAN (anziché PPPoE), registra gli eventi DHCP:

      dhcp service log on

    • Per la registrazione della VPN IPsec:

      ipsec log on

    • Per L2TP e PPTP:

      l2tp log on
pptp log on

    • Registra gli eventi di attivazione/disattivazione dell'interfaccia:

      log state on

    • Se utilizzi il monitoraggio dei link, puoi anche attivare la registrazione per il ping keepalive:

      ping keepalive log on

    • Attiva la registrazione per l'accesso amministrativo (ad esempio SSH o Telnet):

      console notice
ssh notice
telnet notice

    • Registra assegnazioni DHCP:

      dhcp service log on

    • Registrazione DNS (se utilizzi l'agente di inoltro DNS integrato):

      dns service log on

    • Registrazione del trasferimento della posta (se utilizzi gli avvisi via email):

      smtp service log on

    • Registrazione DNS dinamico:

      ddns service log on

    • Eventi NTP:

      ntpdate log on

    • Registrazione dell'autenticazione:

      auth log on

    • Registrazione dei log del raggio:

      ppp use radius log on

  2. Salva la configurazione per assicurarti che le modifiche vengano mantenute dopo il riavvio:

    save

Tabella di mappatura UDM

Campo log Mappatura UDM Logic
data metadata.description La descrizione viene estratta dal campo data del log non elaborato utilizzando i pattern grok. Vengono utilizzati pattern diversi a seconda del formato del messaggio di log. Esempi: "initiate ISAKMP phase", "Connection closed", "succeeded for SSH".
data metadata.event_timestamp Il timestamp viene estratto dal campo data del log non elaborato utilizzando i pattern grok e poi convertito in un oggetto timestamp utilizzando il filtro date. Sono supportati i formati MMM dd HH:mm:ss e MMM d HH:mm:ss.
data principal.asset.hostname Il nome host viene estratto dal campo data del log non elaborato utilizzando i pattern grok.
data principal.asset.ip L'indirizzo IP principale viene estratto dal campo data del log non elaborato utilizzando i pattern grok. È mappato sia a principal.asset.ip sia a principal.ip.
data principal.hostname Il nome host viene estratto dal campo data del log non elaborato utilizzando i pattern grok.
data principal.ip L'indirizzo IP principale viene estratto dal campo data del log non elaborato utilizzando i pattern grok. È mappato sia a principal.asset.ip sia a principal.ip.
data principal.user.userid L'ID utente viene estratto dal campo data del log non elaborato utilizzando i pattern grok.
data target.asset.ip L'indirizzo IP di destinazione viene estratto dal campo data del log non elaborato utilizzando i pattern grok.
data target.ip L'indirizzo IP di destinazione viene estratto dal campo data del log non elaborato utilizzando i pattern grok. Il tipo di evento è determinato dalla logica del parser in base alla presenza di determinati campi. Se sono presenti sia principal che target, il tipo di evento è NETWORK_CONNECTION. Se è presente user, il tipo di evento è USER_UNCATEGORIZED. Se è presente solo principal, il tipo di evento è STATUS_UPDATE. In caso contrario, il valore predefinito è GENERIC_EVENT. Codificato in modo permanente su "YAMAHA_ROUTER". Codificato in modo permanente su "YAMAHA_ROUTER". Codificato in modo permanente su "YAMAHA_ROUTER".
log_type metadata.log_type Copiato direttamente dal campo log_type del log non elaborato.
timestamp timestamp Questo è il tempo di importazione del log e viene aggiunto automaticamente dalla piattaforma Chronicle. Non viene analizzato dal log non elaborato.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.