Beta feature
This functionality is in beta and is subject to change. The design and code is less mature than official generally available features and is being provided as-is with no warranties. Beta features are not subject to the support service level agreement of official generally available features.
What is an Elastic integration?

This integration is powered by Elastic Agent. Elastic Agent is a single, unified way to add monitoring for logs, metrics, and other types of data to a host. It can also protect hosts from security threats, query data from operating systems, forward data from remote services or hardware, and more. Refer to our documentation for a detailed comparison between Beats and Elastic Agent.

Prefer to use Beats for this use case? See Filebeat modules for logs or Metricbeat modules for metrics.

Overview

CyberArk's Privileged Threat Analytics (PTA) continuously monitors the use of privileged accounts that are managed in the CyberArk Privileged Access Security (PAS) platform. This integration collects analytics from PTA's syslog via CEF-formatted logs.

Configuration

Follow the steps described under Send PTA syslog records to SIEM documentation to setup the integration:

  • Sample syslog configuration for systemparm.properties:
[SYSLOG]
syslog_outbound=[{"siem": "Elastic", "format": "CEF", "host": "SIEM_MACHINE_ADDRESS", "port": 9301, "protocol": "TCP"}]

Example event

An example event for pta looks as following:

{
  "cef": {
    "device": {
      "event_class_id": "1",
      "product": "PTA",
      "vendor": "CyberArk",
      "version": "12.6"
    },
    "extensions": {
      "destinationAddress": "175.16.199.0",
      "destinationHostName": "dev1.domain.com",
      "destinationUserName": "andy@dev1.domain.com",
      "deviceCustomDate1": "2014-01-01T12:05:00.000Z",
      "deviceCustomDate1Label": "detectionDate",
      "deviceCustomString1": "None",
      "deviceCustomString1Label": "ExtraData",
      "deviceCustomString2": "52b06812ec3500ed864c461e",
      "deviceCustomString2Label": "EventID",
      "deviceCustomString3": "https://1.128.0.0/incidents/52b06812ec3500ed864c461e",
      "deviceCustomString3Label": "PTAlink",
      "deviceCustomString4": "https://myexternallink.com",
      "deviceCustomString4Label": "ExternalLink",
      "sourceAddress": "1.128.0.0",
      "sourceHostName": "prod1.domain.com",
      "sourceUserName": "mike2@prod1.domain.com"
    },
    "name": "Suspected credentials theft",
    "severity": "8",
    "version": "0"
  },
  "destination": {
    "domain": "dev1.domain.com",
    "ip": "175.16.199.0",
    "user": {
      "name": "andy@dev1.domain.com"
    }
  },
  "ecs": {
    "version": "8.3.0"
  },
  "event": {
    "code": "1",
    "created": [
      "2014-01-01T12:05:00.000Z"
    ],
    "id": [
      "52b06812ec3500ed864c461e"
    ],
    "ingested": "2022-07-28T14:05:49Z",
    "original": "CEF:0|CyberArk|PTA|12.6|1|Suspected credentials theft|8|suser=mike2@prod1.domain.com shost=prod1.domain.com src=1.128.0.0 duser=andy@dev1.domain.com dhost=dev1.domain.com dst=175.16.199.0 cs1Label=ExtraData cs1=None cs2Label=EventID cs2=52b06812ec3500ed864c461e deviceCustomDate1Label=detectionDate deviceCustomDate1=1388577900000 cs3Label=PTAlink cs3=https://1.128.0.0/incidents/52b06812ec3500ed864c461e cs4Label=ExternalLink cs4=https://myexternallink.com",
    "reference": [
      "https://1.128.0.0/incidents/52b06812ec3500ed864c461e"
    ],
    "severity": 8,
    "url": [
      "https://myexternallink.com"
    ]
  },
  "message": "Suspected credentials theft",
  "observer": {
    "product": "PTA",
    "vendor": "CyberArk",
    "version": "12.6"
  },
  "source": {
    "domain": "prod1.domain.com",
    "ip": "1.128.0.0",
    "user": {
      "name": "mike2@prod1.domain.com"
    }
  },
  "tags": [
    "cyberark_pta",
    "forwarded"
  ]
}

Exported fields

Exported fields

