Raccogli i log degli switch Dell

Versione parser: 11.0

Supportata in:

Google SecOps SIEM

Questo documento spiega come importare i log degli switch Dell in Google Security Operations utilizzando l'agente Bindplane.

Questo parser estrae i log degli switch Dell, normalizza i timestamp e utilizza i pattern grok per strutturare il messaggio di log in coppie chiave-valore. Successivamente, mappa questi campi estratti nel modello UDM (Unified Data Model), gestendo vari formati di log e arricchendo i dati con informazioni contestuali come i dettagli degli asset e la gravità della sicurezza.

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 lo switch Dell
• Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
• Una connessione attiva e le credenziali amministrative per uno switch Dell

Ottieni le credenziali di Google SecOps per l'agente Bindplane

Per autenticare l'agente Bindplane in Google SecOps, scegli uno dei seguenti metodi:

• Nuovi deployment: utilizza l'API Chronicle (opzione 1).
• Deployment legacy: continua a utilizzare il file di autenticazione dell'acquisizione (opzione 2) fino al ritiro dell'API Ingestion il 20 luglio 2027.

Opzione 1: crea un account di servizio per l'API Chronicle (consigliata)

1. Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza Google SecOps.
2. Vai a IAM e amministrazione > Service account.
3. Fai clic su Crea service account.
4. Fornisci i seguenti dettagli di configurazione:
   • Nome service account: inserisci un nome per l'account (ad esempio bindplane-ingest).
   • Descrizione service account: inserisci una descrizione (ad esempio Bindplane agent log ingestion).
5. Fai clic su Crea e continua.
6. Nella sezione Concedi a questo account di servizio l'accesso al progetto, fai clic su Seleziona un ruolo e seleziona Chronicle Editor.
7. Fai clic su Continua e poi su Fine.
8. Fai clic sul account di servizio che hai creato, quindi vai alla scheda Chiavi.
9. Fai clic su Aggiungi chiave > Crea nuova chiave.
10. Seleziona JSON e fai clic su Crea. Il file della chiave viene scaricato sul tuo computer.
11. Salva il file della chiave come ingestion-auth.json nella directory del raccoglitore Bindplane (/opt/observiq-otel-collector/ingestion-auth.json su Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json su Windows) oppure aggiorna creds_file_path in config.yaml in modo che corrisponda al percorso in cui lo salvi.
12. Vai a IAM e amministrazione > Impostazioni e copia il Numero progetto. Ti servirà per la configurazione dell'esportatore.

Nota: la chiave JSON è una credenziale. Limita l'accesso al file sull'host Bindplane e ruota la chiave in base alle policy della tua organizzazione.

Opzione 2: scarica il file di autenticazione dell'acquisizione (legacy)

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.

Nota: questo file autentica l'agente nell'API Ingestion legacy (malachiteingestion-pa.googleapis.com), il cui fine del ciclo di vita è previsto da Google per il 20 luglio 2027. Pianifica il passaggio all'Opzione 1 prima di questa data.

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 organizzazione.

   Nota: l'ID cliente è necessario per configurare l'esportatore dell'agente Bindplane.

Installa l'agente Bindplane

Installa l'agente Bindplane sul tuo 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 RUNNING.

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.

Nota: la configurazione dell'esportatore dell'API Chronicle richiede Bindplane Collector v1.106.0 o versioni successive. I comandi precedenti installano l'ultima release. Se stai aggiornando un'installazione esistente, esegui l'upgrade del raccoglitore prima di modificare la configurazione.

Configura l'agente Bindplane per importare il syslog e inviarlo 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/dell_switch:
      protocol: https
      # Region of your instance, for example us, europe, asia-southeast1
      location: <LOCATION>
      # Project number of the Google Cloud project linked to the instance
      project: '<PROJECT_NUMBER>'
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: chronicle.googleapis.com
      log_type: DELL_SWITCH
      raw_log_field: body
  
  service:
    pipelines:
      logs/dell_switch_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/dell_switch
  

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 l'accesso root su Linux; utilizza 1514 per l'accesso non root)

• Configurazione dell'esportatore:

  • creds_file_path: percorso completo del file della chiave JSON del account di servizio (opzione 1):
    • Linux: /opt/observiq-otel-collector/ingestion-auth.json
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • customer_id: ID cliente copiato dalla console Google SecOps
  • location: sostituisci <LOCATION> con la regione della tua istanza Google SecOps (ad esempio us, europe o asia-southeast1). L'esportatore aggiunge chronicle.googleapis.com come prefisso a questo valore. Per l'elenco completo, consulta Endpoint regionali.
  • project: sostituisci <PROJECT_NUMBER> con il numero di progetto in IAM e amministrazione > Impostazioni.
  • endpoint: mantieni l'impostazione su chronicle.googleapis.com.

Esportatore API di importazione legacy

• Se utilizzi il file di autenticazione dell'acquisizione dell'Opzione 2, sostituisci il blocco exporters con il seguente. Imposta creds_file_path sul percorso del file di autenticazione dell'importazione e, se la tua istanza si trova al di fuori degli Stati Uniti, sostituisci malachiteingestion-pa.googleapis.com con l'endpoint regionale (ad esempio, europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/dell_switch:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: DELL_SWITCH
      raw_log_field: body
  

Nota: questo esportatore smetterà di funzionare quando l'API Ingestion verrà ritirata il 20 luglio 2027.

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 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 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 verificare la presenza di errori:

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

Configurare l'esportazione di syslog da uno switch Dell

1. Connettiti allo switch Dell utilizzando SSH o la porta della console.
2. Accedi con le credenziali di amministratore.

3. Utilizza il seguente comando per specificare l'indirizzo IP o il nome host del server syslog (sostituisci <syslog-server-ip>, <udp|tcp> e <syslog-port-number> con i dettagli effettivi):

   logging host <syslog-server-ip> transport <udp|tcp> port <syslog-port-number>
   

4. (Facoltativo) Definisci il livello minimo di gravità per i messaggi da inviare al server syslog. Ad esempio, per registrare i messaggi informativi e di livello superiore:

   logging level informational
   

5. Salva la configurazione in esecuzione nella configurazione di avvio per assicurarti che le modifiche vengano mantenute anche dopo i riavvii:

   copy running-config startup-config
   

6. Salva la configurazione:

   write memory
   

Log di esempio di switch Dell supportati

• SYSLOG

  {
    "priority": 165,
    "version": 1,
    "timestamp": "2023-10-12T12:37:17.249566+00:00",
    "hostname": "switch-lon-01",
    "app_name": "dn_alm",
    "proc_id": "940",
    "message": "Node.1-Unit.1:PRI [event], Dell EMC (OS10) %ALM_AUTH_EVENT: Authentication event was raised MESSAGE=pam_unix(sshd:session): session opened for user service_account by (uid=0)"
  }
  

• JSON

  {
    "appname": "SNOOP",
    "facility": 23,
    "hostname": "access-switch-a1",
    "message": "snooping.c(2177) 70820228 %% DBG Report from intf Gi6/0/11 ignored -- no router ports on vlan 193",
    "priority": 191,
    "proc_id": "snoopTask"
  }
  

• Formato KV / eventi

  Events: 
    Eventid        = {38812} 
    Occurrencetime = {3 Sept 2024 00:06:06} 
    Eventseverity  = {Minor} 
    Jobid          = {30506} 
    Computer       = {backup-server-01} 
    Program        = {DatabaseAgent} 
    Description    = {Block Change Tracking is found DISABLED on Oracle DB [PROD_DB]. Incremental backups may run slow.}
  

• Audit SYSLOG

  {
      "priority": 110,
      "version": 1,
      "timestamp": "2023-12-12T00:58:26.893679+00:00",
      "hostname": "core-switch-palf",
      "app_name": ".clish",
      "proc_id": "29156",
      "message": "Node.1-Unit.1:PRI [audit], User sec_admin on /dev/pts/0 from 10.0.0.50 used cmd: 'terminal length 0' - completed"
  }
  

• Formato SNMP trap / TRAPMGR

  {
    "priority": 189,
    "version": 1,
    "timestamp": "2023-12-28T23:37:27.394Z",
    "hostname": "dist-switch-01",
    "app_name": "TRAPMGR",
    "proc_id": "trapTask",
    "extensions": {
      "origin_ip": "192.168.1.1",
      "software": "N3000_Series",
      "swVersion": "6.3.2.3"
    },
    "message": "traputil.c(721) 1056839 %% Gi1/0/5 is transitioned from the Learning state to the Forwarding state"
  }
  

Tabella di mappatura UDM

Campo log	mappatura UDM	Logica
acct	principal.user.userid	Utilizzato come userid se il campo user non è presente.
addr	principal.asset.ip, principal.ip	Analizzato come indirizzo IP e utilizzato per l'IP del principal e dell'asset se è un IP valido e diverso dal nome host.
application	principal.application	Mappato direttamente.
asset	principal.asset.attribute.labels.value	Mappato direttamente al valore dell'etichetta della risorsa, con la chiave impostata come hardcoded su "Asset Name". Se il campo asset è vuoto e il messaggio contiene "Dell", l'asset è impostato su "Dell".
auid	principal.resource.attribute.labels.value	Mappata direttamente a un'etichetta con chiave auid all'interno di principal.resource.attribute.labels.
datetime	metadata.event_timestamp	Analizzato da vari formati nel campo del messaggio e convertito in un timestamp.
dest_ip	target.asset.ip, target.ip	Mappato all'IP di destinazione e all'IP della risorsa di destinazione.
enterpriseId	principal.resource.attribute.labels.value	Mappato a un'etichetta con chiave enterpriseId all'interno di principal.resource.attribute.labels.
exe	sec_result.detection_fields.value	Mappato a un campo di rilevamento con la chiave exe.
File	target.file.full_path	Mappato direttamente.
grantors	principal.resource.attribute.labels.value	Mappato a un'etichetta con chiave grantors all'interno di principal.resource.attribute.labels.
host	principal.hostname, principal.asset.hostname, metadata.event_type	Utilizzato come nome host principale e nome host asset. Se è presente host, metadata.event_type è impostato su STATUS_UPDATE. Se il nome host è presente, ma l'host no, il nome host viene utilizzato come host.
hostname	principal.asset.ip, principal.ip, host	Se è un IP valido, utilizzato per l'IP principale e l'IP asset. Se host è vuoto, viene utilizzato come host.
ID	principal.resource.attribute.labels.value	Mappato a un'etichetta con chiave ID all'interno di principal.resource.attribute.labels.
ip	principal.asset.ip, principal.ip	Mappato all'IP del principal e all'IP dell'asset.
is_synced	sec_result.detection_fields.value	Mappato a un campo di rilevamento con la chiave is_synced.
local	target.asset.ip, target.ip, target.port	Analizzato per estrarre IP e porta locali, mappati a IP di destinazione, IP asset di destinazione e porta di destinazione.
local_ip	target.asset.ip, target.ip	Estratto dal campo local e mappato all'IP di destinazione e all'IP dell'asset di destinazione.
local_port	target.port	Estratto dal campo local e mappato alla porta di destinazione.
mac	principal.mac	Se è un indirizzo MAC valido, mappato all'indirizzo MAC principale.
msg	metadata.description	Utilizzato come descrizione dell'evento, se presente. Analizzato anche per campi aggiuntivi.
msg1	metadata.description	Utilizzato come descrizione dell'evento se msg2 non è presente.
msg2	sec_result.description, metadata.event_type, extensions.auth.type	Utilizzato come descrizione del risultato di sicurezza. Se contiene "opened for user", il tipo di evento è impostato su USER_LOGIN e il tipo di autenticazione su MACHINE. Se contiene "closed for user", il tipo di evento è impostato su USER_LOGOUT e il tipo di autenticazione su MACHINE.
op	metadata.product_event_type	Utilizzato come tipo di evento del prodotto, se presente.
pid	principal.process.pid	Mappato direttamente.
port	principal.port	Mappato direttamente.
prod_event_type	metadata.product_event_type	Utilizzato come tipo di evento del prodotto, se presente.
res	sec_result.summary	Mappato direttamente.
sec_description	sec_result.description, target.url, target.ip, target.asset.ip, sec_result.action_details	Analizzato per URL di destinazione, IP, dettagli dell'azione e utilizzato come descrizione del risultato di sicurezza.
Server_ID	target.resource.product_object_id	Mappato direttamente.
server	principal.asset.ip, principal.ip, principal.port	Analizzato per estrarre l'IP e la porta del server, mappato all'IP principale, all'IP dell'asset principale e alla porta principale.
server_ip	principal.asset.ip, principal.ip	Estratto dal campo server e mappato all'IP principale e all'IP dell'asset principale.
server_port	principal.port	Estratto dal campo server e mappato alla porta principale.
ses	network.session_id	Mappato direttamente.
severity	sec_result.severity, metadata.product_event_type	Utilizzato per determinare la gravità del risultato di sicurezza e il tipo di evento del prodotto in base a valori specifici.
software	principal.asset.software	Mappato direttamente.
softwareName	software.name	Mappato direttamente.
Status	sec_result.summary	Utilizzato come riepilogo dei risultati di sicurezza se res non è presente.
subj	principal.resource.attribute.labels.value	Mappata a un'etichetta con chiave subj all'interno di principal.resource.attribute.labels.
swVersion	software.version	Mappato direttamente.
target_host	target.hostname, target.asset.hostname	Mappato direttamente al nome host di destinazione e al nome host dell'asset di destinazione.
target_ip	target.asset.ip, target.ip	Mappato direttamente all'IP di destinazione e all'IP della risorsa di destinazione.
target_url	target.url	Mappato direttamente.
target_user_id	target.user.userid	Mappato direttamente.
terminal	principal.resource.attribute.labels.value	Mappato a un'etichetta con chiave terminal all'interno di principal.resource.attribute.labels.
tzknown	sec_result.detection_fields.value	Mappatura a un campo di rilevamento con chiave tzknown.
uid	principal.resource.attribute.labels.value	Mappato a un'etichetta con chiave uid all'interno di principal.resource.attribute.labels.
user	principal.user.userid, metadata.event_type	Utilizzato come ID utente principale. Se è presente user, metadata.event_type è impostato su USER_UNCATEGORIZED.
username	target.user.userid	Mappato direttamente all'ID utente di destinazione.
N/D	metadata.vendor_name	Codificato come "Dell".
N/D	metadata.product_name	Impostato come hardcoded su "Dell Switch".
N/D	extensions.auth.type	Imposta MACHINE per eventi di accesso/disconnessione specifici.
N/D	metadata.event_type	Determinato da una logica complessa basata su vari campi e condizioni, il valore predefinito è GENERIC_EVENT se non impostato diversamente. Può essere USER_LOGIN, USER_LOGOUT, USER_UNCATEGORIZED, NETWORK_CONNECTION, NETWORK_UNCATEGORIZED, STATUS_UPDATE o GENERIC_EVENT.
reason_code	event.idm.read_only_udm.security_result.detection_fields	Mappato dal log delle modifiche
Eventid	metadata.product_log_id	Mappato dal log delle modifiche
Eventseverity	security_result.severity	Mappato dal log delle modifiche
Computer	principal.hostname	Mappato dal log delle modifiche
Program	principal.application	Mappato dal log delle modifiche
Description	security_result.description	Mappato dal log delle modifiche
tzknown", "is_synced" and "exe	security_result.detection_fields	Mappato dal log delle modifiche
res	security_result.summary	Mappato dal log delle modifiche
status	security_result.summary	Mappato dal log delle modifiche
uid", "enterpriseId", "auid", "terminal", "subj", "grantors", and "ID	principal.resource.attribute.labels	Mappato dal log delle modifiche
sec_description	security_result.description	Mappato dal log delle modifiche
action_details	security_result.action_details	Mappato dal log delle modifiche
softwareName	principal.asset.software.name	Mappato dal log delle modifiche
swVersion	principal.asset.software.version	Mappato dal log delle modifiche
port	principal_port	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.