Raccogliere i log di Forcepoint CASB

Supportato in:

Questo documento spiega come importare i log di Forcepoint CASB (Cloud Access Security Broker) in Google Security Operations utilizzando Bindplane. Il parser estrae i campi dai messaggi syslog di Forcepoint CASB formattati con CEF. Utilizza Grok per analizzare il messaggio, KV per separare le coppie chiave-valore e la logica condizionale per mappare i campi estratti al modello di dati unificato (UDM), gestendo vari tipi di eventi e specifiche della piattaforma.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Istanza Google SecOps
  • Un host Windows 2016 o versioni successive oppure Linux con systemd
  • Se l'esecuzione avviene tramite un proxy, le porte del firewall sono aperte
  • Accesso privilegiato a Forcepoint CASB

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

Per ulteriori opzioni di installazione, consulta la guida all'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: 'FORCEPOINT_CASB'
            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
    

Scaricare lo strumento SIEM Forcepoint

  1. Accedi al portale di gestione Forcepoint CASB.
  2. Vai a Impostazioni > Strumenti e agenti > Strumento SIEM.
  3. Fai clic su Scarica per scaricare un file zip denominato SIEM-Tool-\[operating system\]-\[release date\].zip (ad esempio, SIEM-Tool-Windows-2021-10-19.zip). Il file zip contiene uno dei seguenti file, a seconda della versione scaricata:
    • SIEMClient.bat (se hai scaricato lo strumento Windows)
    • SIEMClient.sh (se hai scaricato lo strumento Linux)

Installare lo strumento SIEM

Per la connessione sicura dello strumento SIEM al servizio Forcepoint CASB, lo strumento richiede il file del trust store che può essere scaricato dal portale di gestione CASB di Forcepoint. Segui questi passaggi:

  1. Accedi al portale di gestione Forcepoint CASB.
  2. Vai a Impostazioni > Strumenti e agenti > Strumento SIEM.
  3. Fai clic su Scarica archivio attendibile.
  4. Salva il file dell'archivio attendibile scaricato in una posizione a cui lo strumento SIEM può accedere dopo l'installazione.
  5. Estrai l'archivio dello strumento SIEM su un host su cui è installato Java v1.8 o versioni successive e che può accedere al server di gestione Forcepoint CASB dell'organizzazione.
  6. Apri un prompt dei comandi, vai alla posizione dei file SIEMClient ed esegui questo comando:
    • Windows: SIEMClient.bat --set.credentials –-username <user> --password <password> --credentials.file <file>
    • Linux: SIEMClient.sh --set.credentials –-username <user> --password <password> --credentials.file <file>
  7. Fornisci i seguenti parametri di configurazione:
    • <user> e <password>: credenziali di amministratore CASB di Forcepoint. Se ometti gli argomenti --username e --password, ti verrà chiesto di fornirli in modo interattivo.
    • <file>: Percorso e nome file per l'archivio delle credenziali.
  8. Esegui lo strumento SIEM dal prompt dei comandi: <tool> --credentials.file <file> --host <host> --port <port#> --output.dir <dir> [ truststorePath=<trust> ] [ exportSyslog=true syslogHost=<bindplaneAgentIP> syslogFacility=<facility> ] [ cefVersion=<cef.version> ] [ cefCompliance=<cef.flag> ] [ --proxy.host <proxy.host> ] [ --proxy.port <proxy.port> ]
  9. Fornisci i seguenti parametri di configurazione:
    • <tool>: su Windows: SIEMClient.bat, su Linux: SIEMClient.sh.
    • <file>: percorso e nome file dell'archivio delle credenziali.
    • <host> e <port#>: dettagli della connessione al server di gestione CASB Forcepoint. La porta è solitamente la 443.
    • <dir>: directory in cui lo strumento SIEM salva i file di attività prodotti. Obbligatorio anche se il push viene eseguito su syslog.
    • <trust>: percorso e nome file dell'archivio attendibile scaricato in precedenza.
    • <bindplaneAgentIP>: l'indirizzo IP dell'agente Bindplane.
    • <facility>: inserisci local1.
    • <cef.version>: imposta la versione di CEF su 2.
      • Se cefVersion=1, lo strumento utilizza il formato CEF legacy.
      • Se cefVersion=2, lo strumento utilizza il formato CEF vero.
      • Se cefVersion=3, lo strumento utilizza una versione più recente di CEF che supporta le nuove colonne delle attività (Target, Messaggio e Proprietà).
      • Se il parametro cefVersion è incluso nel comando, lo strumento ignora il parametro cefCompliance.
      • Se il parametro cefVersion viene omesso dal comando, lo strumento utilizza il parametro cef Compliance.
    • <cef.flag>: attiva il formato CEF true.
      • Se cefCompliance=true, lo strumento utilizza il formato CEF vero.
      • Se cefCompliance=false, lo strumento utilizza il formato CEF legacy.
      • Se il parametro viene omesso dal comando, il valore predefinito è false e lo strumento utilizza il formato CEF precedente.
    • <proxy.host> e <proxy.port>: dettagli di connessione al server proxy se la connessione al server di gestione Forcepoint CASB avviene tramite un server proxy.

