Raccogliere i log VPN F5

Versione parser: 2.0

Supportato in:

Google SecOps SIEM

Questo documento spiega come importare i log della VPN F5 in Google Security Operations utilizzando l'agente Bindplane.

F5 BIG-IP Access Policy Manager (APM) è una soluzione di gestione degli accessi e VPN che genera messaggi syslog per l'autenticazione degli utenti, la gestione delle sessioni, la valutazione delle policy, la creazione di tunnel e gli eventi di accesso alla rete. Il parser estrae i campi dai log formattati in syslog 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 F5 BIG-IP
• 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 F5 BIG-IP tmsh (versione 11.x o successive)

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

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

Installa l'agente Bindplane

Installa l'agente Bindplane sul 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/f5_vpn:
      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: F5_VPN
      raw_log_field: body
  
  service:
    pipelines:
      logs/f5_vpn_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/f5_vpn
  

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 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 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'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/f5_vpn:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: F5_VPN
      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'inoltro di syslog su F5 BIG-IP APM

1. Connettiti alla riga di comando di F5 BIG-IP.

2. Apri la shell tmsh:

   tmsh
   

3. Configura un server syslog remoto eseguendo questo comando:

   modify sys syslog remote-servers add { <Name> { host <bindplane-ip> remote-port <bindplane-port> } }
   

   Sostituisci quanto segue:

   • <Name>: un nome univoco per questa destinazione syslog (ad esempio, bindplane_server).
   • <bindplane-ip>: l'indirizzo IP dell'host dell'agente Bindplane.
   • <bindplane-port>: la porta configurata nel ricevitore dell'agente Bindplane (valore predefinito: 514).

4. Salva la configurazione:

   save sys config partitions all
   

Tabella di mappatura UDM

Campo log	mappatura UDM	Logica
cmd_data	principal.process.command_line	Il valore viene estratto dal campo msg
errdefs_msgno	additional.fields.errdefs_msgno.string_value	Il valore viene estratto dal campo msg
event_time	metadata.event_timestamp	Il valore viene analizzato e convertito in un timestamp
hostname	principal.hostname,, observer.hostname,, principal.asset.hostname,, observer.asset.hostname,	Il valore viene estratto dal campo del messaggio e utilizzato per compilare i campi del nome host nell'UDM. Utilizzato anche per compilare il campo hostip
msg	security_result.description	Il valore viene estratto dal campo del messaggio e utilizzato per compilare il campo della descrizione nell'oggetto security_result
prin_ip	principal.ip,, principal.asset.ip	Il valore viene estratto dal campo del messaggio e utilizzato per compilare i campi dell'indirizzo IP nell'UDM
	additional.fields.Canonical_Info.string_value	Il valore è derivato dal messaggio di log
	additional.fields.IDP.string_value	Il valore è derivato dal messaggio di log
	additional.fields.Plugin_Support.string_value	Il valore è derivato dal messaggio di log
	additional.fields.SMB, Stage.string_value	Il valore è derivato dal messaggio di log
	additional.fields.SP.string_value	Il valore è derivato dal messaggio di log
	additional.fields.Timezone.string_value	Il valore è derivato dal messaggio di log
	additional.fields.Tunnel, Type.string_value	Il valore è derivato dal messaggio di log
	additional.fields.UI_Mode.string_value	Il valore è derivato dal messaggio di log
	additional.fields.Version.string_value	Il valore è derivato dal messaggio di log
	additional.fields.from_rule_item.string_value	Il valore è derivato dal messaggio di log
	additional.fields.policy_result.string_value	Il valore è derivato dal messaggio di log
	additional.fields.ppp_id.string_value	Il valore è derivato dal messaggio di log
	additional.fields.resource.string_value	Il valore è derivato dal messaggio di log
	additional.fields.rule.string_value	Il valore è derivato dal messaggio di log
	additional.fields.server_vip_ip.string_value	Il valore è derivato dal messaggio di log
	additional.fields.server_vip_name.string_value	Il valore è derivato dal messaggio di log
	additional.fields.to_rule_item.string_value	Il valore è derivato dal messaggio di log
	additional.fields.tunnel_resource.string_value	Il valore è derivato dal messaggio di log
	metadata.description	Il valore è derivato dal messaggio di log
	metadata.event_type	Il valore è hardcoded nel codice del parser per alcuni eventi e viene derivato dal messaggio di log per altri
	metadata.log_type	Il valore è impostato sul tipo di batch
	metadata.product_event_type	Il valore è derivato dal messaggio di log
	metadata.product_name	Il valore è impostato come hardcoded nel codice del parser
	metadata.vendor_name	Il valore è impostato come hardcoded nel codice dell'analizzatore sintattico
	network.application_protocol	Il valore è derivato dal messaggio di log
	network.direction	Il valore è derivato dal messaggio di log
	network.http.method	Il valore è derivato dal messaggio di log
	network.http.parsed_user_agent	Il valore è derivato dal campo network.http.user_agent
	network.http.referral_url	Il valore è derivato dal messaggio di log
	network.http.response_code	Il valore è derivato dal messaggio di log
	network.http.user_agent	Il valore è derivato dal messaggio di log
	network.ip_protocol	Il valore è derivato dal messaggio di log
	network.received_bytes	Il valore è derivato dal messaggio di log
	network.sent_bytes	Il valore è derivato dal messaggio di log
	network.session_id	Il valore è derivato dal messaggio di log
	network.tls.cipher	Il valore è derivato dal messaggio di log
	network.tls.version	Il valore è derivato dal messaggio di log
	observer.asset.hostname	Il valore è impostato sul campo del nome host
	observer.asset.ip	Il valore è impostato sul campo hostip
	observer.hostname	Il valore è impostato sul campo del nome host
	observer.ip	Il valore è impostato sul campo hostip
	principal.application	Il valore è derivato dal messaggio di log
	principal.asset.hostname	Il valore è impostato sul campo del nome host
	principal.asset.ip	Il valore è impostato sul campo hostip o sul campo prin_ip, se esistente
	principal.asset.product_object_id	Il valore è derivato dal messaggio di log
	principal.hostname	Il valore è impostato sul campo del nome host
	principal.ip	Il valore è impostato sul campo hostip o sul campo prin_ip, se esistente
	principal.location.country_or_region	Il valore è derivato dal messaggio di log
	principal.platform	Il valore è derivato dal messaggio di log
	principal.port	Il valore è derivato dal messaggio di log
	principal.process.command_line	Il valore è derivato dal messaggio di log
	principal.process.pid	Il valore è derivato dal messaggio di log
	principal.resource.name	Il valore è derivato dal messaggio di log
	principal.resource.type	Il valore è impostato come hardcoded nel codice del parser per alcuni eventi e viene derivato dal messaggio di log per altri
	principal.user.email_addresses	Il valore è derivato dal messaggio di log
	principal.user.userid	Il valore è derivato dal messaggio di log
	security_result.action	Il valore è derivato dal messaggio di log
	security_result.description	Il valore è derivato dal messaggio di log
	security_result.rule_name	Il valore è derivato dal messaggio di log
	security_result.severity	Il valore è derivato dal messaggio di log
	security_result.severity_details	Il valore è derivato dal messaggio di log
	security_result.summary	Il valore è derivato dal messaggio di log
	src.ip	Il valore è derivato dal messaggio di log
	src.location.country_or_region	Il valore è derivato dal messaggio di log
	src.port	Il valore è derivato dal messaggio di log
	target.asset.hostname	Il valore è derivato dal messaggio di log
	target.asset.ip	Il valore è derivato dal messaggio di log
	target.hostname	Il valore è derivato dal messaggio di log
	target.ip	Il valore è derivato dal messaggio di log
	target.port	Il valore è derivato dal messaggio di log
	target.process.command_line	Il valore è derivato dal messaggio di log
	target.process.pid	Il valore è derivato dal messaggio di log
	target.resource.id	Il valore è derivato dal messaggio di log
	target.url	Il valore è derivato dal messaggio di log
	target.user.userid	Il valore è derivato dal messaggio di log
