Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Raccogli i log del proxy web iBoss

Supportato in:

Google SecOps SIEM

Questo documento spiega come importare i log del proxy web iBoss in Google Security Operations utilizzando Bindplane.

iBoss è una piattaforma SASE (Secure Access Service Edge) Zero Trust nativa per il cloud che fornisce accesso a internet sicuro, Secure Web Gateway (SWG), CASB, ZTNA e funzionalità DLP. Instrada il traffico attraverso la sua infrastruttura cloud per applicare policy di sicurezza e protezione dalle minacce coerenti per gli utenti, indipendentemente dalla posizione.

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 cloud iBoss
Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
Accesso amministratore al portale iBoss con autorizzazioni per configurare Integration Marketplace

Recuperare il file di autenticazione dell'importazione di Google SecOps

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

Recuperare l'ID cliente Google SecOps

Accedi alla console Google SecOps.
Vai a Impostazioni SIEM > Profilo.
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

Apri Prompt dei comandi o PowerShell come amministratore.

Esegui questo comando:

msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet

Attendi il completamento dell'installazione.
Verifica l'installazione eseguendo:
```
sc query observiq-otel-collector
```
Il servizio dovrebbe essere visualizzato come IN ESECUZIONE.

Installazione di Linux

Apri un terminale con privilegi root o sudo.

Esegui questo comando:

sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh

Attendi il completamento dell'installazione.
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/iboss_webproxy:
        compression: gzip
        creds_file_path: '<CREDS_FILE_PATH>'
        customer_id: '<CUSTOMER_ID>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: IBOSS_WEBPROXY
        raw_log_field: body
        ingestion_labels:
            log_source: iboss

service:
    pipelines:
        logs/iboss_to_chronicle:
            receivers:
                - udplog
            exporters:
                - chronicle/iboss_webproxy

Parametri di configurazione

Sostituisci i seguenti segnaposto:

Configurazione del destinatario:
- listen_address: L'indirizzo IP e la porta su cui l'agente Bindplane è in ascolto dei messaggi syslog in entrata. Utilizza 0.0.0.0 per ascoltare su tutte le interfacce. La porta deve corrispondere a quella configurata nelle impostazioni di inoltro di syslog di iBoss.
- Se iBoss è configurato per inviare log tramite TCP, sostituisci il ricevitore udplog con tcplog:
```
receivers:
    tcplog:
        listen_address: "0.0.0.0:514"
```
Nota: aggiorna di conseguenza il riferimento al destinatario nella sezione service.pipelines.
Configurazione dell'esportatore:
- <CREDS_FILE_PATH>: il 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>: l'ID cliente Google SecOps copiato in precedenza.
- 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

Verifica che il servizio sia in esecuzione:

sudo systemctl status observiq-otel-collector

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.
Verifica che il servizio sia in esecuzione:
```
sc query observiq-otel-collector
```

Controlla i log per individuare eventuali errori:

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

Configurare l'inoltro di Syslog di iBoss

Accedi al portale iBoss.
Vai a Integration Marketplace, poi seleziona Log Forwarding dal menu a sinistra e fai clic sul pulsante Configura associato al widget Syslog Log Forwarding.
Fai clic sul pulsante Aggiungi integrazione per aggiungere l'integrazione Syslog.
Fornisci i seguenti dettagli di configurazione:
- Inoltra da: seleziona Autore della segnalazione dal menu a discesa.
- Seleziona database report: seleziona il database report.
- Nome servizio: inserisci un nome descrittivo per l'integrazione (ad esempio, SecOps-Bindplane).
- Enable Service (Attiva servizio): imposta questa opzione su Enabled (Attivato).
- Tipo di log: seleziona URL dal menu a discesa. Vengono acquisiti i log del traffico del proxy web (richieste HTTP/HTTPS). Per inoltrare altre categorie di eventi come DLP o DNS, configura integrazioni separate con il tipo di log corrispondente.
- Tipo di protocollo: seleziona UDP o TCP dal menu a discesa.
  
  Nota: il protocollo deve corrispondere al tipo di ricevitore configurato nel file config.yaml dell'agente Bindplane (udplog per UDP, tcplog per TCP). TCP è consigliato per gli ambienti di produzione perché fornisce una distribuzione affidabile e ordinata.
