Raccogliere i log di NetApp ONTAP
Questo documento spiega come importare i log NetApp ONTAP in Google Security Operations utilizzando l'agente Bindplane.
NetApp ONTAP è un sistema operativo di archiviazione che genera messaggi syslog per eventi di autenticazione, stato del sistema, attività di rete e operazioni correlate alla sicurezza. Il parser estrae i campi dai messaggi syslog utilizzando le espressioni regolari 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 oppure host Linux con
systemd - Connettività di rete tra l'agente Bindplane e il cluster NetApp ONTAP
- Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
- Accesso amministrativo al cluster NetApp ONTAP tramite SSH
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 l'agente 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/netapp_ontap: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: NETAPP_ONTAP raw_log_field: body service: pipelines: logs/netapp_ontap_to_chronicle: receivers: - udplog exporters: - chronicle/netapp_ontap
Parametri di configurazione
Sostituisci i seguenti segnaposto:
Configurazione del ricevitore:
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 endpoint regionale:- Stati Uniti:
malachiteingestion-pa.googleapis.com - Europa:
europe-malachiteingestion-pa.googleapis.com - Asia:
asia-southeast1-malachiteingestion-pa.googleapis.com - Per un elenco completo, vedi Endpoint regionali.
- Stati Uniti:
Salvare 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 una destinazione syslog in ONTAP
Accedi al cluster ONTAP utilizzando SSH:
ssh admin@<ontap-cluster-ip>- Sostituisci
<ontap-cluster-ip>con l'IP di gestione del cluster ONTAP.
- Sostituisci
Controlla i filtri eventi e le notifiche esistenti:
event filter show event notification showCrea una destinazione syslog. Sostituisci
<syslog-server-ip>e<syslog-server-port>con i dettagli di Bindplane:event notification destination create -name syslog-ems -syslog <syslog-server-ip> -syslog-port <syslog-server-port> -syslog-transport udp-unencryptedAltre opzioni per
-syslog-transport:udp-unencrypted(valore predefinito)tcp-unencryptedtcp-encrypted(per TLS)
Verifica la destinazione syslog:
event notification destination show
Configurare i filtri degli eventi esistenti
Collega i filtri predefiniti alla destinazione syslog:
event notification create -filter-name no-info-debug-events -destinations syslog-ems event notification create -filter-name default-trap-events -destinations syslog-ems
(Facoltativo) Crea e configura filtri personalizzati
Filtro eventi di autenticazione (accessi/disconnessioni):
event filter create -filter-name auth_events event filter rule add -filter-name auth_events -type include -message-name *login* -severity info event filter rule add -filter-name auth_events -type include -message-name *logout* -severity infoFiltro campi di rilevamento della sicurezza:
event filter create -filter-name security_fields event filter rule add -filter-name security_fields -type include -message-name *nmsdk_language* -severity infoApplica ogni filtro alla destinazione syslog:
event notification create -filter-name auth_events -destinations syslog-ems event notification create -filter-name security_fields -destinations syslog-emsVerifica delle notifiche:
event notification show
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
code |
Non mappato | |
description |
metadata.description |
Estratto dal messaggio di log utilizzando un pattern grok. Presente solo quando la descrizione è "Disconnessione" o "Accesso in corso". |
intermediary_host |
intermediary.hostname |
Estratto dal messaggio di log utilizzando un pattern grok. |
nmsdk_language |
security_result.detection_fields.value |
Estratto dal messaggio di log utilizzando un pattern grok. Questo valore viene aggiunto come "value" a un oggetto detection_fields con "key" = "nmsdk_language". |
nmsdk_platform |
security_result.detection_fields.value |
Estratto dal messaggio di log utilizzando un pattern grok. Questo valore viene aggiunto come "value" a un oggetto detection_fields con "key" = "nmsdk_platform". |
nmsdk_version |
security_result.detection_fields.value |
Estratto dal messaggio di log utilizzando un pattern grok. Questo valore viene aggiunto come "value" a un oggetto detection_fields con "key" = "nmsdk_version". |
netapp_version |
security_result.detection_fields.value |
Estratto dal messaggio di log utilizzando un pattern grok. Questo valore viene aggiunto come "value" a un oggetto detection_fields con "key" = "netapp_version". |
product_event_type |
metadata.product_event_type |
Estratto dal messaggio di log utilizzando un pattern grok. |
security_result.summary |
security_result.summary |
Estratto dal messaggio di log utilizzando un pattern grok. |
severity |
security_result.severity |
Imposta il valore su "INFORMATIONAL" se la gravità è "info" (senza distinzione tra maiuscole e minuscole). |
src_ip |
principal.ip |
Estratto dal messaggio di log utilizzando un pattern grok. |
src_port |
principal.port |
Estratto dal messaggio di log utilizzando un pattern grok. |
status |
security_result.summary |
Estratto dal messaggio di log utilizzando un pattern grok. |
ts |
metadata.event_timestamp.seconds |
Estratto dal messaggio di log utilizzando un pattern grok e convertito in un timestamp. |
url |
target.url |
Estratto dal messaggio di log utilizzando un pattern grok. |
user |
target.user.userid |
Estratto dal messaggio di log utilizzando un pattern grok. |
extensions.auth.type |
Imposta "AUTHTYPE_UNSPECIFIED" se la descrizione è "Disconnessione" o "Accesso". | |
metadata.event_type |
Imposta "USER_LOGIN" se la descrizione è "Accesso". | |
metadata.event_type |
Imposta "USER_LOGOUT" se la descrizione è "Disconnessione". | |
metadata.event_type |
Imposta il valore su "SCAN_UNCATEGORIZED" se la descrizione non è "Accesso" o "Disconnessione". | |
metadata.log_type |
Imposta il valore su "NETAPP_ONTAP". | |
metadata.product_name |
Imposta il valore su "NETAPP_ONTAP". | |
metadata.vendor_name |
Imposta il valore su "NETAPP_ONTAP". | |
target.platform |
Imposta "WINDOWS" se nmsdk_platform contiene "windows" (senza distinzione tra maiuscole e minuscole). | |
accessLocation |
event.idm.read_only_udm.principal.ip |
Mappato dal log delle modifiche |
accessLocation |
event.idm.read_only_udm.principal.asset.ip |
Mappato dal log delle modifiche |
deviceId |
event.idm.read_only_udm.principal.asset_id |
Mappato dal log delle modifiche |
deviceId |
event.idm.read_only_udm.principal.asset.asset_id |
Mappato dal log delle modifiche |
deviceName |
event.idm.read_only_udm.principal.hostname |
Mappato dal log delle modifiche |
deviceName |
event.idm.read_only_udm.principal.asset.hostname |
Mappato dal log delle modifiche |
domain |
event.idm.read_only_udm.principal.administarative_domain |
Mappato dal log delle modifiche |
entityName |
event.idm.read_only_udm.target.file.names |
Mappato dal log delle modifiche |
entityPath |
event.idm.read_only_udm.target.file.full_path |
Mappato dal log delle modifiche |
entityType |
event.idm.read_only_udm.target.resource.attribute.labels |
Mappato dal log delle modifiche |
extension |
event.idm.read_only_udm.target.resource.attribute.labels |
Mappato dal log delle modifiche |
entityAccessedTime |
event.idm.read_only_udm.metadata.event_timestamp |
Mappato dal log delle modifiche |
alertTimestamp |
event.idm.read_only_udm.metadata.event_timestamp |
Mappato dal log delle modifiche |
id |
event.idm.read_only_udm.metadata.product_log_id |
Mappato dal log delle modifiche |
userDisplayName |
event.idm.read_only_udm.principal.user.user_display_name |
Mappato dal log delle modifiche |
userId |
event.idm.read_only_udm.principal.user.userid |
Mappato dal log delle modifiche |
volumeId |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
volumeName |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
alertType |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
attributes.dataDestructionDetectedEntityCount |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
attributes.changePercentage |
event.idm.read_only_udm.additional.fields |
Mappato dal log delle modifiche |
severity |
security_result.severity_details |
Mappato dal log delle modifiche |
file_extn |
security_result.detection_fields |
Mappato dal log delle modifiche |
uid |
metadata.product_log_id |
Mappato dal log delle modifiche |
product_name |
principal.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.