Configure Adaptive Response actions for a correlation search in Splunk Enterprise Security
As a Splunk Enterprise Security admin, you can configure which Adaptive Response actions that a correlation search triggers.
Analysts can run some Adaptive Response actions on an ad hoc basis from Incident Review. See Included Adaptive Response actions with Splunk Enterprise Security in Use Splunk Enterprise Security.
Splunk Enterprise Security includes several adaptive response actions, and you can obtain additional ones from add-ons available on Splunkbase.
Included Adaptive Response actions
includes several Adaptive Response actions.
- Create a notable event.
- Modify a risk score with a risk modifier.
- Send an email.
- Run a script.
- Start a stream capture with Splunk Stream.
- Ping a host.
- Run Nbtstat.
- Run Nslookup.
- Add threat intelligence.
- Create a Splunk Web message.
Create a notable event
Create a notable event when the conditions of a correlation search are met.
- On the menu bar, click Configure > Content > Content Management.
- Click an existing correlation search, or click Create New > Correlation Search.
- Click Add New Response Action and select Notable to add a notable event.
- Type a Title of the notable event on the Incident Review dashboard. Supports variable substitution from the fields in the matching event.
- Type a Description of the notable event. Supports variable substitution from the fields in the matching event
- Select the Security Domain of the notable event from the drop-down list.
- Select the Severity of the notable event from the drop-down list. The severity is used to calculate the Urgency of a notable event.
- (Optional) Change the default owner of the notable event from the system default, unassigned.
- (Optional) Change the default status of the notable event from the system default, New.
- Type a drill-down name for the Contributing Events link in the notable event.
- Type a drill-down search for the Contributing Events link in the notable event.
- In the Drill-down earliest offset field, type the amount of time before the time of the triggering event to look for related events for the Contributing Events link in the notable event.
For example 2h to look for contributing events 2 hours before the triggering event.
- In the Drill-down latest offset field, type the amount of time after the time of the triggering event to look for related events for the Contributing Events link in the notable event.
For example, 1h to look for contributing events 1 hour after the triggering event.
- (Optional) Add Investigation Profiles that apply to the notable event.
For example, add an investigation profile that fits a use case of "Malware" to malware-related notable events.
- (Optional) Add fields that contain assets in Asset Extraction to extract the field values and add them to the investigation workbench as artifacts when the notable event is added to an investigation.
- (Optional) Add fields that contain identities in Identity Extraction to extract the field values and add them to the investigation workbench as an artifact when the notable event is added to an investigation.
- Type Next Steps for an analyst to take after triaging a notable event. Type text or click Insert Adaptive Response Action to reference a response action in the text of the next steps. You can only type plain text and links to response actions in the next steps field. Use next steps if you want to recommend response actions that should be taken in a specific order.
For example, ping a host to determine if it is active on the network. If the host is active, increase the risk score by 100, otherwise, increase the risk score by 50.
- Select Recommended Actions to complement the next steps. From the list of all Adaptive Response actions, click the name of an action that you recommend as a triage or investigation step for this notable event to add it to the list of recommended actions that analysts can take for this notable event. You can add as many recommended actions as you like. Use recommended actions to recommend response actions that do not need to be taken in a specific order.
For example, increase the risk score on a host and perform an nslookup on a domain name.
Modify a risk score with a risk modifier
Modify a risk score as a result of a correlation search or in response to notable event details with the Risk Analysis Adaptive Response action. The risk Adaptive Response action creates a risk modifier event. You can view the risk modifier events on the Risk Analysis dashboard in Enterprise Security.
- Click Add New Response Action and select Risk Analysis.
- Type the score to assign to the risk object.
- Type a field in the search to apply the risk score to for the Risk Object Field.
For example, type "src" to specify the source field.
- Select the Risk Object Type to apply the risk score to.
See Assign risk to an object in Use Splunk Enterprise Security for other ways to modify risk scores.
Send an email
Send an email as a result of a correlation search match.
Make sure that the mail server is configured in the Splunk platform before setting up this response action.
- For Splunk Enterprise, see Configure email notification settings in the Splunk Enterprise Alerting Manual.
- For Splunk Cloud, see Configure email notification settings in the Splunk Cloud Alerting Manual.
- Click Add New Response Action and select Send email.
- In the To field, type a comma-separated list of email addresses to send the email to.
- (Optional) Change the priority of the email. Defaults to Lowest.
- Type a subject for the email.
- Type a message to include as the body of the email.
- Select the check boxes of the information you want the email message to include.
- Select whether to send a plain-text or HTML and plain-text email message.
If you're using the Override Email Alert Action in the general settings, the
subject="$action.email.subject$" is passed explicitly. The default
useNSSubject for use in local savedsearches
$action.email.subject.report$ is ignored. See Configure general settings for Splunk Enterprise Security.
When using '''Send email''' from the adaptive response actions through Incident Review, token replacement is not supported based on event fields. For example, you cannot use an email subject such as "Splunk Alert: $name$", where $name$ is the correlation search name. Since this is an ad-hoc adaptive response action rather than a scheduled saved search, the $name$ token does not apply. Token replacement is supported from the adaptive response actions through the correlation search editor.
Run a script
Run a script stored in
- Click Add New Response Action and select Run a script.
- Type the filename of the script.
More information about scripted alerts can be found in the Splunk platform documentation.
- For Splunk Enterprise, see Configure scripted alerts in the Splunk Enterprise Alerting Manual.
- For Splunk Cloud, see Configure scripted alerts in the Splunk Cloud Alerting Manual.
Start a stream capture with Splunk Stream
Start a stream capture to capture packets on the IP addresses of the selected protocols over the time period that you select. You can view the results of the capture session on the Protocol Intelligence dashboards.
A stream capture will not work unless you integrate Splunk Stream with . See Integrate Splunk Stream with Splunk Enterprise Security.
- Click Add New Response Action and select Stream Capture to start a packet capture in response to a correlation search match.
- Type a Description to describe the stream created in response to the correlation search match.
- Type a Category to define the type of stream capture. You can view streams by category in Splunk Stream.
- Type the comma-separated event fields to search for IP addresses for the Stream capture. The first non-null field is used for the capture.
- Type the comma-separated list of protocols to capture.
- Select a Capture duration to define the length of the packet capture.
- Type a Stream capture limit to limit the number of stream captures started by the correlation search.
Ping a host
Determine whether a host is still active on the network by pinging the host.
- Click Add New Response Action and select Ping.
- Type the event field that contains the host that you want to ping in the Host Field.
- Type the number of maximum results that the ping returns. Defaults to 1.
Learn more about a host and the services that the host runs by running nbtstat.
- Click Add New Response Action and select Nbtstat.
- Type the event field that contains the host that you want to run the nbtstat for in the Host Field.
- Type the number of maximum results that the nbtstat returns. Defaults to 1.
Look up the domain name of an IP address, or the IP address of a domain name, by running nslookup.
- Click Add New Response Action and select Nslookup.
- Type the event field that contains the host that you want to run the nslookup for in the Host Field.
- Type the number of maximum results that the nslookup returns. Defaults to 1.
Add threat intelligence
Create threat artifacts in a threat collection.
- Click Add New Response Action and select Add Threat Intelligence.
- Select the Threat Group to attribute this artifact to.
- Select the Threat Collection to insert the threat artifact into.
- Type the Search Field that contains the value to insert into the threat artifact.
- Type a Description for the threat artifact.
- Type a Weight associated with the threat list. Defaults to 1.
- Type a number of Max Results to specify the number of results to process as threat artifacts. Each unique search field value counts as a result. Defaults to 100.
Set up an Adaptive Response relay from a Splunk Cloud Enterprise Security search head to an on-premises device
Add asset and identity data to Splunk Enterprise Security
This documentation applies to the following versions of Splunk® Enterprise Security: 5.2.0, 5.2.1, 5.2.2, 5.3.0, 5.3.1, 6.0.0, 6.0.1, 6.0.2, 6.1.0
Feedback submitted, thanks!