Raccogliere i log di NetApp ONTAP

Supportato in:

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

  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 l'agente 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/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.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 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.

Salvare 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 una destinazione syslog in ONTAP

  1. Accedi al cluster ONTAP utilizzando SSH:

    ssh admin@<ontap-cluster-ip>
    
    • Sostituisci <ontap-cluster-ip> con l'IP di gestione del cluster ONTAP.
  2. Controlla i filtri eventi e le notifiche esistenti:

    event filter show
    event notification show
    
  3. Crea 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-unencrypted
    

    Altre opzioni per -syslog-transport:

    • udp-unencrypted (valore predefinito)
    • tcp-unencrypted
    • tcp-encrypted (per TLS)
  4. 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

  1. 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 info
    
  2. Filtro 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 info
    
  3. Applica ogni filtro alla destinazione syslog:

    event notification create -filter-name auth_events -destinations syslog-ems
    event notification create -filter-name security_fields -destinations syslog-ems
    
  4. Verifica 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.