Proxy Configuration

Overview

Decisions has the ability to handle proxied requests so that all traffic goes back through the host site. This allows everything to remain as same-origin from the browser's point of view. This ability is useful for self-hosted scenarios, where it is less likely that IIS or another technology is in between and could be used as a reverse proxy.

Configuration

The following example will demonstrate how to configure the Settings.xml file for proxy.

1. Navigate to C:\Program Files\Decisions\Decisions Server and open the Settings.xml file. 
2. Edit the Settings.xml file to include a true value for AllowProxyFrom and include the appropriate 'scheme:host' value for the ProxyFromWhiteList configuration option.

   Configuration	Description
   AllowProxyFrom	True or False value. Allows feature to be enabled or disabled. Default is false.
   ProxyFromWhiteList	Comma-separated string-list of 'schema:host' values. Specifying a 'schema:host' value will limit where Decisions UI will rewrite UI traffic to. If nothing is specified, it will allow proxies from anywhere.

   <Settings>
    ...
    <ForceBaseURI />
    <AllowProxyFrom>true</AllowProxyFrom>
    <ProxyFromWhiteList>http://site-1,https://site-2</ProxyFromWiteList>
    ...
   </Settings>
   

After enabling the proxy, the proxy will forward traffic, for example, from https://host-server/decisions to https://d-server/decisions. It will also change the origin of each request and add 'x-proxied-from : "https://host-server"'.

If the base path is different than the proxy test path, then the proxy will rewrite the base path. This could mean clearing it of its host at the root or setting it to the actual path. If there is a specified path, there is an additional header, x-proxied-from-path-base, which allows the user to specify a different base path.     

Proxy with 8 at root

When the proxy is at the root, the proxy will forward traffic (e.g. from https://host-server/decisions to https://d-server/) and change the origin of each request. It will then rewrite the path (e.g., "/decisions" to ""') and add 'x-proxied-from : "https://host-server"'.

Proxy at Different Path Base

When the proxy is at a different path base, the proxy will forward traffic (e.g., from https://host-server/decisions to https://d-server/d-8) and change the origin of each request. It will then rewrite the path (e.g., "/decisions" to "/d-8) and add 'x-proxied-from : "https://host-server"' and 'x-proxied-from-path-base : "/d-8"'.