Tabella di mappatura UDM

Campo log Mappatura UDM Logic
act security_result.action Se act contiene "ALLOW" (senza distinzione tra maiuscole e minuscole), imposta il valore su "ALLOW". In caso contrario, imposta "BLOCK".
agt principal.ip Mappato direttamente.
ahost principal.hostname Mappato direttamente.
aid principal.resource.id Mappato direttamente.
amac principal.mac Mappato direttamente dopo aver sostituito "-" con ":" e convertito in minuscolo.
at principal.resource.name Mappato direttamente.
atz principal.location.country_or_region Mappato direttamente.
av principal.resource.attribute.labels.key, principal.resource.attribute.labels.value av è mappato a key e il valore di av è mappato a value.
cs1 principal.user.email_addresses Mappato direttamente.
deviceProcessName target.resource.name Mappato direttamente.
deviceZoneURI target.url Mappato direttamente.
dvc target.ip Mappato direttamente.
dvchost target.hostname Mappato direttamente.
event_name metadata.product_event_type, metadata.event_type Utilizzato in combinazione con event_type per compilare metadata.product_event_type. Utilizzato anche per determinare metadata.event_type: "Login" -> USER_LOGIN, "Logout" -> USER_LOGOUT, "access event" -> USER_UNCATEGORIZED, altrimenti (se è presente agt) -> STATUS_UPDATE.
event_type metadata.product_event_type Utilizzato in combinazione con event_name per compilare metadata.product_event_type.
msg metadata.description, security_result.summary Mappato direttamente su entrambi i campi.
product metadata.vendor_name Mappato direttamente.
request extensions.auth.auth_details, extensions.auth.type Mappato direttamente a extensions.auth.auth_details. extensions.auth.type è impostato su "SSO".
requestClientApplication network.http.user_agent Mappato direttamente.
shost src.hostname Mappato direttamente.
smb_host intermediary.hostname Mappato direttamente.
smb_uid intermediary.user.userid Mappato direttamente.
sourceServiceName principal.platform_version, principal.platform Mappato direttamente a principal.platform_version. principal.platform è derivato dal valore di sourceServiceName: "Window" -> WINDOWS, "Linux" -> LINUX, "mac" o "iPhone" -> MAC.
sourceZoneURI src.url Mappato direttamente.
spriv src.user.department Mappato direttamente.
sproc src.resource.attribute.labels.key, src.resource.attribute.labels.value sproc è mappato a key e il valore di sproc è mappato a value.
src src.ip Mappato direttamente.
suid principal.user.userid Mappato direttamente.
timestamp metadata.event_timestamp Mappato direttamente.
ts_event metadata.collected_timestamp Mappato direttamente dopo l'analisi e la conversione in un timestamp.
value metadata.product_name Concatenato con "Forcepoint " per formare metadata.product_name. Imposta il valore su "FORCEPOINT_CASB".

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