Set up Splunk Cloud Connect to use the agentic SOC
Set up Splunk Cloud Connect to use the agentic capabilities in Splunk Enterprise Security by connecting on-premises deployments of Splunk Enterprise Security with Cloud-native, Splunk managed, or Splunk Cloud Services (SCS) security extensions. For troubleshooting common UI issues, see Troubleshoot common issues using Splunk Cloud Connect.
Prerequisites to use the agentic SOC with Splunk Cloud Connect
Meet the following prerequisites to use the agentic SOC with Splunk Cloud Connect:
- Install Splunk Platform version 10.4 or higher
- Install Splunk Enterprise Security version 8.8 and higher.
- Download the Splunk Cloud Connect app version 2.0 or higher from Splunkbase for Splunk Enterprise Security version 8.8 or higher.
- Download the Splunk AI Assistant version 2.4 or higher from Splunkbase.
- See Access Splunk Cloud Connect on Splunkbase to access Cloud extensions in the Splunk app for Cloud Connect manual.
- Also see Access Splunk Cloud Connect in Splunk Enterprise Security to access Cloud extensions in the Splunk Enterprise Security User manual.
Install Splunk Cloud Connect and Splunk AI Assistant (SAIA)
Follow these steps to upgrade Splunk Cloud Connect and install Splunk AI Assistant:
- Upgrade Splunk Cloud Connect by ensuring that you select the checkbox to upgrade the app.
- Install the Splunk AI Assistant app: Go to Apps and select Manage and then select Install App From File.
Note: SAIA installation prompts you to set up the app. The instructions direct you to the Splunk Cloud Connect Status page to activate the SAIA product. You are now ready to use SAIA and any app that requires STC.
Set up Splunk Cloud Connect
- In Splunk Platform, go to Apps and select Splunk Cloud Connect.
- Select an appropriate Splunk Cloud Region for your connection. For example: US-East; US-West
- Enter a preferred tenant name or identifier. For example,
mytenant, my-tenant, t-name-123.Note: The preferred tenant identifier must begin with one or more lowercase alphanumeric characters, which is optionally followed by hyphen-separated segments of length between 3 and 63 characters. Domain URLs and GUIDs are not supported. Additionally, the segments cannot start or end with a hyphen. - Enter an email address associated with your Splunk purchase account or the Salesforce (SFDC) email associated with your Splunk license account.
- Select the checkbox and agree to the
General Terms. - Select Submit.
- Select Confirm and continue to confirm your Splunk Cloud Connect information.
- Get the one-time passcode from your email and enter the passcode.
- Select Submit.
- Wait for the onboarding process to complete.
Note: You might receive some warnings indicating that STC is not set up. You can ignore those warnings as STC is set up in a future step.
Activate Splunk Enterprise Security services using Splunk Cloud Connect
Follow these steps to activate Splunk Enterprise Security services on Splunk Cloud Connect:
- In the Cloud Connect Overview page, go to Available features.
- Select the Activate button for Splunk Enterprise Security Essentials or Premier.
Note: Wait for the activation to complete. This can take a few minutes. Do not attempt to activate other products or refresh the page.
- Activate Splunk AI Toolkit and wait for it to complete.
Use Splunk Cloud Connect with Splunk tokens
To use Splunk Cloud Connect with Splunk tokens, you must add a certificate file to the [oauth2_settings] stanza in the $SPLUNK_HOME/etc/system/local/authentication.conf configuration file. The certificate file must be the same file across all search heads in a search head cluster. For more information, see authentication.conf file in the Splunk Enterprise Admin Manual. This ensures a secure link between your on-premises deployment and Splunk Cloud Services.
[oauth2_settings]
certFile = <absolute_path_to_cert_file>.pem
sslPassword = <password>
Follow these steps to use Splunk Cloud Connect with Splunk tokens:
- Run the following
curlcommand and replace the <stack-ip> with the IP address of your Splunk deployment.CODEcurl -sku 'admin:Chang3d!' -X POST -d 'name=oauth2_settings' -d 'certFile=/opt/splunk/etc/auth/oauth2_signing.pem' -d "sslPassword=2f62961f331cdf620003bda4e627f3daf1df9b33028004486e5db17318c798f9" 'https://<stack-ip>:8089/servicesNS/nobody/system/configs/conf-authentication?output_mode=json' - Use the
reloadendpoint to ensure that the certificate is refreshed and replace the <stack-ip> with the IP address of your Splunk deployment.CODEcurl -sk -u 'admin:Chang3d!' -X POST 'https://<stack-ip>:8089/services/admin/tokens-keys/_reload?output_mode=json' -
Wait for a minute to pick up the certificate changes to set up using Splunk Splunk Cloud Connect automatically.