Raccogli i log di Varonis

Supportato in:

Google SecOps SIEM

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

Varonis è una piattaforma di sicurezza dei dati e analisi che genera messaggi syslog in formato CEF e LEEF per eventi di accesso ai file, modifiche alle autorizzazioni, attività di autenticazione e avvisi di sicurezza DatAlert. Il parser estrae i campi dai log formattati in CEF, LEEF e coppie chiave-valore e li mappa al modello UDM (Unified Data Model).

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 server Varonis
• Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane.
• Accesso privilegiato a Varonis

Ottieni le credenziali di Google SecOps per l'agente Bindplane

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

• Nuove implementazioni: 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 del 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 Editor Chronicle.
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 precedente (malachiteingestion-pa.googleapis.com), che Google ha programmato per la fine del ciclo di vita 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 dell'organizzazione.

   Nota: l'ID cliente è obbligatorio 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 il 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.

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 dell'agente di raccolta 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/varonis:
      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: VARONIS
      raw_log_field: body
  
  service:
    pipelines:
      logs/varonis_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/varonis
  

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 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 antepone chronicle.googleapis.com 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/varonis:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: VARONIS
      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 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"
       

Configura l'esportazione di syslog in Varonis

1. Accedi all'interfaccia utente web di Varonis.
2. Vai a Tools > DatAlert > Select DatAlert (Strumenti > DatAlert > Seleziona DatAlert).
3. Seleziona Configurazione.
4. Fornisci i seguenti dettagli di configurazione:
   • Indirizzo IP del messaggio Syslog: inserisci l'indirizzo IP dell'agente Bindplane.
   • Porta: inserisci il numero di porta dell'agente Bindplane (ad esempio, 514 per UDP).
   • Nome struttura: seleziona una struttura.
5. Fai clic su Applica.

Configurare il formato syslog in Varonis

