Raccogliere i log di Forcepoint CASB
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
- Accedi alla console Google SecOps.
- Vai a Impostazioni SIEM > Agenti di raccolta.
- 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
- 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 il 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
Installazione di Linux
- Apri un terminale con privilegi di 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
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
- 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).
- Individua il file
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
- Sostituisci la porta e l'indirizzo IP in base alle esigenze della tua infrastruttura.
- Sostituisci
<customer_id>
con l'ID cliente effettivo. - Aggiorna
/path/to/ingestion-authentication-file.json
al percorso in cui è stato salvato il file di autenticazione nella sezione Recupera il file di autenticazione per l'importazione di Google SecOps.
Riavvia l'agente Bindplane per applicare le modifiche
Per riavviare l'agente Bindplane in Linux, esegui questo comando:
sudo systemctl restart bindplane-agent
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
- Accedi al portale di gestione Forcepoint CASB.
- Vai a Impostazioni > Strumenti e agenti > Strumento SIEM.
- 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:
- Accedi al portale di gestione Forcepoint CASB.
- Vai a Impostazioni > Strumenti e agenti > Strumento SIEM.
- Fai clic su Scarica archivio attendibile.
- Salva il file dell'archivio attendibile scaricato in una posizione a cui lo strumento SIEM può accedere dopo l'installazione.
- 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.
- 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>
- Windows:
- 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.
- 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> ]
- 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.