Description

Microsoft has a routing component for IIS7/7.5 called ARR (Application Request Routing). We have a page about integrating JIRA applications with IIS, which has a similar set of recommended configurations for use with the native-Microsoft routing.

Steps to configure the integration

1. Install Application Request Routing and URL Rewriting on your IIS server;
2. Enable Proxying on ARR:
   
   1. From the IIS7 Console, click on Server_Name and  open Application Request Routing:
      
   2. From the Actions panel on the right hand side, select  "Server Proxy Settings"

   3. Check "Enable Proxy" and set HTTP Version to "HTTP/1.1":
      
      
      

      Make sure to disable "Reverse Rewrite Host in Response Headers" - this can cause problems with URLs being re-written incorrectly:

      1. Click on your Server in the sidebar
      2. Click "Application Request Routing Cache"
      3. Click "Server Proxy Settings"
      4. Untick "Reverse rewrite host in response headers"
3. Add a new site on IIS (i.e jira.example.com);
4. Add a new URL Rewrite Rule for jira.example.com:
   1. From the IIS7 Console, click on jira.example.com and open URL Rewrite:
      
   2. From the Actions panel on the right hand side, select "Add Rules" and choose "Blank Rule";
   3. Set Match URL to:
      1. Requested URL: Matches the Pattern
      2. Using: Regular Expressions
      3. Pattern: (.*)
      4. Ignore Case: Checked
   4. Set Action to:
      1. Action Type: Rewrite
      2. Rewrite URL: http://<JIRA_url:Port>/{R:1}
      3. Append query string: Checked
   5. Mark Stop processing of subsequent rules;
      

5. Click in Request Filtering.
   

6. Then click in Edit Feature Settings:
   
   
7. Check Allow double escaping and hit OK:
   
   

8. Now comment the following section on your <jira-install>/conf/server.xml:

    <Connector port="8080" connectionTimeout="20000" redirectPort="8443" maxThreads="200" minSpareThreads="10" enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8" />

9. Add the parameters proxyName and proxyPort to your <JIRA-install-directory>/conf/server.xml file in JIRA, as in this example;

    <Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxSpareThreads="75" maxThreads="150" minSpareThreads="25" port="8080" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true"
   proxyName="jira.example.com" proxyPort="80"/>

10. Restart your JIRA applications.

Known Issues

• Elements in Jira server fail to render with 400 bad request error

• User session changed or hijacked in Jira server integrated with IIS

• HTTP Error 500.51 when attempting to access Jira through IIS