Authentication settings for apps with OTP challenge¶
In the public portal app that you want to protect by using authentication, you need to configure the authentication settings. These settings make the app into a personalized app. As part of this, you can increase security by configuring a one-time passcode (OTP) challenge. There are different options available:
- Send a one-time password/code to the user's email address
- Allow the user to choose where to receive the password
- Verify that the user owns the email address or mobile phone number by requiring them to type it in
Note: For details of how to configure authentication without OTP.
To configure authentication for a personalized portal app that is using an OTP challenge:
- On the Studio Designer page, click App Settings (top right).
- Go to the Authentication tab.
In the Setup section, enter:
Field Description Challenge Page App Select the app configured as the challenge app. The app must be live.
Note: If you change this later, then save the app before continuing to configure the settings.Required Inputs from Challenge App Map the inputs required by the challenge app to the form that you created for the challenge app input parameters. 4. In the OTP Configuration section, enter the details for sending an OTP challenge. This sends a one-time password or secured link depending on the configuration: Field Description Verification Methods and Precedence Select the verification method and then drag to change the precedence:
• Email: defaults to the outbound email address defined for the contact center unit.
Note: You need to select the verification methods before dragging to change the order.Timeout The OTP challenge expires after the timeout period. Maximum timeout is 60 minutes.
Note: The expiry time is calculated from when the email is sent and not from when the user receives it.Maximum failed attempts allowed Sets a limit on the number of attempts to enter the OTP code. For example, if you enter 1 then the user can only make one mistake before their session expires and they must start again.
The minimum is 1 and the maximum is 5.Email From Address, Email Mask Lists the system email address available for sending emails. You can change the character used in the mask and/or select a different mask. Mode of Authentication The OTP challenge sent to the user contains one of the following:
• One Time Code
• Secure LinkRequire User to Confirm OTP Address This is an additional layer of security. It prompts the user to type in their full email address or mobile number. Email Content Select the email response template to use. Whether Users Can Select the Verification Method Select the verification method to use:
• Always: lets the user choose between receiving an email even if there is no choice because the user has a mobile phone number but no email address (for example).
• Never (Configured Precedence): you send the challenge using your preferred verification method. If that is unavailable, then you use the alternative method.
In the current release, there is only one verification method: Email. Please select 'Always' or 'Never.'Code Length Length of the password that is sent to the user. Minimum 6, maximum 9 characters in length. Code Type By default, the code is numbers only but you can choose to use a code that is alphanumeric, In the Get Authentication Details section, enter:
Field Description Select Authentication Details Action Set Select the action that gets the authentication details.
The response properties are for the OTP challenge.Select response properties Select the provider property that provides the data for the OTP challenge. For example, for email, which response property contains the email address. 2. Click Continue to save the authentication settings.