Raccogliere i log di ZyXEL ZyWALL

Supportato in:

Questo documento spiega come acquisire i log di ZyXEL ZyWALL in Google Security Operations utilizzando l'agente Bindplane.

ZyXEL ZyWALL è un'appliance UTM/firewall che genera log di firewall, VPN, IDP, filtro dei contenuti ed eventi di sistema. Fornisce una gestione unificata delle minacce per gli ambienti di rete on-premise.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Windows Server 2016 o versioni successive oppure host Linux con systemd
  • Connettività di rete tra l'agente Bindplane e l'appliance ZyXEL ZyWALL
  • Se l'esecuzione avviene tramite un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
  • Accesso amministrativo all'appliance ZyXEL ZyWALL

Recuperare il file di autenticazione dell'acquisizione di Google SecOps

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

Recuperare l'ID cliente di Google SecOps

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

Installare 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
    
  3. Attendi il completamento dell'installazione.

  4. Verifica l'installazione eseguendo:

    sc query observiq-otel-collector
    

    Il servizio dovrebbe essere visualizzato come IN ESECUZIONE.

Installazione di Linux

  1. Apri un terminale con privilegi di 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
    
  3. Attendi il completamento dell'installazione.

  4. Verifica l'installazione eseguendo:

    sudo systemctl status observiq-otel-collector
    

    Il servizio dovrebbe essere visualizzato come attivo (in esecuzione).

Risorse di installazione aggiuntive

Per ulteriori opzioni di installazione e risoluzione dei problemi, consulta la guida all'installazione dell'agente Bindplane.

Configurare l'agente Bindplane per acquisire syslog e inviarli a Google SecOps

Individuare il file di configurazione

  • Linux:

    sudo nano /etc/bindplane-agent/config.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Modificare il file di configurazione

  • Sostituisci l'intero contenuto di config.yaml con la seguente configurazione:

    receivers:
        udplog:
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/zywall:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: ZYWALL
            raw_log_field: body
    
    service:
        pipelines:
            logs/zywall_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/zywall
    

Parametri di configurazione

Sostituisci i seguenti segnaposto:

  • Configurazione del ricevitore:

    • listen_address: indirizzo IP e porta su cui ascoltare:
      • 0.0.0.0 per ascoltare su tutte le interfacce (consigliato)
      • La porta 514 è la porta syslog standard (richiede la root su Linux; utilizza 1514 per non root)
  • Configurazione dell'esportatore:

    • creds_file_path: percorso completo del file di autenticazione dell'acquisizione:
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: ID cliente copiato dalla console Google SecOps
    • endpoint: URL dell'endpoint regionale:
      • Stati Uniti: malachiteingestion-pa.googleapis.com
      • Europa: europe-malachiteingestion-pa.googleapis.com
      • Asia: asia-southeast1-malachiteingestion-pa.googleapis.com
      • Per l'elenco completo, consulta Endpoint regionali

Salvare il file di configurazione

  • Dopo la modifica, salva il file:

    • Linux: premi Ctrl+O, poi Enter, poi Ctrl+X
    • Windows: fai clic su File > Salva

Riavviare l'agente Bindplane per applicare le modifiche

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

    sudo systemctl restart observiq-otel-collector
    
    1. Verifica che il servizio sia in esecuzione:

      sudo systemctl status observiq-otel-collector
      
    2. Controlla i log per verificare la presenza di errori:

      sudo journalctl -u observiq-otel-collector -f
      
  • Per riavviare l'agente Bindplane in Windows, scegli una delle seguenti opzioni:

    • Prompt dei comandi o PowerShell come amministratore:

        net stop observiq-otel-collector && net start observiq-otel-collector
      
    • Console Servizi:

      1. Premi Win+R, digita services.msc e premi Invio.
      2. Individua observIQ OpenTelemetry Collector.
      3. Fai clic con il tasto destro del mouse e seleziona Riavvia.
      4. Verifica che il servizio sia in esecuzione:

        sc query observiq-otel-collector
        
      5. Controlla i log per verificare la presenza di errori:

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

Configurare l'inoltro di syslog di ZyXEL ZyWALL

  1. Accedi all'interfaccia di gestione web ZyWALL accedendo all'indirizzo IP dell'appliance in un browser web.
  2. Vai a Configurazione > Log e report > Impostazioni log.
  3. Nella sezione Server remoto, seleziona un profilo disponibile (ad esempio, Server remoto 1 ) e fai clic su Modifica.
  4. Configura le seguenti impostazioni:
    • Seleziona Attivo per attivare il profilo syslog remoto.
    • Formato log: seleziona VRPT/Syslog.
    • Indirizzo server: inserisci l'indirizzo IP dell'host dell'agente Bindplane.
    • Porta server: inserisci 514.
    • Struttura log: seleziona Local0 o la struttura che preferisci.
  5. Nella sezione Log attivo, seleziona le categorie di log che vuoi inoltrare:
    • Sistema
    • Firewall
    • VPN
    • IDP (rilevamento e prevenzione delle intrusioni)
    • Filtro dei contenuti
    • Antivirus
    • Antispam
  6. Fai clic su OK per salvare la configurazione.
  7. Verifica che il server syslog riceva i log dall'appliance ZyWALL.

Tabella di mapping UDM

Campo log Mapping UDM Logica
devID, class, dir additional.fields Campi aggiuntivi non coperti dallo schema UDM standard
inter_host intermediary.hostname Nome host del dispositivo intermedio
msg metadata.description Descrizione dell'evento
metadata.event_type Tipo di evento
protoID network.ip_protocol Protocollo IP utilizzato nell'evento di rete
src_ip principal.asset.ip Indirizzo IP dell'asset associato al principale
src_ip principal.ip Indirizzo IP del principale
ob_mac principal.mac Indirizzo MAC del principale
src_port principal.port Numero di porta utilizzato dal principale
cat security_result.category_details Dettagli della categoria del risultato di sicurezza
rule_name security_result.rule_name Nome della regola che ha attivato il risultato di sicurezza
note security_result.summary Riepilogo del risultato di sicurezza
dst_ip target.asset.ip Indirizzo IP dell'asset associato alla destinazione
dst_ip target.ip Indirizzo IP della destinazione
dst_port target.port Numero di porta utilizzato dalla destinazione
metadata.product_name Nome del prodotto che ha generato l'evento
metadata.vendor_name Nome del fornitore del prodotto
action event.idm.read_only_udm.security_result.action Mappato dal log delle modifiche
app event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
cef_event_class_id event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
cef_spec_version event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
proto event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
cef_name event.idm.read_only_udm.metadata.product_event_type Mappato dal log delle modifiche
cef_device_version event.idm.read_only_udm.metadata.product_version Mappato dal log delle modifiche
ob event.idm.read_only_udm.network.sent_bytes Mappato dal log delle modifiche
user event.idm.read_only_udm.principal.user.userid Mappato dal log delle modifiche
cef_severity event.idm.read_only_udm.security_result.severity Mappato dal log delle modifiche
ZYlevel event.idm.read_only_udm.security_result.severity_details Mappato dal log delle modifiche
dvchost event.idm.read_only_udm.target.asset.hostname Mappato dal log delle modifiche
dvchost event.idm.read_only_udm.target.hostname Mappato dal log delle modifiche

Log delle modifiche

Visualizza il log delle modifiche per questo parser

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