Installing the Windows Authentication Application

The Windows Authentication application is an additional application you must install for on-premise installations that use Active Directory.

Installation

You must complete the following steps to completely install the Windows Authentication application:

1. Install the Windows Authentication application
2. Configure the Windows Authentication application
3. Configure the HotDocs Identity Server application

1. To install the Windows Authentication application

1. Extract the webhostwinauth zip file provided as part of the HotDocs Hub installation files.
2. Copy the webhostwinauth folder in the extracted folder.
3. Paste the folder into the HotDocs Hub installation directory; by default, this is C:\inetpub\wwwroot.
4. Open Internet Information Services (IIS) Manager.
5. Navigate to the site where HotDocs Hub is installed.
6. Right-click the webhostwinauth folder.
7. Select Convert to Application.
8. Click OK.

2. Configure the Windows Authentication application

You must configure the Windows Authentication application with the location of the HotDocs Identity Server application.

1. Select the webhostwinauth application in IIS.
2. Open Application Settings.
3. Select the IdpReplyUrl key.
4. Click Edit.
5. Enter URL of the HotDocsIdentityServer application in the Value field; by default, this is https://localhost/hotdocsidentityserver/core.  You should use the server name (or the URL used to connect to the server) instead of localhost.
6. Click OK.

3. Configure the HotDocs Identity Server Application

You must configure the HotDocs Identity Server application with the location of the Windows Authentication application.

1. Select the HotDocsIdentityServer application in IIS.
2. Open Application Settings.
3. Select the MetadataAddress key.
4. Click Edit.
5. Enter URL of the webhostwinauth application in the Value field; by default, this is https://localhost/webhostwinauth. You should use the server name (or the URL used to connect to the server) instead of localhost.
6. Click OK.

4. Check Windows Authentication Feature delegation in IIS

1. Open Internet Information Services (IIS) Manager.
2. Select the top-level server node.
3. Open Feature Delegation.
4. Check that the Authentication - Windows settings is set to Read/Write.

Next Steps

Installing HotDocs Server and Web Services