Raccogli i log di Snort IDS
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
- Accedi alla console Google SecOps.
- Vai a Impostazioni SIEM > Agenti di raccolta.
- Scarica il file di autenticazione dell'acquisizione.
Salva il file in modo sicuro sul sistema in cui verrà installato Bindplane.
Recuperare l'ID cliente Google SecOps
- Accedi alla console Google SecOps.
- Vai a Impostazioni SIEM > Profilo.
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
- Apri Prompt dei comandi o PowerShell come amministratore.
Esegui questo comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietAttendi il completamento dell'installazione.
Verifica l'installazione eseguendo:
sc query observiq-otel-collectorIl servizio dovrebbe essere visualizzato come IN ESECUZIONE.
Installazione di Linux
- Apri un terminale con privilegi root o sudo.
Esegui questo comando:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shAttendi il completamento dell'installazione.
Verifica l'installazione eseguendo:
sudo systemctl status observiq-otel-collectorIl 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.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Modifica il file di configurazione
Sostituisci l'intero contenuto di
config.yamlcon 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.0per ascoltare su tutte le interfacce (consigliato)- La porta
514è la porta syslog standard (richiede l'accesso root su Linux; utilizza1514per 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
- Linux:
customer_id: ID cliente copiato dalla console Google SecOpsendpoint: 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.
- Stati Uniti:
Salva il file di configurazione
- Dopo la modifica, salva il file:
- Linux: premi
Ctrl+O, poiEntere infineCtrl+X. - Windows: fai clic su File > Salva.
- Linux: premi
Riavvia l'agente Bindplane per applicare le modifiche
Per riavviare l'agente Bindplane in Linux, esegui questo comando:
sudo systemctl restart observiq-otel-collectorVerifica che il servizio sia in esecuzione:
sudo systemctl status observiq-otel-collectorControlla 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-collectorConsole dei servizi:
- Premi
Win+R, digitaservices.msce premi Invio. - Individua observIQ OpenTelemetry Collector.
- Fai clic con il tasto destro del mouse e seleziona Riavvia.
Verifica che il servizio sia in esecuzione:
sc query observiq-otel-collectorControlla i log per individuare eventuali errori:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Premi
Configura l'esportazione di syslog su Snort v2.x
- Accedi al dispositivo Snort utilizzando il terminale.
- Modifica il seguente file:
/etc/snort/snort.conf. - Vai a
6) Configure output plugins. 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.
- Sostituisci
Salva il file.
Avvia il servizio snort.
Arresta il servizio rsyslog.
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.
- Sostituisci
Avvia il servizio rsyslog.
Configura l'esportazione di syslog su Snort v3.1.53
- Accedi al dispositivo Snort utilizzando il terminale.
- Arresta i servizi rsyslog e snort.
- Vai alla directory di installazione di Snort:
/usr/local/etc/snort/. - Modifica il file di configurazione di Snort:
snort.lua. Nelle opzioni Configura output, aggiungi il seguente codice:
alert_syslog = { facility = 'local3', level = 'info', }Salva il file di configurazione di Snort.
Vai alla directory dei file di configurazione predefinita del servizio rsyslog:
/etc/rsyslog.d.Crea un nuovo file:
3-snort.conf.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.
- Sostituisci
Salva il file.
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.