Raccogli i log di Check Point Harmony

Versione parser: 3.0

Supportata in:

Google SecOps SIEM

Questo documento spiega come importare i log di Check Point Harmony Email and Collaboration (HEC) in Google Security Operations utilizzando Bindplane. Questo codice del parser estrae le coppie chiave-valore dai messaggi syslog di Check Point Harmony e le mappa a un modello UDM (Unified Data Model). Innanzitutto normalizza il formato del messaggio, poi analizza e mappa in modo iterativo i campi alle categorie UDM come principal, target, network e security_result, arricchendo i dati per l'analisi della sicurezza.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

• Istanza Google SecOps
• Windows 2016 o versioni successive oppure un host Linux con systemd
• Se l'esecuzione avviene tramite un proxy, le porte del firewall sono aperte
• Accesso con privilegi a Check Point Harmony HEC (Infinity Portal)

Recupera le credenziali Google SecOps per l'agente Bindplane

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

• Nuove implementazioni: utilizza l'API Chronicle (opzione 1).
• Deployment legacy: continua a utilizzare il file di autenticazione dell'acquisizione (opzione 2) fino al ritiro 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 del 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 Editor Chronicle.
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) o 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 legacy (malachiteingestion-pa.googleapis.com), il cui fine del ciclo di vita è previsto da Google per il 20 luglio 2027. Pianifica il passaggio all'Opzione 1 prima di questa data.

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

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

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 dell'agente di raccolta prima di modificare la configurazione.

Configura l'agente Bindplane per importare Syslog e inviarlo a Google SecOps

1. Accedi al file di configurazione:
   • Individua il file config.yaml. In genere si trova nella directory /opt/observiq-otel-collector/ 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:
           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
           # 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: chronicle.googleapis.com
           # Add optional ingestion labels for better organization
           log_type: 'CHECKPOINT_HARMONY'
           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 come richiesto nella tua infrastruttura.
   • Sostituisci <LOCATION> con la regione della tua istanza Google SecOps (ad esempio us, europe o asia-southeast1). L'esportatore antepone chronicle.googleapis.com a questo valore.
   • Sostituisci <PROJECT_NUMBER> con il numero di progetto in IAM e amministrazione > Impostazioni.
   • Sostituisci <customer_id> con l'ID cliente effettivo.
   • Aggiorna /path/to/ingestion-authentication-file.json con il percorso in cui è stato salvato il file della chiave del account di servizio (Opzione 1) nella sezione Ottieni le credenziali di Google SecOps per l'agente Bindplane.

Esportatore dell'API di importazione precedente

• Se utilizzi il file di autenticazione dell'importazione dell'opzione 2, sostituisci il blocco exporters con il seguente. Imposta creds_file_path sul percorso del file di autenticazione dell'importazione e, se la tua istanza si trova al di fuori degli Stati Uniti, sostituisci malachiteingestion-pa.googleapis.com con l'endpoint regionale (ad esempio, europe-malachiteingestion-pa.googleapis.com).

  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: 'CHECKPOINT_HARMONY'
          raw_log_field: body
          ingestion_labels:
  

Nota: questo strumento di esportazione smetterà di funzionare quando l'API Ingestion non sarà più disponibile il 20 luglio 2027.

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
  

Configura Syslog per Check Point Harmony HEC

1. Accedi all'interfaccia utente web di Infinity Portal > Harmony Email & Collaboration.
2. Vai a Impostazioni > Monitoraggio > SIEM.
3. Fai clic su Aggiungi server SIEM.
4. Fornisci i seguenti dettagli di configurazione:
   • Host: inserisci l'indirizzo IP dell'agente Bindplane.
   • Porta: inserisci il numero di porta dell'agente Bindplane.
   • Protocollo: seleziona UDP.
   • (Facoltativo) Token: inserisci un tag facoltativo nei log.
5. Fai clic su Salva.

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
azione	security_result.action_details	Mappato direttamente.
	security_result.action	Mappato a ALLOW, BLOCK, ALLOW_WITH_MODIFICATION o QUARANTINE in base al valore del campo action.
additional_info	additional.fields.value.string_value	Mappato direttamente con chiave = additional_info.
analyzed_on	security_result.detection_fields.value	Mappato direttamente con chiave = analyzed_on.
client_name	additional.fields.value.string_value	Mappato direttamente con la chiave = client_name.
client_version	intermediary.platform_version	Mappato direttamente.
confidence_level	security_result.detection_fields.value	Mappato direttamente con la chiave = confidence_level.
	security_result.confidence	Mappato su UNKNOWN_CONFIDENCE, LOW_CONFIDENCE, MEDIUM_CONFIDENCE o HIGH_CONFIDENCE in base al valore del campo confidence_level.
descrizione	security_result.description	Mappato direttamente.
dst	target.ip	Mappato direttamente.
dst_dns_name	security_result.detection_fields.value	Mappato direttamente con la chiave = dst_dns_name.
dst_machine_name	security_result.detection_fields.value	Mappato direttamente con la chiave = dst_machine_name.
	target.asset.hostname	Mappato direttamente.
	target.hostname	Mappato direttamente.
dst_user_dn	security_result.detection_fields.value	Mappato direttamente con chiave = dst_user_dn.
dst_user_name	target.user.userid	Mappato direttamente.
ep_rule_id	security_result.rule_id	Mappato direttamente se rule_uid è vuoto.
errori	security_result.summary	Mappato direttamente.
event_type	metadata.product_event_type	Mappato direttamente.
file_md5	target.process.file.md5	Mappato direttamente se il valore è un hash MD5 valido e non è composto solo da zero.
	target.file.md5	Mappato direttamente se il valore è un hash MD5 valido e non è composto solo da zero.
file_name	target.process.file.full_path	Mappato direttamente.
file_sha1	target.process.file.sha1	Mappato direttamente se il valore è un hash SHA-1 valido e non è composto solo da zero.
	target.file.sha1	Mappato direttamente se il valore è un hash SHA-1 valido e non è composto solo da zero.
file_sha256	target.process.file.sha256	Mappato direttamente se il valore è un hash SHA256 valido e non tutti zeri.
	target.file.sha256	Mappato direttamente se il valore è un hash SHA256 valido e non tutti zeri.
file_size	target.file.size	Mappato direttamente.
file_type	target.file.file_type	Mappato su FILE_TYPE_ZIP, FILE_TYPE_DOS_EXE, FILE_TYPE_PDF o FILE_TYPE_XLSX in base al valore del campo file_type.
flags	additional.fields.value.string_value	Mappato direttamente con chiave = flags.
fw_subproduct	additional.fields.value.string_value	Mappato direttamente con key = fw_subproduct se il prodotto è vuoto.
	metadata.product_name	Mappato direttamente se il prodotto è vuoto.
host_type	security_result.detection_fields.value	Mappato direttamente con la chiave = host_type.
ifdir	network.direction	Mappati direttamente dopo la conversione in lettere maiuscole.
ifname	security_result.detection_fields.value	Mappato direttamente con la chiave = ifname.
installed_products	security_result.detection_fields.value	Mappato direttamente con la chiave = installed_products.
is_scanned	security_result.detection_fields.value	Mappato direttamente con la chiave = is_scanned.
layer_name	security_result.detection_fields.value	Mappato direttamente con la chiave = layer_name.
	security_result.rule_set_display_name	Mappato direttamente.
layer_uuid	security_result.detection_fields.value	Mappato direttamente con chiave = layer_uuid.
	security_result.rule_set	Mappato direttamente.
loguid	metadata.product_log_id	Mappato direttamente.
machine_guid	principal.asset.attribute.labels.value	Mappato direttamente con chiave = machine_guid.
malware_action	security_result.detection_fields.value	Mappato direttamente con chiave = malware_action.
malware_family	security_result.detection_fields.value	Mappato direttamente con la chiave = malware_family.
media_authorized	security_result.detection_fields.value	Mappato direttamente con la chiave = media_authorized.
media_class_id	security_result.detection_fields.value	Mappato direttamente con la chiave = media_class_id.
media_description	security_result.detection_fields.value	Mappatura diretta con chiave = media_description.
media_encrypted	security_result.detection_fields.value	Mappato direttamente con chiave = media_encrypted.
media_manufacturer	security_result.detection_fields.value	Mappato direttamente con chiave = media_manufacturer.
media_type	security_result.detection_fields.value	Mappatura diretta con chiave = media_type.
metodi	security_result.detection_fields.value	Mappato direttamente con chiave = methods.
originsicname	security_result.detection_fields.value	Mappato direttamente con chiave = originsicname.
origine	intermediary.ip	Mappato direttamente.
os_version	principal.asset.platform_software.platform_patch_level	Mappato direttamente.
outzone	security_result.detection_fields.value	Mappato direttamente con chiave = outzone.
parent_rule	security_result.detection_fields.value	Mappato direttamente con la chiave = parent_rule.
peer_gateway	intermediary.ip	Mappato direttamente.
policy_guid	security_result.detection_fields.value	Mappato direttamente con chiave = policy_guid.
policy_name	security_result.detection_fields.value	Mappatura diretta con chiave = policy_name.
policy_number	security_result.detection_fields.value	Mappatura diretta con chiave = policy_number.
policy_type	security_result.detection_fields.value	Mappato direttamente con la chiave = policy_type.
prodotto	additional.fields.value.string_value	Mappato direttamente con chiave = product.
	metadata.product_name	Mappato direttamente.
