Raccogliere i log del bilanciatore del carico di rete A10

Versione parser: 7.0

Supportato in:

Questo documento spiega come importare i log del bilanciatore del carico di rete A10 in Google Security Operations utilizzando l'agente Bindplane.

A10 Networks fornisce controller di distribuzione delle applicazioni (ADC) e bilanciatori del carico che ottimizzano e proteggono il traffico delle applicazioni. La serie A10 Thunder supporta il bilanciamento del carico del server, l'offload SSL, la protezione DDoS e le funzionalità del web application firewall.

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 il bilanciatore del carico A10
  • Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
  • Accesso privilegiato alla CLI di A10 Load Balancer (credenziali amministratore)

Recuperare il file di autenticazione dell'importazione di Google SecOps

  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.

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

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

Individua il file di configurazione

  • Linux:

    sudo nano /etc/bindplane-agent/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/a10_lb:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: A10_LOAD_BALANCER
            raw_log_field: body
    
    service:
        pipelines:
            logs/a10_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/a10_lb
    

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 di autenticazione dell'acquisizione:
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: ID cliente copiato dalla console Google SecOps
    • endpoint: URL dell'endpoint regionale:
      • Stati Uniti: malachiteingestion-pa.googleapis.com
      • Europa: europe-malachiteingestion-pa.googleapis.com
      • Asia: asia-southeast1-malachiteingestion-pa.googleapis.com
      • Per l'elenco completo, consulta Endpoint regionali.

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 individuare eventuali 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 dei 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 individuare eventuali errori:

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

Configura l'inoltro di syslog sul bilanciatore del carico A10

  1. Stabilisci una connessione SSH al bilanciatore del carico A10 utilizzando un client SSH.
  2. Inserisci la modalità di configurazione eseguendo il seguente comando:

    config
    
  3. Configura il server syslog remoto eseguendo questo comando:

    logging host <BINDPLANE_IP> <PORT>
    
    • Sostituisci <BINDPLANE_IP> con l'indirizzo IP dell'host dell'agente Bindplane (ad esempio, 192.168.1.100).
    • Sostituisci <PORT> con la porta configurata nel ricevitore Bindplane (ad esempio, 514).
  4. Imposta il livello di gravità eseguendo questo comando:

    logging level information
    
  5. Assicurati che la registrazione syslog sia abilitata eseguendo questo comando:

    logging enable
    
  6. Salva la configurazione per assicurarti che rimanga invariata dopo un riavvio:

    write memory
    
  7. Esempio di configurazione completa della CLI:

    config
    logging host 192.168.1.100 514
    logging level information
    logging enable
    write memory
    

Tabella di mappatura UDM

Campo log mappatura UDM Logica
dns additional.fields.dns.value.string_value Il valore viene estratto dal campo dns dal pattern grok.
dns_server additional.fields.dns_server.value.string_value Il valore viene estratto dal campo dns_server dal pattern grok.
gslb additional.fields.gslb.value.string_value Il valore viene estratto dal campo gslb dal pattern grok.
host_name principal.hostnameprincipal.asset.hostname Il valore viene estratto dal campo host_name dal pattern grok.
httpmethod network.http.method Il valore viene estratto dal campo httpmethod dal pattern grok.
partion_id additional.fields.partion_id.value.string_value Il valore viene estratto dal campo partion_id dal pattern grok.
prin_ip principal.ipprincipal.asset.ip Il valore viene estratto dal campo prin_ip dal pattern grok.
prin_mac principal.mac Il valore viene estratto dal campo prin_mac dal pattern grok, con i punti rimossi e i due punti inseriti ogni due caratteri.
prin_port principal.port Il valore viene estratto dal campo prin_port dal pattern grok e convertito in un numero intero.
proto network.ip_protocol Il valore viene estratto dal campo proto dal pattern grok. Se il campo message contiene UDP, il valore viene impostato su UDP.
sessionid network.session_id Il valore viene estratto dal campo sessionid dal pattern grok.
status_code network.http.response_code Il valore viene estratto dal campo status_code dal pattern grok e convertito in un numero intero.
tar_ip target.iptarget.asset.ip Il valore viene estratto dal campo tar_ip dal pattern grok.
tar_mac target.mac Il valore viene estratto dal campo tar_mac dal pattern grok, con i punti rimossi e i due punti inseriti ogni due caratteri.
tar_port target.port Il valore viene estratto dal campo tar_port dal pattern grok e convertito in un numero intero.
time metadata.event_timestamp.seconds Il valore viene analizzato dal campo time estratto dal pattern grok, utilizzando più formati di data possibili.
url target.url Il valore viene estratto dal campo url dal pattern grok.
user principal.user.userid Il valore viene estratto dal campo user dal pattern grok.
N/D metadata.event_type Determinato dalla logica del parser in base alla presenza di informazioni sul soggetto e sul target:
-NETWORK_CONNECTION: se sono presenti sia le informazioni sul soggetto sia quelle sul target.
-STATUS_UPDATE: se sono presenti solo le informazioni sul soggetto.
-GENERIC_EVENT: altrimenti.
N/D metadata.log_type Codificato in modo permanente su A10_LOAD_BALANCER.
N/D network.application_protocol Imposta su HTTP se il campo proto è HTTP.
dhost event.idm.read_only_udm.target.hostname Mappato dal log delle modifiche
inter_host event.idm.read_only_udm.observer.hostname Mappato dal log delle modifiche
virtualserver event.idm.read_only_udm.intermediary.hostname Mappato dal log delle modifiche
Script_name event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
len event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
seq_id event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
desc event.idm.read_only_udm.metadata.description Mappato dal log delle modifiche
target_user event.idm.read_only_udm.target.user.userid Mappato dal log delle modifiche
rule_name event.idm.read_only_udm.security_result.rule_name Mappato dal log delle modifiche
vendor_severity event.idm.read_only_udm.security_result.severity Mappato dal log delle modifiche
facility event.idm.read_only_udm.additional.fields Mappato dal log delle modifiche
proxy_machine_ip event.idm.read_only_udm.intermediary.ip e event.idm.read_only_udm.intermediary.asset.ip Mappato dal log delle modifiche
event_dt event.idm.read_only_udm.metadata.event_timestamp Mappato dal log delle modifiche
prin_host principal.hostname Mappato dal log delle modifiche
app target.application Mappato dal log delle modifiche
device_version metadata.product_version Mappato dal log delle modifiche
device_vendor metadata.vendor_name Mappato dal log delle modifiche
device_product metadata.product_name Mappato dal log delle modifiche
event_name" and "device_event_class_id metadata.product_event_type Mappato dal log delle modifiche
severity security_result.severity Mappato dal log delle modifiche
src principal.ip Mappato dal log delle modifiche
spt principal.port Mappato dal log delle modifiche
dst target.ip Mappato dal log delle modifiche
dpt target.port Mappato dal log delle modifiche
msg metadata.description Mappato dal log delle modifiche
suser principal.user.user_display_name Mappato dal log delle modifiche
act" and "cn1 additional.fields Mappato dal log delle modifiche
app_proto network.application_protocol Mappato dal log delle modifiche
tls_version network.tls.version 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.