Connect Splunk App for SOAR Export and the Splunk Platform to Splunk SOAR
Configure a Splunk SOAR server so that Splunk App for SOAR Export and the Splunk platform can connect to your Splunk SOAR instance.
To configure a Splunk SOAR server, follow these steps:
- Before you begin, make sure you have added the required roles to the admin user. See Enable Splunk platform users to use Splunk App for SOAR Export.
- (Optional) If you are connecting to a Splunk Enterprise instance and if you have not configured certificates for Splunk SOAR and the Splunk platform, you can optionally disable HTTP validation on the Splunk Platform. Perform the following steps:
- Run the following command and provide the proper username, password, and splunkaddress:
curl -ku '<username>:<password>' https://<splunkaddress>:8089/servicesNS/nobody/phantom/configs/conf-phantom/verify_certs\?output_mode\=json -d value=0
- Return to the Splunk SOAR configuration page and verify that the HTTPS certificate verification is disabled message appears with a warning icon.
- Run the following command and provide the proper username, password, and splunkaddress:
- Navigate to Splunk App for SOAR Export, installed on your Splunk platform instance.
- Select the Configurations tab.
- Select Create Server.
- To add a new server, use an authorization token from Splunk SOAR. To get an authorization token, follow these steps:
- Navigate to your Splunk SOAR instance.
- From the main menu, select Administration.
- Select User Management, then Users.
- You can either use the default automation user and change the allowed IP addresses, or create a new automation user. In this example we will create a new automation user. Select + User to create a new automation user.
- Update the Allowed IPs field to reflect the IP address or IP range for the Splunk platform instance.
Do not use any unless you are troubleshooting or testing.
- (Optional) To synchronize custom severity levels you might have created in Splunk SOAR, add the Observer role to this user. In the Roles field, select Observer.
- Select Create to create the user.
- On the Users page, Select the ellipsis (...) icon for the new automation user and select Edit.
- Copy the text in the Authorization Configuration for REST API box.
- Select Save.
- Navigate back to Splunk App for SOAR Export on your Splunk platform instance and paste the authorization token in the Authorization Configuration box. Verify that the format of the object looks like the following example:
{ "ph-auth-token": "*********", "server": "https://10.1.65.229" }
- Enter an optional name for the server. This will show up later in Splunk SOAR as your container name, so pick a name you can easily identify.
- (Optional) Configure a Proxy server. For example:
- An example HTTP proxy in the format
http://[<username>[:password]@]<host>[:<port>]
. For example:http://username:password@172.31.225.254:8080
- An example HTTPS proxy in the format
https://[<username>[:password]@]<host>[:<port>]
. For example:https://username:password@proxy.host.com:8080
- An example HTTP proxy in the format
- (Optional) Select Optional: This server will be used for AR Relay if this server will be used in an adaptive response relay configuration. See Use adaptive response relay to send notable events from Splunk ES to Splunk SOAR.
- Select Save. A page shows your new server. If you have multiple servers, they are listed on this page.
- To test your server, select Manage, then Test Connectivity. A success message appears if the server is working correctly.
- (Optional) Select Manage, then Sync Playbooks to further test connectivity and make sure that your playbooks are synchronized. See Synchronize the list of available Splunk SOAR playbooks on your Splunk platform.
Do not select Enable debug logging unless directed to do so by Splunk support. Debug logging causes a heavy load on your server.
Synchronize Splunk SOAR information on your Splunk Platform for Adaptive Response Actions
You can run adaptive response action in Splunk Enterprise Security (ES) to send a notable event to Splunk SOAR and also run a playbook on the resulting artifact. Synchronize playbooks and severity levels so they are available in adaptive response action. See Run adaptive response actions in Splunk ES to send notable events to Splunk SOAR for more information about running adaptive response actions in Splunk ES.
Synchronize the list of available playbooks
Perform the following tasks to make sure that the list of available playbooks is current in your Splunk platform. The list of playbooks is maintained in the <SPLUNK_HOME>/etc/apps/phantom/local/phantom.conf
file.
- Navigate to Splunk App for SOAR Export on your Splunk platform.
- Select the Configurations tab.
- In the Actions column for the desired server, select Manage, then Sync playbooks.
Synchronize severity levels
If you created custom severity levels in Splunk SOAR, you can use them in adaptive response actions and event forwarding configurations within Splunk App for SOAR Export. Custom severity levels are synchronized when you add a server in Splunk App for Export, using an Automation user with the Observer role, as described earlier in this article. If severities were not synced when you added a server, you can sync them manually by following these steps.
- Navigate to Splunk App for SOAR Export on your Splunk platform.
- Select the Configurations tab.
- In the Actions column for the desired server, select Manage, then Sync severities.
Use caution when deleting custom severity levels that you created in Splunk SOAR and then synchronized with Splunk App for SOAR Export. If an expected custom severity level is no longer present in Splunk SOAR, Splunk App for SOAR Export will designate the event as High severity and apply the tag check_sase_severity. You might choose to create a playbook that searches for check_sase_severity tag and alerts you to check the severity of the event.
For information on creating custom severity names, see Create custom severity names in the Splunk SOAR documentation.
Provide a valid SSL certificate for the connection between Splunk SOAR and Splunk Enterprise | Verify that data can be pushed from the Splunk platform to Splunk SOAR |
This documentation applies to the following versions of Splunk® App for SOAR Export: 4.3.13
Feedback submitted, thanks!