Raccogli i log di Symantec Web Isolation

Supportato in:

Questo documento spiega come importare i log di Symantec Web Isolation in Google Security Operations utilizzando l'agente Bindplane.

Symantec Web Isolation è una piattaforma di isolamento del browser che genera messaggi syslog per sessioni di navigazione web, eventi di accesso agli URL, attività di download di file, applicazione di norme ed eventi di gestione dei dispositivi. Il parser estrae i campi dai log in formato JSON e li mappa al modello Unified Data Model (UDM).

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 la piattaforma Symantec Web Isolation
  • 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 all'UI web di Symantec Web Isolation

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

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"
        

Configurare syslog nella piattaforma Symantec Web Isolation

  1. Accedi all'UI web di Symantec Web Isolation.
  2. Vai a Configurazione di sistema > Server di log esterno > Nuovo server di log esterno > Server Syslog.
  3. Fornisci i seguenti dettagli di configurazione:
    • Stato: seleziona la casella di controllo per attivare.
    • Host: inserisci l'indirizzo IP dell'agente Bindplane.
    • Porta: inserisci il numero di porta dell'agente Bindplane (ad esempio, 514 per UDP).
    • Protocollo: seleziona UDP.
    • Appname: inserisci un tag per identificare la piattaforma di isolamento web.
    • Facility: nome della facility syslog correlato ai log di isolamento web.
  4. Fai clic su Crea.
  5. Vai a Report > Inoltro log.
  6. Fai clic su Modifica.
  7. Fornisci i seguenti dettagli di configurazione:
    • Log attività: seleziona il server Bindplane appena aggiunto.
    • Log di controllo della gestione: seleziona il server Bindplane appena aggiunto.
    • Gateway Audit Logs: seleziona il server Bindplane appena aggiunto.
  8. Fai clic su Aggiorna.

Tabella di mappatura UDM

Campo log Mappatura UDM Logica
action security_result.summary Concatenato con action_reason per formare il riepilogo.
action_reason security_result.summary Concatenato con action per formare il riepilogo.
content_action security_result.action_details Mappatura diretta.
createdAt metadata.event_timestamp Convertito in timestamp utilizzando il formato UNIX_MS.
creationDate metadata.event_timestamp Convertito in timestamp utilizzando il formato UNIX_MS.
data.level security_result.severity Mappato su INFORMATIVO, BASSO o ALTO in base al valore.
data.properties.environment.str intermediary.location.name Mappatura diretta.
data.properties.hostname.str intermediary.hostname Mappatura diretta.
destination_ip target.ip Mappatura diretta.
destination_ip_country_name target.location.country_or_region Mappatura diretta.
device.current_risk_warnings security_result.category_details Mappatura diretta.
device.identifier target.asset.product_object_id Mappatura diretta.
device.model hardware.model Mappatura diretta.
device.os_version target.asset.platform_software.platform_version Mappatura diretta.
device.serial_number hardware.serial_number Mappatura diretta.
device.udid target.asset.asset_id Con il prefisso "UDID:" prima della mappatura.
device.user.email target.user.email_addresses Mappatura diretta.
device.user.id target.user.userid Mappatura diretta.
device.user.name target.user.user_display_name Mappatura diretta.
device.user.organization.id target.user.groupid Mappatura diretta.
device.user.organization.name target.user.group_identifiers Mappatura diretta.
event metadata.product_event_type Mappatura diretta.
event_type metadata.event_type Impostato su "GENERIC_EVENT" o "NETWORK_HTTP" in base ai dati dei log.
file_name target.file.names Mappatura diretta.
file_type about.labels, about.resource.attribute.labels Aggiunto come etichetta con la chiave "file_type".
id metadata.product_log_id Mappatura diretta.
isolation_session_id network.parent_session_id Mappatura diretta.
level security_result.severity Mappato su INFORMATIVO, BASSO o ALTO in base al valore.
original_source_ip principal.ip Mappatura diretta.
policy_version security_result.rule_version Mappatura diretta.
properties.environment intermediary.location.name Mappatura diretta.
properties.hostname intermediary.hostname Mappatura diretta.
referer_url network.http.referral_url Mappatura diretta.
request_method network.http.method Mappatura diretta.
resource_response_headers.x-nauthilus-traceid network.community_id Mappatura diretta.
response_status_code network.http.response_code Mappatura diretta.
rule_id security_result.rule_id Mappatura diretta.
rule_name_at_log_time security_result.rule_name Mappatura diretta.
rule_type security_result.rule_type Mappatura diretta.
service principal.application Mappatura diretta.
session_id network.session_id Mappatura diretta.
severity security_result.severity Mappato su BASSO, MEDIO o ALTO in base al valore.
source_ip principal.ip Mappatura diretta.
source_ip_country_name principal.location.country_or_region Mappatura diretta.
source_port principal.port Mappatura diretta.
sub_type security_result.summary Mappatura diretta.
target.asset.type target.asset.type Imposta su "MOBILE" se device.model contiene "ipad" o "iphone".
target.asset.platform_software.platform target.asset.platform_software.platform Imposta "MAC" se device.model contiene "ipad" o "iphone".
timestamp metadata.event_timestamp Analizzato utilizzando il formato yyyy-MM-dd HH:mm:ss.SSS Z.
total_bytes network.received_bytes Mappatura diretta se maggiore di 0.
traceId metadata.product_log_id Mappatura diretta.
type metadata.product_event_type Mappatura diretta.
url target.url Mappatura diretta.
url_host principal.hostname Mappatura diretta.
user_download_usage_bytes network.received_bytes Mappatura diretta.
user_total_usage_bytes about.labels, about.resource.attribute.labels Aggiunta come etichetta con la chiave "user_total_usage_bytes".
user_upload_usage_bytes network.sent_bytes Mappatura diretta.
username principal.user.user_display_name Mappatura diretta.
vendor_name metadata.vendor_name Impostato su "Broadcom Inc.".
product_name metadata.product_name Imposta "Symantec Web Isolation".
log_type metadata.log_type Imposta "SYMANTEC_WEB_ISOLATION".
sandbox about.labels, about.resource.attribute.labels Aggiunta come etichetta con la chiave "Sandbox" e il valore estratto dall'URL.
utub about.labels, about.resource.attribute.labels Aggiunta come etichetta con la chiave "user_total_usage_bytes".
userid target.user.userid Estratto dall'URL.

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.