SSH Activity events report remote client connections to a server using the Secure Shell (SSH) Protocol.
- Category: Network Activity
- Extends:
network - UID:
4007
Attributes
Section titled “Attributes”Classification
Section titled “Classification”activity_id
- Type:
integer_t - Requirement: required
- Values:
0-Unknown: The event activity is unknown.1-Open: A new network connection was opened.2-Close: The network connection was closed.3-Reset: The network connection was abnormally terminated or closed by a middle device like firewalls.4-Fail: The network connection failed. For example a connection timeout or no route to host.5-Refuse: The network connection was refused. For example an attempt to connect to a server port which is not open.6-Traffic: Network traffic report.7-Listen: A network endpoint began listening for new network connections.99-Other: The event activity is not mapped. See theactivity_nameattribute, which contains a data source specific value.
The normalized identifier of the activity that triggered the event.
category_uid
- Type:
integer_t - Requirement: required
- Values:
4-Network Activity: Network Activity events.
The category unique identifier of the event.
class_uid
- Type:
integer_t - Requirement: required
- Values:
4007-SSH Activity: SSH Activity events report remote client connections to a server using the Secure Shell (SSH) Protocol.
The unique identifier of a class. A class describes the attributes available in an event.
severity_id
- Type:
integer_t - Requirement: required
- Values:
0-Unknown: The event/finding severity is unknown.1-Informational: Informational message. No action required.2-Low: The user decides if action is needed.3-Medium: Action is required but the situation is not serious at this time.4-High: Action is required immediately.5-Critical: Action is required immediately and the scope is broad.6-Fatal: An error occurred but it is too late to take remedial action.99-Other: The event/finding severity is not mapped. See theseverityattribute, which contains a data source specific value.
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.
type_uid
- Type:
long_t - Requirement: required
- Values:
400700-SSH Activity: Unknown400701-SSH Activity: Open: A new network connection was opened.400702-SSH Activity: Close: The network connection was closed.400703-SSH Activity: Reset: The network connection was abnormally terminated or closed by a middle device like firewalls.400704-SSH Activity: Fail: The network connection failed. For example a connection timeout or no route to host.400705-SSH Activity: Refuse: The network connection was refused. For example an attempt to connect to a server port which is not open.400706-SSH Activity: Traffic: Network traffic report.400707-SSH Activity: Listen: A network endpoint began listening for new network connections.400799-SSH Activity: Other
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.
activity_name
- Type:
string_t - Requirement: optional
The event activity name, as defined by the activity_id.
category_name
- Type:
string_t - Requirement: optional
The event category name, as defined by category_uid value: Network Activity.
class_name
- Type:
string_t - Requirement: optional
The event class name, as defined by class_uid value: SSH Activity.
severity
- Type:
string_t - Requirement: optional
The event/finding severity, normalized to the caption of the severity_id value. In the case of ‘Other’, it is defined by the source.
type_name
- Type:
string_t - Requirement: optional
The event/finding type name, as defined by the type_uid.
Context
Section titled “Context”metadata
- Type:
metadata - Requirement: required
The metadata associated with the event or a finding.
protocol_ver
- Type:
string_t - Requirement: recommended
The Secure Shell Protocol version.
proxy_connection_info network_proxy
- Type:
network_connection_info - Requirement: recommended
The connection information from the proxy server to the remote server.
proxy_tls network_proxy
- Type:
tls - Requirement: recommended
The TLS protocol negotiated between the proxy server and the remote server.
proxy_traffic network_proxy
- Type:
network_traffic - Requirement: recommended
The network traffic refers to the amount of data moving across a network, from proxy to remote server at a given point of time.
api cloud
- Type:
api - Requirement: optional
Describes details about a typical API (Application Programming Interface) call.
app_name
- Type:
string_t - Requirement: optional
The name of the application associated with the event or object.
enrichments
- Type:
enrichment - Requirement: optional
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"}}]
file
- Type:
file - Requirement: optional
The file that is the target of the SSH activity.
ja4_fingerprint_list
- Type:
ja4_fingerprint - Requirement: optional
A list of the JA4+ network fingerprints.
proxy_endpoint network_proxy
- Type:
network_proxy - Requirement: optional
The proxy (server) in a network connection.
proxy_http_request network_proxy
- Type:
http_request - Requirement: optional
The HTTP Request from the proxy server to the remote server.
proxy_http_response network_proxy
- Type:
http_response - Requirement: optional
The HTTP Response from the remote server to the proxy server.
raw_data
- Type:
string_t - Requirement: optional
The raw event/finding data as received from the source.
tls
- Type:
tls - Requirement: optional
The Transport Layer Security (TLS) attributes.
unmapped
- Type:
object - Requirement: optional
The attributes that are not mapped to the event schema. The names and values of those attributes are specific to the event source.
Occurrence
Section titled “Occurrence”time
- Type:
timestamp_t - Requirement: required
The normalized event occurrence time or the finding creation time.
timezone_offset
- Type:
integer_t - Requirement: recommended
The number of minutes that the reported event time is ahead or behind UTC, in the range -1,080 to +1,080.
count
- Type:
integer_t - Requirement: optional
The number of times that events in the same logical group occurred during the event Start Time to End Time period.
duration
- Type:
long_t - Requirement: optional
The event duration or aggregate time, the amount of time the event covers from start_time to end_time in milliseconds.
end_time
- Type:
timestamp_t - Requirement: optional
The end time of a time period, or the time of the most recent event included in the aggregate event.
end_time_dt datetime
- Type:
datetime_t - Requirement: optional
The end time of a time period, or the time of the most recent event included in the aggregate event.
start_time
- Type:
timestamp_t - Requirement: optional
The start time of a time period, or the time of the least recent event included in the aggregate event.
start_time_dt datetime
- Type:
datetime_t - Requirement: optional
The start time of a time period, or the time of the least recent event included in the aggregate event.
time_dt datetime
- Type:
datetime_t - Requirement: optional
The normalized event occurrence time or the finding creation time.
Primary
Section titled “Primary”action_id security_control
- Type:
integer_t - Requirement: required
- Values:
0-Unknown: The action was unknown. Thedisposition_idattribute may still be set to a non-unknown value, for example ‘Count’, ‘Uncorrected’, ‘Isolated’, ‘Quarantined’ or ‘Exonerated’.1-Allowed: The activity was allowed. Thedisposition_idattribute should be set to a value that conforms to this action, for example ‘Allowed’, ‘Approved’, ‘Delayed’, ‘No Action’, ‘Count’ etc.2-Denied: The attempted activity was denied. Thedisposition_idattribute should be set to a value that conforms to this action, for example ‘Blocked’, ‘Rejected’, ‘Quarantined’, ‘Isolated’, ‘Dropped’, ‘Access Revoked, etc.99-Other: The action was not mapped. See theactionattribute, which contains a data source specific value.
The action taken by a control or other policy-based system leading to an outcome or disposition. Dispositions conform to an action of 1 ‘Allowed’ or 2 ‘Denied’ in most cases. Note that 99 ‘Other’ is not an option. No action would equate to 1 ‘Allowed’. An unknown action may still correspond to a known disposition. Refer to disposition_id for the outcome of the action.
cloud cloud
- Type:
cloud - Requirement: required
Describes details about the Cloud environment where the event was originally created or logged.
dst_endpoint
- Type:
network_endpoint - Requirement: required
The responder (server) in a network connection.
osint osint
- Type:
osint - Requirement: required
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.
auth_type
- Type:
string_t - Requirement: recommended
The SSH authentication type, normalized to the caption of ‘auth_type_id’. In the case of ‘Other’, it is defined by the event source.
auth_type_id
- Type:
integer_t - Requirement: recommended
- Values:
0-Unknown: The authentication type is unknown.1-Certificate Based: Authentication using digital certificates.2-GSSAPI: GSSAPI for centralized authentication.3-Host Based: Authentication based on the client host’s identity.4-Keyboard Interactive: Multi-step, interactive authentication.5-Password: Password Authentication.6-Public Key: Paired public key authentication.99-Other: The authentication type is not mapped. See theauth_typeattribute, which contains a data source specific value.
The normalized identifier of the SSH authentication type.
client_hassh
- Type:
hassh - Requirement: recommended
The Client HASSH fingerprinting object.
connection_info
- Type:
network_connection_info - Requirement: recommended
The network connection information.
device host
- Type:
device - Requirement: recommended
An addressable device, computer system or host.
disposition_id security_control
- Type:
integer_t - Requirement: recommended
- Values:
0-Unknown: The disposition is unknown.1-Allowed: Granted access or allowed the action to the protected resource.2-Blocked: Denied access or blocked the action to the protected resource.3-Quarantined: A suspicious file or other content was moved to a benign location.4-Isolated: A session was isolated on the network or within a browser.5-Deleted: A file or other content was deleted.6-Dropped: The request was detected as a threat and resulted in the connection being dropped.7-Custom Action: A custom action was executed such as running of a command script. Use themessageattribute of the base class for details.8-Approved: A request or submission was approved. For example, when a form was properly filled out and submitted. This is distinct from1‘Allowed’.9-Restored: A quarantined file or other content was restored to its original location.10-Exonerated: A suspicious or risky entity was deemed to no longer be suspicious (re-scored).11-Corrected: A corrupt file or configuration was corrected.12-Partially Corrected: A corrupt file or configuration was partially corrected.13-Uncorrected: A corrupt file or configuration was not corrected.14-Delayed: An operation was delayed, for example if a restart was required to finish the operation.15-Detected: Suspicious activity or a policy violation was detected without further action.16-No Action: The outcome of an operation had no action taken.17-Logged: The operation or action was logged without further action.18-Tagged: A file or other entity was marked with extended attributes.19-Alert: The request or activity was detected as a threat and resulted in a notification but request was not blocked.20-Count: Counted the request or activity but did not determine whether to allow it or block it.21-Reset: The request was detected as a threat and resulted in the connection being reset.22-Captcha: Required the end user to solve a CAPTCHA puzzle to prove that a human being is sending the request.23-Challenge: Ran a silent challenge that required the client session to verify that it’s a browser, and not a bot.24-Access Revoked: The requestor’s access has been revoked due to security policy enforcements. Note: use theHostprofile if theUserorActorrequestor is not present in the event class.25-Rejected: A request or submission was rejected. For example, when a form was improperly filled out and submitted. This is distinct from2‘Blocked’.26-Unauthorized: An attempt to access a resource was denied due to an authorization check that failed. This is a more specific disposition than2‘Blocked’ and can be complemented with theauthorizationsattribute for more detail.27-Error: An error occurred during the processing of the activity or request. Use themessageattribute of the base class for details.99-Other: The disposition is not mapped. See thedispositionattribute, which contains a data source specific value.
Describes the outcome or action taken by a security control, such as access control checks, malware detections or various types of policy violations.
load_balancer load_balancer
- Type:
load_balancer - Requirement: recommended
The Load Balancer object contains information related to the device that is distributing incoming traffic to specified destinations.
message
- Type:
string_t - Requirement: recommended
The description of the event/finding, as defined by the source.
observables
- Type:
observable - Requirement: recommended
The observables associated with the event or a finding.
proxy
- Type:
network_proxy - Requirement: recommended
The proxy (server) in a network connection.
server_hassh
- Type:
hassh - Requirement: recommended
The Server HASSH fingerprinting object.
src_endpoint
- Type:
network_endpoint - Requirement: recommended
The initiator (client) of the network connection.
status
- Type:
string_t - Requirement: recommended
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
- Type:
string_t - Requirement: recommended
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
- Type:
string_t - Requirement: recommended
The status detail contains additional information about the event/finding outcome.
status_id
- Type:
integer_t - Requirement: recommended
- Values:
0-Unknown: The status is unknown.1-Success2-Failure99-Other: The event status is not mapped. See thestatusattribute, which contains a data source specific value.
The normalized identifier of the event status.
traffic
- Type:
network_traffic - Requirement: recommended
The network traffic refers to the amount of data moving across a network at a given point of time. Intended to be used alongside Network Connection.
action security_control
- Type:
string_t - Requirement: optional
The normalized caption of action_id.
actor host
- Type:
actor - Requirement: optional
The actor object describes details about the user/role/process that was the source of the activity.
attacks security_control
- Type:
attack - Requirement: optional
An array of MITRE ATT&CK® objects describing the tactics, techniques & sub-techniques identified by a security control or finding.
authorizations security_control
- Type:
authorization - Requirement: optional
Provides details about an authorization, such as authorization outcome, and any associated policies related to the activity/event.
disposition security_control
- Type:
string_t - Requirement: optional
The disposition name, normalized to the caption of the disposition_id value. In the case of ‘Other’, it is defined by the event source.
firewall_rule security_control
- Type:
firewall_rule - Requirement: optional
The firewall rule that triggered the event.
malware security_control
- Type:
malware - Requirement: optional
A list of Malware objects, describing details about the identified malware.