Skip to content

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:

  1. On the Studio Designer page, click App Settings (top right).
  2. Go to the Authentication tab.
  3. In the Setup section, enter:

    FieldDescription
    Challenge Page AppSelect 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 AppMap 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:
    FieldDescription
    Verification Methods and PrecedenceSelect 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.
    TimeoutThe 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 allowedSets 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 MaskLists 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 AuthenticationThe OTP challenge sent to the user contains one of the following:
    • One Time Code
    • Secure Link
    Require User to Confirm OTP AddressThis is an additional layer of security. It prompts the user to type in their full email address or mobile number.
    Email ContentSelect the email response template to use.
    Whether Users Can Select the Verification MethodSelect 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 LengthLength of the password that is sent to the user. Minimum 6, maximum 9 characters in length.
    Code TypeBy default, the code is numbers only but you can choose to use a code that is alphanumeric,
  4. In the Get Authentication Details section, enter:

    FieldDescription
    Select Authentication Details Action SetSelect the action that gets the authentication details.
    The response properties are for the OTP challenge.
    Select response propertiesSelect 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.