Email Activity
email_activity
Email Activity events report SMTP protocol and email activities including those with embedded URLs and files. See the Email
object for details.
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.
|
Activity ID | activity_id |
Integer |
Group:classification The normalized identifier of the activity that triggered the event.
|
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. |
MITRE ATT&CK® Details | attacks |
MITRE ATT&CK®[] | An array of MITRE ATT&CK® objects describing identified tactics, techniques & sub-techniques. |
Attempt | attempt |
Integer |
Group:context The attempt number for attempting to deliver the email. |
Authorization Information | authorizations |
Authorization Result[] | Provides details about an authorization, such as authorization outcome, and any associated policies related to the activity/event. |
Protocol Banner | banner |
String |
Group:context The initial connection response that a messaging server receives after it connects to an email server. |
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.
|
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.
|
Cloud | cloud |
Cloud[] |
Group:primary Describes details about the Cloud environment where the event was originally created or logged. |
Command | command |
String |
Group:primary The command issued by the initiator (client), such as SMTP HELO or EHLO. |
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.
|
Confidence Score | confidence_score |
Integer |
Group:context The confidence score as reported by the event source. |
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[] | An addressable device, computer system or host. |
Direction | direction |
String |
Group:context The direction of the email, as defined by the direction_id value.
|
Direction ID | direction_id |
Integer |
Group:context The direction of the email relative to the scanning host or organization. Email scanned at an internet gateway might be characterized as inbound to the organization from the Internet, outbound from the organization to the Internet, or internal within the organization. Email scanned at a workstation might be characterized as inbound to, or outbound from the workstation.
|
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.
|
Destination Endpoint | dst_endpoint |
Network Endpoint[] |
Group:primary The responder (server) receiving the email. |
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.
|
email |
Email[] |
Entity:EMAIL Group: primary The email object. |
|
Email Authentication | email_auth |
Email Authentication[] |
Group:primary The SPF, DKIM and DMARC attributes of an email. |
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 .
|
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. |
Message Trace UID | message_trace_uid |
String |
Group:primary The identifier that tracks a message that travels through multiple points of a messaging service. |
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. |
Protocol Name | protocol_name |
String |
Group:primary The Protocol Name specifies the email communication protocol, such as SMTP, IMAP, or POP3. |
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.
|
Risk Score | risk_score |
Integer |
Group:context The risk score as reported by the event source. |
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.
|
SMTP Hello | smtp_hello |
String |
Group:primary The value of the SMTP HELO or EHLO command sent by the initiator (client).
|
Source Endpoint | src_endpoint |
Network Endpoint[] |
Group:primary The initiator (client) sending the email. |
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.
|
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.
|
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 .
|
Unmapped | unmapped |
Unmapped[] |
Group:context Data from the source that was not mapped into the schema. |
Relationships
Outbound Relationships
Email Activity references the following objects and events in its attributes:
- Actor
- API
- Device
- Email Authentication
- Authorization Result
- Network Endpoint
- Firewall Rule
- Observable
- MITRE ATT&CK®
- Unmapped
- Enrichment
- Metadata
- Cloud
- OSINT
- Policy
- Malware
This page describes ocsf-1.4.0
Updated 3 days ago