Configuring Two Factor Authentication (2FA) - On Premise Only

Updated by Cheryl Wallace

ToolHound supports Two Factor Authentication (2FA) or two-step verification using your choice of authenticator app, such as Microsoft Authenticator, as an additional layer of authentication for user logins on top of either passwords or SSO.

For ToolHound On Premise only, 2FA must be first be configured before being enabled. For ToolHound Cloud subscribers, this is not necessary.

Watch this video overview of using 2FA.
Step 1: Configure the ToolHound server

Edit appsettings.json file in the installation path on the application server.

  1. Add the Authentication block as shown below and add the parameter "UseTwoFactor": true.

"Authentication": {

"UseTwoFactor": true

}

If the Authentication block already exists, add the parameter "UseTwoFactor": true.

"Authentication": {

"Google": {

"ClientSecret": "xxxx",

"ClientId": "xxxx"

},

"Microsoft": {

"ClientSecret": "xxxx",

"ClientId": "xxxx"

},

"UseTwoFactor": true

}

Note: If this is not the last block in the file, add a comma after the last }.

  1. Restart the ToolHound web site in IIS.
Step 3: Enable 2FA in the Settings

This can be done by the ToolHound administrator in the browser.

  1. Log in to the browser.
  2. Click Utilities > Settings.
  3. Select the Authentication tab.
  4. Select Use Two Factor Authentication.
If Disable Local Login has been selected as a Single Sign On (SSO) option on the left, Two Factor Authentication will not be available.
  1. Click . The changes will take effect for the next user login. Each user will be able to configure 2FA for their login.

See also:

​Copyright © 2020-2024 ToolHound Inc. All Rights Reserved.


How did we do?