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 :
- Internet Information Services (IIS) version 7.0, 8.0 or 10.0 installed.
- Jira server deployed using IIS. More details for integrating IIS Server as a reverse proxy with JIRA is available here: https://confluence.atlassian.com/kb/proxying-atlassian-server-applications-with-microsoft-internet-information-services-iis-833931378.html
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
- Open IIS Manager and find the site being used for Jira. For example: jira.example.com in the above image.
- From the IIS Console, click on jira.example.com and open URL Rewrite
- From the Actions panel on the right-hand side, select "Add Rules" and choose "Blank Rule";
- Add a name for the rule;
- Set Match URL to:
- Requested URL: Matches the Pattern
- Using: Regular Expressions
- Pattern: ^rm/(.*)
- Ignore Case: Checked
- Set Action to:
- Action Type: Rewrite
- Rewrite URL: http://<RMsis_url:Port>/{R:0}
- Append query string: Checked
- Mark Stop processing of subsequent rules
- 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.
Configure RMsis Server :
The server configuration in RMsis will be :
...