Downloading and running the installer
The following sections brief about the steps to download and install the latest version of the Starling Two-Factor HTTP Module.
To download the installer
- On the support.oneidentity.com site, sign in to the One Identity account by entering credentials. If you do not have an account, click Sign up for a new account. You also have the option of signing in through the Microsoft account.
The One Identity Support page is displayed.
- In the Identity as a Service section, click Starling Two-Factor Authentication.
- In the Download Software section, click See All Downloads link.
The Starling Two-Factor Authentication - Download Software page is displayed.
- Click Starling Two-Factor HTTP Module 2.3.
The Download Starling Two-Factor HTTP Module 2.3 page is displayed.
- Click Add to Downloads.
- Review the terms and conditions and click Continue.
The Add to My Downloads page is displayed.
- Click Download Now to download the .exe file.
- Alternatively, click Add to My Downloads to save the application in the My Downloads cart. It is recommended to use this option when you are downloading multiple products.
The Starling.2FA.HttpModule.exe file is downloaded.
To run the installer
- Right-click on the installer and click Run as Administrator.
- Follow the instructions on the installer to complete the installation.
NOTE: Elevated privileges are required to run the Starling Two-Factor HTTP Module configuration tool. Once the installation is complete, configure Starling Two-Factor HTTP Module settings. For details, see Starling Two-Factor HTTP Module configuration.
- The default application pool in IIS requires .NET Framework version 4.0 or later.
- The account under which you will be running the Setup must be a member of the local administrators group.
Starling Two-Factor HTTP Module
You can configure the Starling Two-Factor HTTP Module for two-factor authentication by setting the required parameters in the Starling Two-Factor HTTP Module Configuration window.
To complete the configuration process, you must configure the following
Configuring Starling Two-Factor Authentication
Using the Starling Two-Factor HTTP Module Configuration window, you can complete the Two-Factor Authentication configuration for HTTP Module.
To configure the Configuration tab
- In the Starling Two-Factor HTTP Module Configuration window, click the Configuration tab to provide the following details:
- Subscription key: Allows you to enter the subscription key available in the Starling Two-Factor Authentication Dashboard.
- Message: Allows you to enter the message that has to appear in the 2FA app as a push notification for the user.
- Timeout (seconds): Allows you to enter the duration until which the push notification message received on Starling 2FA app is valid.
Configuring user repository for Active Directory
Use the Active Directory tab to configure the user repository details.
To configure the repository for data stored in Active Directory
- In the Starling Two-Factor HTTP Module Configuration window, click the Active Directory tab and configure the following parameters:
- Domain name: Enter the name of the Active Directory domain.
- User name: Allows you to enter the name of the user used for querying the Active Directory.
NOTE: The user account must have read-only permission to query the Active Directory.
- Password: Allows you to enter the Password used to access the Active Directory.
- Base DN: This is the path from where user search is performed. You must specify the root container to search the users in the format cn=users,dc=domain,dc=com, where cn is Common Name and dc is Domain Component. If Base DN is not specified, the entire directory is searched to locate the users.
- Use SSL: Select this check box to enable LDAP over SSL for communicating with the Active Directory server.
- Advanced: Click this button to open the Advanced Settings window to modify the mapping details of the Active Directory attributes.