product_family	additional.fields.value.string_value	Mappato direttamente con la chiave = product_family.
program_name	additional.fields.value.string_value	Mappato direttamente con chiave = program_name.
protection_name	security_result.detection_fields.value	Mappato direttamente con la chiave = protection_name.
protection_type	security_result.detection_fields.value	Mappatura diretta con chiave = protection_type.
reading_data_access	security_result.detection_fields.value	Mappatura diretta con chiave = reading_data_access.
rule_action	security_result.detection_fields.value	Mappatura diretta con chiave = rule_action.
rule_name	security_result.rule_name	Mappato direttamente.
rule_uid	security_result.rule_id	Mappato direttamente se ep_rule_id è vuoto.
s_port	principal.port	Mappato direttamente.
schema	security_result.detection_fields.value	Mappatura diretta con chiave = scheme.
sequencenum	additional.fields.value.string_value	Mappato direttamente con chiave = sequencenum.
servizio	target.port	Mappato direttamente.
service_id	security_result.detection_fields.value	Mappatura diretta con chiave = service_id.
session_uid	network.session_id	Mappato direttamente.
src	principal.ip	Mappato direttamente.
src_dns_name	security_result.detection_fields.value	Mappato direttamente con chiave = src_dns_name.
src_machine_name	security_result.detection_fields.value	Mappato direttamente con chiave = src_machine_name.
	principal.asset.hostname	Mappato direttamente.
	principal.hostname	Mappato direttamente.
src_user_dn	security_result.detection_fields.value	Mappato direttamente con la chiave = src_user_dn.
src_user_name	principal.user.userid	Mappato direttamente.
	principal.user.email_addresses	L'indirizzo email viene estratto dal campo src_user_name, se esiste ed è nel formato userid (email).
te_verdict_determined_by	security_result.detection_fields.value	Mappato direttamente con chiave = te_verdict_determined_by.
timestamp	metadata.event_timestamp	Mappato direttamente.
trusted_domain	security_result.detection_fields.value	Mappato direttamente con la chiave = trusted_domain.
utente	principal.user.userid	Mappato direttamente se src_user_name è vuoto.
	principal.user.email_addresses	L'indirizzo email viene estratto dal campo user, se esiste, ed è nel formato userid (email).
user_name	principal.user.email_addresses	Mappato direttamente se il valore è un indirizzo email valido.
user_sid	principal.user.windows_sid	Mappato direttamente.
verdetto	security_result.detection_fields.value	Mappatura diretta con chiave = verdict.
versione	additional.fields.value.string_value	Mappatura diretta con chiave = version.
vpn_feature_name	security_result.detection_fields.value	Mappato direttamente con chiave = vpn_feature_name.
web_client_type	security_result.detection_fields.value	Mappatura diretta con chiave = web_client_type.
	metadata.log_type	Questo campo è impostato come hardcoded su CHECKPOINT_HARMONY.
	metadata.vendor_name	Questo campo è codificato in modo permanente su CHECKPOINT_HARMONY.
	principal.asset.platform_software.platform	Mappato su WINDOWS, MAC o LINUX in base al valore del campo os_name.
	network.ip_protocol	Mappato a TCP, UDP, ICMP, IP6IN4 o GRE in base al valore del campo proto e ad altri campi come service e service_id.
	security_result.severity	Mappato a LOW, MEDIUM, HIGH o CRITICAL in base al valore del campo severity.
	metadata.event_type	Questo campo è impostato su NETWORK_CONNECTION se sono presenti sia l'entità che la destinazione, su STATUS_UNCATEGORIZED se è presente solo l'entità e su GENERIC_EVENT in caso contrario.
label	event.idm.read_only_udm.network.email.to	Mappato dal log delle modifiche
entityLink	event.idm.read_only_udm.metadata.url_back_to_product	Mappato dal log delle modifiche
actionType	event.idm.read_only_udm.security_result.action_details	Mappato dal log delle modifiche
eventId	event.idm.read_only_udm.metadata.product_log_id	Mappato dal log delle modifiche
eventCreated	event.idm.read_only_udm.metadata.event_timestamp	Mappato dal log delle modifiche
type	event.idm.read_only_udm.metadata.product_event_type	Mappato dal log delle modifiche
act.createTime	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
act.relatedEntityId	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
customerId	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
saas	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
state	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
entityId	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
connectivity_state	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
actions.actionType	event.idm.read_only_udm.security_result.action	Mappato dal log delle modifiche
senderAddress	event.idm.read_only_udm.network.email.from	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.