Raccogli i log di Snort IDS

Supportato in:

Questo documento spiega come importare i log Snort IDS in Google Security Operations utilizzando l'agente Bindplane.

Snort è un sistema di rilevamento e prevenzione delle intrusioni open source che genera messaggi syslog per avvisi di intrusioni di rete, eventi di analisi dei protocolli e anomalie del traffico. Il parser estrae i campi dai log formattati in syslog e JSON utilizzando i pattern grok e li mappa al modello Unified Data Model (UDM).

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Windows Server 2016 o versioni successive o host Linux con systemd
  • Connettività di rete tra l'agente Bindplane e il dispositivo Snort
  • Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
  • Accesso al terminale al dispositivo Snort

Recuperare il file di autenticazione dell'importazione 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.
  4. 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 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 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 aggiuntive per l'installazione

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

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

Individua il file di configurazione

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows:

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

Modifica 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/snort_ids:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: SNORT_IDS
            raw_log_field: body
    
    service:
        pipelines:
            logs/snort_ids_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/snort_ids
    

Parametri di configurazione

Sostituisci i seguenti segnaposto:

  • Configurazione del destinatario:

    • listen_address: Indirizzo IP e porta da ascoltare:
      • 0.0.0.0 per ascoltare su tutte le interfacce (consigliato)
      • La porta 514 è la porta syslog standard (richiede l'accesso root su Linux; utilizza 1514 per l'accesso 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.

Salva il file di configurazione

  • Dopo la modifica, salva il file:
    • Linux: premi Ctrl+O, poi Enter e infine Ctrl+X.
    • Windows: fai clic su File > Salva.

Riavvia 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 individuare eventuali 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 dei 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 individuare eventuali errori:

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

Configura l'esportazione di syslog su Snort v2.x

  1. Accedi al dispositivo Snort utilizzando il terminale.
  2. Modifica il seguente file: /etc/snort/snort.conf.
  3. Vai a 6) Configure output plugins.
  4. Aggiungi la seguente voce:

    # syslog output
    alert_syslog: host=<BINDPLANE_IP>:<PORT_NUMBER>, LOG_AUTH LOG_ALERT
    
    • Sostituisci <BINDPLANE_IP> con l'indirizzo IP dell'agente Bindplane e <PORT_NUMBER> con il numero di porta.
  5. Salva il file.

  6. Avvia il servizio snort.

  7. Arresta il servizio rsyslog.

  8. Modifica il seguente file: /etc/rsyslogd.conf:

    # remote host is: name/ip:port
    *.* @@<BINDPLANE_IP>:<PORT_NUMBER>
    
    • Sostituisci <BINDPLANE_IP> con l'indirizzo IP dell'agente Bindplane e <PORT_NUMBER> con il numero di porta.
  9. Avvia il servizio rsyslog.

Configura l'esportazione di syslog su Snort v3.1.53

  1. Accedi al dispositivo Snort utilizzando il terminale.
  2. Arresta i servizi rsyslog e snort.
  3. Vai alla directory di installazione di Snort: /usr/local/etc/snort/.
  4. Modifica il file di configurazione di Snort: snort.lua.
  5. Nelle opzioni Configura output, aggiungi il seguente codice:

    alert_syslog = {
        facility = 'local3',
        level = 'info',
    }
    
  6. Salva il file di configurazione di Snort.

  7. Vai alla directory dei file di configurazione predefinita del servizio rsyslog: /etc/rsyslog.d.

  8. Crea un nuovo file: 3-snort.conf.

  9. Per inviare i log tramite TCP o UDP, aggiungi la seguente configurazione:

    local3.* @@<BINDPLANE_IP>:<PORT_NUMBER>
    
    • Sostituisci <BINDPLANE_IP> con l'indirizzo IP dell'agente Bindplane e <PORT_NUMBER> con il numero di porta.
  10. Salva il file.

  11. Avvia rsyslog e poi il servizio snort.

Tabella di mappatura UDM

