Configuring IIS

The following information provides steps for setting up the IIS Application Request Routing (ARR) module to act as a proxy server.  These directions are for Windows 2012.

1.  Install IIS

If IIS is not installed, use Server Manager to install it by selecting Add roles and features.

This will take you through a setup wizard. In the Server Roles step of the wizard, check the box next to Web Server (IIS) and accept the default sub-components that are pre-selected. 3

2.  Install URL Redirect Component

Once IIS is installed, the URL Redirect component needs to be installed. This is done by launching the IIS Manager and clicking Get New Web Platform Components, which takes you to a Microsoft site where you download, and subsequently run, the Web Platform Installer.

3.  Install ARR Module

Click the Get New Web Platform Components again from the IIS Manager, which will launch an application that lets you search for and install additional components. Search for “Application Request Routing 3.0” and install it by clicking the Add button next to it in the search results, then clicking the Install button at the bottom of the window.

After the installation has completed, restart the system and proceed with the following instructions.

4.  Configure ARR Module

A.  Open IIS Manager.
B.  In the Connections pane, select the server.
C.  Single click Application Request Routing Cache, then select Open Feature from the Actions pane on the right.

D.  Click Server Proxy Settings from the Action pane.
E.  Check the Enable proxy box, then click Apply.

5.  Set up a URL Rewrite Rule

A.  In the Connections pane, select the Default Web Site.
B.  Under the IIS section, double-click URL Rewrite.

C.  In the Actions pane, select Add Rule(s).
D.  Select Blank Rule and click OK.

E.  Assign a new name to the rule.
F.  Enter your MITS Discover or MITS Report path, followed by “.*” in the Pattern field, using the following format: (mitsdiscover.*). Make sure this is enclosed in parentheses.

 If using the MITS Unified Installer, use (.*) in the Pattern field to redirect to the main site, which allows you to choose between MITS Discover and MITS Report.

G.  Set the Action type to Rewrite.
H.  Enter the address and port of your MITS install, followed by “/{R:0}” in the Rewrite URL field, using the following format: http://localhost:8080/{R:0}.
9. Click Apply in the Actions pane on the right.

6.  Configuring Apache

This section provides directions for configuring a proxy server using Apache. These steps assume you already have the MITS application installed.

If your Apache server hosts or will host web pages available to the public internet, do not perform these steps until your Apache server has been properly secured to prevent unauthorized access. An “open” proxy server is dangerous to your network as well as the internet at large, and running an unsecured proxy server could allow unauthorized access to your potentially sensitive MITS data. Tips for securing Apache HTTP Server can be acquired from http://httpd.apache.org. From the list of links on the left select Docs , then Version 2.0, then Modules , then mod_proxy.

1. Open the httpd.conf Apache configuration file in a text editor and make the following changes:

Locate the following lines in the Dynamic Shared Object (DSO) Support section based on the version of Apache HTTP Server in use. Verify that these lines are not disabled. (A disabled line begins with a # sign. To enable a disabled line, simply remove the # character from the beginning of the line.)

If you’re using Apache version 2.x

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so

If you’re using Apache version 1.x

AddModule mod_proxy.c
LoadModule proxy_module modules/mod_proxy.so

Locate the section labeled <IfModule mod_proxy.c>. If this section does not exist, add it as follows:

<IfModule mod_proxy.c> ProxyRequests off
     ProxyPass /mitsweb http://SERVER:PORT
     ProxyPassReverse /mitsweb http://SERVER:PORT
</IfModule>

If this section already exists, add the following line between the <IfModule mod_proxy.c> and </IfModule> tags:

ProxyPass /mitsweb http://SERVER:PORT
ProxyPassReverse /mitsweb http://SERVER:PORT

In the two steps above, “SERVER” and “PORT” should be replaced with the IP address or DNS name and appropriate port number for the MitsWeb Gateway.)

Save the modified httpd.conf file.

2. Restart the Apache HTTP server to apply the new configuration.

3. In the MitsWeb Gateway interface, verify that the Web Service Status is stopped. If it is listening, open the Web Connection menu and select Stop Listening.

4. From the MitsWeb Gateway File menu, select Properties then select Web Properties.

5. Set the Location property to:  http://IP.address.of.Apache.server/mitsweb