Data Security Finding

data_security_finding

A Data Security Finding describes detections or alerts generated by various data security products such as Data Loss Prevention (DLP), Data Classification, Secrets Management, Digital Rights Management (DRM), Data Security Posture Management (DSPM), and similar tools. These detections or alerts can be created using fingerprinting, statistical analysis, machine learning or other methodologies. The finding describes the actors and endpoints who accessed or own the sensitive data, as well as the resources which store the sensitive data. 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

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. `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 Data Security Finding activity. `0`: Unknown (`UNKNOWN`) `1`: Create (`CREATE`) `2`: Update (`UPDATE`) `3`: Close (`CLOSE`) `4`: Suppressed (`SUPPRESSED`) `99`: Other (`OTHER`)
Activity	`activity_name`	String	Group:`classification` The Data Security finding activity name, as defined by the `activity_id`.
Actor	`actor`	Actor[]	Group:`context` Describes details about the actor implicated in the data security finding. Either an actor that owns a particular digital file or information store, or an actor which accessed classified or sensitive data.
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. `2006`: Data Security Finding (`DATA_SECURITY_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.
Data Security	`data_security`	Data Security[]	Group:`context` The Data Security object describes the characteristics, techniques and content of a Data Loss Prevention (DLP), Data Loss Detection (DLD), Data Classification, or similar tools' finding, alert, or detection mechanism(s).
Database	`database`	Database[]	Group:`primary` Describes the database where classified or sensitive data is stored in, or was accessed from. Databases are typically datastore services that contain an organized collection of structured and/or semi-structured data.
Databucket	`databucket`	Databucket[]	Group:`primary` Describes the databucket where classified or sensitive data is stored in, or was accessed from. The data bucket object is a basic container that holds data, typically organized through the use of data partitions.
Device	`device`	Device[]	Group:`context` Describes the device where classified or sensitive data is stored in, or was accessed from.
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`)
Destination Endpoint	`dst_endpoint`	Network Endpoint[]	Group:`context` Describes the endpoint where classified or sensitive data is stored in, or was accessed from.
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"}}]`
File	`file`	File[]	Entity:`FILE` Group:`primary` Describes a file that contains classified or sensitive data.
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
Additional Resources	`resources`	Resource Details[]	Group:`primary` Describes details about additional resources, where classified or sensitive data is stored in, or was accessed from. You can populate this object, if the specific resource type objects available in the class (`database, databucket, table, file`) aren't sufficient; OR You can also choose to duplicate `uid, name` of the specific resources objects, for a consistent access to resource uids across all findings.
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 Endpoint	`src_endpoint`	Network Endpoint[]	Group:`context` Details about the source endpoint where classified or sensitive data was accessed from.
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`)
Table	`table`	Table[]	Group:`primary` Describes the table where classified or sensitive data is stored in, or was accessed from. The table object represents a table within a structured relational database, warehouse, lake, or similar.
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`. `200600`: Data Security Finding: Unknown (`DATA_SECURITY_FINDING_UNKNOWN`) `200601`: Data Security Finding: Create (`DATA_SECURITY_FINDING_CREATE`) `200602`: Data Security Finding: Update (`DATA_SECURITY_FINDING_UPDATE`) `200603`: Data Security Finding: Close (`DATA_SECURITY_FINDING_CLOSE`) `200604`: Data Security Finding: Suppressed (`DATA_SECURITY_FINDING_SUPPRESSED`) `200699`: Data Security Finding: Other (`DATA_SECURITY_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`)

Relationships

Outbound Relationships

Data Security Finding references the following objects and events in its attributes:

This page describes ocsf-1.4.0