Splunk® Enterprise

Securing Splunk Enterprise

Configure Duo multifactor authentication for Splunk Enterprise in the configuration file

You can configure Duo multifactor authentication in Splunk Enterprise using configuration files.

The authentication.conf file determines how Splunk Enterprise uses Duo multifactor authentication to log in.

To configure Duo multifactor authentication with this file, take the following steps:

  1. On the Splunk Enterprise instance where you want to configure Duo multifactor authentication, open the $SPLUNK_HOME/etc/system/local/authentication.conf file for editing.
  2. In the authentication.conf file, edit the [<2FA stanza name>] stanza as follows:
    [authentication]
    externalTwoFactorAuthVendor = <Duo>
    externalTwoFactorAuthSettings = <2FA stanza name, usually 'duo-mfa'>
    
    [<2FA stanza name>]
    universalPrompt = True | False (Default: True)
    apiHostname = <API Hostname as provided by Duo>
    integrationKey = <Integration Key as provided by Duo>
    secretKey = <Secret Key as provided by Duo>
    appSecretKey = <Manually generated secret key specific to the Splunk application, required if 'universalPrompt=False'>
    failOpen = True|False (Default: False)
    timeout = <in seconds>
    
  3. Save the authentication.conf file and close it.
  4. Restart Splunk Enterprise.

If the universalPrompt setting has a value of True, it means that the Splunk platform uses the Universal Prompt for Duo multifactor authentication. The value of False means that Splunk Enterprise uses the existing Traditional Prompt experience.

Due to the announced deprecation of the Traditional Prompt, continued use of this experience might result in authentication failure in the future.

Last modified on 11 September, 2024
Configure Splunk Enterprise to use Duo Security multifactor authentication   Migrate from the Duo Traditional Prompt to the Duo Universal Prompt

This documentation applies to the following versions of Splunk® Enterprise: 9.1.6, 9.1.7, 9.2.3, 9.2.4, 9.3.1, 9.3.2, 9.4.0


Was this topic useful?







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