Security Finding [2001] Class

Findings Category

Security Finding events describe findings, detections, anomalies, alerts and/or actions performed by security products
DEPRECATED since v1.1.0
Use the new specific classes according to the use-case: Vulnerability Finding, Compliance Finding, Detection Finding, Incident Finding, Data Security Finding.
Name Caption Group Requirement Type Description
activity_id Activity ID classification Required Integer The normalized identifier of the activity that triggered the event.
0Unknown
The event activity is unknown.
1Create
A security finding was created.
2Update
A security finding was updated.
3Close
A security finding was closed.
99Other
The event activity is not mapped. See the activity_name attribute, which contains a data source specific value.
This is an enum attribute; its string sibling is activity_name.
activity_name Activity classification Optional String The event activity name, as defined by the activity_id.
This is the string sibling of enum attribute activity_id.
attacks MITRE ATT&CK® and ATLAS™ Details context Optional MITRE ATT&CK® & ATLAS™ Array An array of MITRE ATT&CK® objects describing the tactics, techniques & sub-techniques associated to the Finding.


category_name Category classification Optional String The event category name, as defined by category_uid value: Findings.
This is the string sibling of enum attribute category_uid.
category_uid Category ID classification Required Integer The category unique identifier of the event.
2Findings
Findings events report findings, detections, and possible resolutions of malware, anomalies, or other actions performed by security products.
This is an enum attribute; its string sibling is category_name.
cis_csc CIS CSC context Optional CIS CSC Array The CIS Critical Security Controls is a list of top 20 actions and practices an organization’s security team can take on such that cyber attacks or malware, are minimized and prevented.
DEPRECATED since v1.5.0
Use CIS Controls for standard benchmark controls.
class_name Class classification Optional String The event class name, as defined by class_uid value: Security Finding.
This is the string sibling of enum attribute class_uid.
class_uid Class ID classification Required Integer The unique identifier of a class. A class describes the attributes available in an event.
2001Security Finding
Security Finding events describe findings, detections, anomalies, alerts and/or actions performed by security products
This is an enum attribute; its string sibling is class_name.
compliance Compliance context Optional Compliance The compliance object provides context to compliance findings (e.g., a check against a specific regulatory or best practice framework such as CIS, NIST etc.) and contains compliance related details.
count Count occurrence Optional Integer The number of times that events in the same logical group occurred during the event Start Time to End Time period.
data_sources Data Sources context Optional String Array A list of data sources utilized in generation of the finding.
duration Duration Milliseconds occurrence Optional 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 occurrence Optional Timestamp The end time of a time period, or the time of the most recent event included in the aggregate event.
enrichments Enrichments context Optional Enrichment Array 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 Evidence context Optional JSON The data the finding exposes to the analyst.
DEPRECATED since v1.1.0
Use the evidences attribute instead.
finding Finding primary Required Finding The Finding object provides details about a finding/detection generated by a security tool.
kill_chain Kill Chain context Optional Kill Chain Phase Array The Cyber Kill Chain® provides a detailed description of each phase and its associated activities within the broader context of a cyber attack.
malware Malware context Optional Malware Array A list of Malware objects, describing details about the identified malware.
metadata Metadata context Required Metadata The metadata associated with the event or a finding.
nist NIST List context Optional String Array The NIST Cybersecurity Framework recommendations for managing the cybersecurity risk.
process Process O context Optional Process The process object.
raw_data Raw Data context Optional String The raw event/finding data as received from the source.
raw_data_hash Raw Data Hash O context Optional Fingerprint The hash, which describes the content of the raw_data field.
raw_data_size Raw Data Size context Optional Long The size of the raw data which was transformed into an OCSF event, in bytes.
severity Severity classification Optional 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.
This is the string sibling of enum attribute severity_id.
severity_id Severity ID classification Required 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.
0Unknown
The event/finding severity is unknown.
1Informational
Informational message. No action required.
2Low
The user decides if action is needed.
3Medium
Action is required but the situation is not serious at this time.
4High
Action is required immediately.
5Critical
Action is required immediately and the scope is broad.
6Fatal
An error occurred but it is too late to take remedial action.
99Other
The event/finding severity is not mapped. See the severity attribute, which contains a data source specific value.
This is an enum attribute; its string sibling is severity.
start_time Start Time occurrence Optional Timestamp The start time of a time period, or the time of the least recent event included in the aggregate event.
state State context Optional String The normalized state of a security finding.
This is the string sibling of enum attribute state_id.
state_id State ID context Required Integer The normalized state identifier of a security finding.
0Unknown
The state is unknown.
1New
The finding is new and yet to be reviewed.
2In Progress
The finding is under review.
3Suppressed
The finding was reviewed, considered as a false positive and is now suppressed.
4Resolved
The finding was reviewed and remediated and is now considered resolved.
99Other
The state is not mapped. See the state attribute, which contains a data source specific value.
This is an enum attribute; its string sibling is state.
time Event Time occurrence Required Timestamp The normalized event occurrence time or the finding creation time.
type_name Type Name classification Optional String The event/finding type name, as defined by the type_uid.
This is the string sibling of enum attribute type_uid.
type_uid Type ID classification Required 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.
200100Security Finding: Unknown
200101Security Finding: Create
A security finding was created.
200102Security Finding: Update
A security finding was updated.
200103Security Finding: Close
A security finding was closed.
200199Security Finding: Other
This is an enum attribute; its string sibling is type_name.
unmapped Unmapped Data context Optional Object The attributes that are not mapped to the event schema. The names and values of those attributes are specific to the event source.
vulnerabilities Vulnerabilities context Optional Vulnerability Details Array This object describes vulnerabilities reported in a security finding.