- Livello struttura Syslog: seleziona Struttura Syslog dal menu a discesa.
- Gruppo di report: seleziona Tutti dal menu a discesa.
- Nome host: inserisci l'indirizzo IP o il nome di dominio completo dell'host dell'agente Bindplane.
- Porta: inserisci il numero di porta corrispondente alla porta listen_address nella configurazione dell'agente Bindplane (ad esempio, 514).
  
  Nota: su Linux, la porta 514 è una porta con privilegi. Se l'agente Bindplane viene eseguito come utente non root, utilizza una porta senza privilegi (ad esempio 5514) e aggiorna sia il campo Porta di iBoss sia listen_address di Bindplane in modo che corrispondano.
- Formato log: seleziona JSON dal menu a discesa.
- Intervallo di trasferimento: seleziona Continuo dal menu a discesa.
- Delimitatore campo: seleziona SPAZIO dal menu a discesa.
- Send DLP/Web/DNS/Malware/Audit/ConnectionError Logs: imposta Enable in base alle tue preferenze per l'invio dei log.
  
  Nota :il pulsante di attivazione/disattivazione Invia log degli errori di connessione è visibile nell'interfaccia utente di iBoss solo quando l'opzione Invia log web è disattivata.
- Campi da inoltrare: aggiungi tutti i campi tranne Metadati codificati in Base64 DLP, Metadati codificati in Base64 e Messaggio Chat GPT.
Fai clic su Aggiungi servizio.

Tabella di mappatura UDM

Campo log	mappatura UDM	Logica
intermediario	intermediario	Informazioni su un servizio o dispositivo intermediario coinvolto nell'evento.
decr	metadata.description	Descrizione aggiuntiva dell'evento.
metadata.event_type	metadata.event_type	Tipo di evento (ad es. USER_LOGIN, NETWORK_CONNECTION).
urlLogId	metadata.product_log_id	Identificatore univoco della voce di log del prodotto.
requestMethod	network.http.method	Metodo HTTP utilizzato nella richiesta.
ref_url	network.http.referral_url	L'URL che ha indirizzato l'utente alla pagina corrente.
response_Code	network.http.response_code	Codice di risposta HTTP.
user_Agent	network.http.user_agent	Stringa dello user agent della richiesta HTTP.
up_stream	network.received_bytes	Numero di byte ricevuti nella connessione di rete.
down_stream	network.sent_bytes	Numero di byte inviati nella connessione di rete.
computerName	principal.asset.hostname	Il nome host della risorsa associata all'entità.
computer_Mac_Address	principal.asset.mac	L'indirizzo MAC dell'asset associato al principal.
filtering_Group_Name	principal.group.group_display_name	Nome visualizzato del gruppo associato all'entità.
computerName	principal.hostname	Il nome host dell'entità.
sourceIpAddress	principal.ip	Indirizzo IP dell'entità.
pri_ip	principal.ip
pub_ip	principal.ip
mac_address	principal.mac	Indirizzo MAC del principale.
src_port	principal.port	Numero di porta utilizzato dal principal.
file_name	principal.process.file.names	Nomi dei file associati al processo.
nome utente	principal.user.userid	ID utente dell'entità.
sec_res	security_result	Risultato dell'analisi di sicurezza, incluse azioni e categorie.
host	target.hostname	Il nome host della destinazione.
ipAddress	target.ip	Indirizzo IP della destinazione.
targetPort	target.port	Numero di porta della destinazione.
uri_path	target.process.file.full_path	Il percorso completo del file o della risorsa sulla destinazione.
url	target.url	URL della destinazione.
metadata.product_name	metadata.product_name	Nome del prodotto che ha generato l'evento.
metadata.vendor_name	metadata.vendor_name	Nome del fornitore che ha prodotto il prodotto.

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.