Collect Check Point EDR logs
This document explains how to ingest Check Point Antivirus logs to Google Security Operations using Bindplane. The parser handles logs from Check Point SandBlast, converting both SYSLOG + KV and SYSLOG + CEF formatted logs into the Unified Data Model (UDM). The parser extracts fields from CEF messages using included modules and maps them to UDM fields, handling various event types and enriching the data with additional context from the raw logs. For non-CEF messages, the parser uses key-value extraction, grok patterns, and conditional logic to map relevant fields to the EDR UDM schema.
Before you begin
Make sure you have the following prerequisites:
- Google SecOps instance
- Windows 2016 or later, or a Linux host with
systemd
- If running behind a proxy, firewall ports are open
- Privileged access to Check Point Appliance with SandBlast
Get Google SecOps ingestion authentication file
- Sign in to the Google SecOps console.
- Go to SIEM Settings > Collection Agents.
- Download the Ingestion Authentication File. Save the file securely on the system where Bindplane will be installed.
Get Google SecOps customer ID
- Sign in to the Google SecOps console.
- Go to SIEM Settings > Profile.
- Copy and save the Customer IDfrom the Organization Detailssection.
Install the Bindplane agent
Windows installation
- Open the Command Promptor PowerShellas an administrator.
-
Run the following command:
msiexec / i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" / quiet
Linux installation
- Open a terminal with root or sudo privileges.
-
Run the following command:
sudo sh -c " $( curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh ) " install_unix.sh
Additional installation resources
For additional installation options, consult the installation guide .
Configure the Bindplane agent to ingest Syslog and send to Google SecOps
- Access the configuration file:
- Locate the
config.yaml
file. Typically, it's in the/etc/bindplane-agent/
directory on Linux or in the installation directory on Windows. - Open the file using a text editor (for example,
nano
,vi
, or Notepad).
- Locate the
-
Edit the
config.yaml
file as follows: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 : '/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 : 'CHECKPOINT_EDR' raw_log_field : body service : pipelines : logs/source0__chronicle_w_labels-0 : receivers : - udplog exporters : - chronicle/chronicle_w_labels
-
Replace the port and IP address as required in your infrastructure.
-
Replace
<customer_id>
with the actual customer ID. -
Update
/path/to/ingestion-authentication-file.json
to the path where the authentication file was saved in the Get Google SecOps ingestion authentication file section.
Restart the BindPlane agent to apply the changes
-
To restart the Bindplane agent in Linux, run the following command:
sudo systemctl restart bindplane-agent
-
To restart the Bindplane agent in Windows, you can either use the Servicesconsole or enter the following command:
net stop BindPlaneAgent && net start BindPlaneAgent
Configure Syslog in Checkpoint 1500 Appliance Series
- Sign in to the Checkpoint Appliance.
- Go to Logs & Monitoring > Log Servers > Syslog Servers.
- Click Configure.
- Provide the following configuration details:
- Protocol: Select UDP.
- Name: Enter a descriptive name.
- IP Address: Enter the Bindplane agent IP address.
- Port: Enter the Bindplane agent port number.
- Select Enablelog server.
- Select logs to forward: Both system and security logs.
- Click Apply.
UDM mapping table
Log Field | UDM Mapping | Logic |
---|---|---|
action
|
event.idm.read_only_udm.security_result.action
|
Directly mapped from the action
CEF field. |
action_comment
|
event.idm.read_only_udm.additional.fields[<N>].key
: action_comment
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of action_comment
|
Directly mapped from the action_comment
field. |
action_details
|
event.idm.read_only_udm.security_result.action_details
|
Directly mapped from the action_details
CEF field. |
additional_info
|
event.idm.read_only_udm.additional.fields[<N>].key
: additional_info
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of additional_info
|
Directly mapped from the additional_info
field. |
am_update_proxy
|
event.idm.read_only_udm.intermediary.domain.name
|
Directly mapped from the am_update_proxy
field. |
am_update_source
|
event.idm.read_only_udm.target.url
|
Directly mapped from the am_update_source
field. |
client_version
|
event.idm.read_only_udm.metadata.product_version
|
Directly mapped from the client_version
field. |
cn1
|
event.idm.read_only_udm.security_result.severity
|
Mapped from the cn1
CEF field and converted to UDM severity values (CRITICAL, HIGH, MEDIUM, LOW, INFO). |
cs1
|
event.idm.read_only_udm.additional.fields[<N>].key
: Connectivity State
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of cs1
|
Directly mapped from the cs1
field. |
description
|
event.idm.read_only_udm.metadata.description
|
Directly mapped from the description
CEF field. |
deviceDirection
|
event.idm.read_only_udm.network.direction
|
Mapped from the deviceDirection
field. A value of 0
is mapped to INBOUND
, other values are not mapped. |
deviceFacility
|
event.idm.read_only_udm.additional.fields[<N>].key
: deviceFacility
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of deviceFacility
|
Directly mapped from the deviceFacility
field. |
dst
|
event.idm.read_only_udm.network.target.ip
|
Directly mapped from the dst
field when event_type
is Firewall
. |
engine_ver
|
event.idm.read_only_udm.additional.fields[<N>].key
: engine_ver
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of engine_ver
|
Directly mapped from the engine_ver
field. |
ep_rule_id
|
event.idm.read_only_udm.firewall.firewall_rule_id
|
Directly mapped from the ep_rule_id
field when event_type
is Firewall
. |
event_type
|
event.idm.read_only_udm.metadata.product_event_type
|
Directly mapped from the event_type
CEF field. |
failed_updates
|
event.idm.read_only_udm.additional.fields[<N>].key
: failed_updates
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of failed_updates
|
Directly mapped from the failed_updates
field. |
file_md5
|
event.idm.read_only_udm.source_file.hash_md5
|
Directly mapped from the file_md5
field when event_type
is TE Event
. |
file_name
|
event.idm.read_only_udm.source_file.file_name
|
Directly mapped from the file_name
field when event_type
is TE Event
. |
file_sha1
|
event.idm.read_only_udm.source_file.hash_sha1
|
Directly mapped from the file_sha1
field when event_type
is TE Event
. |
file_sha256
|
event.idm.read_only_udm.source_file.hash_sha256
|
Directly mapped from the file_sha256
field when event_type
is TE Event
. |
host_type
|
event.idm.read_only_udm.principal.asset.type
|
Mapped from the host_type
field. Desktop
is converted to WORKSTATION
, then the value is uppercased. |
ifdir
|
event.idm.read_only_udm.network.direction
|
Directly mapped from the ifdir
field and uppercased when event_type
is Firewall
. |
installed_products
|
event.idm.read_only_udm.principal.asset.software.name
|
Directly mapped from the installed_products
field. |
is_scanned
|
sec_res.detection_fields[<N>].key
: is_scanned
sec_res.detection_fields[<N>].value
: Value of is_scanned
|
Directly mapped from the is_scanned
field. |
local_time
|
event.idm.read_only_udm.additional.fields[<N>].key
: local_time
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of local_time
|
Directly mapped from the local_time
field. |
log_type
|
event.idm.read_only_udm.metadata.log_type
|
Directly mapped from the log_type
field. |
loguid
|
event.idm.read_only_udm.metadata.product_log_id
|
Directly mapped from the loguid
field. |
machine_guid
|
event.idm.read_only_udm.principal.asset.product_object_id
|
Directly mapped from the machine_guid
field. |
media_authorized
|
event.idm.read_only_udm.additional.fields[<N>].key
: media_authorized
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of media_authorized
|
Directly mapped from the media_authorized
field. |
media_class_id
|
event.idm.read_only_udm.additional.fields[<N>].key
: media_class_id
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of media_class_id
|
Directly mapped from the media_class_id
field. |
media_description
|
event.idm.read_only_udm.additional.fields[<N>].key
: media_description
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of media_description
|
Directly mapped from the media_description
field. |
media_encrypted
|
event.idm.read_only_udm.additional.fields[<N>].key
: media_encrypted
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of media_encrypted
|
Directly mapped from the media_encrypted
field. |
media_manufacturer
|
event.idm.read_only_udm.additional.fields[<N>].key
: media_manufacturer
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of media_manufacturer
|
Directly mapped from the media_manufacturer
field. |
media_type
|
event.idm.read_only_udm.additional.fields[<N>].key
: media_type
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of media_type
|
Directly mapped from the media_type
field. |
msg
|
event.idm.read_only_udm.metadata.description
|
Directly mapped from the msg
CEF field. |
origin
|
event.idm.read_only_udm.about.ip
|
Directly mapped from the origin
CEF field. |
os_name
|
event.idm.read_only_udm.additional.fields[<N>].key
: os_name
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of os_name
|
Directly mapped from the os_name
field. |
os_version
|
event.idm.read_only_udm.principal.asset.platform_software.platform_version
|
Directly mapped from the os_version
field. |
policy_date
|
event.idm.read_only_udm.additional.fields[<N>].key
: policy_date
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of policy_date
|
Directly mapped from the policy_date
field. |
policy_guid
|
event.idm.read_only_udm.principal.resource.product_object_id
|
Directly mapped from the policy_guid
field. |
policy_name
|
event.idm.read_only_udm.principal.resource.name
|
Directly mapped from the policy_name
field. |
policy_number
|
event.idm.read_only_udm.principal.resource.product_object_id
|
Directly mapped from the policy_number
field. |
policy_type
|
event.idm.read_only_udm.additional.fields[<N>].key
: policy_type
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of policy_type
|
Directly mapped from the policy_type
field. |
policy_version
|
event.idm.read_only_udm.additional.fields[<N>].key
: policy_version
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of policy_version
|
Directly mapped from the policy_version
field. |
product
|
event.idm.read_only_udm.metadata.product_name
|
Directly mapped from the product
CEF field. |
proto
|
event.idm.read_only_udm.network.protocol
|
Directly mapped from the proto
field when event_type
is Firewall
. |
reading_data_access
|
event.idm.read_only_udm.additional.fields[<N>].key
: reading_data_access
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of reading_data_access
|
Directly mapped from the reading_data_access
field. |
requestClientApplication
|
event.idm.read_only_udm.network.http.user_agent
|
Directly mapped from the requestClientApplication
field. |
result
|
event.idm.read_only_udm.security_result.summary
|
Directly mapped from the result
field. |
rt
|
event.idm.read_only_udm.metadata.event_timestamp.seconds
|
Mapped from the rt
field, divided by 1000, and the integer part is taken as seconds. |
rule_name
|
event.idm.read_only_udm.firewall.firewall_rule
|
Directly mapped from the rule_name
field when event_type
is Firewall
. |
s_port
|
event.idm.read_only_udm.network.client.port
|
Directly mapped from the s_port
field when event_type
is Firewall
. |
sequencenum
|
event.idm.read_only_udm.additional.fields[<N>].key
: sequencenum
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of sequencenum
|
Directly mapped from the sequencenum
field. |
service
|
event.idm.read_only_udm.network.target.port
|
Directly mapped from the service
field when event_type
is Firewall
. |
severity
|
event.idm.read_only_udm.security_result.severity
|
Mapped from the severity
field and converted to UDM severity values (CRITICAL, HIGH, MEDIUM, LOW, INFO). |
shost
|
event.idm.read_only_udm.principal.hostname
|
Directly mapped from the shost
CEF field. |
sig_ver
|
event.idm.read_only_udm.additional.fields[<N>].key
: sig_ver
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of sig_ver
|
Directly mapped from the sig_ver
field. |
src
|
event.idm.read_only_udm.principal.ip
|
Directly mapped from the src
CEF field. |
src_machine_name
|
event.idm.read_only_udm.principal.hostname
|
Directly mapped from the src_machine_name
field when event_type
is empty. |
subject
|
event.idm.read_only_udm.task.task_name
|
Directly mapped from the subject
field when event_type
is empty. |
suser
|
event.idm.read_only_udm.principal.user.user_display_name
|
Directly mapped from the suser
CEF field. |
time
|
event.idm.read_only_udm.metadata.event_timestamp.seconds
|
Directly mapped from the time
field and converted to Unix epoch seconds. |
user_name
|
event.idm.read_only_udm.principal.user.email_addresses
|
Directly mapped from the user_name
CEF field. |
user_sid
|
event.idm.read_only_udm.principal.user.windows_sid
|
Directly mapped from the user_sid
field. |
version
|
event.idm.read_only_udm.additional.fields[<N>].key
: version
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of version
|
Directly mapped from the version
field. |
writing_data_access
|
event.idm.read_only_udm.additional.fields[<N>].key
: writing_data_access
event.idm.read_only_udm.additional.fields[<N>].value.string_value
: Value of writing_data_access
|
Directly mapped from the writing_data_access
field. |
N/A
|
event.idm.read_only_udm.metadata.event_type
|
Set to GENERIC_EVENT
if none of principal.ip
, principal.hostname
, or principal.mac
are present in the raw log, otherwise set to STATUS_UPDATE
. |
N/A
|
event.idm.read_only_udm.metadata.vendor_name
|
Constant value: Check Point
. |
N/A
|
event.idm.read_only_udm.metadata.log_type
|
Constant value: CHECKPOINT_EDR
. |
N/A
|
event.idm.read_only_udm.principal.asset.platform_software.platform
|
Set to WINDOWS
if os_name
contains WINDOWS
or Windows
. |
N/A
|
event.idm.read_only_udm.network.http.user_agent
|
Set to Check Point Endpoint Security Client
if requestClientApplication
is present. |
N/A
|
event.edr.data_source
|
Constant value: CHECKPOINT_SANDBLAST
when message
doesn't contain CEF
. |
Need more help? Get answers from Community members and Google SecOps professionals.