Raccogli i log di Cisco Secure Web Appliance (precedentemente Web Security Appliance)

Versione parser: 7.0

Supportata in:

Google SecOps SIEM

Questo documento spiega come importare i log di Cisco Secure Web Appliance (precedentemente noto come Web Security Appliance) in Google Security Operations utilizzando Bindplane.

Cisco Secure Web Appliance è un proxy web on-premise e un gateway di sicurezza che protegge le organizzazioni dalle minacce basate sul web. Fornisce filtri URL, scansione malware, prevenzione della perdita di dati, visibilità e controllo delle applicazioni per tutto il traffico HTTP, HTTPS e FTP. L'appliance applica norme di utilizzo accettabile e ispeziona il traffico criptato per rilevare e bloccare le minacce avanzate.

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 Cisco Secure Web Appliance
• Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane.
• Accesso con privilegi all'interfaccia web di Cisco Secure Web Appliance

Ottieni le credenziali di Google SecOps per l'agente Bindplane

Per autenticare l'agente Bindplane in Google SecOps, scegli uno dei seguenti metodi:

• Nuovi deployment: 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 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 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) 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 di passare 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 finestre

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

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 del raccoglitore prima di modificare la configurazione.

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:
    tcplog:
      listen_address: "0.0.0.0:514"
  
  exporters:
    chronicle/cisco_wsa:
      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: CISCO_WSA
      raw_log_field: body
  
  service:
    pipelines:
      logs/cisco_wsa_to_chronicle:
        receivers:
          - tcplog
        exporters:
          - chronicle/cisco_wsa
  

Parametri di configurazione

Sostituisci i seguenti segnaposto:

• Configurazione del destinatario:

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

1. Esegui questo comando:

   sudo systemctl restart observiq-otel-collector
   

2. Verifica che il servizio sia in esecuzione:

   sudo systemctl status observiq-otel-collector
   

3. Controlla i log per individuare eventuali errori:

   sudo journalctl -u observiq-otel-collector -f
   

Per riavviare l'agente Bindplane in Windows:

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

2. Verifica che il servizio sia in esecuzione:

   sc query observiq-otel-collector
   

3. Controlla i log per individuare eventuali errori:

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

Configura l'inoltro di syslog su Cisco Secure Web Appliance

1. Accedi all'interfaccia web di Cisco Secure Web Appliance.
2. Vai ad Amministrazione di sistema > Abbonamenti ai log.
3. Fai clic su Aggiungi abbonamento ai log.
4. Seleziona un tipo di log dal menu a discesa Tipo di log. Per il traffico del proxy web, seleziona Log di accesso.
5. Nel campo Nome log, inserisci un nome descrittivo per la sottoscrizione ai log (ad esempio, chronicle-access).

6. Seleziona il formato del log degli accessi:

   • Squid: formato standard compatibile con Squid
   • Apache: formato compatibile con Apache
   • W3C Extended: formato file di log W3C Extended con campi configurabili
   Nota: il formato Squid è quello predefinito e di uso comune con il parser CISCO_WSA.

7. Specifica la dimensione massima del file prima del rollover dei log e l'intervallo di tempo tra i rollover.

8. Seleziona il livello di log. Le opzioni disponibili sono Critico, Avviso, Informazioni, Debug o Trace.

9. Nella sezione Metodo di recupero, seleziona Syslog Push.

10. Fornisci i seguenti dettagli di configurazione:

    • Nome host: inserisci l'indirizzo IP o il nome host dell'host dell'agente Bindplane (ad esempio, 192.168.1.100).
    • Porta: inserisci il numero di porta configurato sull'agente Bindplane (ad esempio 514).
    • Protocollo: seleziona TCP.
    • Dimensione massima del messaggio: inserisci la dimensione massima del messaggio di log in byte da inviare al server syslog remoto.
    • Facility: seleziona la facility syslog richiesta (ad esempio, Local0).
    Nota: Syslog Push è conforme a RFC 3164.

11. Fai clic su Invia.

