Raccogli i log DDI di EfficientIP

Versione parser: 9.0

Supportata in:

Google SecOps SIEM

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

EfficientIP SOLIDserver è una soluzione DDI (DNS-DHCP-IPAM) completa che offre appliance virtuali e hardware altamente scalabili, sicure e robuste per servizi di rete critici, tra cui DNS, DHCP, gestione degli indirizzi IP, NTP e TFTP. La piattaforma fornisce gestione e automazione centralizzate per l'infrastruttura di rete con funzionalità avanzate di monitoraggio e sicurezza.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

• Un'istanza Google SecOps
• Windows Server 2016 o versioni successive oppure un host Linux con systemd
• Connettività di rete tra l'agente Bindplane e l'appliance EfficientIP SOLIDserver
• 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 alla console web EfficientIP SOLIDserver
• SOLIDserver versione 8.0 o successive (testato con le versioni 8.3.x e 8.4.x)

Recupera le credenziali 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 alla dismissione dell'API Ingestion il 20 luglio 2027.

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

1. Accedi alla Google Cloud console 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 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 di 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 norme 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.

Ottieni 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 è 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
   

   Lo stato del servizio deve essere 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
   

   Lo stato del servizio deve essere 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

1. Sostituisci l'intero contenuto di config.yaml con la seguente configurazione:

   receivers:
     udplog:
       listen_address: "0.0.0.0:514"
   
   exporters:
     chronicle/efficientip_ddi:
       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: 'YOUR_CUSTOMER_ID'
       endpoint: chronicle.googleapis.com
       log_type: EFFICIENTIP_DDI
       raw_log_field: body
       ingestion_labels:
         env: production
         source: solidserver
   
   service:
     pipelines:
       logs/efficientip_to_chronicle:
         receivers:
           - udplog
         exporters:
           - chronicle/efficientip_ddi
   

2. Sostituisci i seguenti segnaposto:

   • Configurazione del ricevitore:

     • listen_address: imposta su 0.0.0.0:514 per ascoltare su tutte le interfacce sulla porta UDP 514.
       • Per i deployment non root di Linux, utilizza la porta 1514 o una porta successiva.
       • Assicurati che la porta corrisponda alla configurazione in SOLIDserver.

   • 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: sostituisci YOUR_CUSTOMER_ID con l'ID cliente del passaggio precedente.

     • 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 chronicle.googleapis.com.

     • log_type: impostato su EFFICIENTIP_DDI (è richiesta la corrispondenza esatta).

     • ingestion_labels: etichette facoltative per classificare i log (personalizza in base alle esigenze).

Esportatore API di importazione legacy

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

  exporters:
    chronicle/efficientip_ddi:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: 'YOUR_CUSTOMER_ID'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: EFFICIENTIP_DDI
      raw_log_field: body
      ingestion_labels:
        env: production
        source: solidserver
  

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:

  1. Esegui questo comando:

     sudo systemctl restart observiq-otel-collector
     

  2. Verifica che il servizio sia in esecuzione:

     sudo systemctl status observiq-otel-collector
     

  3. Controlla i log per individuare eventuali errori:

     sudo journalctl -u observiq-otel-collector -f
     

• Per riavviare l'agente Bindplane in Windows:

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

  2. Verifica che il servizio sia in esecuzione:

     sc query observiq-otel-collector
     

  3. Controlla i log per verificare la presenza di errori:

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

Configura l'inoltro di syslog EfficientIP DDI

1. Accedi alla console web EfficientIP SOLIDserver.
2. Nel menu di navigazione a sinistra, fai clic su Amministrazione.
3. Nella sezione Monitoring, fai clic su Configurazione.
4. Nel menu, fai clic su + Aggiungi.
5. Nell'elenco Servizi, seleziona i seguenti servizi: named (per i log DNS)
6. Nel campo Server di destinazione, inserisci l'indirizzo IP e la porta dell'host dell'agente Bindplane nel formato <ip-address>:<port>.
   • Esempio: 192.168.1.100:514
   • Se utilizzi una porta non standard su Linux, specificala di conseguenza (ad esempio, 192.168.1.100:1514)

7. Fai clic su OK per salvare la configurazione.

   Nota: la pagina di configurazione verrà aggiornata e mostrerà la regola di forwarding di syslog appena aggiunta. SOLIDserver inizierà immediatamente a inoltrare i log DNS al server di destinazione specificato.

Verificare l'inoltro dei log

1. Controlla i log dell'agente Bindplane per verificare che i log vengano ricevuti:
   • Linux: sudo journalctl -u observiq-otel-collector -f
   • Windows: type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
2. Cerca voci di log contenenti eventi di query e risposta DNS da SOLIDserver.
3. Accedi alla console Google SecOps e verifica che i log EfficientIP DDI vengano visualizzati nella pagina Eventi.

Tipi di log supportati

Questa integrazione raccoglie i seguenti tipi di log da EfficientIP SOLIDserver:

• Log delle query DNS: query DNS client con tipo di query, nome di dominio e IP client
• Log delle risposte DNS: risposte DNS con record di risposta, TTL e codici di risposta
• Log DHCP: operazioni DHCP, tra cui DISCOVER, OFFER, REQUEST, ACK, NAK, RELEASE e INFORM
• Log di DNS Guardian: eventi di sicurezza, tra cui il rilevamento di comportamenti sospetti, l'attivazione/disattivazione di trigger
• Log di trasferimento di zona DNS: operazioni e notifiche di trasferimento di zona
• Log degli errori DNS: errori di formato, SERVFAIL, REFUSED e altri errori DNS

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
ip_version	additional.fields	Unito come etichetta con la chiave "ip_version" se non è vuoto
message_size	additional.fields	Unito come etichetta con chiave "message_size" se non vuoto
domain_name	additional.fields	Unito come etichetta con chiave "domain_name" se non vuoto
N/D	intermediario	Unito da un oggetto intermediario
descrizione	metadata.description	Valore copiato direttamente se non vuoto
msg2	metadata.description	Impostato su msg2 se event_type è GENERIC_EVENT e la descrizione è vuota
su_cmd	metadata.event_type	Imposta su "PROCESS_OPEN" se su_cmd è "sudo"
activity_type	metadata.event_type	Imposta su "NETWORK_DNS" se activity_type corrisponde a dns e has_dns_questions è true
messaggio	metadata.event_type	Imposta su "NETWORK_DHCP" se il messaggio corrisponde a DHCP
inner_message	metadata.event_type	Impostato su "NETWORK_UNCATEGORIZED" se inner_message corrisponde a pattern specifici e has_principal e has_target sono true
di diffusione	metadata.event_type	Imposta "NETWORK_DNS" se il processo è "named" e has_dns_questions è true; imposta "STATUS_UPDATE" se il processo è "named" e has_principal è true; imposta "GENERIC_EVENT" se il processo è "named"; imposta "NETWORK_DHCP" se il processo è "dhcpd"
PWD	metadata.event_type	Impostato su "PROCESS_OPEN" se PWD non è vuoto e has_target o has_principal è true
activity_type	metadata.product_event_type	Valore copiato direttamente
N/D	metadata.vendor_name	Imposta su "EFFICIENTIP_DDI"
N/D	metadata.product_name	Imposta "EFFICIENTIP_DDI DHCP"
activity_type	network.application_protocol	Impostato su "DNS" se activity_type corrisponde a dns e has_dns_questions è true
messaggio	network.application_protocol	Imposta su "DHCP" se il messaggio corrisponde a dhcp
di diffusione	network.application_protocol	Imposta "DNS" se il processo è "named"; imposta "DHCP" se il processo è "dhcpd"
src_mac	network.dhcp.chaddr	Valore copiato direttamente se il processo è "dhcpd"
src_ip	network.dhcp.ciaddr	Valore copiato direttamente se dhcp_info è "REQUEST"
giaddr	network.dhcp.giaddr	Valore copiato direttamente
dhcp_info	network.dhcp.opcode	Impostato su "BOOTREQUEST" se dhcp_info è "INFORM", "DISCOVER" o "REQUEST"; impostato su "BOOTREPLY" se dhcp_info è "OFFER" o "ACK"
siaddr	network.dhcp.siaddr	Valore copiato direttamente
transaction_id	network.dhcp.transaction_id	Valore convertito in uinteger se non è vuoto o "0"
dhcp_info	network.dhcp.type	Impostato su "INFORM" se dhcp_info è "INFORM"; impostato su "DISCOVER" se "DISCOVER"; impostato su "OFFER" se "OFFER"; impostato su "REQUEST" se "REQUEST"; impostato su "ACK" se "PACK"
yiaddr	network.dhcp.yiaddr	Valore copiato direttamente
src_ip	network.dhcp.yiaddr	Impostato su src_ip se il processo è "dhcpd" e yiaddr è vuoto
answer_rrs	network.dns.answers	Unito dall'oggetto della risposta per ogni rd in answer_rrs
N/D	network.dns.questions	Unito dall'oggetto domande se has_dns_questions è true
rcode	network.dns.response_code	Valore convertito in uinteger
response_code	network.dns.response_code	Valore mappato al codice numerico e convertito in uinteger
trasporto	network.ip_protocol	Valore in maiuscolo se corrisponde a udp o tcp
osservatore	observer.ip	Valore convertito in indirizzo IP
su_cmd	principal.application	Il valore viene copiato direttamente se su_cmd è "sudo"
di diffusione	principal.application	Impostato su process se il processo è "named" o "dhcpd"
host	principal.asset.hostname	Valore copiato direttamente se non vuoto
nome host	principal.asset.hostname	Valore copiato direttamente se non è vuoto e l'host è vuoto
src_ip	principal.asset.ip	Valore copiato direttamente
asset_id	principal.asset_id	Concatenato come "ID:" + asset_id
host	principal.hostname	Valore copiato direttamente se non è vuoto
nome host	principal.hostname	Valore copiato direttamente se non è vuoto e l'host è vuoto
domain_name	principal.hostname	Valore copiato direttamente se la descrizione contiene il nome host e l'host/il nome host sono vuoti
src_ip	principal.ip	Valore copiato direttamente se la conversione in ipaddress va a buon fine; estratto dalla descrizione se src_ip è vuoto
src_mac	principal.mac	Valore copiato direttamente
src_port	principal.port	Valore convertito in numero intero
process_id	principal.process.pid	Valore copiato direttamente
source_user	principal.user.userid	Valore copiato direttamente
N/D	security_result	Unito da sec_result
dst_ip	target.asset.ip	Valore copiato direttamente
file_path	target.file.full_path	Valore copiato direttamente
dst_ip	target.hostname	Valore copiato direttamente se non è un indirizzo IP valido
host	target.hostname	Valore copiato direttamente se inner_message corrisponde a pattern specifici
dst_ip	target.ip	Valore copiato direttamente
dst_port	target.port	Valore convertito in numero intero
target_cmd_line	target.process.command_line	Valore copiato direttamente
target_user	target.user.userid	Valore copiato direttamente
RR_msg	event.idm.read_only_udm.metadata.description	Mappato dal log delle modifiche
client_id	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
key_office	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
rrset_type	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
syslog_priority	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
updating_zone	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
view_office	event.idm.read_only_udm.additional.fields	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.