Versions Compared

Old Version 3

changes.mady.by.user Terry van der Griend

Saved on

compared with

New Version Current

changes.mady.by.user Mark Sloof

Saved on

Key

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

...

It is not uncommon when installing Blueriq on a virtual machine in the cloud to not expose the machine directly to the internet, but to configure it behind a reverse proxy. This is done to limit direct access to virtual machine and to only allow traffic over ports 80 and 433443. When this is done you will need to configure the X-Forwarded headers for the Runtime to work as intended. The Blueriq Runtime uses HATEOAS to construct urls to where resources can be found, HATEOAS itself uses the X-FORWARDED headers to determine the original request url which was used to reach the Blueriq Runtime. Without configuring the X-Forwarded headers, the Runtime would return build resource urls based on the request it got from the reserve proxy. 

...

Without configuring the X-Forwarded headers on the proxy the following will happend happen when sending a request to test.example.com/Runtime.

  1. A request a is made to test.example.com/Runtime → request is https://test.example.com/Runtime
  2. The request is proxied through 10.0.12.1 → new request is http://10.0.12.1/Runtime
  3. The Runtime will return a resource links for → http://10.0.12.1

When the X-Forwarded headers are configuredin configured in the proxy to take over the original request details, the Runtime will be able to determine the correct resource urls.

...

  1. Go to Internet Information Services (IIS) Manager. 
  2. Select the Runtime folder in Blueriq site and from the Features view, open the "vURL Rewrite" feature. 
  3. In the URL Rewrite feature view select "ReverseProxyInboundRule", and from the Inbound Rules click the "Edit..." action.
  4. In the Edit Inbound Rule scroll down to the Server Variables and select the "HTTP_X_FORWARDED_PROTO" variable, click in on "Edit..."
  5. In the Set Server Variable window check off the "Replace the existing value" checkbox, and click on "OK" to save setting. This is done to keep the existing X_FORWARDED_PROTO header from the proxy.
  6. In the Actions menu select "Apply", to save the Inbound Rule settings.

...