Raccogli i log di BeyondTrust Remote Support

Versione parser: 33.0

Supportato in:

Google SecOps SIEM

Questo documento spiega come importare i log di BeyondTrust Remote Support (in precedenza Bomgar) in Google Security Operations utilizzando Bindplane.

BeyondTrust Remote Support è una soluzione di accesso remoto che genera messaggi syslog per l'attività della sessione, gli eventi dell'account, gli eventi di accesso e le modifiche alla configurazione. Il parser normalizza i campi 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 o host Linux con systemd
• Connettività di rete tra l'agente Bindplane e l'appliance di assistenza da remoto BeyondTrust
• 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 a BeyondTrust Remote Support

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 alla dismissione 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 Chronicle Editor.
7. Fai clic su Continua, quindi 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 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 è 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 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 /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:
    tcplog:
      listen_address: "0.0.0.0:514"
  
  exporters:
    chronicle/bomgar:
      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: BOMGAR
      raw_log_field: body
  
  service:
    pipelines:
      logs/bomgar_to_chronicle:
        receivers:
          - tcplog
        exporters:
          - chronicle/bomgar
  

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 dell'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/bomgar:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: BOMGAR
      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:

     ```bash
     sudo systemctl status observiq-otel-collector
     ```
     

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

     ```bash
     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 da BeyondTrust Remote Support

1. Accedi a BeyondTrust Remote Support.
2. Vai a Sicurezza > Amministrazione dell'appliance.
3. Vai alla sezione Syslog e imposta i seguenti valori:
   • Server Syslog remoto: inserisci il nome host o l'indirizzo IP del server host syslog (Bindplane). Puoi aggiungere fino a tre server syslog.
   • Formato messaggio: seleziona RFC 5424.
   • Porta: inserisci la porta del server host syslog (Bindplane).
4. Fai clic su Invia.

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	Mappata direttamente
device_product	about.asset.asset_id	Mappata direttamente
device_vendor	about.asset.asset_id	Mappata direttamente
fileHash	about.file.full_path	Mappata direttamente
filePath	about.file.full_path	Rinominato/mappato
_hash	about.file.sha256	Rinominate/mappate
fileHash	about.file.sha256	Rinominate/mappate
fsize	about.file.size	Rinominate/mappate
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	Mappata direttamente
Path	about.process.command_line	Mappata direttamente
Subject	about.process.command_line	Mappata direttamente
deviceProcessName	about.process.command_line	Rinominato/mappato
dvcpid	about.process.pid	Rinominate/mappate
message	about.resource.attribute.permissions	Mappato: 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
cs2	additional.fields	Mappato: arc_test → additional_cs2
cs5_label	additional.fields	Unita
message	additional.fields	Valori mappati (19 in totale, ad es. CEF → additional_eventId, CEF → `additional_devicePayloa…
_extensions	extensions	Rinominato/mappato
_intermediary	intermediary	Unita
message	intermediary	Mappatura: CEF → _intermediary
_metadata	metadata	Rinominate/mappate
meta_desc	metadata.description	Mappata direttamente
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
datetime	metadata.event_timestamp	Analizzato come RFC 3339
dtPostTime	metadata.event_timestamp	Analizzato come yyyy-dd-MM HH:mm:ss
rt	metadata.event_timestamp	Analizzato come yyyy-MM-ddTHH:mm:ssZ
when	metadata.event_timestamp	Analizzato come UNIX
_event_type	metadata.event_type	Mappata direttamente
event_name	metadata.event_type	Mappato: "LogSpyware","LogPredictiveMachineLearning" → SCAN_UNCATEGORIZED
message	metadata.event_type	Mappato: CEF → PROCESS_UNCATEGORIZED, CEF → SCAN_UNCATEGORIZED, CEF → `USER_RESOURC…
device_event_class_id	metadata.product_event_type	Mappata direttamente
eventName	metadata.product_event_type	Mappata direttamente
event_name	metadata.product_event_type	Mappata direttamente
sEventID	metadata.product_event_type	Mappata direttamente
externalId	metadata.product_log_id	Mappata direttamente
when	metadata.product_log_id	Mappata direttamente
device_product	metadata.product_name	Mappata direttamente
message	metadata.product_name	Mappatura: CEF → BeyondTrust Remote Support
device_version	metadata.product_version	Mappato direttamente
device_vendor	metadata.vendor_name	Rinominato/mappato
message	metadata.vendor_name	Mappatura: CEF → BeyondTrust Bomgar
app_protocol_output	network.application_protocol	Mappato direttamente
deviceDirection	network.direction	Mappatura: 0 → INBOUND, 1 → OUTBOUND
message	network.direction	Mappato: CEF → INBOUND, CEF → OUTBOUND
requestMethod	network.http.method	Rinominato/mappato
requestClientApplication	network.http.user_agent	Rinominato/mappato
ip_protocol_out	network.ip_protocol	Mappata direttamente
in	network.received_bytes	Rinominato/mappato
out	network.sent_bytes	Rinominate/mappate
_principal	principal	Rinominate/mappate
sntdom	principal.administrative_domain	Rinominate/mappate
sourceServiceName	principal.application	Rinominato/mappato
Group_name	principal.group.group_display_name	Mappata direttamente
Gruppenavn	principal.group.group_display_name	Mappata direttamente
Device_name	principal.hostname	Mappata direttamente
Enhetsnavn	principal.hostname	Mappata direttamente
shost	principal.hostname	Rinominate/mappate
message	principal.ip	Mappatura: CEF → principal_ip, CEF → shost
principal_ip	principal.ip	Unita
shost	principal.ip	Unita
mac	principal.mac	Unita
message	principal.mac	Mappatura: CEF → mac
message	principal.nat_ip	Mappatura: CEF → sourceTranslatedAddress
sourceTranslatedAddress	principal.nat_ip	Unita
sourceTranslatedPort	principal.nat_port	Rinominate/mappate
spt	principal.port	Rinominate/mappate
sproc	principal.process.command_line	Rinominate/mappate
spid	principal.process.pid	Rinominato/mappato
message	principal.user.attribute.roles	Mappato: CEF → principal_role
principal_role	principal.user.attribute.roles	Unita
suser	principal.user.user_display_name	Mappato direttamente
suid	principal.user.userid	Rinominato/mappato
_security_result	security_result	Unita
message	security_result	Mappatura: CEF → security_result, CEF → _security_result
_action	security_result.action	Unita
act	security_result.action	Mappatura: accept → _action, deny → _action
message	security_result.action	Mappato: CEF → _action
Action_Taken	security_result.action_details	Mappata direttamente
act	security_result.action_details	Mappato direttamente
cat	security_result.category_details	Unita
message	security_result.category_details	Mappatura: CEF → cat
Scan_Type	security_result.description	Mappato direttamente
Type	security_result.description	Mappata direttamente
msg_data_2	security_result.description	Mappato direttamente
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
mwProfile	security_result.rule_name	Mappato direttamente
message	security_result.severity	Mapped: CEF → LOW, CEF → MEDIUM, CEF → HIGH, CEF → CRITICAL
severity	security_result.severity	Mappatura: "0", "1", "2", "3", "LOW" → LOW, `"4", "5", "6", "MEDIUM", "SUBSTANTIAL", "INFO"…
Result	security_result.summary	Mappato direttamente
appcategory	security_result.summary	Mappata direttamente
reason	security_result.summary	Rinominato/mappato
Spyware	security_result.threat_name	Mappata direttamente
Unknown_Threat	security_result.threat_name	Mappata direttamente
Virus_Malware_Name	security_result.threat_name	Mappata direttamente
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
_target	target	Rinominate/mappate
dntdom	target.administrative_domain	Rinominate/mappate
destinationServiceName	target.application	Rinominato/mappato
temp_dhost	target.hostname	Mappata direttamente
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	Mappato: 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	Rinominate/mappate
dproc	target.process.command_line	Rinominato/mappato
File_name	target.process.file.full_path	Mappata direttamente
Infected_Resource	target.process.file.full_path	Mappata direttamente
Object	target.process.file.full_path	Mappata direttamente
Objekt	target.process.file.full_path	Mappata direttamente
dpid	target.process.pid	Rinominate/mappate
message	target.resource.attribute.labels	Mappato: CEF → resource_Type_label
resource_Type_label	target.resource.attribute.labels	Unita
request	target.url	Mappato direttamente
message	target.user.attribute.roles	Mappatura: CEF → target_role
target_role	target.user.attribute.roles	Unita
CustomerName	target.user.user_display_name	Mappata direttamente
temp_duser	target.user.user_display_name	Mappata direttamente
Bruker	target.user.userid	Mappata direttamente
User_value	target.user.userid	Mappata direttamente
temp_duid	target.user.userid	Mappata direttamente
N/D	metadata.event_type	Costante: PROCESS_UNCATEGORIZED
N/D	metadata.product_name	Costante: BeyondTrust Remote Support
N/D	metadata.vendor_name	Costante: BeyondTrust Bomgar
N/D	network.direction	Costante: INBOUND
N/D	security_result.severity	Costante: LOW
exc	event.idm.read_only_udm.principal.process.pid	Mappato dal log delle modifiche
loggerHost	event.idm.read_only_udm.principal.asset.hostname	Mappato dal log delle modifiche
loggerHost	event.idm.read_only_udm.intermediary.hostname e event.idm.read_only_udm.intermediary.asset.hostname	Mappato dal log delle modifiche
product	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
sequenceId	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
site_id	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
segment	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
total_segment	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
who	event.idm.read_only_udm.principal.user.userid	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.