Splunk® Enterprise

Securing Splunk Enterprise

Download manual as PDF

Download topic as PDF

Configure Splunk Enterprise to use RSA Authentication Manager multifactor authentication via the REST endpoint

You can configure multifactor authentication via REST endpoints.

  • To configure multifactor authentication for Splunk Web, you use the /services/admin/Rsa-MFA endpoint. To enable CLI and management port, set the parameter enableMfaAuthRest to true.
  • To verify the authentication, you use the /services/admin/Rsa-MFA-config-verify/ endpoint.

For details, see the REST API documentation for RSA_Multifactor_Authentication_REST_API_usage_details.

Two factor authentication when connecting to REST endpoints

When multifactor authentication is turned on for the management port, the user will need to pass the passcode encoded in the basic auth header to authenticate the user. The passcode is a combination of the user's authentication PIN and the RSA-generated tokencode. For example, if the user's PIN is 1111 and RSA generates a tokencode of 2222, the passcode is 11112222.

The following command shows the user passing the passcode 11112222 to authenticate: curl -k -u user1:root_123:11112222 -X GET https://localhost:8090/services/saved/searches

You may also need to connect to the auth/login REST endpoint using the RSA tokencode to acquire a session key. For example:

curl -k https://localhost:8089/services/auth/login -d username=user1 -d password=changed -d passcode=11112222
<response>
<sessionKey>LfyRYqGEvt6aeOcotdBvqLBTDGG6Jk6HJEx56WqrhBYNrWrZRFrZ8XBgPRh4_kbrBMN4oJa2BF4dat7PjwB23Ebl6mmCYuGcXYJN4U1BJzCEviqVKKN</sessionKey>
<messages>
<msg code=""></msg>
</messages>
</response>

You cannot use the SDK to authenticate once the backend RSA multifactor authentication is enabled.

PREVIOUS
Configure RSA authentication from Splunk Web
  NEXT
Configure Splunk Enterprise to use RSA Authentication Manager multifactor authentication in the configuration file

This documentation applies to the following versions of Splunk® Enterprise: 7.2.0, 7.2.1, 7.2.2, 7.2.3, 7.2.4, 7.2.5, 7.2.6, 7.2.7, 7.3.0, 7.3.1


Was this documentation topic helpful?

Enter your email address, and someone from the documentation team will respond to you:

Please provide your comments here. Ask a question or make a suggestion.

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters