Chat now with support
Chat with Support

Starling Two-Factor Authentication Hosted - AD FS Adapter Administrator Guide

Connectivity requirements

After verifying and setting up the prerequisites, request the Starling Two-Factor Authentication subscription.

Starling Two-Factor AD FS Adapter communicates with Starling Two-Factor Authentication on SSL/TCP port 443. Since the IP addresses may change over time, you must not lock down the firewall to individual IP addresses.

Downloading Starling Two-Factor AD FS Adapter installer

The following section briefs about the steps to download the latest version of the Starling Two-Factor AD FS Adapter.

To download the installer

  1. On the support.oneidentity.com site, sign in to the One Identity account by entering the appropriate credentials. If you do not have an account, click Sign up for a new account. You also have the option to sign in through the Microsoft account.

    The One Identity Support page is displayed.

  2. In the Identity as a Service section, click Starling Two-Factor Authentication.

    The Product Support - Starling Two-Factor Authentication page is displayed.

  3. Click Install & Upgrade.
  4. Click Starling Two-Factor AD FS Adapter 7.1.

    The Download Starling Two-Factor AD FS Adapter 7.1 page is displayed.

  5. Click Add to Downloads.
  6. Review the terms and conditions and click Continue.

    The Add to My Downloads page is displayed.

  7. Click Download Now to download the .msi file.
  8. Alternatively, click Add to My Downloads to save the application in the My Downloads cart. It is recommended to use this option when you download multiple products.

    The StarlingTwoFactorADFSAdapter.msi file is downloaded

Running the Starling Two-Factor AD FS Adapter installer

The following section briefs about the steps to install the latest version of the Starling Two-Factor AD FS Adapter.

To run the installer

  1. Launch Starling Two-Factor AD FS Adapter installer MSI from an elevated command prompt or right-click on the installer and select Run as Administrator.

  1. Complete the remaining steps for installing Starling Two-Factor AD FS Adapter.

    NOTE: AD FS Service will restart during installation.

IMPORTANT: In case of an upgrade from Starling Two-Factor AD FS Adapter 6.x to 7.1, you must connect to Starling as the Subscription key related provision is removed. Connect to Starling using the credentials that were used to create the Starling account. You must configure the Push notification and AD attributes again, to overwrite the default values. For information on connecting to Starling, see Connecting Starling for authentication

Starling Two-Factor AD FS Adapter Configuration Settings

You can configure the Starling Two-Factor AD FS Adapter for two-factor authentication by setting the required parameters in the Starling Two-Factor AD FS Adapter Configuration window. You can set the parameters using the following options that are displayed on the Starling Two-Factor AD FS Adapter 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.
  • Attribute names: Allows you to specify the Active Directory attributes, which are used to retrieve the values for user who has logged in to the Starling Two-Factor AD FS Adapter.
Related Documents