Tunnel Activity

tunnel_activity

Tunnel Activity events report secure tunnel establishment (such as VPN), teardowns, renewals, and other network tunnel specific actions.

Attributes

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: `[{"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.

Relationships

Outbound Relationships

Tunnel Activity references the following objects and events in its attributes:

This page describes ocsf-1.4.0