Tip: Hide Isis web-app behind normal Apache server

By default, the Isis webapp is served by a Java webapp server (or Jetty) on port 8080.

But what happens if your (or one of your client's) access to port 8080 is blocked by a corporate firewall?

There is a straight-forward workaround if your webapp is running on a server with Apache httpd (Apache Webserver) - Provide the following stanza in your Apache httpd config:

ProxyRequests Off
<Proxy  http://real.webserver.url:80/isis/>
        Order deny,allow
        Allow from all
ProxyPass /isis/ http://localhost:8080/
ProxyPassReverse /isis/ http://localhost:8080/

This will tell Apache httpd to internally redirect all traffic to/from "http://real.webserver.url/isis/" to "http://localhost:8080/".

Additionally, if you wish to provide SSL access to the webapp, change the line as follows:

<Proxy  https://real.webserver.address:443/isis/>

and you'll have SSL access to the webapp!

In the case of one of my clients, the Isis application is running on a virtual server, so the above stanza is defined in the appropriate virtual server configuration file.