Skip to main content

 

Splunk Lantern

Writing better searches with the Common Information Model

 

Your organization uses dozens of different software vendors, and there is no consistency among field names and their meanings in the data that comes from the vendors' logs. The variety makes analyzing similar data types to look for security events very difficult. You need a a way to normalize your data to match a common standard.

Solution

The Splunk Common Information Model (CIM) is a semantic model focused on extracting values from data. It is a taxonomy schema that allows you to map vendor fields to common fields that are the same for each data source in a given domain. Essentially, when you add your data through a supported technical add-on (TA), it acts as a translator from vendor language to Splunk language. The CIM is implemented as an add-on that can be downloaded from Splunkbase. It provides the following:

  • Data models. These are predefined domains of interest, such as endpoint or authentication, that map to your data. 
  • Data normalization. Each domain has assigned fields and tags to normalize data at search time.
  • Data sets. These are specific subsets of the data models, such as privileged escalation authentication, which is a subset of the authentication data model.
  • Data model acceleration. The CIM creates a summary index for data, which speeds up searches when compared to searching across raw data.

What are the benefits of using the CIM?

  • Faster. Data model acceleration uses summary indexes for data, which speed up searches. Searches are also more efficient, as shown in the table below. 
  • Easier. With CIM, you can query across multiple source types simultaneously, which is especially helpful if you don't know which source you need. 
  • Accurate. There are fewer operators and fields, which makes your searches less error prone and less likely to waste analysts' time with false positives.
  • Less Work. Using common fields across all sources means that you have less content to write and maintain since you no longer need to worry about vendor-specific naming conventions.
  • Complete. The CIM covers all data sources that have associated, Splunk-supported TAs. To map data correctly to the CIM, the data must be ingested through these add-ons.
  • Expanded Deployments. In Splunk Enterprise Security, 619 detections use data-model based searches. If you want to upgrade to Splunk Enterprise Security, you should have the CIM.
Sample Search Without CIM With CIM
Blocked malware search (sourcetype=symantec:ep:* “Virus found” AND
“Actual action: Cleaned by deletion”)
(sourcetype=“mcafee:epo:syslog” AND
“<ThreatActionTaken>blocked”)
(sourcetype=“crowdstrike:events:sensor”
“"event_simpleName":"ProcessBlocked"”)
(tag=malware tag=attack action=blocked)
Windows process started search (sourcetype=crowdstrike:events:sensor AND
“event_simpleName”:”ProcessRollup2””)
(sourcetype=Perfmon:Process OR
sourcetype=WMI:LocalProcesses AND
“A new process has been created.”)
(sourcetype=XmlWinEventLog
AND “<EventID>1”)
(tag=processes tag=report action=allowed)

When you should not use the Common Information Model

Not all events should be mapped to a data model in the CIM. Here are a few reasons you wouldn't map an event:

  • Field extractions at search time have a cost, and not all events fit the data model definitions to contribute to threat detections. By determining what those unusable events are and not mapping them to data models and extracting fields, you can improve search performance.
  • Not all data sources have enough fields that are mappable to a CIM domain. Some data sources are too product-specific.
  • Some events have a lack of semantic value. For example:
    • Sysmon Event ID 7: Image loaded. This is a very noisy event that is often disabled by administrators.
    • gws_login_verification: actor was presented with login verification.
  • If a use case is data-source specific or unique to a single product, it isn't applicable to a common model.

How to test your CIM implementation

The Pytest Splunk add-on is a dynamic test tool for Splunk Technical add-ons. It is downloadable from GitHub. You can use it on your CIM Add-on to check the following:

  • Each event that is mapped to a data model includes the fields required for that data model. Fields can be required, recommended, or optional.
  • You have the right format in a given field. For example, it can check that an IP address field contains an IPv4 or IPv6 address and not a string.

Next steps

Now that you understand the basics of what the Common Information Model is and why you should use it, watch the full demo in this .Conf22 Talk (Finding Threats Better With Splunk® Common Information Model (CIM) in Your Searches and Custom Add-ons). Then, download the add-on and get started in your deployment.

These additional Splunk resources might help you understand and implement this product tip:

Still need help with this use case? Most customers have OnDemand Services per their license support plan. Engage the ODS team at OnDemand-Inquires@splunk.com if you require assistance.

 

  • Written by Justin Scaggs and Alexei Suvorov
  • Principal Security Engineers at Splunk