1. Vai a Tools > DatAlert > Alert Templates.
2. Fai clic su Modifica modello di avviso e seleziona Modello predefinito del sistema esterno.
3. In Applica ai metodi di avviso, seleziona Messaggio Syslog dall'elenco.
4. Seleziona Regole > Metodo di avviso dal menu.
5. Seleziona Messaggio Syslog.
6. Fai clic su OK.

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
act	security_result.summary	Valore del campo act nel messaggio CEF.
cn1	security_result.rule_id	Valore del campo cn1 nel messaggio CEF.
cs1	network.email.to	Valore del campo cs1 nel messaggio CEF, in particolare il destinatario dell'email.
cs2	security_result.rule_name	Valore del campo cs2 nel messaggio CEF.
device_version	metadata.product_version	Valore del campo device_version nel messaggio CEF.
dhost	principal.hostname	Valore del campo dhost nel messaggio CEF, che rappresenta il nome host principale. Se file_server è presente e non è "DirectoryServices", sovrascrive questo valore.
duser	target.user.userid	Valore del campo duser nel messaggio CEF. Viene sottoposto alla trasformazione gsub per rimuovere le barre rovesciate e suddividerlo in target.user.userid e target.administrative_domain.
dvchost	target.hostname	Valore del campo dvchost nel messaggio CEF.
filePath	target.file.full_path	Valore del campo filePath nel messaggio CEF.
rt	metadata.event_timestamp	Valore del campo rt nel messaggio CEF, analizzato come timestamp.
severity	security_result.severity	Valore del campo severity nel messaggio CEF o LEEF. Vengono convertiti in lettere maiuscole. Mappato ai valori di gravità UDM (LOW, INFORMATIONAL, MEDIUM, HIGH, CRITICAL) in base al valore numerico o alla parola chiave.
Acting Object	target.user.user_display_name	Valore del campo Acting Object nei dati della coppia chiave-valore. Suddividi per "\" per estrarre il nome visualizzato.
Acting Object SAM Account Name	target.user.userid	Valore del campo Acting Object SAM Account Name nei dati della coppia chiave-valore.
Device hostname	target.hostname	Valore del campo Device hostname nei dati coppia chiave-valore.
Device IP address	target.ip	Valore del campo Device IP address nei dati coppia chiave-valore.
Event Time	metadata.event_timestamp	Valore del campo Event Time nei dati della coppia chiave-valore, analizzato come timestamp.
Event Type	target.application, metadata.event_type	Valore del campo Event Type nei dati della coppia chiave-valore. Utilizzato per ricavare metadata.event_type (FILE_OPEN, USER_CHANGE_PERMISSIONS, USER_CHANGE_PASSWORD, USER_UNCATEGORIZED).
File Server/Domain	principal.hostname	Valore del campo File Server/Domain nei dati della coppia chiave-valore. Se non è "DirectoryServices", sovrascrive principal.hostname derivato da dhost.
Path	target.file.full_path	Valore del campo Path nei dati della coppia chiave-valore.
Rule Description	metadata.description	Valore del campo Rule Description nei dati della coppia chiave-valore.
Rule ID	security_result.rule_id	Valore del campo Rule ID nei dati coppia chiave-valore.
Rule Name	security_result.rule_name	Valore del campo Rule Name nei dati della coppia chiave-valore.
intermediary_host	intermediary.hostname	Valore estratto da grok, che rappresenta il nome host intermedio.
log_type	metadata.log_type	Impostato come hardcoded su VARONIS.
metadata.event_type	metadata.event_type	Derivato in base ai valori di evt_typ, act e filepath. Il valore predefinito è STATUS_UPDATE se event_type è GENERIC_EVENT e principal_hostname è presente.
metadata.product_name	metadata.product_name	Impostato come hardcoded su VARONIS, ma può essere sovrascritto dal campo product_name del messaggio LEEF.
metadata.vendor_name	metadata.vendor_name	Codificato in modo permanente su VARONIS, ma può essere sovrascritto dal campo vendor del messaggio LEEF.
prin_host	principal.hostname	Valore estratto da grok, che rappresenta il nome host del principal.
product_name	metadata.product_name	Valore ottenuto dal messaggio LEEF.
security_result.action	security_result.action	Derivato dal campo result o Event Status. Imposta su "ALLOW" se il risultato è Success, altrimenti imposta su BLOCK.
timestamp	timestamp, metadata.event_timestamp	Il timestamp dell'evento viene derivato da vari campi (datetime1, event_time, start_datetime, datetime2) in base alla disponibilità. create_time del log non elaborato viene utilizzato come riserva e mappato sia a timestamp sia a metadata.event_timestamp se non sono disponibili altri campi di timestamp.
vendor	metadata.vendor_name	Valore del messaggio LEEF.
fname	event.idm.read_only_udm.target.file.names	Mappato dal log delle modifiche
msg	event.idm.read_only_udm.security_result.description	Mappato dal log delle modifiche
cs7	event.idm.read_only_udm.security_result.url_back_to_product	Mappato dal log delle modifiche
usrName	principal.user.userid	Mappato dal log delle modifiche
Event_Type	metadata.product_event_type	Mappato dal log delle modifiche
domain	prinicipal.administrative_domain	Mappato dal log delle modifiche
proto", "cat", "Event_Additional_Data", "Event_Status", "Email_Attachment_Name", "Email_Date", "Account_of_Changed_Permissions", "Permissions_Changes", "Permissions_before_Change", and "Permissions_after_Change	additional.fields	Mappato dal log delle modifiche
Affected_Object_Path	taregt.file.full_path	Mappato dal log delle modifiche
Affected_Object	security_result.detection_fields	Mappato dal log delle modifiche
src	principal.ip	Mappato dal log delle modifiche
Alert_ID	security_result.rule_id	Mappato dal log delle modifiche
Email_Recipients	network.email.to	Mappato dal log delle modifiche
Email_Item", "Mailbox_Access_by_Owner", "Threshold_Value", "Threshold_First_Timestamp", "Event_by_MailboxOwner", and "Email_Sender	additional.fields	Mappato dal log delle modifiche
Email_Sender	network.email.from	Mappato dal log delle modifiche
accountName	target.user.userid	Mappato dal log delle modifiche
Device_Name	taregt.hostname	Mappato dal log delle modifiche
Event_Type_ID	metadata.product_log_id	Mappato dal log delle modifiche
Event_File_Server_Domain	target.administrative_domain	Mappato dal log delle modifiche
Alert_Page_URL	taregt.url	Mappato dal log delle modifiche
devTime	metadata.event_timestamp	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.