Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

RMsis can be configured to run using IIS in reverse proxy Configuration. Configuring a reverse proxy server allows for running RMsis on non-standard HTTP/HTTPS port (such as 3060) and users will be able to access RMsis over standard HTTP/HTTPS as their traffic will be routed through the proxy.

This page describes how to integrate IIS Server with RMsis, utilizing URL Rewrite so that IIS operates as a reverse proxy over HTTP/HTTPS. 

Target Audience :

The target audience for this document are users who want to

  • access RMsis over HTTPS but do not want to install/ configure a security certificate. 
  • run RMsis behind a reverse proxy server using IIS.  

Prerequisites :

The following are the prerequisites for running RMsis behind a reverse proxy server :

A typical Reverse Proxy Configuration

If the above-mentioned prerequisites are fulfilled, a typical reverse Proxy Configuration with JIRA and RMsis running on HTTP will look like this: 

...

Now, We need to configure links #3, and #5 (Link #4 is automatically created by RMsis).

Add URL Rewrite Rule for RMsis Server

  1. Open IIS Manager and find the site being used for Jira. For example: jira.example.com in the above image.
  2. From the IIS Console, click on  jira.example.com  and open URL Rewrite
  3. From the Actions panel on the right-hand side, select "Add Rules" and choose "Blank Rule";
  4. Add a name for the rule;
  5. Set Match URL to:
    1. Requested URLMatches the Pattern
    2. UsingRegular Expressions
    3. Pattern^rm/(.*)
    4. Ignore CaseChecked
  6. Set Action to:
    1. Action TypeRewrite
    2. Rewrite URL http://<RMsis_url:Port>/{R:0}
    3. Append query stringChecked
  7. Mark Stop processing of subsequent rules
  8. Click on Apply to apply the changes.

Sample Reverse Proxy Configuration for IIS:

If JIRA is running under the root context "/jira",then the URL Rewrite rules for both JIRA and RMsis servers would be:

...

Note : The reverse proxy URL Rewrite rule for RMsis should be written before the URL Rewrite directives for JIRA in the IIS configuration. It will be listed below the Jira URL Rewrite rule by default, move it up using the "Move up" link. See attached image for reference. 

Restart IIS to apply the changes.

Image Added

Configure RMsis Server :

The server configuration in RMsis will be :

...