Splunk® Common Information Model Add-on

Common Information Model Add-on Manual

Acrobat logo Download manual as PDF


This documentation does not apply to the most recent version of Splunk® Common Information Model Add-on. For documentation on the most recent version, go to the latest release.
Acrobat logo Download topic as PDF

Data Access

The Data Access data model is for monitoring shared data access user activity. It helps you detect a user's unauthorized data access, misuse, exfiltration, and more. It applies to events about users accessing data on servers that are shared by many other users, such as: The "file abc" on the "server xyz" was accessed (read, created, modified, shared, and so on) by a "user Bob".

Note: A dataset is a component of a data model. In versions of the Splunk platform prior to version 6.5.0, these were referred to as data model objects.

Tags used with Data Access event datasets

The following tags act as constraints to identify your events as being relevant to this data model. For more information, see How to use these reference tables.

Dataset name Tag name
Data_Access data
access

Fields for Data Access event datasets

The key for using the column titled "Notes" or "Abbreviated list of example values" is as follows:

  • Recommended: Add-on developers make their best effort attempts to map these event fields. If these fields are not populated, then the event is not very useful.
  • Required: Add-on developers must map these event fields when using the pytest-splunk-addon to test for CIM compatibility. See pytest-splunk-addon documentation.
  • Prescribed values: Permitted values that can populate the fields, which Splunk is using for a particular purpose. Other valid values exist, but Splunk is not relying on them.
  • Other values: Other example values that you might see.

For even more examples, see Data Access Field Mapping.

Dataset name Field name Data type Description Abbreviated list of example values
Data_Access action string The data access action taken by the user.
  • recommended
  • prescribed values:
    copied, created, deleted, modified, read, stopped, updated, downloaded, uploaded, shared
Data_Access app string The application involved in the event. recommended
Data_Access app_id string Application ID as defined by the vendor.
Data_Access dest string The destination where the data resides or where it is being accessed, such as the product or application. You can alias this from more specific fields not included in this data model, such as dest_host, dest_ip, dest_url, or dest_name. recommended
Data_Access dest_name string Name of the destination as defined by the vendor.
Data_Access dest_url string Url of the product, application, or object.
Data_Access dvc string The device that reported the data access event.
Data_Access email string The email address of the user involved in the event, or who initiated the event.
Data_Access object string Resource object name on which the action was performed by a user. recommended
Data_Access object_category string Generic name for the class of the updated resource object. Expected values may be specific to an app. For example, collaboration, file, folder, comment, task, note, and so on.

recommended

Data_Access object_id string The unique updated resource object ID as presented to the system, if applicable. For example, a source_folder_id, doc_id. recommended
Data_Access object_path string The path of the modified resource object, if applicable, such as a file, directory, or volume.
Data_Access object_size string The size of the modified resource object. recommended
Data_Access owner string Resource owner.
Data_Access owner_email string Email of the resource owner.
Data_Access owner_id string ID of the owner as defined by the vendor.
Data_Access parent_object string Parent of the object name on which the action was performed by a user.
Data_Access parent_object_id string Parent object ID
Data_Access parent_object_category string Object category of the parent object on which action was performed by a user.
Data_Access src string The endpoint client host. recommended
Data_Access tenant_id string Tenant ID in multi-tenant environments. recommended
Data_Access user string The user involved in the event, or who initiated the event. recommended
Data_Access user_agent string The user agent through which the request was made, such as Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) or aws-cli/2.0.0 Python/3.7.4 Darwin/18.7.0 botocore/2.0.0dev4 recommended
Data_Access user_group string The group of the user involved in the event, or who initiated the event.
Data_Access user_role string The role of the user involved in the event, or who initiated the event.
Data_Access vendor_product string The vendor and product name of the vendor. recommended
Data_Access vendor_product_id string The vendor and product name ID as defined by the vendor.
Last modified on 06 November, 2023
PREVIOUS
Change Analysis (deprecated)
  NEXT
Databases

This documentation applies to the following versions of Splunk® Common Information Model Add-on: 4.20.0, 4.20.2


Was this documentation topic helpful?


You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters