Raccogliere i log di Carbon Black App Control
Questo documento spiega come raccogliere i log di Carbon Black App Control. Il parser supporta i formati CEF e JSON. Innanzitutto, tenta di analizzare l'input come JSON. Se l'operazione non va a buon fine, considera l'input come CEF, esegue sostituzioni di testo, estrae i campi CEF, li mappa a UDM e imposta il tipo di evento su GENERIC_EVENT
. In caso contrario, utilizza un file di inclusione della mappatura UDM specifico per JSON separato.
Prima di iniziare
- Assicurati di avere un'istanza Google Security Operations.
- Assicurati di utilizzare Windows 2016 o versioni successive oppure un host Linux con
systemd
. - Se l'esecuzione avviene tramite un proxy, assicurati che le porte del firewall siano aperte.
- Server Carbon Black App Control (CB Protection) (consigliata la versione 8.x o successive).
- Assicurati di disporre dell'accesso con privilegi a Carbon Black App Control.
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
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 questa guida all'installazione.
Configura l'agente Bindplane per importare Syslog e inviarlo 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: tcplog: # Replace the port and IP address as required listen_address: "0.0.0.0:11592" exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds: '/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 ingestion_labels: log_type: JSON namespace: cb_app_control raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - tcplog 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 Bindplane Agent 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
Configurare il controllo app CB per inviare log Syslog
- Accedi alla console di controllo delle app CB con un account amministratore.
- Vai ad Amministrazione > Configurazione di sistema > Registrazione esterna.
- Nella sezione Registrazione eventi esterni:
- Abilita logging Syslog: seleziona la casella di controllo Syslog abilitato.
- Indirizzo server:
<Bindplane Server IP>
. - Porta:
<Bindplane Server PORT>
. - Protocollo: seleziona TCP.
- Formato Syslog: seleziona JSON.
- Nella sezione Opzioni di registrazione eventi, seleziona i tipi di log da inviare:
- Violazioni delle norme
- Eventi di monitoraggio dell'integrità dei file (FIM)
- Eventi di autenticazione utente
- Dati di Threat Intelligence
- Fai clic su Salva.
Tabella di mappatura UDM
Campo log | Mappatura UDM | Logic |
---|---|---|
ABId |
principal.asset.asset_id |
Il valore ABId del log JSON viene utilizzato come parte dell'ID risorsa nel formato PRODUCT_SPECIFIC_ID:{ABId}-{Bit9Server} . |
Bit9Server |
principal.asset.asset_id |
Utilizzato come parte dell'ID risorsa dell'entità, combinato con ABId . Utilizzato anche per costruire il campo metadata.url_back_to_product . |
CommandLine |
about.process.command_line |
Mappato direttamente. |
EventType |
metadata.product_event_type |
Mappato con il EventTypeId corrispondente tra parentesi quadre (ad es. [5] - Discovery ). |
EventTypeId |
metadata.product_event_type |
Utilizzato con EventType per compilare metadata.product_event_type . |
EventSubType |
metadata.description |
Aggiunto al campo metadata.description . |
EventSubTypeId |
metadata.description |
Non mappato in modo esplicito, ma potrebbe contribuire alla descrizione in base alla logica interna del parser. |
externalId |
metadata.product_log_id |
Mappato direttamente. |
FileHash |
about.file.sha256 |
Mappato direttamente. |
FileName |
additional.fields (con chiave FileName ) |
Aggiunto come campo aggiuntivo. Utilizzato anche come parte delle informazioni sui file in metadata.description per alcuni eventi. |
FilePath |
about.file.full_path |
Mappato direttamente. |
FileThreat |
additional.fields (con chiave fileThreat ) |
Aggiunto come campo aggiuntivo. |
FileTrust |
additional.fields (con chiave fileTrust ) |
Aggiunto come campo aggiuntivo. |
HostId |
principal.asset.asset_id |
Utilizzato per creare l'URL che rimanda al prodotto in metadata.url_back_to_product . |
HostName |
target.hostname |
Mappato direttamente. |
HostIP |
target.ip |
Mappato direttamente. |
Message |
metadata.description |
Mappato direttamente. |
PathName |
about.file.full_path |
Mappato direttamente. |
Platform |
target.platform |
Mappato al valore enum WINDOWS . |
Policy |
additional.fields (con chiave Policy ) |
Aggiunto come campo aggiuntivo. |
PolicyId |
additional.fields (con chiave PolicyId ) |
Aggiunto come campo aggiuntivo. |
ProcessKey |
additional.fields (con chiave ProcessKey ) |
Aggiunto come campo aggiuntivo. |
ProcessPath |
about.process.command_line |
Mappato direttamente. |
ProcessPathName |
about.process.command_line |
Mappato direttamente. |
ProcessThreat |
additional.fields (con chiave ProcessThreat ) |
Aggiunto come campo aggiuntivo. |
ProcessTrust |
additional.fields (con chiave ProcessTrust ) |
Aggiunto come campo aggiuntivo. |
RuleName |
additional.fields (con chiave ruleName ) |
Aggiunto come campo aggiuntivo. |
Timestamp |
metadata.event_timestamp |
Mappato direttamente. |
UserName |
target.user.user_display_name |
Mappato direttamente. |
UserSid |
principal.user.userid |
Mappato direttamente. |
agent.ephemeral_id |
observer.labels (con chiave ephemeral_id ) |
Aggiunta come etichetta di osservatore. |
agent.name |
principal.hostname , observer.hostname , observer.user.userid |
Mappato su più campi. |
agent.type |
observer.application |
Mappato direttamente. |
agent.version |
metadata.product_version |
Mappato direttamente per i log JSON. Per i log CEF, estratti dal messaggio CEF. |
cat |
security_result.category_details |
Mappato direttamente. |
cs1 |
additional.fields (con chiave rootHash o altra cs1Label) |
Aggiunto come campo aggiuntivo con la chiave definita da cs1Label . |
cs1Label |
additional.fields |
Utilizzato come chiave per il campo aggiuntivo compilato da cs1 . |
cs2 |
additional.fields (con chiave installerFilename o altra etichetta cs2) |
Aggiunto come campo aggiuntivo con la chiave definita da cs2Label . |
cs2Label |
additional.fields |
Utilizzato come chiave per il campo aggiuntivo compilato da cs2 . |
cs3 |
additional.fields (con chiave Policy o altra cs3Label) |
Aggiunto come campo aggiuntivo con la chiave definita da cs3Label . |
cs3Label |
additional.fields |
Utilizzato come chiave per il campo aggiuntivo compilato da cs3 . |
cs5 |
additional.fields (con chiave ruleName o altra etichetta cs5Label) |
Aggiunto come campo aggiuntivo con la chiave definita da cs5Label . |
cs5Label |
additional.fields |
Utilizzato come chiave per il campo aggiuntivo compilato da cs5 . |
cfp1 |
additional.fields (con chiave fileTrust o altra cfp1Label) |
Aggiunto come campo aggiuntivo con la chiave definita da cfp1Label . |
cfp1Label |
additional.fields |
Utilizzato come chiave per il campo aggiuntivo compilato da cfp1 . |
cfp2 |
additional.fields (con chiave processTrust o altra cfp2Label) |
Aggiunto come campo aggiuntivo con la chiave definita da cfp2Label . |
cfp2Label |
additional.fields |
Utilizzato come chiave per il campo aggiuntivo compilato da cfp2 . |
deviceProcessName |
about.process.command_line |
Mappato direttamente. |
dhost |
target.hostname |
Mappato direttamente. |
dst |
target.ip |
Mappato direttamente. |
duser |
target.user.user_display_name |
Mappato direttamente. |
dvchost |
about.hostname |
Mappato direttamente. |
eventId |
additional.fields (con chiave eventId ) |
Aggiunto come campo aggiuntivo. |
fileHash |
about.file.sha256 |
Mappato direttamente. |
flexString1 |
additional.fields (con chiave fileThreat o altra flexString1Label) |
Aggiunto come campo aggiuntivo con la chiave definita da flexString1Label . |
flexString1Label |
additional.fields |
Utilizzato come chiave per il campo aggiuntivo compilato da flexString1 . |
flexString2 |
additional.fields (con chiave processThreat o altra flexString2Label) |
Aggiunto come campo aggiuntivo con la chiave definita da flexString2Label . |
flexString2Label |
additional.fields |
Utilizzato come chiave per il campo aggiuntivo compilato da flexString2 . |
fname |
additional.fields (con chiave fname ) |
Aggiunto come campo aggiuntivo. Utilizzato anche come parte delle informazioni sui file in metadata.description per alcuni eventi. |
host.architecture |
target.asset.hardware.cpu_platform |
Mappato direttamente. |
host.hostname |
target.asset.asset_id |
Utilizzato come parte dell'ID risorsa target (Host Id: {host.hostname} ). Mappato anche a target.hostname . |
host.id |
target.asset.asset_id |
Utilizzato come parte dell'ID risorsa target (Host Id: {host.id} ). |
host.ip |
target.asset.ip |
Mappato direttamente. |
host.mac |
target.mac |
Mappato direttamente. |
host.name |
target.hostname |
Mappato direttamente. |
host.os.build |
target.platform_patch_level |
Mappato direttamente. |
host.os.kernel |
target.platform_patch_level |
Aggiunto a target.platform_patch_level . |
host.os.platform |
target.platform |
Mappato al valore enum WINDOWS . |
host.os.type |
target.platform |
Mappato al valore enum WINDOWS . |
host.os.version |
target.platform_version |
Mappato direttamente. |
log.file.path |
target.file.full_path |
Mappato direttamente. |
metadata.event_type |
metadata.event_type |
Imposta GENERIC_EVENT per i log CEF, SYSTEM_AUDIT_LOG_UNCATEGORIZED per i log JSON. |
metadata.log_type |
metadata.log_type |
Imposta su CB_EDR . |
metadata.product_log_id |
metadata.product_log_id |
Mappato da externalId per i log CEF. Non applicabile ai log JSON. |
metadata.product_name |
metadata.product_name |
Imposta App Control per i log CEF, CB_APP_CONTROL per i log JSON. |
metadata.product_version |
metadata.product_version |
Estratto dal messaggio CEF per i log CEF. Mappato da agent.version per i log JSON. |
metadata.vendor_name |
metadata.vendor_name |
Imposta su Carbon Black . |
msg |
metadata.description , additional.fields |
Utilizzato per compilare metadata.description e potenzialmente altri campi in base alla logica del parser. |
sproc |
principal.process.command_line |
Mappato direttamente. |
metadata.url_back_to_product |
metadata.url_back_to_product |
Costruito utilizzando i campi Bit9Server e HostId per i log JSON. Non applicabile ai log CEF. |
security_result.severity |
security_result.severity |
Imposta su MEDIUM . |
timestamp |
events.timestamp |
Mappato direttamente per i log JSON. Per i log CEF, la logica del parser determina il timestamp in base al campo rt del log non elaborato, se disponibile, o al campo collection_time se rt non è presente. |
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.