Raccogli i log Trend Micro DDI

Supportata in:

Google SecOps SIEM

Questo documento spiega come importare i log di Trend Micro Deep Discovery Inspector (DDI) in Google Security Operations utilizzando l'agente Bindplane.

Trend Micro Deep Discovery Inspector è un'appliance di rete che monitora tutte le porte e i protocolli di rete per rilevare minacce avanzate. Genera messaggi syslog in formato CEF per i risultati dell'analisi di Virtual Analyzer, i rilevamenti dei prodotti integrati, gli eventi di pre-scansione ICAP, gli eventi di sistema e gli eventi di avviso. Il parser estrae i campi dai log formattati in CEF 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 l'appliance Trend Micro DDI
• Se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
• Accesso con privilegi a un'istanza di Trend Micro Deep Discovery Inspector

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

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

1. Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza di Google SecOps.
2. Vai a IAM e amministrazione > Service account.
3. Fai clic su Crea account di servizio.
4. Fornisci i seguenti dettagli di configurazione:
   • Nome account di servizio: 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) o 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 > Gestione dei dati > Agenti di raccolta. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > 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 > Amministrazione > Profilo. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Profilo.

3. Copia e salva l'ID cliente dalla sezione Dettagli 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 finestre

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 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/trendmicro_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: '<customer_id>'
      endpoint: chronicle.googleapis.com
      log_type: TRENDMICRO_DDI
      raw_log_field: body
  
  service:
    pipelines:
      logs/trendmicro_ddi_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/trendmicro_ddi
  

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 da IAM e amministrazione > Impostazioni.
  • endpoint: mantieni l'impostazione chronicle.googleapis.com.

Esportatore API di importazione precedente

• 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'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/trendmicro_ddi:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: TRENDMICRO_DDI
      raw_log_field: body
  

Nota: questo strumento di esportazione smetterà di funzionare quando l'API Ingestion non sarà più disponibile 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 syslog in Trend Micro Deep Discovery Inspector

1. Accedi alla UI web di Trend Micro Deep Discovery Inspector.
2. Vai ad Amministrazione > Prodotti/servizi integrati > Syslog.
3. Fai clic su Aggiungi per aggiungere un nuovo server Syslog.
4. Fornisci i seguenti dettagli di configurazione:
   • Attiva il profilo Syslog.
   • Nome profilo: inserisci un nome univoco e significativo.
   • Indirizzo server: inserisci l'indirizzo IP dell'agente Bindplane.
   • Porta: inserisci il numero di porta dell'agente Bindplane (ad esempio UDP: 514).
   • Protocollo: seleziona UDP (o un altro protocollo in base alla configurazione di Bindplane).
   • Facility: inserisci Local0.
   • Gravità: seleziona Informativa.
   • Formato: seleziona CEF.
   • Ambito dei log: seleziona Log di analisi di Virtual Analyzer, Log di rilevamento dei prodotti integrati, Log di pre-scansione ICAP, Log eventi di sistema e Log eventi di avviso.
