Raccogliere i log della VPN F5

Supportato in:

Questo documento spiega come importare i log VPN F5 in Google Security Operations utilizzando Bindplane. Il parser estrae informazioni rilevanti per la sicurezza dai log. Utilizza espressioni regolari per identificare e analizzare i campi chiave come timestamp, indirizzi IP e nomi host, quindi struttura questi dati nel formato del modello di dati unificato (UDM) di Google SecOps per l'analisi.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Windows 2016 o versioni successive oppure un host Linux con systemd
  • Se l'esecuzione avviene tramite un proxy, le porte del firewall sono aperte
  • Accesso con privilegi a F5 BIG-IP APM (Access Policy Manager)

Recuperare il file di autenticazione importazione di Google SecOps

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni SIEM > Agenti di raccolta.
  3. Scarica il file di autenticazione importazione. Salva il file in modo sicuro sul sistema in cui verrà installato Bindplane.

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.

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
    

Installazione di Linux

  1. Apri un terminale con privilegi di 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
    

Risorse aggiuntive per l'installazione

Configura l'agente Bindplane per importare Syslog e inviarli a Google SecOps

  1. Accedi al file di configurazione:
    • Individua il file config.yaml. In genere, si trova nella directory /etc/bindplane-agent/ su Linux o nella directory di installazione su Windows.
    • Apri il file utilizzando un editor di testo (ad esempio nano, vi o Blocco note).
  2. Modifica il file config.yaml come segue:

    receivers:
        udplog:
            # Replace the port and IP address as required
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/chronicle_w_labels:
            compression: gzip
            # Adjust the path to the credentials file you downloaded in Step 1
            creds_file_path: '/path/to/ingestion-authentication-file.json'
            # Replace with your actual customer ID from Step 2
            customer_id: <customer_id>
            endpoint: malachiteingestion-pa.googleapis.com
            # Add optional ingestion labels for better organization
            log_type: 'F5_VPN'
            raw_log_field: body
            ingestion_labels:
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    

Riavvia l'agente Bindplane per applicare le modifiche

  1. Per riavviare l'agente Bindplane in Linux, esegui questo comando:

    sudo systemctl restart bindplane-agent
    
  2. Per riavviare l'agente Bindplane in Windows, puoi utilizzare la console Servizi o inserire il seguente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configura Syslog per F5 BIG-IP APM v11.x e versioni successive

  1. Accedi a F5 BIG-IP APM utilizzando l'interfaccia a riga di comando o SSH.
  2. Inserisci il seguente comando per aggiungere il server syslog:

    tmsh syslog remote server {<Name> {host <bindplane-ip> remote-port <bindplane-port>}}
    

    Assicurati di sostituire i seguenti parametri:

    • <Name>: inserisci il nome dell'origine F5 BIG-IP APM (ad esempio BIGIP_APM).
    • <bindplane-ip>: inserisci l'indirizzo IP dell'agente Bindplane.
    • <bindplane-port>: inserisci il numero di porta dell'agente Bindplane.
  3. Inserisci il seguente comando per salvare le modifiche:

    tmsh save sys config partitions all
    

Tabella di mappatura UDM

Campo log Mappatura UDM Logic
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
nome host principal.hostname, observer.hostname, principal.asset.hostname, observer.asset.hostname, hostip 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 popolare 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 è codificato 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 è hardcoded nel codice del parser
metadata.vendor_name Il valore è hardcoded nel codice del parser
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 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 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 è codificato 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

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.