Chat now with support
Chat mit Support

Starling Two-Factor Authentication Hosted - HTTP Module Administration Guide

OTP through Starling 2FA app

To generate OTP through Starling 2FA app

  1. If you have installed Starling 2FA app, your account is added to Starling 2FA app. If you have not installed the Starling 2FA app, install the app and register your phone number. Your account will be added to the Starling 2FA app.

NOTE: Install the Starling 2FA app either by clicking the link in the SMS you have received or from the app store.

  1. Enter the received OTP from the Starling 2FA App in the token response field of the Starling Two-Factor Authentication Token Response page, and click Continue to log in.

NOTE:

  • The Starling 2FA app is available on Android and iOS for Mobile versions, and Windows and Macintosh for Desktop versions.
  • You can download the Starling 2FA app using Get the app link (https://2fa.cloud.oneidentity.com/install) to automatically detect which version to install.

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.

Verwandte Dokumente