Hostname	target.hostname	Mappato dal log delle modifiche
sess_id	network.session_id	Mappato dal log delle modifiche
internal_ip	target.ip	Mappato dal log delle modifiche
file_path	principal.resource.name	Mappato dal log delle modifiche
useragent	network.http.user_agent	Mappato dal log delle modifiche
User-Agent" and "useragent	network.http.parsed_user_agent	Mappato dal log delle modifiche
username	target.user.userid	Mappato dal log delle modifiche
sid	target.user.windows_sid	Mappato dal log delle modifiche
bytes_out	network.sent_bytes	Mappato dal log delle modifiche
bytes_in	network.received_bytes	Mappato dal log delle modifiche
Platform	principal.platform	Mappato dal log delle modifiche
Platform_Version	principal.platform_version	Mappato dal log delle modifiche
Javascript_Support", "ActiveX_Support", "Plugin_Support", "Version", "Model", "CPU", "UI_Mode", "SP", "IDP", "to_rule_item", "from_rule_item", "policy_result", "rule", "resource", "ppp_id", "tunnel_resource", "server_vip_ip", "server_vip_name", and "Canonical_Info	additional.fields	Mappato dal log delle modifiche
uri_path	target.url	Mappato dal log delle modifiche
User-Agent	network.http.user_agent	Mappato dal log delle modifiche
s_ip	src.ip	Mappato dal log delle modifiche
t_ip	target.ip	Mappato dal log delle modifiche
t_port	target.port	Mappato dal log delle modifiche
s_nat_ip	target.nat_ip	Mappato dal log delle modifiche
cipher_name	network.tls.cipher	Mappato dal log delle modifiche
tls_version	network.tls.version	Mappato dal log delle modifiche
resource_id	target.resource.id	Mappato dal log delle modifiche
src_ip	principal.ip	Mappato dal log delle modifiche
status	network.http.response_code	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.