FieldDescriptionType
@timestamp
Event timestamp.
date
cef.device.event_class_id
Unique identifier of the event type.
keyword
cef.device.product
Product of the device that produced the message.
keyword
cef.device.vendor
Vendor of the device that produced the message.
keyword
cef.device.version
Version of the product that produced the message.
keyword
cef.extensions.TrendMicroDsDetectionConfidence
keyword
cef.extensions.TrendMicroDsFileMD5
keyword
cef.extensions.TrendMicroDsFileSHA1
keyword
cef.extensions.TrendMicroDsFileSHA256
keyword
cef.extensions.TrendMicroDsFrameType
keyword
cef.extensions.TrendMicroDsMalwareTarget
keyword
cef.extensions.TrendMicroDsMalwareTargetType
keyword
cef.extensions.TrendMicroDsPacketData
keyword
cef.extensions.TrendMicroDsRelevantDetectionNames
keyword
cef.extensions.TrendMicroDsTenant
keyword
cef.extensions.TrendMicroDsTenantId
keyword
cef.extensions.ad
flattened
cef.extensions.agentAddress
The IP address of the ArcSight connector that processed the event.
ip
cef.extensions.agentHostName
The hostname of the ArcSight connector that processed the event.
keyword
cef.extensions.agentId
The agent ID of the ArcSight connector that processed the event.
keyword
cef.extensions.agentMacAddress
The MAC address of the ArcSight connector that processed the event.
keyword
cef.extensions.agentReceiptTime
The time at which information about the event was received by the ArcSight connector.
date
cef.extensions.agentTimeZone
The agent time zone of the ArcSight connector that processed the event.
keyword
cef.extensions.agentType
The agent type of the ArcSight connector that processed the event.
keyword
cef.extensions.agentVersion
The version of the ArcSight connector that processed the event.
keyword
cef.extensions.agentZoneURI
keyword
cef.extensions.aggregationType
keyword
cef.extensions.applicationProtocol
Application level protocol, example values are HTTP, HTTPS, SSHv2, Telnet, POP, IMPA, IMAPS, and so on.
keyword
cef.extensions.assetCriticality
keyword
cef.extensions.baseEventCount
A count associated with this event. How many times was this same event observed? Count can be omitted if it is 1.
long
cef.extensions.bytesIn
Number of bytes transferred inbound, relative to the source to destination relationship, meaning that data was flowing from source to destination.
long
cef.extensions.bytesOut
Number of bytes transferred outbound relative to the source to destination relationship. For example, the byte number of data flowing from the destination to the source.
long
cef.extensions.categoryBehavior
Action or a behavior associated with an event. It's what is being done to the object (ArcSight).
keyword
cef.extensions.categoryDeviceGroup
General device group like Firewall (ArcSight).
keyword
cef.extensions.categoryDeviceType
Device type. Examples - Proxy, IDS, Web Server (ArcSight).
keyword
cef.extensions.categoryObject
Object that the event is about. For example it can be an operating sytem, database, file, etc (ArcSight).
keyword
cef.extensions.categoryOutcome
Outcome of the event (e.g. sucess, failure, or attempt) (ArcSight).
keyword
cef.extensions.categorySignificance
Characterization of the importance of the event (ArcSight).
keyword
cef.extensions.categoryTechnique
Technique being used (e.g. /DoS) (ArcSight).
keyword
cef.extensions.cp_app_risk
keyword
cef.extensions.cp_severity
keyword
cef.extensions.destinationAddress
Identifies the destination address that the event refers to in an IP network. The format is an IPv4 address.
ip
cef.extensions.destinationHostName
Identifies the destination that an event refers to in an IP network. The format should be a fully qualified domain name (FQDN) associated with the destination node, when a node is available.
keyword
cef.extensions.destinationMacAddress
Six colon-separated hexadecimal numbers.
keyword
cef.extensions.destinationNtDomain
Outcome of the event (e.g. sucess, failure, or attempt) (ArcSight).
keyword
cef.extensions.destinationPort
The valid port numbers are between 0 and 65535.
long
cef.extensions.destinationServiceName
The service targeted by this event.
keyword
cef.extensions.destinationTranslatedAddress
Identifies the translated destination that the event refers to in an IP network.
ip
cef.extensions.destinationTranslatedPort
Port after it was translated; for example, a firewall. Valid port numbers are 0 to 65535.
long
cef.extensions.destinationUserName
Identifies the destination user by name. This is the user associated with the event's destination. Email addresses are often mapped into the UserName fields. The recipient is a candidate to put into this field.
keyword
cef.extensions.destinationUserPrivileges
The typical values are "Administrator", "User", and "Guest". This identifies the destination user's privileges. In UNIX, for example, activity executed on the root user would be identified with destinationUser Privileges of "Administrator".
keyword
cef.extensions.deviceAction
Action taken by the device.
keyword
cef.extensions.deviceAddress
Identifies the device address that an event refers to in an IP network.
ip
cef.extensions.deviceAssetId
keyword
cef.extensions.deviceCustomDate1
One of two timestamp fields available to map fields that do not apply to any other in this dictionary.
keyword
cef.extensions.deviceCustomDate1Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomDate2
One of two timestamp fields available to map fields that do not apply to any other in this dictionary.
keyword
cef.extensions.deviceCustomDate2Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomIPv6Address1
One of four IPv6 address fields available to map fields that do not apply to any other in this dictionary.
ip
cef.extensions.deviceCustomIPv6Address1Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomIPv6Address2
One of four IPv6 address fields available to map fields that do not apply to any other in this dictionary.
ip
cef.extensions.deviceCustomIPv6Address2Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomIPv6Address3
One of four IPv6 address fields available to map fields that do not apply to any other in this dictionary.
ip
cef.extensions.deviceCustomIPv6Address3Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomIPv6Address4
One of four IPv6 address fields available to map fields that do not apply to any other in this dictionary.
ip
cef.extensions.deviceCustomIPv6Address4Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomNumber1
One of three number fields available to map fields that do not apply to any other in this dictionary. Use sparingly and seek a more specific, dictionary supplied field when possible.
long
cef.extensions.deviceCustomNumber1Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomNumber2
One of three number fields available to map fields that do not apply to any other in this dictionary. Use sparingly and seek a more specific, dictionary supplied field when possible.
long
cef.extensions.deviceCustomNumber2Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomNumber3
One of three number fields available to map fields that do not apply to any other in this dictionary. Use sparingly and seek a more specific, dictionary supplied field when possible.
long
cef.extensions.deviceCustomNumber3Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomString1
One of six strings available to map fields that do not apply to any other in this dictionary. Use sparingly and seek a more specific, dictionary supplied field when possible.
keyword
cef.extensions.deviceCustomString1Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomString2
One of six strings available to map fields that do not apply to any other in this dictionary. Use sparingly and seek a more specific, dictionary supplied field when possible.
keyword
cef.extensions.deviceCustomString2Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomString3
One of six strings available to map fields that do not apply to any other in this dictionary. Use sparingly and seek a more specific, dictionary supplied field when possible.
keyword
cef.extensions.deviceCustomString3Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomString4
One of six strings available to map fields that do not apply to any other in this dictionary. Use sparingly and seek a more specific, dictionary supplied field when possible.
keyword
cef.extensions.deviceCustomString4Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomString5
One of six strings available to map fields that do not apply to any other in this dictionary. Use sparingly and seek a more specific, dictionary supplied field when possible.
keyword
cef.extensions.deviceCustomString5Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceCustomString6
One of six strings available to map fields that do not apply to any other in this dictionary. Use sparingly and seek a more specific, dictionary supplied field when possible.
keyword
cef.extensions.deviceCustomString6Label
All custom fields have a corresponding label field. Each of these fields is a string and describes the purpose of the custom field.
keyword
cef.extensions.deviceDirection
Any information about what direction the observed communication has taken. The following values are supported - "0" for inbound or "1" for outbound.
long
cef.extensions.deviceEventCategory
Represents the category assigned by the originating device. Devices often use their own categorization schema to classify event. Example "/Monitor/Disk/Read".
keyword
cef.extensions.deviceExternalId
A name that uniquely identifies the device generating this event.
keyword
cef.extensions.deviceFacility
The facility generating this event. For example, Syslog has an explicit facility associated with every event.
keyword
cef.extensions.deviceHostName
The format should be a fully qualified domain name (FQDN) associated with the device node, when a node is available.
keyword
cef.extensions.deviceInboundInterface
Interface on which the packet or data entered the device.
keyword
cef.extensions.deviceOutboundInterface
Interface on which the packet or data left the device.
keyword
cef.extensions.deviceProcessName
Process name associated with the event. An example might be the process generating the syslog entry in UNIX.
keyword
cef.extensions.deviceReceiptTime
The time at which the event related to the activity was received. The format is MMM dd yyyy HH:mm:ss or milliseconds since epoch (Jan 1st 1970)
keyword
cef.extensions.deviceSeverity
keyword
cef.extensions.deviceTimeZone
The time zone for the device generating the event.
keyword
cef.extensions.deviceZoneID
keyword
cef.extensions.deviceZoneURI
Thee URI for the Zone that the device asset has been assigned to in ArcSight.
keyword
cef.extensions.dvc
This field is used by Trend Micro if the hostname is an IPv4 address.
ip
cef.extensions.dvchost
This field is used by Trend Micro for hostnames and IPv6 addresses.
keyword
cef.extensions.eventAnnotationAuditTrail
keyword
cef.extensions.eventAnnotationEndTime
date
cef.extensions.eventAnnotationFlags
keyword
cef.extensions.eventAnnotationManagerReceiptTime
date
cef.extensions.eventAnnotationModificationTime
date
cef.extensions.eventAnnotationStageUpdateTime
date
cef.extensions.eventAnnotationVersion
keyword
cef.extensions.eventId
This is a unique ID that ArcSight assigns to each event.
long
cef.extensions.fileHash
Hash of a file.
keyword
cef.extensions.filePath
Full path to the file, including file name itself.
keyword
cef.extensions.fileSize
Size of the file.
long
cef.extensions.fileType
Type of file (pipe, socket, etc.)
keyword
cef.extensions.filename
Name of the file only (without its path).
keyword
cef.extensions.ifname
keyword
cef.extensions.inzone
keyword
cef.extensions.layer_name
keyword
cef.extensions.layer_uuid
keyword
cef.extensions.locality
keyword
cef.extensions.logid
keyword
cef.extensions.loguid
keyword
cef.extensions.managerReceiptTime
When the Arcsight ESM received the event.
date
cef.extensions.match_id
keyword
cef.extensions.message
An arbitrary message giving more details about the event. Multi-line entries can be produced by using \n as the new line separator.
keyword
cef.extensions.method
HTTP request method. The value should retain its casing from the original event. For example, GET, get, and GeT are all considered valid values for this field.
keyword
cef.extensions.modelConfidence
keyword
cef.extensions.nat_addtnl_rulenum
keyword
cef.extensions.nat_rulenum
keyword
cef.extensions.oldFileHash
Hash of the old file.
keyword
cef.extensions.origin
keyword
cef.extensions.originalAgentAddress
keyword
cef.extensions.originalAgentHostName
keyword
cef.extensions.originalAgentId
keyword
cef.extensions.originalAgentType
keyword
cef.extensions.originalAgentVersion
keyword
cef.extensions.originalAgentZoneURI
keyword
cef.extensions.originsicname
keyword
cef.extensions.outzone
keyword
cef.extensions.parent_rule
keyword
cef.extensions.priority
keyword
cef.extensions.product
keyword
cef.extensions.relevance
keyword
cef.extensions.repeatCount
keyword
cef.extensions.requestContext
Description of the content from which the request originated (for example, HTTP Referrer).
keyword
cef.extensions.requestMethod
The HTTP method used to access a URL.
keyword
cef.extensions.requestUrl
In the case of an HTTP request, this field contains the URL accessed. The URL should contain the protocol as well.
keyword
cef.extensions.requestUrlFileName
keyword
cef.extensions.rule_action
keyword
cef.extensions.rule_uid
keyword
cef.extensions.sequencenum
keyword
cef.extensions.service_id
keyword
cef.extensions.severity
keyword
cef.extensions.sourceAddress
Identifies the source that an event refers to in an IP network.
ip
cef.extensions.sourceGeoLatitude
long
cef.extensions.sourceGeoLongitude
long
cef.extensions.sourceHostName
Identifies the source that an event refers to in an IP network. The format should be a fully qualified domain name (FQDN) associated with the source node, when a mode is available.
keyword
cef.extensions.sourceMacAddress
Six colon-separated hexadecimal numbers.
keyword
cef.extensions.sourceNtDomain
The Windows domain name for the source address.
keyword
cef.extensions.sourcePort
The valid port numbers are 0 to 65535.
long
cef.extensions.sourceServiceName
The service that is responsible for generating this event.
keyword
cef.extensions.sourceTranslatedAddress
Identifies the translated source that the event refers to in an IP network.
ip
cef.extensions.sourceTranslatedPort
A port number after being translated by, for example, a firewall. Valid port numbers are 0 to 65535.
long
cef.extensions.sourceTranslatedZoneID
keyword
cef.extensions.sourceTranslatedZoneURI
The URI for the Translated Zone that the destination asset has been assigned to in ArcSight.
keyword
cef.extensions.sourceUserId
Identifies the source user by ID. This is the user associated with the source of the event. For example, in UNIX, the root user is generally associated with user ID 0.
keyword
cef.extensions.sourceUserName
Identifies the source user by name. Email addresses are also mapped into the UserName fields. The sender is a candidate to put into this field.
keyword
cef.extensions.sourceUserPrivileges
The typical values are "Administrator", "User", and "Guest". It identifies the source user's privileges. In UNIX, for example, activity executed by the root user would be identified with "Administrator".
keyword
cef.extensions.sourceZoneID
Identifies the source user by ID. This is the user associated with the source of the event. For example, in UNIX, the root user is generally associated with user ID 0.
keyword
cef.extensions.sourceZoneURI
The URI for the Zone that the source asset has been assigned to in ArcSight.
keyword
cef.extensions.startTime
The time when the activity the event referred to started. The format is MMM dd yyyy HH:mm:ss or milliseconds since epoch (Jan 1st 1970).
date
cef.extensions.target
keyword
cef.extensions.transportProtocol
Identifies the Layer-4 protocol used. The possible values are protocols such as TCP or UDP.
keyword
cef.extensions.type
0 means base event, 1 means aggregated, 2 means correlation, and 3 means action. This field can be omitted for base events (type 0).
long
cef.extensions.version
keyword
cef.name
keyword
cef.severity
keyword
cef.version
keyword
cyberark_pta.log.event_type
A unique ID that identifies the event that is reported.
keyword
data_stream.dataset
Data stream dataset.
constant_keyword
data_stream.namespace
Data stream namespace.
constant_keyword
data_stream.type
Data stream type.
constant_keyword
destination.domain
The domain name of the destination system. This value may be a host name, a fully qualified domain name, or another host naming format. The value may derive from the original event or be added from enrichment.
keyword
destination.ip
IP address of the destination (IPv4 or IPv6).
ip
destination.service.name
keyword
destination.user.name
Short name or login of the user.
keyword
destination.user.name.text
Multi-field of destination.user.name.
match_only_text
ecs.version
ECS version this event conforms to. ecs.version is a required field and must exist in all events. When querying across multiple indices -- which may conform to slightly different ECS versions -- this field lets integrations adjust to the schema version of the events.
keyword
event.action
The action captured by the event. This describes the information in the event. It is more specific than event.category. Examples are group-add, process-started, file-created. The value is normally defined by the implementer.
keyword
event.created
event.created contains the date/time when the event was first read by an agent, or by your pipeline. This field is distinct from @timestamp in that @timestamp typically contain the time extracted from the original event. In most situations, these two timestamps will be slightly different. The difference can be used to calculate the delay between your source generating an event, and the time when your agent first processed it. This can be used to monitor your agent's or pipeline's ability to keep up with your event source. In case the two timestamps are identical, @timestamp should be used.
date
event.dataset
Event dataset
constant_keyword
event.id
Unique ID to describe the event.
keyword
event.module
Event module
constant_keyword
event.reason
Reason why this event happened, according to the source. This describes the why of a particular action or outcome captured in the event. Where event.action captures the action from the event, event.reason describes why that action was taken. For example, a web proxy with an event.action which denied the request may also populate event.reason with the reason why (e.g. blocked site).
keyword
event.reference
Reference URL linking to additional information about this event. This URL links to a static definition of this event. Alert events, indicated by event.kind:alert, are a common use case for this field.
keyword
event.severity
The numeric severity of the event according to your event source. What the different severity values mean can be different between sources and use cases. It's up to the implementer to make sure severities are consistent across events from the same source. The Syslog severity belongs in log.syslog.severity.code. event.severity is meant to represent the severity according to the event source (e.g. firewall, IDS). If the event source does not publish its own severity, you may optionally copy the log.syslog.severity.code to event.severity.
long
event.url
URL linking to an external system to continue investigation of this event. This URL links to another system where in-depth investigation of the specific occurrence of this event can take place. Alert events, indicated by event.kind:alert, are a common use case for this field.
keyword
input.type
Input type
keyword
log.source.address
Source address from which the log event was read / sent from.
keyword
message
For log events the message field contains the log message, optimized for viewing in a log viewer. For structured logs without an original message field, other fields can be concatenated to form a human-readable summary of the event. If multiple messages exist, they can be combined into one message.
match_only_text
observer.product
The product name of the observer.
keyword
observer.vendor
Vendor name of the observer.
keyword
observer.version
Observer version.
keyword
source.domain
The domain name of the source system. This value may be a host name, a fully qualified domain name, or another host naming format. The value may derive from the original event or be added from enrichment.
keyword
source.ip
IP address of the source (IPv4 or IPv6).
ip
source.service.name
keyword
source.user.name
Short name or login of the user.
keyword
source.user.name.text
Multi-field of source.user.name.
match_only_text
tags
List of keywords used to tag each event.
keyword

Changelog

VersionDetails
0.1.0
Enhancement View pull request
initial beta release