12. Fai clic su Commit Changes (Esegui commit delle modifiche) per applicare la configurazione.

    Nota: ripeti i passaggi da 3 a 12 per creare abbonamenti ai log aggiuntivi per altri tipi di log, ad esempio L4 Traffic Monitor Logs, Malware Scanning Logs o Authentication Logs.
    Nota: per ulteriori informazioni, consulta la Guida per l'utente di Cisco Secure Web Appliance.

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
_field	additional.fields	Unita
case_name_label	additional.fields	Unita
cmf_label	additional.fields	Unita
dcf_label	additional.fields	Unita
err_label	additional.fields	Unita
interaction_mode_label	additional.fields	Unita
proxy_session_id_label	additional.fields	Unita
request_size_label	additional.fields	Unita
total_bytes_label	additional.fields	Unita
transaction_disposition_label	additional.fields	Unita
auth_mechanism	extensions.auth.auth_details	Mappato direttamente
wsa_hostname	intermediary.asset.hostname	Mappato direttamente
wsa_hostname	intermediary.hostname	Mappato direttamente
description	metadata.description	Mappato direttamente
time	metadata.event_timestamp	Analizzato come MMM dd HH:mm:ss
when	metadata.event_timestamp	Analizzato come UNIX
has_principal	metadata.event_type	Mappatura: true → NETWORK_HTTP, true → NETWORK_CONNECTION, true → STATUS_UPDATE
has_user	metadata.event_type	Mappatura: true → USER_UNCATEGORIZED
action	metadata.product_event_type	Mappata direttamente
app_proto	network.application_protocol	Mappato direttamente
method	network.http.method	Mappato direttamente
referer_url	network.http.referral_url	Mappato direttamente
returnCode	network.http.response_code	Mappato direttamente
user_agent	network.http.user_agent	Mappato direttamente
response_size	network.received_bytes	Mappato direttamente
bytes_sent	network.sent_bytes	Mappato direttamente
size	network.sent_bytes	Mappato direttamente
session_id	network.session_id	Mappata direttamente
srcip	principal.asset.ip	Unita
srcip	principal.ip	Unita
process_id	principal.process.pid	Mappata direttamente
_field	principal.resource.attribute.labels	Unita
key	principal.resource.attribute.labels	Mappatura: server_response → _field
username	principal.user.userid	Mappato direttamente
_security_result	security_result	Unita
domain	target.administrative_domain	Mappato direttamente
tgthost	target.asset.hostname	Mappata direttamente
tgtip	target.asset.ip	Unita
mime_type	target.file.mime_type	Mappato direttamente
tgthost	target.hostname	Mappata direttamente
tgtip	target.ip	Unita
tar_city	target.location.city	Mappato direttamente
tar_region	target.location.country_or_region	Mappato direttamente
tar_state	target.location.state	Mappato direttamente
tgtport	target.port	Mappata direttamente
kerberos_enctype_label	target.resource.attribute.labels	Unita
kerberos_keytab_label	target.resource.attribute.labels	Unita
kerberos_kvno_label	target.resource.attribute.labels	Unita
server_cert_organization_label	target.resource.attribute.labels	Unita
target_kerberos_realm_label	target.resource.attribute.labels	Unita
url	target.url	Mappata direttamente
N/D	metadata.event_type	Costante: NETWORK_HTTP
N/D	metadata.product_name	Costante: WSA
N/D	metadata.vendor_name	Costante: CISCO
information	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
appname	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
facility	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
logtime	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
policy	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
hostname	event.idm.read_only_udm.principal.hostname	Mappato dal log delle modifiche
hostname	event.idm.read_only_udm.principal.asset.hostname	Mappato dal log delle modifiche
ser_url	event.idm.read_only_udm.security_result.description	Mappato dal log delle modifiche
ser_msg	event.idm.read_only_udm.security_result.rule_name	Mappato dal log delle modifiche
ser_data	event.idm.read_only_udm.security_result.detection_fields	Mappato dal log delle modifiche
priority	event.idm.read_only_udm.security_result.severity_details	Mappato dal log delle modifiche
srcport	event.idm.read_only_udm.principal.port	Mappato dal log delle modifiche
category	event.idm.read_only_udm.security_result.category_details	Mappato dal log delle modifiche
sha_value	event.idm.read_only_udm.target.file.sha256	Mappato dal log delle modifiche
cmf	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
dcf	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
err	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
case_name	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
total_bytes	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
request_size	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
transaction_disposition	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
application	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
bytes_sent	event.idm.read_only_udm.network.sent_bytes	Mappato dal log delle modifiche
response_size	event.idm.read_only_udm.network.received_bytes	Mappato dal log delle modifiche
description	event.idm.read_only_udm.metadata.description	Mappato dal log delle modifiche
referer_url	event.idm.read_only_udm.network.http.referral_url	Mappato dal log delle modifiche
wsa_hostname	event.idm.read_only_udm.intermediary.hostname, event.idm.read_only_udm.intermediary.asset.hostname	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.