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 ID from the Organization Details section.
Install the Bindplane agent
Windows installation
- Open the Command Prompt or PowerShell as 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.yamlfile. 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.yamlfile 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_labelsReplace the port and IP address as required in your infrastructure.
Replace
<customer_id>with the actual customer ID.Update
/path/to/ingestion-authentication-file.jsonto 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-agentTo restart the Bindplane agent in Windows, you can either use the Services console 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 Enable log 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_commentevent.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_infoevent.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 Stateevent.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: deviceFacilityevent.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_verevent.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_updatesevent.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_scannedsec_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_timeevent.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_authorizedevent.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_idevent.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_descriptionevent.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_encryptedevent.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_manufacturerevent.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_typeevent.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_nameevent.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_dateevent.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_typeevent.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_versionevent.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_accessevent.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: sequencenumevent.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_verevent.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: versionevent.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_accessevent.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.