Detection Finding

detection_finding

A Detection Finding describes detections or alerts generated by security products using correlation engines, detection engines or other methodologies. Note: if the event producer is a security control, the security_control profile should be applied and its attacks information, if present, should be duplicated into the finding_info object.
Note: If the Finding is an incident, i.e. requires incident workflow, also apply the incident profile or aggregate this finding into an Incident Finding.

Attributes

CaptionNameTypeDescription
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 finding activity.
  • 0: Unknown (UNKNOWN)
  • 1: Create (CREATE)
  • 2: Update (UPDATE)
  • 3: Close (CLOSE)
  • 99: Other (OTHER)
Activity activity_name String Group:classification
The finding 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.
Assignee assignee User[] Entity:USER
Group:context
The details of the user assigned to an Incident.
Assignee Group assignee_group Group[] Group:context
The details of the group assigned to an Incident.
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.
  • 2: Findings (FINDINGS)
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.
  • 2004: Detection Finding (DETECTION_FINDING)
Cloud cloud Cloud[] Group:primary
Describes details about the Cloud environment where the event was originally created or logged.
Comment comment String Group:context
A user provided comment about the finding.
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.
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
Describes the affected device/host. It can be used in conjunction with Affected Resource(s).

e.g. Specific details about an AWS EC2 instance, that is affected by the Finding.

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)
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 time of the most recent event included in the finding.
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"}}]
Evidence Artifacts evidences Evidence Artifacts[] Group:primary
Describes various evidence artifacts associated to the activity/activities that triggered a security detection.
Finding Information finding_info Finding Information[] Group:primary
Describes the supporting information about a generated finding.
Firewall Rule firewall_rule Firewall Rule[] The firewall rule that pertains to the control that triggered the event, if applicable.
Impact impact String Group:context
The impact , normalized to the caption of the impact_id value. In the case of 'Other', it is defined by the event source.
Impact ID impact_id Integer Group:context
The normalized impact of the incident or finding. Per NIST, this is the magnitude of harm that can be expected to result from the consequences of unauthorized disclosure, modification, destruction, or loss of information or information system availability.
  • 0: Unknown (UNKNOWN)
  • 1: Low (LOW)
  • 2: Medium (MEDIUM)
  • 3: High (HIGH)
  • 4: Critical (CRITICAL)
  • 99: Other (OTHER)
Impact Score impact_score Integer Group:context
The impact as an integer value of the finding, valid range 0-100.
Alert is_alert Boolean Group:primary
Indicates that the event is considered to be an alertable signal. For example, an activity_id of 'Create' could constitute an alertable signal and the value would be true, while 'Close' likely would not and either omit the attribute or set its value to false. Note that other events with the security_control profile may also be deemed alertable signals and may also carry is_alert = true attributes.
Suspected Breach is_suspected_breach Boolean Group:context
A determination based on analytics as to whether a potential breach was found.
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.
Priority priority String Group:context
The priority, normalized to the caption of the priority_id value. In the case of 'Other', it is defined by the event source.
Priority ID priority_id Integer Group:context
The normalized priority. Priority identifies the relative importance of the incident or finding. It is a measurement of urgency.
  • 0: Unknown (UNKNOWN)
  • 1: Low (LOW)
  • 2: Medium (MEDIUM)
  • 3: High (HIGH)
  • 4: Critical (CRITICAL)
  • 99: Other (OTHER)
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
Remediation Guidance remediation Remediation[] Group:context
Describes the recommended remediation steps to address identified issue(s).
Affected Resources resources Resource Details[] Group:context
Describes details about resources that were the target of the activity that triggered the finding.
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.
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 URL src_url URL String Entity:URL_STRING
Group:primary
A Url link used to access the original incident.
Start Time start_time Timestamp Group:occurrence
The time of the least recent event included in the finding.
Status status String Group:context
The normalized status of the Finding set by the consumer normalized to the caption of the status_id value. In the case of 'Other', it is defined by the 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:context
The normalized status identifier of the Finding, set by the consumer.
  • 0: Unknown (UNKNOWN)
  • 1: New (NEW)
  • 2: In Progress (IN_PROGRESS)
  • 3: Suppressed (SUPPRESSED)
  • 4: Resolved (RESOLVED)
  • 5: Archived (ARCHIVED)
  • 99: Other (OTHER)
Ticket ticket Ticket[] Group:context
The linked ticket in the ticketing system.
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.
  • 200400: Detection Finding: Unknown (DETECTION_FINDING_UNKNOWN)
  • 200401: Detection Finding: Create (DETECTION_FINDING_CREATE)
  • 200402: Detection Finding: Update (DETECTION_FINDING_UPDATE)
  • 200403: Detection Finding: Close (DETECTION_FINDING_CLOSE)
  • 200499: Detection Finding: Other (DETECTION_FINDING_OTHER)
Unmapped unmapped Unmapped[] Group:context
Data from the source that was not mapped into the schema.
Vendor Attributes vendor_attributes Vendor Attributes[] Group:context
The Vendor Attributes object can be used to represent values of attributes populated by the Vendor/Finding Provider. It can help distinguish between the vendor-prodvided values and consumer-updated values, of key attributes like severity_id.
The original finding producer should not populate this object. It should be populated by consuming systems that support data mutability.
Verdict verdict String Group:primary
The verdict assigned to an Incident finding.
Verdict ID verdict_id Integer Group:primary
The normalized verdict of an Incident.
  • 0: Unknown (UNKNOWN)
  • 1: False Positive (FALSE_POSITIVE)
  • 10: Duplicate (DUPLICATE)
  • 2: True Positive (TRUE_POSITIVE)
  • 3: Disregard (DISREGARD)
  • 4: Suspicious (SUSPICIOUS)
  • 5: Benign (BENIGN)
  • 6: Test (TEST)
  • 7: Insufficient Data (INSUFFICIENT_DATA)
  • 8: Security Risk (SECURITY_RISK)
  • 9: Managed Externally (MANAGED_EXTERNALLY)
  • 99: Other (OTHER)
Vulnerabilities vulnerabilities Vulnerability Details[] Group:context
Describes vulnerabilities reported in a Detection Finding.

Relationships

Detection Finding shown in context

Outbound Relationships

Detection Finding references the following objects and events in its attributes:

This page describes ocsf-1.4.0