Chat now with support
Chat with Support

Starling Two-Factor Authentication Hosted - HTTP Module Administration Guide

Push Notifications in Starling 2FA App

To use push notifications, you must install Starling 2FA app and register your phone number.

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 on your mobile device, install the app from the app store or using Get the app link (https://2fa.cloud.oneidentity.com/install).
  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 Starling Two-Factor HTTP Module, you need to enable diagnostic logging. You can enable or disable diagnostic logging for the configuration tool and the web UI.

By default, diagnostic logging is disabled. After enabling or disabling diagnostic logging, you must restart the configuration tool and client application.

Enabling diagnostic logging for configuration tool

To enable diagnostic logging for Starling Two-Factor HTTP Module Configuration tool:

  1. On a computer where Starling Two-Factor HTTP Module is installed, go to the bin folder in the installation directory. Normally, the path to the folder is %ProgramFiles%\One Identity\Starling Two-Factor HTTP Module\bin.
  2. Make the following changes to Starling.TwoFactor.HttpModule.Settings.exe.config file in the bin folder:
    • In the <log4net debug="false"> entry, set the value to true. For example, <log4net debug="true">
    • In the <level value="ERROR" /> entry, set the value to DEBUG. For example, <level value="DEBUG"/>

You can find the log file, Configuration.log, in %ProgramData%\One Identity\Starling Two-Factor HTTP Module.

Enabling diagnostic logging for web interface

To enable diagnostic logging for Starling Two-Factor HTTP Module web interface:

  1. On a computer where Starling Two-Factor HTTP Module is installed, go to Starling Two-Factor HTTP Module folder in the installation directory. Normally, the folder path is %ProgramFiles%\One Identity\Starling Two-Factor HTTP Module.
  2. Make the following changes to the web.config and log4net.config files in the Starling Two-Factor HTTP Module folder:
    • In the <log4net debug="false"> entry, set the value to true. For example, <log4net debug="false">
    • In the <level value="ERROR" /> entry, set the value to DEBUG. For example, <level value="ERROR"/>

You can find the log file HttpModuleWeb.log in %ProgramData%\One Identity\Starling Two-Factor HTTP Module.

Related Documents