Downloading and running the installer
The following sections briefs about the steps to download and install the latest version of the Starling Two-Factor RADIUS Agent.
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.
The Product Support - Starling Two-Factor Authentication page is displayed.
- Click Install & Upgrade tab.
- Click Starling Two-Factor RADIUS Agent 7.2.
The Download Starling Two-Factor RADIUS Agent 7.2 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 .zip file.
- 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 StarlingTwoFactorRADIUSAgent.zip file is downloaded.
To run the installer
- Extract the downloaded StarlingTwoFactorRADIUSAgent.zip file to your local drive.
The extracted folder contains Setup.exe and StarlingTwoFactorRADIUSAgent.msi files.
- Right click Setup.exe file and click Run as Administrator.
- Follow the instructions on the installer screens to complete the installation.
NOTE: Once the installation is complete, configure Starling Two-Factor RADIUS Agent settings. For details, see the Starling Two-Factor RADIUS Agent configuration.
The account under which you will be running the Setup must be a member of the local administrators group.
IMPORTANT: In case of an upgrade from Starling Two-Factor RADIUS Agent 6.x to 7.2, 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. All configurations that were part of the earlier version of RADIUS Agent will be retained after the upgrade. For information on connecting to Starling, see Connecting Starling for authentication.
Starling Two Factor RADIUS Agent settings
You can configure the Starling Two-Factor RADIUS Agent for two-factor authentication by setting the required parameters in the Starling Two-Factor RADIUS Agent Configuration window. You can set the parameters using the following options that are displayed on the Starling Two-Factor RADIUS Agent configuration window:
- Home: Displays the various configuration options in a tree view and as tiles.
- Server Settings: Allows you to configure the RADIUS server by providing the IP address and port number.
- 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.
- User Repository: Allows you to specify the repository for storing the user data. The available options are Active Directory or as a comma-separated values (CSV).
- Client Settings: Allows you to configure the RADIUS clients who need to be authenticated using the Starling Two-Factor authentication.
Configuring RADIUS Agent Server Settings
To configure the RADIUS Agent server settings
- In the Server Settings section on the Starling Two-Factor RADIUS Agent Configuration window, provide the following details:
- IP address: IP address of the RADIUS Agent server, that validates the authentication requests. The field lists all the IP addresses (IPv4 addresses) on the server and displays the first server in the list. Select the IP that you want to use for authentication.
- Port number: The port number that the RADIUS Agent will use to receive the authentication requests. The default port is 1812. You must configure the firewall exceptions manually to allow Starling Two-Factor RADIUS Agent traffic on the selected port.
- After completing the configuration, click Save Settings.
The Starling Two-Factor RADIUS Agent configuration dialog is displayed prompting you to restart the service.
- Restart the Starling Two-Factor RADIUS Agent service to save the changes.
Connecting Starling for authentication
To use the Starling Two-Factor authentication for RADIUS Agent, 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: