Shinydocs Pro Enterprise Search with IIS

This feature was released in Shinydocs Pro v 24.3.0

To use Shinydocs Pro Enterprise Search with Microsoft IIS, you will need a few dependencies installed on all servers hosting Search:

• Shinydocs Pro installed

• https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-7.0.17-windows-hosting-bundle-installer

• IIS Feature: Windows Authentication

  • Added via Server Manager (Web Server (IIS) > Web Server > Security)

Once Shinydocs Pro is installed, note the installation directory. The default is C:\Program Files\Shinydocs Professional\Search, but you may have chosen to install it in a different directory.

1. Ensure permissions are set properly for the search folder

   1. Right-click on the Search folder and go to Properties > Security 

   2. Add IIS_IUSRS to the permissions of the folder and give Read access

   3. Ensure IIS_IUSRS or the Application Pool user has Write access to the web.config file

2. Create the Enterprise Search site

   1. Start Internet Information Services (IIS) Manager

   2. In the Connections panel on the left side, expand the tree

   3. Right-click on Sites and select Add Website

   4. In the Add Website window, enter a Site name (for example, Enterprise Search)

   5. Enter the Physical path to the extracted folder from Step 1 (for example, C:\Program Files\Shinydocs Professional\Search)

   6. Set the port you wish to use (44300 is recommended if configuring SSL)

3. Configure the Enterprise Search site authentication in IIS

   1. Select the Enterprise Search site you created in the previous steps

   2. In the middle panel, under the IIS section, double-click Authentication 

   3. Enable Anonymous, Windows Authentication and ASP.NET Impersonation

   4. Disable Basic Authentication, and Forms Authentication

4. Edit appsettings.json in …\Shinydocs Professional\Search

   1. If you are updating from an older version of Search where the configuration was in web.config, copy your existing "SettingsIndexName"and "SettingsEncryptionKey"

      1. Replace "SettingsIndexName" value with your web.config value

      2. Replace "SettingsEncryptionKey" value with your web.config value

      3. If you are using ElasticSearch, change IndexType to "IndexType":"Elasticsearch"

   2. Ensure IndexServerUrl is using appropriate HTTP or HTTPS

   3. If your configuration has an index username and password enter it as values for the appropriate key.

5. Using IIS Manager Restart the Application

Setting Up Secure Sockets Layer (SSL) on the Enterprise Search Site

1. Start Internet Information Services (IIS) Manager

2. Add HTTPS binding to the site

   1. With your site selected in the Connections panel, select Bindings in the Actions panel

   2. In the Site Bindings window, click Add

   3. Select “https” from the Type dropdown

   4. Ensure IP address is “All Unassigned” (for typical deployment)

   5. If your organization has multiple websites running on a single IP address, update the Host name field with the domain or subdomain value

   6. Specify the Port (typically port 44300 for SSL)

   7. Select the ShinydocsPlatformSelfSigned SSL certificate dropdown if you have already used the Platform installer.

   8. Click OK