Guides

Incident Finding

Suggest Edits

An Incident Finding reports the creation, update, or closure of security incidents as a result of detections and/or analytics.

Attributes

CaptionNameTypeDescription
Activity ID activity_id Integer The normalized identifier of the Incident activity.
  • 0: Unknown (UNKNOWN)
  • 1: Create (CREATE)
  • 2: Update (UPDATE)
  • 3: Close (CLOSE)
  • 99: Other (OTHER)
Activity activity_name String The Incident activity name, as defined by the activity_id.
API Details api API[] Describes details about a typical API (Application Programming Interface) call.
Assignee assignee User[] The details of the user assigned to an Incident.
Assignee Group assignee_group Group[] 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 the tactics, techniques & sub-techniques associated to the Incident.
Category category_name String The event category name, as defined by category_uid value.
Category ID category_uid Integer The category unique identifier of the event.
  • 2: Findings (FINDINGS)
Class class_name String The event class name, as defined by class_uid value.
Class ID class_uid Integer The unique identifier of a class. A class describes the attributes available in an event.
  • 2005: Incident Finding (INCIDENT_FINDING)
Cloud cloud Cloud[] Describes details about the Cloud environment where the event was originally created or logged.
Comment comment String Additional user supplied details for updating or closing the incident.
Confidence confidence Integer The confidence of the reported event severity as a percentage: 0%-100%.

🚧 WARNING: DEPRECATED

Confidence has been deprecated since 1.1.0. Deprecated in upgrade from ocsf-0.31.1 to qdm-1.1.0
Confidence Id confidence_id Integer 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 The confidence score as reported by the event source.
Count count Integer The number of times that events in the same logical group occurred during the event Start Time to End Time period.
Data data JSON Additional data that is associated with the event.

🚧 WARNING: DEPRECATED

Data has been deprecated since 1.1.0. Deprecated in upgrade from ocsf-0.31.1 to qdm-1.1.0
Description desc String The short description of the Incident.
Duration duration Long 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 The time of the most recent event included in the incident.
Enrichments enrichments Enrichment[] 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"}}]
Finding Information List finding_info_list Finding Information[] A list of finding_info objects associated to an incident.
Impact impact String 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 The normalized impact of the finding.
  • 0: Unknown (UNKNOWN)
  • 1: Low (LOW)
  • 2: Medium (MEDIUM)
  • 3: High (HIGH)
  • 4: Critical (CRITICAL)
  • 99: Other (OTHER)
Impact impact_score Integer The impact of the finding, valid range 0-100.
Suspected Breach is_suspected_breach Boolean A determination based on analytics as to whether a potential breach was found.
Message message String The description of the event/finding, as defined by the source.
Metadata metadata Metadata[] The metadata associated with the event or a finding.
Observables observables Observable[] The observables associated with the event or a finding.
OSINT osint OSINT[] 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.
Priority priority Integer 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 The normalized priority. Priority identifies the relative importance of the 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 The event data as received from the event source.
Record ID record_id String Unique idenifier for the event
Severity severity String 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

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 A Url link used to access the original incident.
Start Time start_time Timestamp The time of the least recent event included in the incident.
Status status String The normalized status of the Incident 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 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 Details status_detail String The status detail contains additional information about the event/finding outcome.
Status ID status_id Integer The normalized status identifier of the Incident.
  • 0: Unknown (UNKNOWN)
  • 1: New (NEW)
  • 2: In Progress (IN_PROGRESS)
  • 3: On Hold (ON_HOLD)
  • 4: Resolved (RESOLVED)
  • 5: Closed (CLOSED)
  • 99: Other (OTHER)
Ticket ticket Ticket[] The linked ticket in the ticketing system.
Event Time time Timestamp The normalized event occurrence time or the finding creation time.
Timezone Offset timezone_offset Integer 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 The event/finding type name, as defined by the type_uid.
Type ID type_uid Long 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.
  • 200500: Incident Finding: Unknown (INCIDENT_FINDING_UNKNOWN)
  • 200501: Incident Finding: Create (INCIDENT_FINDING_CREATE)
  • 200502: Incident Finding: Update (INCIDENT_FINDING_UPDATE)
  • 200503: Incident Finding: Close (INCIDENT_FINDING_CLOSE)
  • 200599: Incident Finding: Other (INCIDENT_FINDING_OTHER)
Unmapped Data unmapped Unmapped[] The attributes that are not mapped to the event schema. The names and values of those attributes are specific to the event source.
Verdict verdict String The verdict assigned to an Incident finding.
Verdict ID verdict_id Integer 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)

Relationships

Incident Finding shown in context

Outbound Relationships

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

This page describes qdm-1.3.2+ocsf-1.3.0

Updated 2 months ago