Campo log Mappatura UDM Logica
agent.hostname observer.hostname Valore estratto dal campo agent.hostname nel log non elaborato.
agent.id observer.asset_id Valore estratto dal campo agent.id nel log non elaborato e concatenato con agent.type nel seguente modo: agent.type:agent.id.
agent.type observer.application Valore estratto dal campo agent.type nel log non elaborato.
agent.version observer.platform_version Valore estratto dal campo agent.version nel log non elaborato.
alert.category security_result.category_details Valore estratto dal campo alert.category nel log non elaborato.
alert.rev security_result.rule_version Valore estratto dal campo alert.rev nel log non elaborato.
alert.rule security_result.summary Valore estratto dal campo alert.rule nel log non elaborato, con le virgolette doppie rimosse.
alert.severity security_result.severity Se alert.severity è maggiore o uguale a 4, imposta LOW. Se alert.severity è 2 o 3, imposta su MEDIUM. Se alert.severity è 1, impostalo su HIGH. In caso contrario, imposta il valore su UNKNOWN_SEVERITY.
alert.signature security_result.rule_name Valore estratto dal campo alert.signature nel log non elaborato.
alert.signature_id security_result.rule_id Valore estratto dal campo alert.signature_id nel log non elaborato.
app_proto network.application_protocol Se app_proto è dns, smb o http, converti in maiuscolo e utilizza questo valore. In caso contrario, imposta il valore su UNKNOWN_APPLICATION_PROTOCOL.
categoria security_result.category Se category è trojan-activity, impostalo su NETWORK_MALICIOUS. Se category è policy-violation, impostalo su POLICY_VIOLATION. In caso contrario, imposta il valore su UNKNOWN_CATEGORY.
classtype security_result.rule_type Valore estratto dal campo classtype nel log non elaborato, se non è vuoto o unknown.
community_id network.community_id Valore estratto dal campo community_id nel log non elaborato.
date_log Utilizzato per impostare il timestamp dell'evento se il campo time è vuoto.
decr metadata.description Valore estratto dal campo desc nel log non elaborato.
dest_ip target.ip Valore estratto dal campo dest_ip nel log non elaborato.
dest_port target.port Valore estratto dal campo dest_port nel log non elaborato e convertito in numero intero.
dstport target.port Valore estratto dal campo dstport nel log non elaborato e convertito in numero intero.
file.filename security_result.about.file.full_path Valore estratto dal campo file.filename nel log non elaborato, se non è vuoto o /.
file.size security_result.about.file.size Valore estratto dal campo file.size nel log non elaborato e convertito in numero intero senza segno.
host.name principal.hostname Valore estratto dal campo host.name nel log non elaborato.
nome host principal.hostname Valore estratto dal campo hostname nel log non elaborato.
inter_host intermediary.hostname Valore estratto dal campo inter_host nel log non elaborato.
log.file.path principal.process.file.full_path Valore estratto dal campo log.file.path nel log non elaborato.
metadata.version metadata.product_version Valore estratto dal campo metadata.version nel log non elaborato.
proto network.ip_protocol Valore estratto dal campo proto nel log non elaborato. Se è un numero, viene convertito nel nome del protocollo IP corrispondente utilizzando una tabella di ricerca.
rule_name security_result.rule_name Valore estratto dal campo rule_name nel log non elaborato.
signature_id security_result.rule_id Valore estratto dal campo signature_id nel log non elaborato.
signature_rev security_result.rule_version Valore estratto dal campo signature_rev nel log non elaborato.
src_ip principal.ip Valore estratto dal campo src_ip nel log non elaborato.
src_port principal.port Valore estratto dal campo src_port nel log non elaborato e convertito in numero intero.
srcport principal.port Valore estratto dal campo srcport nel log non elaborato e convertito in numero intero.
tempo Utilizzato per impostare il timestamp dell'evento.
metadata.event_type Sempre impostato su SCAN_NETWORK.
metadata.log_type Codificato in modo permanente su SNORT_IDS.
metadata.product_name Codificato in modo permanente su SNORT_IDS.
metadata.vendor_name Codificato in modo permanente su SNORT.
security_result.action Imposta su ALLOW se alert.action è allowed, altrimenti imposta su UNKNOWN_ACTION.

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.