Skip to main content

Multi-factor app enrollment URL configuration

Use this guide to create an app enrollment page with a URL workflow for end users to connect to their profile in the following ways to enroll and provision any of the following:

  • SecureAuth Passcode app to receive one-time passcodes (OTPs) on their desktop

  • SecureAuth Authenticate app to receive time-based one-time passcodes (TOTPs), push notification one-time passcodes (OTPs), Push-to-Accept, and Symbol-to-Accept login requests on their mobile device

Once provisioned to use SecureAuth Passcode and SecureAuth Authenticate, the passcode and login requests from the app is used to validate the end user attempting to log in to a protected resource.

For supported versions of mobile apps, OTP clients, desktop browsers, and paired smartwatches, see the SecureAuth compatibility guide.

Prerequisites

  • SecureAuth® Identity Platform release 21.04 or later

  • Data store added to the Identity Platform

  • Configured user authentication policy

Identity Platform configuration

  1. On the left side of the Identity Platform, click Internal Application Manager.

  2. Click Add New Internal Application.

  3. Set the Name and Description of the new URL enrollment application.

    The name is shown on the page header and document title on the end user login pages.

    url_enrollment_001.png
  4. Set the following configurations.

    Data Store

    Enter the data store to authenticate and allow user access to the URL enrollment application.

    Groups

    Use one of the following options:

    • Slider in the On position (enabled): Allow users from every group in your selected data stores access to the URL enrollment application.

    • Slider in the Off position (disabled): Enter the specific groups who are allowed access to the URL enrollment application.

    Authentication Policy

    Select the login authentication policy for the URL enrollment application.

    Authenticate User Redirect

    Select the Generic (HTTP/OAuth/OpenID/etc) category.

    Generic (HTTP/OAuth/OpenID/etc)

    Select Multi-Factor App Enrollment - URL.

    Redirect To

    This field is automatically populated by the selection of the Multi-Factor Enrollment - URL as an internal application.

    This is the URL enrollment page the end user lands on after login.

    Multi-Factor App Enrollment section

    Require OATH PIN

    Set to one of the following options:

    • True – To view the time-based one-time passcode (TOTP) on the Authenticate app, require users to provide a PIN or biometric ID (fingerpint)

    • False – PIN is not required to view the TOTP on the Authenticate app

    PIN Length

    Set the number of digits in the PIN (4, 6, 8, or 10 digits).

    url_enrollment_002.png
  5. Click Create Connection.

    This creates a new URL enrollment application with an attached user authentication policy.

    url_enrollment_003.png
  6. Optional: You only need to complete the configuration in Advanced Settings if you want to do any of the following:

    To go to Advanced Settings, click either link at the top or bottom of the Edit Internal Application page.

  7. Use the login URL for your end users to access the URL enrollment page.

    You can find this on the main Internal Application Manager page or when you edit the URL enrollment application in the Redirect Information section.

    url_enrollment_005.png
    url_enrollment_006.png