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 3.0.
The Download Starling Two-Factor HTTP Module 3.0 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.
- In case of an upgrade from Starling Two-Factor HTTP Module 2.x to 3.0, you must connect to Starling as the Subscription key related provision is removed. Connect to Starling using the credentials that were used earlier to create the Starling account.
- All configurations that were part of the earlier version of HTTP Module will be retained after the upgrade. For more information on connecting to Starling, see Connecting Starling for authentication.
Starling Two-Factor HTTP Module Configuration
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.
You can set the parameters using the following options that are displayed on the Starling Two-Factor HTTP Module configuration window:
- Home: Displays the various configuration options in a tree view and as tiles.
- Connect Starling: Allows you to connect to the Two-Factor Authentication subscription by logging in to your One Identity Starling account.
- Push Notification: Allows you to configure the push notifications messages and timeout settings.
- Active Directory: Configures the repository for data stored in Active Directory.
- Protected Server Sites : Allows you to protect the websites hosted on your IIS.
Connecting Starling for authentication
To use the Starling Two-Factor authentication for HTTP Module, you must first connect to Starling using the Starling Join option available for One Identity on-premises products.
To obtain a Starling Two-Factor Authentication subscription and register with Starling, click https://www.cloud.oneidentity.com/.
NOTE: If you do not have a Starling account, you can create a new account. For more information on creating a Starling account, see the One Identity Starling User Guide.
To connect to Starling for authentication, see
Prerequisites to connect Starling
Following are the prerequisites to connect to Starling
- User must have One Identity Starling account. For more information on creating a One Identity Starling account, see the Starling Two-Factor Authentication Administration Guide.
- The Starling Account must be activated with a valid Two-Factor Authentication subscription.