Tunnel Activity events report secure tunnel establishment (such as VPN), teardowns, renewals, and other network tunnel specific actions.
Caption Name Type Description Action action
String The normalized caption of action_id
.
Action ID action_id
Integer The action taken by a control or other policy-based system leading to an outcome or disposition. An unknown action may still correspond to a known disposition. Refer to disposition_id
for the outcome of the action.
0
: Unknown (UNKNOWN
)1
: Allowed (ALLOWED
)2
: Denied (DENIED
)3
: Observed (OBSERVED
)4
: Modified (MODIFIED
)99
: Other (OTHER
)Activity ID activity_id
Integer Group: classification
The normalized identifier of the activity that triggered the event.
0
: Unknown (UNKNOWN
)1
: Open (OPEN
)2
: Close (CLOSE
)3
: Renew (RENEW
)99
: Other (OTHER
)Activity activity_name
String Group: classification
The event activity name, as defined by the activity_id.
Actor actor
Actor[] The actor object describes details about the user/role/process that was the source of the activity. Note that this is not the threat actor of a campaign but may be part of a campaign.
API Details api
API[] Group: context
Describes details about a typical API (Application Programming Interface) call.
Application Name app_name
String Group: context
The name of the application associated with the event or object.
MITRE ATT&CK® Details attacks
MITRE ATT&CK®[] An array of MITRE ATT&CK® objects describing identified tactics, techniques & sub-techniques.
Authorization Information authorizations
Authorization Result[] Provides details about an authorization, such as authorization outcome, and any associated policies related to the activity/event.
Category category_name
String Group: classification
The event category name, as defined by category_uid value.
Category ID category_uid
Integer Group: classification
The category unique identifier of the event.
4
: Network Activity (NETWORK_ACTIVITY
)Class class_name
String Group: classification
The event class name, as defined by class_uid value.
Class ID class_uid
Integer Group: classification
The unique identifier of a class. A class describes the attributes available in an event.
4014
: Tunnel Activity (TUNNEL_ACTIVITY
)Cloud cloud
Cloud[] Group: primary
Describes details about the Cloud environment where the event was originally created or logged.
Confidence confidence
String Group: context
The confidence, normalized to the caption of the confidence_id value. In the case of 'Other', it is defined by the event source.
Confidence ID confidence_id
Integer Group: context
The normalized confidence refers to the accuracy of the rule that created the finding. A rule with a low confidence means that the finding scope is wide and may create finding reports that may not be malicious in nature.
0
: Unknown (UNKNOWN
)1
: Low (LOW
)2
: Medium (MEDIUM
)3
: High (HIGH
)99
: Other (OTHER
)Confidence Score confidence_score
Integer Group: context
The confidence score as reported by the event source.
Connection Info connection_info
Network Connection Information[] Group: context
The tunnel connection information.
Count count
Integer Group: occurrence
The number of times that events in the same logical group occurred during the event Start Time to End Time period.
Device device
Device[] Group: primary
The device that reported the event.
Disposition disposition
String The disposition name, normalized to the caption of the disposition_id value. In the case of 'Other', it is defined by the event source.
Disposition ID disposition_id
Integer Describes the outcome or action taken by a security control, such as access control checks, malware detections or various types of policy violations.
0
: Unknown (UNKNOWN
)1
: Allowed (ALLOWED
)10
: Exonerated (EXONERATED
)11
: Corrected (CORRECTED
)12
: Partially Corrected (PARTIALLY_CORRECTED
)13
: Uncorrected (UNCORRECTED
)14
: Delayed (DELAYED
)15
: Detected (DETECTED
)16
: No Action (NO_ACTION
)17
: Logged (LOGGED
)18
: Tagged (TAGGED
)19
: Alert (ALERT
)2
: Blocked (BLOCKED
)20
: Count (COUNT
)21
: Reset (RESET
)22
: Captcha (CAPTCHA
)23
: Challenge (CHALLENGE
)24
: Access Revoked (ACCESS_REVOKED
)25
: Rejected (REJECTED
)26
: Unauthorized (UNAUTHORIZED
)27
: Error (ERROR
)3
: Quarantined (QUARANTINED
)4
: Isolated (ISOLATED
)5
: Deleted (DELETED
)6
: Dropped (DROPPED
)7
: Custom Action (CUSTOM_ACTION
)8
: Approved (APPROVED
)9
: Restored (RESTORED
)99
: Other (OTHER
)Destination Endpoint dst_endpoint
Network Endpoint[] Group: primary
The server responding to the tunnel connection.
Duration Milliseconds duration
Long Group: occurrence
The event duration or aggregate time, the amount of time the event covers from start_time
to end_time
in milliseconds.
End Time end_time
Timestamp Group: occurrence
The end time of a time period, or the time of the most recent event included in the aggregate event.
Enrichments enrichments
Enrichment[] Group: context
The additional information from an external data source, which is associated with the event or a finding.
For example, add location information for the IP address in the DNS answers:
JSON
[
{
"name": "answers.ip",
"value": "92.24.47.250",
"type": "location",
"data": {
"city": "Socotra",
"continent": "Asia",
"coordinates": [-25.4153, 17.0743],
"country": "YE",
"desc": "Yemen"
}
}
]
Firewall Rule firewall_rule
Firewall Rule[] The firewall rule that pertains to the control that triggered the event, if applicable.
Alert is_alert
Boolean Indicates that the event is considered to be an alertable signal. Should be set to true
if disposition_id = Alert
among other dispositions, and/or risk_level_id
or severity_id
of the event is elevated. Not all control events will be alertable, for example if disposition_id = Exonerated
or disposition_id = Allowed
.
JA4+ Fingerprints ja4_fingerprint_list
JA4+ Fingerprint[] Group: context
A list of the JA4+ network fingerprints.
Load Balancer load_balancer
Load Balancer[] The Load Balancer object contains information related to the device that is distributing incoming traffic to specified destinations.
Malware malware
Malware[] A list of Malware objects, describing details about the identified malware.
Message message
String Group: primary
The description of the event/finding, as defined by the source.
Metadata metadata
Metadata[] Group: context
The metadata associated with the event or a finding.
Observables observables
Observable[] Group: primary
The observables associated with the event or a finding.
OSINT osint
OSINT[] Group: primary
The OSINT (Open Source Intelligence) object contains details related to an indicator such as the indicator itself, related indicators, geolocation, registrar information, subdomains, analyst commentary, and other contextual information. This information can be used to further enrich a detection or finding by providing decisioning support to other analysts and engineers.
Policy policy
Policy[] The policy that pertains to the control that triggered the event, if applicable. For example the name of an anti-malware policy or an access control policy.
Tunnel Protocol protocol_name
String Group: context
The networking protocol associated with the tunnel. E.g. IPSec
, SSL
, GRE
.
Proxy proxy
Network Proxy Endpoint[] Group: primary
The proxy (server) in a network connection.
🚧 WARNING: DEPRECATED Proxy has been deprecated since 1.1.0. Use the proxy_endpoint
attribute instead.
Proxy Connection Info proxy_connection_info
Network Connection Information[] The connection information from the proxy server to the remote server.
Proxy Endpoint proxy_endpoint
Network Proxy Endpoint[] The proxy (server) in a network connection.
Proxy HTTP Request proxy_http_request
HTTP Request[] The HTTP Request from the proxy server to the remote server.
Proxy HTTP Response proxy_http_response
HTTP Response[] The HTTP Response from the remote server to the proxy server.
Proxy TLS proxy_tls
Transport Layer Security (TLS)[] The TLS protocol negotiated between the proxy server and the remote server.
Proxy Traffic proxy_traffic
Network Traffic[] The network traffic refers to the amount of data moving across a network, from proxy to remote server at a given point of time.
Raw Data raw_data
JSON Group: context
The event data as received from the event source.
Record ID record_id
String Group: primary
Unique idenifier for the event
Risk Details risk_details
String Group: context
Describes the risk associated with the finding.
Risk Level risk_level
String Group: context
The risk level, normalized to the caption of the risk_level_id value.
Risk Level ID risk_level_id
Integer Group: context
The normalized risk level id.
0
: Info (INFO
)1
: Low (LOW
)2
: Medium (MEDIUM
)3
: High (HIGH
)4
: Critical (CRITICAL
)99
: Other (OTHER
)Risk Score risk_score
Integer Group: context
The risk score as reported by the event source.
Tunnel Session session
Session[] Group: primary
The session associated with the tunnel.
Severity severity
String Group: classification
The event/finding severity, normalized to the caption of the severity_id value. In the case of 'Other', it is defined by the source.
Severity ID severity_id
Integer Group: classification
The normalized identifier of the event/finding severity.
The normalized severity is a measurement the effort and expense required to manage and resolve an event or incident. Smaller numerical values represent lower impact events, and larger numerical values represent higher impact events.0
: Unknown (UNKNOWN
)1
: Informational (INFORMATIONAL
)2
: Low (LOW
)3
: Medium (MEDIUM
)4
: High (HIGH
)5
: Critical (CRITICAL
)6
: Fatal (FATAL
)99
: Other (OTHER
)Source Endpoint src_endpoint
Network Endpoint[] Group: primary
The initiator (client) of the tunnel connection.
Start Time start_time
Timestamp Group: occurrence
The start time of a time period, or the time of the least recent event included in the aggregate event.
Status status
String Group: primary
The event status, normalized to the caption of the status_id value. In the case of 'Other', it is defined by the event source.
Status Code status_code
String Group: primary
The event status code, as reported by the event source. For example, in a Windows Failed Authentication event, this would be the value of 'Failure Code', e.g. 0x18.
Status Detail status_detail
String Group: primary
The status detail contains additional information about the event/finding outcome.
Status ID status_id
Integer Group: primary
The normalized identifier of the event status.
0
: Unknown (UNKNOWN
)1
: Success (SUCCESS
)2
: Failure (FAILURE
)99
: Other (OTHER
)Event Time time
Timestamp Group: occurrence
The normalized event occurrence time or the finding creation time.
Timezone Offset timezone_offset
Integer Group: occurrence
The number of minutes that the reported event time
is ahead or behind UTC, in the range -1,080 to +1,080.
TLS tls
Transport Layer Security (TLS)[] Group: context
The Transport Layer Security (TLS) attributes.
Traffic traffic
Network Traffic[] Group: context
Traffic refers to the amount of data moving across the tunnel at a given point of time. Ex: bytes_in
and bytes_out
.
Tunnel Interface tunnel_interface
Network Interface[] Group: primary
The information about the virtual tunnel interface, e.g. utun0
. This is usually associated with the private (rfc-1918) ip of the tunnel.
Type tunnel_type
String Group: primary
The tunnel type. Example: Split
or Full
.
Type tunnel_type_id
Integer Group: primary
The normalized tunnel type ID.
0
: Unknown (UNKNOWN
)1
: Split Tunnel (SPLIT_TUNNEL
)2
: Full Tunnel (FULL_TUNNEL
)99
: Other (OTHER
)Type Name type_name
String Group: classification
The event/finding type name, as defined by the type_uid.
Type ID type_uid
Long Group: classification
The event/finding type ID. It identifies the event's semantics and structure. The value is calculated by the logging system as: class_uid * 100 + activity_id
.
401400
: Tunnel Activity: Unknown (TUNNEL_ACTIVITY_UNKNOWN
)401401
: Tunnel Activity: Open (TUNNEL_ACTIVITY_OPEN
)401402
: Tunnel Activity: Close (TUNNEL_ACTIVITY_CLOSE
)401403
: Tunnel Activity: Renew (TUNNEL_ACTIVITY_RENEW
)401499
: Tunnel Activity: Other (TUNNEL_ACTIVITY_OTHER
)Unmapped unmapped
Unmapped[] Group: context
Data from the source that was not mapped into the schema.
User user
User[] Entity: USER
Group: primary
The user associated with the tunnel activity.