Chat now with support
Chat with Support

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

Diagnostic logging

To troubleshoot issues that may occur during authentication with Starling Two-Factor AD FS Adapter, you need to enable diagnostic logging. By default, diagnostic logging is disabled.

NOTE: After enabling or disabling diagnostic logging, you must restart AD FS service.

Enabling diagnostic logging

To enable diagnostic logging for Starling Two-Factor AD FS Adapter

  1. On a computer where Starling Two-Factor AD FS Adapter is installed, use the Registry Editor to create the following values in the HKLM\SOFTWARE\One Identity\Starling Two-Factor AD FS Adapter registry key:
    • Value type: REG_DWORD
    • Value name: Diagnostics
    • Value data: 1
  2. Restart the Starling Two-Factor AD FS Adapter service.

The path to the log file: %ProgramData%\One Identity\Starling Two-Factor AD FS Adapter\Diagnostics

File name for Adapter: StarlingTwoFactorAdapter.log

File name for Configuration tool: Configuration.log

Disabling diagnostic logging

To disable diagnostic logging for Starling Two-Factor AD FS Adapter

  1. On a computer where Starling Two-Factor AD FS Adapter is installed, in the HKLM\SOFTWARE\One Identity\Starling Two-Factor AD FS Adapter registry key, delete the Diagnostics value or set the value data to 0 using the Registry Editor.
  2. Restart the AD FS service.

Uninstalling Starling Two-Factor AD FS Adapter

The following section briefs about the steps to uninstall the Starling Two-Factor AD FS Adapter.

Before you uninstall the Starling Two-Factor AD FS Adapter

On Windows Server 2012 R2

  1. On the computer where Starling Two-Factor AD FS Adapter is installed, launch the AD FS Management console.
  2. Navigate to AD FS | Authentication Policies and click Edit Global Multi-factor Authentication.

Alternatively, under Multi-factor Authentication | Global Settings section, click Edit.

  1. In the Edit Global Authentication Policy dialog box, click Multi-factor.
  2. Clear the Starling Two-Factor Authentication check box and click Apply.

On Windows Server 2016 and Windows Server 2019

  1. On the computer where Starling Two-Factor AD FS Adapter is installed, launch the AD FS Management console.
  2. Navigate to AD FS | Service | Authentication Methods.
  3. On the Authentication Methods pane, under Multi-factor Authentication Methods, click Edit .

Alternatively, in the Actions pane, click Edit Multi-factor Authentication Methods.

  1. On the Edit Authentication Methods wizard, under the Multi-factor tab, Clear the Starling Two-Factor Authentication check box and click Apply.

To uninstall the Starling Two-Factor AD FS Adapter

  1. Open Control Panel | Programs and Features.
  2. Click One Identity Starling Two-Factor AD FS Adapter, and then click Uninstall.

NOTE: After uninstalling the One Identity Starling Two-Factor AD FS Adapter, details regarding the Starling Two-Factor AD FS Adapter get deleted from the Starling account.

Related Documents