5. Fai clic su Salva.

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
message	about	Mappatura: CEF: → about
deviceNtDomain	about.administrative_domain	Rinominato/mappato
deviceExternalId	about.asset.asset_id	Mappatura diretta
device_product	about.asset.asset_id	Mappatura diretta
device_vendor	about.asset.asset_id	Mappatura diretta
fileHash	about.file.full_path	Mappatura diretta
filePath	about.file.full_path	Rinominato/mappato
_hash	about.file.sha256	Rinominato/mappato
fileHash	about.file.sha256	Rinominato/mappato
fsize	about.file.size	Rinominato/mappato
dvchost	about.hostname	Rinominato/mappato
ips	about.ip	Unita
message	about.ip	Mappatura: CEF: → ips
dvc_mac	about.mac	Mappatura: slot → mac_address
dvcmac	about.mac	Unita
mac_address	about.mac	Unita
message	about.mac	Mappatura: CEF: → mac_address, CEF: → dvcmac
deviceTranslatedAddress	about.nat_ip	Unita
message	about.nat_ip	Mappatura: CEF: → deviceTranslatedAddress
Emne	about.process.command_line	Mappatura diretta
Path	about.process.command_line	Mappatura diretta
Subject	about.process.command_line	Mappatura diretta
deviceProcessName	about.process.command_line	Rinominato/mappato
dvcpid	about.process.pid	Rinominato/mappato
message	about.resource.attribute.permissions	Mappatura: CEF: → permissions
permissions	about.resource.attribute.permissions	Unita
additional_cfp1	additional.fields	Unita
additional_cfp2	additional.fields	Unita
additional_cfp3	additional.fields	Unita
additional_cfp4	additional.fields	Unita
additional_cn1	additional.fields	Unita
additional_cn2	additional.fields	Unita
additional_cn3	additional.fields	Unita
additional_cs1	additional.fields	Unita
additional_cs2	additional.fields	Unita
additional_cs3	additional.fields	Unita
additional_cs4	additional.fields	Unita
additional_cs5	additional.fields	Unita
additional_cs6	additional.fields	Unita
additional_cs7	additional.fields	Unita
additional_devicePayloadId	additional.fields	Unita
additional_eventId	additional.fields	Unita
additional_flexString1	additional.fields	Unita
additional_fname	additional.fields	Unita
appGroup_label	additional.fields	Unita
cn4_label	additional.fields	Unita
cn5_label	additional.fields	Unita
cnt_label	additional.fields	Unita
compressed_file_hash_label	additional.fields	Unita
cs10_label	additional.fields	Unita
cs2	additional.fields	Mappatura: arc_test → additional_cs2
cs5_label	additional.fields	Unita
cs8_label	additional.fields	Unita
cs9_label	additional.fields	Unita
device_mac_address_label	additional.fields	Unita
evt_cat_label	additional.fields	Unita
fileType_label	additional.fields	Unita
message	additional.fields	Valori mappati (33 in totale, ad es. CEF: → additional_eventId, CEF: → `additional_devicePayl…
pcomp_label	additional.fields	Unita
ptype_label	additional.fields	Unita
vlan_info	additional.fields	Unita
msg	metadata.description	Rinominato/mappato
Generated	metadata.event_timestamp	Analizzato come yyyy-MM-ddTHH:mm:ss
Received	metadata.event_timestamp	Analizzato come yyyy-MM-ddTHH:mm:ss
date_value	metadata.event_timestamp	Analizzato come MMM dd yyyy HH:mm:ss ZZ
rt	metadata.event_timestamp	Analizzato come yyyy-MM-ddTHH:mm:ssZ
event_name	metadata.event_type	Mappatura: "LogSpyware","LogPredictiveMachineLearning" → SCAN_UNCATEGORIZED
message	metadata.event_type	Valori mappati (5 in totale, ad es. CEF: → PROCESS_UNCATEGORIZED, CEF: → SCAN_UNCATEGORIZED…
principal_present	metadata.event_type	Mappatura: true → NETWORK_CONNECTION, true → STATUS_UPDATE
device_event_class_id	metadata.product_event_type	Mappatura diretta
event_name	metadata.product_event_type	Mappatura diretta
externalId	metadata.product_log_id	Mappatura diretta
device_product	metadata.product_name	Mappatura diretta
device_version	metadata.product_version	Mappatura diretta
device_vendor	metadata.vendor_name	Rinominato/mappato
app_protocol_output	network.application_protocol	Mappatura diretta
deviceDirection	network.direction	Mappatura: 0 → INBOUND, 1 → OUTBOUND
message	network.direction	Mappatura: CEF: → INBOUND, CEF: → OUTBOUND
message	network.dns.questions	Mappatura: CEF: → question
question	network.dns.questions	Unita
requestMethod	network.http.method	Rinominato/mappato
requestClientApplication	network.http.user_agent	Rinominato/mappato
ip_protocol_out	network.ip_protocol	Mappatura diretta
in	network.received_bytes	Rinominato/mappato
out	network.sent_bytes	Rinominato/mappato
sntdom	principal.administrative_domain	Rinominato/mappato
sourceServiceName	principal.application	Rinominato/mappato
Group_name	principal.group.group_display_name	Mappatura diretta
Gruppenavn	principal.group.group_display_name	Mappatura diretta
Device_name	principal.hostname	Mappatura diretta
Enhetsnavn	principal.hostname	Mappatura diretta
shost	principal.hostname	Rinominato/mappato
message	principal.ip	Mappatura: CEF: → principal_ip, CEF: → shost
principal_ip	principal.ip	Unita
shost	principal.ip	Unita
deviceMacAddress	principal.mac	Unita
mac	principal.mac	Unita
message	principal.mac	Mappatura: CEF: → mac, CEF: → deviceMacAddress
message	principal.nat_ip	Mappatura: CEF: → sourceTranslatedAddress
sourceTranslatedAddress	principal.nat_ip	Unita
sourceTranslatedPort	principal.nat_port	Rinominato/mappato
spt	principal.port	Rinominato/mappato
sproc	principal.process.command_line	Rinominato/mappato
spid	principal.process.pid	Rinominato/mappato
message	principal.user.attribute.roles	Mappatura: CEF: → principal_role
principal_role	principal.user.attribute.roles	Unita
suser	principal.user.user_display_name	Mappatura diretta
suid	principal.user.userid	Rinominato/mappato
message	security_result	Mappatura: CEF: → security_result
_action	security_result.action	Unita
act	security_result.action	Mappatura: accept → _action, deny → _action
message	security_result.action	Mappatura: CEF: → _action
Action_Taken	security_result.action_details	Mappatura diretta
act	security_result.action_details	Mappatura diretta
cat	security_result.category_details	Unita
message	security_result.category_details	Mappatura: CEF: → cat
deviceRiskConfidenceLevel	security_result.confidence_score	Mappatura diretta
message	security_result.confidence_score	Mappatura: CEF: → float
Scan_Type	security_result.description	Mappatura diretta
Type	security_result.description	Mappatura diretta
msg_data_2	security_result.description	Mappatura diretta
infection_channel_label	security_result.detection_fields	Unita
message	security_result.detection_fields	Valori mappati (7 in totale, ad es. CEF: → operation_label, CEF: → operasjon_label, CEF: …
operasjon_label	security_result.detection_fields	Unita
operation_label	security_result.detection_fields	Unita
permission_label	security_result.detection_fields	Unita
spyware_Grayware_Type_label	security_result.detection_fields	Unita
threat_probability_label	security_result.detection_fields	Unita
tillatelse_label	security_result.detection_fields	Unita
ruleId	security_result.rule_id	Mappatura diretta
mwProfile	security_result.rule_name	Mappatura diretta
ruleName	security_result.rule_name	Mappatura diretta
hostSeverity	security_result.severity	Mapped: "0", "1", "2", "3" → LOW, "4", "5", "6" → MEDIUM, "7", "8" → HIGH, `"9",…
message	security_result.severity	Mappatura: CEF: → LOW, CEF: → MEDIUM, CEF: → HIGH, CEF: → CRITICAL
severity	security_result.severity	Mappato: "0", "1", "2", "3", "LOW" → LOW, `"4", "5", "6", "MEDIUM", "SUBSTANTIAL", "INFO"…
Result	security_result.summary	Mappatura diretta
appcategory	security_result.summary	Mappatura diretta
reason	security_result.summary	Rinominato/mappato
Spyware	security_result.threat_name	Mappatura diretta
Unknown_Threat	security_result.threat_name	Mappatura diretta
Virus_Malware_Name	security_result.threat_name	Mappatura diretta
malType	security_result.threat_name	Mappatura diretta
oldFilePath	src.file.full_path	Rinominato/mappato
oldFileSize	src.file.size	Rinominato/mappato
message	src.resource.attribute.permissions	Mappatura: CEF: → old_permissions
old_permissions	src.resource.attribute.permissions	Unita
dntdom	target.administrative_domain	Rinominato/mappato
destinationServiceName	target.application	Rinominato/mappato
temp_dhost	target.hostname	Mappatura diretta
IPv6_Address	target.ip	Unita
dst_ip	target.ip	Unita
ipv6	target.ip	Mappatura: - → IPv6_Address
message	target.ip	Mappatura: CEF: → dst_ip, CEF: → IPv6_Address
mac_address	target.mac	Unita
message	target.mac	Mappatura: CEF: → mac_address
destination_translated_address	target.nat_ip	Unita
message	target.nat_ip	Mappatura: CEF: → destination_translated_address
destinationTranslatedPort	target.nat_port	Rinominato/mappato
dpt	target.port	Rinominato/mappato
dproc	target.process.command_line	Rinominato/mappato
File_name	target.process.file.full_path	Mappatura diretta
Infected_Resource	target.process.file.full_path	Mappatura diretta
Object	target.process.file.full_path	Mappatura diretta
Objekt	target.process.file.full_path	Mappatura diretta
dpid	target.process.pid	Rinominato/mappato
message	target.resource.attribute.labels	Mappatura: CEF: → resource_Type_label
resource_Type_label	target.resource.attribute.labels	Unita
request	target.url	Mappatura diretta
message	target.user.attribute.roles	Mappatura: CEF: → target_role
target_role	target.user.attribute.roles	Unita
CustomerName	target.user.user_display_name	Mappatura diretta
temp_duser	target.user.user_display_name	Mappatura diretta
Bruker	target.user.userid	Mappatura diretta
User_value	target.user.userid	Mappatura diretta
temp_duid	target.user.userid	Mappatura diretta
N/D	metadata.event_type	Costante: PROCESS_UNCATEGORIZED
N/D	network.direction	Costante: INBOUND
N/D	security_result.severity	Costante: LOW
reason	event.idm.read_only_udm.network.dns.questions.name	Mappato dal log delle modifiche
deviceMacAddress	event.idm.read_only_udm.principal.mac	Mappato dal log delle modifiche
deviceRiskConfidenceLevel	event.idm.read_only_udm.security_result.confidence_score	Mappato dal log delle modifiche
ruleId	event.idm.read_only_udm.security_result.rule_id	Mappato dal log delle modifiche
ruleName	event.idm.read_only_udm.security_result.rule_name	Mappato dal log delle modifiche
hostSeverity	event.idm.read_only_udm.security_result.severity	Mappato dal log delle modifiche
malType	event.idm.read_only_udm.security_result.threat_name	Mappato dal log delle modifiche
vLANId	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
cnt	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
evtCat	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
deviceGUID	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
ptype	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
cs9	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
cs10	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
pComp	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
cn4	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
cn5	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
cs8	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
fileType	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
appGroup	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
compressedFileHash	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.