Customize threat match searches using Splunk Enterprise Security
Use the Splunk Enterprise Security UI to edit threat match searches that are available in the app to enrich the incoming data in your deployment with threat intelligence.
Configuring the threat match specifications in the UI automatically populates the settings in the
[threat match] stanza for the DSS Threat intelligence module in the
inputs.conf configuration file. The threat match settings are used by the custom search builder to construct the SPL for the threat match searches.
The events generated by these threat match searches are tagged for the Threat intelligence data model and populate the
threat_activity index. As a security analyst, you may review the items in the
threat_activity index on the Threat Activity dashboard to investigate threats.
You can customize the threat match searches by making the following changes:
- Add or remove extra data models
- Change the time interval
- Change the earliest or latest time
- Add or remove aggregates
- Add or remove datasets
If you upgrade your instance of Splunk Enterprise Security app to version 6.4.0, you may see a conflict between the previous threat gen searches that you had defined in the
savedsearches.conf and the new dynamically generated threat gen searches by the custom search builder. If this occurs, you may receive a health check warning "Threat gen searches may cause conflicts with default threat gen searches". You must delete the existing threat gen searches in the
savedsearches.conf file to remove this conflict.
Edit threat match settings to customize threat match searches
Edit the threat match settings to generate the SPL for threat match searches and enrich your data with threat intelligence.
You have an administrator role with
edit_modinput_threatmatch capabilities to edit the threat match settings.
- From the Enterprise Security menu bar, select Configure > Data Enrichment > Threat Intelligence Management. This displays the list of downloaded intelligence documents in the app that are sorted by Interval, Type, URL, Weight, and Status.
- Click on the Threat Matching tab.
Use the following table to identify the available threat match sources and the associated configuration settings for the threat match searches:
Setting Description Example Source Type of threat match sources in your deployment.
Interval The cron interval at which the search runs.
For more information on cron formats, see Commonly used cron field formats.
Earliest Time Time when the search starts.
Latest Time Time when the search completes.
Match Fields Fields to match against to generate threats.
Status Turn on or turn off the threat match search
Activate / Turn on,
Deactivate / Turn off
You can expand the threat match source to view the SPL generated for the threat match search.
- Click on the threat match source to edit the threat match settings.
This opens the Edit Threat Match Configuration dialog.
You may only turn on, turn off, or edit existing threat match sources using this UI. You may not use the editor to create new threat match sources.
Use the following table to edit the specific configuration settings for your threat match search:
Setting Description Name Name of the threat match stanza. Source Name of the threat match source or the threat artifact. Earliest Time Time when the threat match search starts. Latest time Time when the threat match search completes. Interval Cron interval at which the threat match search runs. Max Aggregate values Maximum number of aggregate values for the threat match search. Datasets Datasets currently included in the threat match search.
You may delete any existing dataset from the threat match search by clicking on the X button next to the specific dataset. You may also edit any existing dataset included in the threat match search by clicking the pencil icon next to the specific dataset. You may turn on or turn off an existing dataset by clicking on the
Activate / Turn onor
Deactivate / Turn offbutton for the dataset. You may also remove specific fields against which you want to match in the threat match searches.
To add a new dataset to the threat match search
- Click on the Add Dataset to add more datasets to the threat match search.
This opens the Add a Dataset dialog.
- Select the data model for the dataset from the Datamodel drop down to specify the source of the dataset.
For example: Alerts, Authentication, Certificates, Change Analysis, Inventory, Database, and so on.
- Select the object using the Object drop down menu to specify the type of object used from the datamodel.
For example: If you selected Authentication as the datamodel type, you can select various objects like: Failed_Authentication, Default_Authentication, Successful_Authentication, Insecure_Authentication, and so on.
- Specify the boolean clause to filter out events for the threat match search in the Event Filter field. The Boolean clause translated to the where clause within the search SPL.
- Specify the Match field field to select the fields to match on and generate threats. For example: source, sourcetype, and so on.
- Click Add Aggregate to identify the datasets that the search may retrieve from the datamodel.
- Specify the alias for the field to rename the aggregate.
For example, you may rename the aggregate
All_Certificates.srcto the alias
src; or, you may rename the aggregate
All_Certificates.destto the alias
destwhile specifying the settings for the threat match search.
- Click Save Dataset to build the threat match search.
Configure intelligence documents in Splunk Enterprise Security
Configure global threatlist settings to retrieve threat intelligence
This documentation applies to the following versions of Splunk® Enterprise Security: 7.0.1, 7.0.2, 7.1.0, 7.1.1, 7.2.0