Collect CyberArk PAM logs
Parser Version: 11.0
This document explains how to ingest CyberArk PAM (Privileged Access Manager) logs to Google Security Operations using Bindplane. CyberArk PAM secures, manages, and monitors privileged credentials across on-premises and cloud environments. It provides a Digital Vault for storing privileged account credentials, session isolation and monitoring, automated password rotation, and detailed audit logs for all privileged access activities.
Before you begin
Make sure you have the following prerequisites:
- A Google SecOps instance.
- A Windows 2016 or later or Linux host with systemd.
- If running behind a proxy, ensure firewall ports are open per the Bindplane agent requirements.
- Privileged access to the CyberArk PAM Vault and PVWA (Password Vault Web Access) with administrative permissions.
Get Google SecOps credentials for the Bindplane agent
To authenticate the Bindplane agent to Google SecOps, choose one of the following methods:
- New deployments: Use the Chronicle API (Option 1).
- Legacy deployments: Continue using the ingestion authentication file (Option 2) until the Ingestion API is discontinued on July 20, 2027.
Option 1: Create a service account for the Chronicle API (recommended)
- Sign in to the Google Cloud console and select the Google Cloud project that is linked to your Google SecOps instance.
- Go to IAM & Admin > Service Accounts.
- Click Create service account.
- Provide the following configuration details:
- Service account name: Enter a name for the account (for example,
bindplane-ingest). - Service account description: Enter a description (for example,
Bindplane agent log ingestion).
- Service account name: Enter a name for the account (for example,
- Click Create and continue.
- In the Grant this service account access to project section, click Select a role and select Chronicle Editor.
- Click Continue, and then click Done.
- Click the service account you created, and then go to the Keys tab.
- Click Add key > Create new key.
- Select JSON and click Create. The key file is downloaded to your computer.
- Save the key file as
ingestion-auth.jsonin the Bindplane collector directory (/opt/observiq-otel-collector/ingestion-auth.jsonon Linux orC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonon Windows), or updatecreds_file_pathinconfig.yamlto match the path where you save it. - Go to IAM & Admin > Settings and copy the Project number. You'll need it for the exporter configuration.
Option 2: Download the ingestion authentication file (legacy)
- 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 the Bindplane agent 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
Install the Bindplane agent on your Windows or Linux operating system according to the following instructions.
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 this 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/opt/observiq-otel-collector/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: tcplog: # 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: <PLACEHOLDER_CUSTOMER_ID> endpoint: chronicle.googleapis.com # Add optional ingestion labels for better organization log_type: 'CYBERARK_PAM' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - tcplog exporters: - chronicle/chronicle_w_labels
- Replace the port and IP address as required in your infrastructure.
- Replace
<LOCATION>with the region of your Google SecOps instance (for example,us,europe, orasia-southeast1). The exporter prefixeschronicle.googleapis.comwith this value. - Replace
<PROJECT_NUMBER>with the project number from IAM & Admin > Settings. - Replace
<PLACEHOLDER_CUSTOMER_ID>with the actual Customer ID. - Update
/path/to/ingestion-authentication-file.jsonto the file path where the service account key file (Option 1) was saved in the Get Google SecOps credentials for the Bindplane agent section.
Legacy ingestion API exporter
If you use the ingestion authentication file from Option 2, replace the
exportersblock with the following. Setcreds_file_pathto the path to the ingestion authentication file, and if your instance is outside the US, replacemalachiteingestion-pa.googleapis.comwith your regional endpoint (for example,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: <PLACEHOLDER_CUSTOMER_ID> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization log_type: 'CYBERARK_PAM' raw_log_field: body ingestion_labels:
Restart the Bindplane agent to apply the changes
To restart the Bindplane agent in Linux, run the following command:
sudo systemctl restart observiq-otel-collectorTo restart the Bindplane agent in Windows, you can either use the Services console or enter the following command:
net stop observiq-otel-collector && net start observiq-otel-collector
Configure CyberArk PAM syslog forwarding
CyberArk PAM sends audit data to a SIEM via the Vault's syslog integration configured in the dbparm.ini file.
Configure the Vault server
- Sign in to the CyberArk Vault server with administrative privileges.
Navigate to the Vault installation directory and open the
dbparm.inifile:- Default path (Windows):
C:\Program Files (x86)\PrivateArk\Server\Conf\dbparm.ini - Default path (Linux):
/opt/CARKaim/vault/Conf/dbparm.ini
- Default path (Windows):
Add or modify the following syslog configuration parameters in
dbparm.ini:SyslogTranslatorFile=Syslog\CASP.xsl SyslogServerIP=<BINDPLANE_AGENT_IP> SyslogServerPort=514 SyslogServerProtocol=TCP SyslogMessageCodeFilter=0-999 UseSyslogFormat=Yes SyslogSendAuditAsJSON=YesReplace
<BINDPLANE_AGENT_IP>with the IP address of the Bindplane agent host (for example,192.168.1.100).
Configuration parameter reference
| Parameter | Value | Description |
|---|---|---|
SyslogTranslatorFile |
Syslog\CASP.xsl |
XSL translation file for syslog format |
SyslogServerIP |
Bindplane agent IP | IP address of the syslog receiver |
SyslogServerPort |
514 |
Port number for syslog (match Bindplane config) |
SyslogServerProtocol |
TCP |
Transport protocol (TCP recommended for reliable delivery) |
SyslogMessageCodeFilter |
0-999 |
Range of message codes to forward (0-999 = all) |
UseSyslogFormat |
Yes |
Send logs in standard syslog format |
SyslogSendAuditAsJSON |
Yes |
Send audit records in JSON format for better parsing |
Restart the Vault service
After modifying
dbparm.ini, restart the CyberArk Vault service:- Windows: Open Services console, find CyberArk Vault, right-click, and select Restart.
- Linux: Run the following command:
sudo systemctl restart vaultVerify logs are being received by checking the Bindplane agent logs:
sudo journalctl -u observiq-otel-collector -f
Configure PVWA audit logging (optional)
To forward PVWA (Password Vault Web Access) activity logs:
- Sign in to the PVWA web interface as an administrator.
- Go to Administration > Options > Audit.
- Verify that Send syslog messages is enabled.
- The PVWA uses the Vault's syslog configuration from
dbparm.ini.
For more information about CyberArk PAM syslog integration, see the CyberArk PAM documentation.
UDM mapping table
| Log Field | UDM Mapping | Logic |
|---|---|---|
Vendor |
metadata.vendor_name |
Set to "CyberArk". |
Product |
metadata.product_name |
Set to "PAM" or "Vault". |
Version |
metadata.product_version |
The CyberArk PAM version. |
MessageID |
metadata.product_event_type |
The audit action code. |
Message |
metadata.description |
The human-readable audit message. |
Severity |
security_result.severity |
Mapped from CyberArk severity level. |
Issuer |
principal.user.userid |
The user who performed the action. |
Station |
principal.ip |
The source IP address of the session. |
SourceUser |
principal.user.userid |
The source user initiating the action. |
TargetUser |
target.user.userid |
The target privileged account. |
SafeName |
target.resource.name |
The CyberArk Safe containing the credential. |
AccountName |
target.resource.attribute.labels |
The privileged account name. |
Address |
target.hostname |
The target system hostname or address. |
PolicyID |
security_result.rule_name |
The platform policy ID. |
Reason |
security_result.description |
The reason provided for the action. |
RequestID |
network.session_id |
The dual-control request ID. |
GatewayStation |
intermediary.ip |
The PSM gateway IP address. |
Timestamp |
metadata.event_timestamp |
The event timestamp. |
Command |
event.idm.read_only_udm.target.process.command_line |
Mapped from changelog |
User |
event.idm.read_only_udm.target.user.userid |
Mapped from changelog |
syslog.audit_record.TargetUser |
event.idm.read_only_udm.target.user.userid |
Mapped from changelog |
syslog.audit_record.TargetUser |
event.idm.read_only_udm.target.user.attribute.labels |
Mapped from changelog |
SrcHost |
event.idm.read_only_udm.principal.ip and event.idm.read_only_udm.principal.asset.ip |
Mapped from changelog |
DstHost |
event.idm.read_only_udm.target.ip and event.idm.read_only_udm.target.asset.ip |
Mapped from changelog |
ProcessName |
event.idm.read_only_udm.target.process.file.names |
Mapped from changelog |
SessionID |
event.idm.read_only_udm.network.session_id |
Mapped from changelog |
Protocol |
event.idm.read_only_udm.network.application_protocol |
Mapped from changelog |
syslog.audit_record.Issuer |
event.idm.read_only_udm.principal.user.userid |
Mapped from changelog |
syslog.audit_record.SourceUser |
event.idm.read_only_udm.principal.user.attribute.labels |
Mapped from changelog |
syslog.audit_record.SourceUser |
event.idm.read_only_udm.principal.user.userid |
Mapped from changelog |
syslog.audit_record.Action |
event.idm.read_only_udm.metadata.product_event_type |
Mapped from changelog |
syslog.audit_record.Version |
event.idm.read_only_udm.metadata.product_version |
Mapped from changelog |
syslog.audit_record.Severity |
event.idm.read_only_udm.security_result.severity |
Mapped from changelog |
syslog.audit_record.Severity |
event.idm.read_only_udm.security_result.severity_details |
Mapped from changelog |
syslog.audit_record.Location |
event.idm.read_only_udm.principal.location.country_or_region |
Mapped from changelog |
syslog.audit_record.Message |
event.idm.read_only_udm.security_result.description |
Mapped from changelog |
syslog.audit_record.CAProperties.CAProperty |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
format |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
syslog.audit_record.Rfc5424 |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
syslog.audit_record.Timestamp |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
syslog.audit_record.IsoTimestamp |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
syslog.audit_record.Hostname |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
syslog.audit_record.Vendor |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
syslog.audit_record.Product |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
syslog.audit_record.RequestId |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
version |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
PSMID |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
cs2 |
event.idm.read_only_udm.target.resource.name |
Mapped from changelog |
event_data.created |
event.idm.read_only_udm.metadata.collected_timestamp |
Mapped from changelog |
host |
event.idm.read_only_udm.intermediary.hostname and event.idm.read_only_udm.intermediary.asset.hostname |
Mapped from changelog |
dvc |
event.idm.read_only_udm.intermediary.asset.ip |
Mapped from changelog |
dvc |
event.idm.read_only_udm.intermediary.hostname and event.idm.read_only_udm.intermediary.asset.hostname |
Mapped from changelog |
PSMID |
event.idm.read_only_udm.principal.hostname |
Mapped from changelog |
PSMID |
event.idm.read_only_udm.principal.asset.hostname |
Mapped from changelog |
GatewayStation |
event.idm.read_only_udm.target.ip |
Mapped from changelog |
GatewayStation |
event.idm.read_only_udm.target.asset.ip |
Mapped from changelog |
reason |
event.idm.read_only_udm.target.process.file.full_path |
Mapped from changelog |
ApplicationType |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
RDPOffset |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
VIDOffset |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
ConnectionComponentId |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
ProcessId |
event.idm.read_only_udm.target.process.pid |
Mapped from changelog |
leef_version |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
leef_event_id |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
inter_host |
event.idm.read_only_udm.intermediary.hostname |
Mapped from changelog |
EventMessage |
event.idm.read_only_udm.metadata.description |
Mapped from changelog |
src |
event.idm.read_only_udm.principal.ip and event.idm.read_only_udm.principal.asset.ip |
Mapped from changelog |
usrName |
event.idm.read_only_udm.principal.user.userid |
Mapped from changelog |
Reason |
event.idm.read_only_udm.security_result.action_details |
Mapped from changelog |
Category |
event.idm.read_only_udm.security_result.category_details |
Mapped from changelog |
sev |
event.idm.read_only_udm.security_result.severity and event.idm.read_only_udm.security_result.severity_details |
Mapped from changelog |
address |
event.idm.read_only_udm.target.hostname and event.idm.read_only_udm.target.asset.hostname |
Mapped from changelog |
Safe |
event.idm.read_only_udm.target.resource.name |
Mapped from changelog |
username |
event.idm.read_only_udm.target.user.user_display_name |
Mapped from changelog |
logondomain |
event.idm.read_only_udm.principal.administrative_domain |
Mapped from changelog |
devicetype |
event.idm.read_only_udm.principal.resource.resource_subtype |
Mapped from changelog |
header_host |
event.idm.read_only_udm.src.hostname |
Mapped from changelog |
Ticket_ID |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
Ticketing_System |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
Ticketing_Audit_Safe |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
Action |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
msg |
event.idm.read_only_udm.security_result.description |
Mapped from changelog |
name |
event.idm.read_only_udm.principal.resource.name |
Mapped from changelog |
policyid |
event.idm.read_only_udm.security_result.detection_fields |
Mapped from changelog |
msg |
event.idm.read_only_udm.metadata.description |
Mapped from changelog |
actionType |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
action |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
auditType |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.app_id |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.end_time |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.is_internal_application |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.scopes |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.start_time |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.token_type |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.user_guid |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
identityType |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
tenantId |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
component |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
serviceName |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.DPA.ephemeral_user |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.DPA.access_method |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.DPA.assigned_domain_groups |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.DPA.assigned_groups |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.DPA.authentication_methods |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.DPA.connection_string |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.DPA.maximum_session_duration |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.deny_by_user |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.mfa_reason |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.factors |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.auth_method |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.entity_type |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
customData.mfa_initiator |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
safe |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
cloudAssets |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
cloudIdentities |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
cloudResources |
event.idm.read_only_udm.additional.fields |
Mapped from changelog |
applicationCode |
event.idm.read_only_udm.target.application |
Mapped from changelog |
auditCode |
event.idm.read_only_udm.security_result.detection_fields |
Mapped from changelog |
userId |
event.idm.read_only_udm.principal.user.userid |
Mapped from changelog |
username |
event.idm.read_only_udm.principal.user.user_display_name |
Mapped from changelog |
cloudProvider |
event.idm.read_only_udm.principal.cloud.environment |
Mapped from changelog |
customData.client |
event.idm.read_only_udm.principal.user.attribute.labels |
Mapped from changelog |
uuid |
event.idm.read_only_udm.metadata.product_log_id |
Mapped from changelog |
timestamp |
event.idm.read_only_udm.metadata.event_timestamp |
Mapped from changelog |
source |
event.idm.read_only_udm.principal.ip |
Mapped from changelog |
source |
event.idm.read_only_udm.principal.asset.ip |
Mapped from changelog |
accessMethod |
event.idm.read_only_udm.extensions.auth.auth_details |
Mapped from changelog |
accountId |
event.idm.read_only_udm.principal.user.product_object_id |
Mapped from changelog |
sessionId |
event.idm.read_only_udm.network.session_id |
Mapped from changelog |
target |
event.idm.read_only_udm.target.hostname |
Mapped from changelog |
target |
event.idm.read_only_udm.target.asset.hostname |
Mapped from changelog |
targetPlatform |
event.idm.read_only_udm.target.labels |
Mapped from changelog |
customData.DPA.source_hostname |
event.idm.read_only_udm.principal.hostname |
Mapped from changelog |
customData.DPA.source_hostname |
event.idm.read_only_udm.principal.asset.hostname |
Mapped from changelog |
customData.DPA.source_user |
event.idm.read_only_udm.principal.user.attributes.labels |
Mapped from changelog |
customData.DPA.target_machine |
event.idm.read_only_udm.target.labels |
Mapped from changelog |
customData.entity_name |
event.idm.read_only_udm.principal.hostname |
Mapped from changelog |
customData.entity_name |
event.idm.read_only_udm.principal.asset.hostname |
Mapped from changelog |
customData.geoip_latitude |
event.idm.read_only_udm.principal.location.region_latitude |
Mapped from changelog |
customData.geoip_longitude |
event.idm.read_only_udm.principal.location.region_longitude |
Mapped from changelog |
customData.geoip_city_name |
event.idm.read_only_udm.principal.location.city |
Mapped from changelog |
customData.mfa_result |
event.idm.read_only_udm.security_result.action |
Mapped from changelog |
customData.geoip_country_name |
event.idm.read_only_udm.principal.location.country_or_region |
Mapped from changelog |
customData.request_device_os |
event.idm.read_only_udm.principal.asset.platform_software.platform |
Mapped from changelog |
customData.request_broswer_name |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mapped from changelog |
customData.geoip_country_code |
event.idm.read_only_udm.principal.resource.attribute.labels |
Mapped from changelog |
accountName |
event.idm.read_only_udm.principal.user.attribute.labels |
Mapped from changelog |
targetAccount |
event.idm.read_only_udm.target.user.userid |
Mapped from changelog |
customData.PAM.new_target |
event.idm.read_only_udm.target.user.attribute.labels |
Mapped from changelog |
customData.PAM.target |
event.idm.read_only_udm.target.file.full_path |
Mapped from changelog |
customData.directory_service_id |
event.idm.read_only_udm.principal.user.attribute.labels |
Mapped from changelog |
customData.user_id |
event.idm.read_only_udm.principal.user.attribute.labels |
Mapped from changelog |
customData.user_name |
event.idm.read_only_udm.principal.user.attribute.labels |
Mapped from changelog |
customData.mfa_initiator |
event.idm.read_only_udm.extensions.auth.type |
Mapped from changelog |
signature_id |
metadata.product_event_type |
Mapped from changelog |
app |
target.application |
Mapped from changelog |
Change Log
View the Change Log for this parser
Need more help? Get answers from Community members and Google SecOps professionals.