Configure an IIS reverse proxy for the Web Task List

The information provided in this section is specific to configuring Internet Information Services (IIS) to act as a reverse proxy using the Application Request Routing (ARR) and URL Rewrite modules.

Before you begin

Tip: Before installing IIS Application Request Routing (ARR), it is recommended that you enable HTTP Logging and Tracing features for IIS first. Tracing makes it possible to diagnose problems with reverse proxy rewrite rules.
Note: Before you make any changes to Internet Information Services (IIS), you may want to export your existing configuration to review it. For more information on an existing Microsoft utility, refer to https://www.iis.net/learn/get-started/getting-started-with-iis/getting-started-with-appcmdexe
  1. From the Control Panel, go to Windows Features to enable the following IIS settings:
    • HTTP Logging
    • Tracing
      Tip: To make it easier to diagnose problems, tracing must be enabled before installing ARR.
    • The ARR and URL Rewrite modules only install their trace providers if those IIS features are already enabled. You can install them later by enabling the IIS HTTP Logging and Tracing features and reinstalling or repairing ARR.
    • Tracing is disabled by default.
  2. Install the IIS ARR 2.5 (or later) module from http://www.iis.net/download/ApplicationRequestRouting.
  3. In the Install window, click Options.
  4. In the Change Options window, when asked which web server you want to use, click the IIS check box.
  5. Click OK, and then click Install.
    Note: The URL Rewrite 2.0 module installs automatically.
  6. Start the Internet Information Service (IIS) Manager application.
  7. From the Start menu, click Administrative Tools > Internet Information Services (IIS) Manager.
  8. Enable the server to act as a proxy.
    Note: This is a server-wide setting.
    1. From the Connections panel, select the server you want to configure.
    2. From the IIS section in the central panel, double-click Application Request Routing Cache.
    3. From the Actions panel, in the Proxy section, click Server Proxy Settings. Application Request Routing opens in the central panel.
    4. Select the Enable proxy check box, and then in the Actions panel, click Apply.

The URL Rewrite rules apply to a single web site. These instructions and rules assume that your server already is configured with a web site, such as Default Web Site, with an HTTPS binding on port 443 that uses a certificate that is trusted by the client machines.

Procedure

  1. In the Internet Information Services (IIS) Manager, in the Connections panel, under the server you are currently configuring, expand the Sites node, and then select the web site that you want to configure.
  2. From the Actions panel, click Explore to open Windows Explorer to the physical directory on disk for your web site.
    • The default location for Default Web Site is C:\inetpub\wwwroot.
    • In this location, you see a file named web.config.
  3. Open another Windows Explorer window and navigate to your Workflow installation directory.
    • On 32-bit systems, the default location is C:\Program Files\Proficy\Proficy Workflow.
    • On 64-bit systems, the default location is C:\Program Files (x86)\Proficy\Proficy Workflow.
  4. In the Workflow installation directory, go to the folder Reverse Proxy Config (IIS) for the reverse proxy configuration files.
    1. From the Reverse Proxy Config (IIS) directory, copy the following files to your web site's directory:
      • rewriteMaps.config
      • rules.config
      • outboundRules.config
    2. For a sample of the web.config showing how to configure the <rewrite> element under <system.webServer>, go to the Reverse Proxy Config (IIS) directory.
      If your web site's web.config has:
  5. Update the rewrite.Maps.config file with the actual server names, as follows:
    1. In the Internet Information Services (IIS) Manager, in the Connections panel, under the server you are currently configuring, expand the Sites node, and then select the web site whose rewriteMaps.config file you want to update.
    2. Double-click the URL Rewrite icon.
    3. From the Actions panel, click View Rewrite Maps. URL Rewrite Maps opens in the central panel.
    4. Double-click ComputerNames. Edit Rewrite Map opens in the central panel.
    5. From the Original Value column, select a server, and then from the Actions panel, click Edit Mapping Entry. The Edit Mapping Entry dialog box appears.
    6. In the New Value field, enter the actual server name, as follows:
      • For the WebServerHostName, enter the fully qualified name of the computer where your Web Task List is installed.
      • For all other server values, enter the fully qualified name of the computer where your servers are installed.
    7. Repeat steps 5e and 5f for each server listed in the Edit Rewrite Map panel.