Chat now with support
Chat mit Support

Starling Two-Factor Authentication Hosted - RADIUS Agent Administrator Guide

Push notifications in Starling 2FA app

To perform two-factor authentication when you log in to the application using push notifications in the Starling 2FA application, you must have the Starling 2FA app installed on your mobile device or on Desktop, and your mobile phone number must be registered with the app.

NOTE: The Starling 2FA app can be used for two-factor authentication on Android or iOS devices for Mobile versions, and the Windows or Macintosh for Desktop versions.

To use push notifications

  1. If you have not installed the Starling 2FA app, install the app from the app store or using Get the app link (https://2fa.cloud.oneidentity.com/install).
  2. On the application being integrated with RADIUS Agent server, in the token response field, enter Push.
  3. Click Enter.

    You token will be added to the Starling 2FA app.

  1. Open the Starling 2FA app and navigate to the Requests menu.
  2. In the Pending tab, approve the request to log in to the application.

Diagnostic logging

To troubleshoot issues that may occur during authentication with the Starling Two-Factor RADIUS Agent, you must enable diagnostic logging for the Starling Two-Factor RADIUS Agent. By default, diagnostic logging is disabled. After enabling or disabling diagnostic logging, you must restart the Starling Two-Factor RADIUS Agent service.

Enabling diagnostic logging

To enable diagnostic logging for Starling Two-Factor RADIUS Agent

  1. On a computer where the Starling Two-Factor RADIUS Agent is installed, go to the Starling Two-Factor RADIUS Agent folder in the installation directory default path (%ProgramFiles%\One Identity\Starling Two-Factor RADIUS Agent).
    1.  On a computer where the Starling Two-Factor RADIUS Agent version lesser than 7.x installed, make the following changes to the StarlingTwoFactor.RadiusAgent.Service.exe.config file:
      1. In the <log4net debug="false"> entry, set the value to "true". For example, <log4net debug="true">

      2. In the <level value="ERROR" /> entry, set the value to "DEBUG". For example, <level value="DEBUG" />

    2.  On a computer where the Starling Two-Factor RADIUS Agent version 7.x or later is installed , make the following changes to the log4net.config file:
      1.  In the <log4net debug="false"> entry, set the value to "true". For example, <log4net debug="true">.
      2.  In the <level value="ERROR" /> entry, set the value to "DEBUG". For example, <level value="DEBUG" />.
  1. Restart the Starling Two-Factor RADIUS Agent Service.

NOTE: While upgrading from Starling Two-Factor RADIUS Agent earlier versions to version 7.x, the debug logging settings are reset.

Disabling diagnostic logging

To disable diagnostic logging for Starling Two-Factor RADIUS Agent

  1. On a computer where the Starling Two-Factor RADIUS Agent is installed, go to the Starling Two-Factor RADIUS Agent folder in the installation directory (%ProgramFiles%\One Identity\Starling Two-Factor RADIUS Agent)
  2.  On a computer having the Starling Two-Factor RADIUS Agentversion lesser than 7.x installed, make the following changes to the StarlingTwoFactor.RadiusAgent.Service.exe.config file:
    1. Set the <log4net debug> entry value to "false".

    2. Set the <level value="ERROR" /> entry to "ERROR".

  3.  On a computer having the Starling Two-Factor RADIUS Agentversion 7.x or later installed , make the following changes to the log4net.config file:
    1.  Set the <log4net debug> entry value to "false"..
    2. Set the <level value="ERROR" /> entry to "ERROR".
  1. Restart the Starling Two-Factor RADIUS Agent Service.
Verwandte Dokumente