Run Essentials with a Proxy

The following information only applies if your Essentials server must use a proxy to make connections to the Internet.

This topic refers to using a forward proxy, not to be confused with a reverse proxy. A forward proxy handles outbound requests from the Essentials server, whereas a reverse proxy handles incoming requests and directs them to the Essentials server.

A proxy makes and returns requests on behalf of another computer, in this case, the Essentials server. A typical reason to use a proxy is to allow Internet access to computers restricted by a firewall.

If the Essentials server must use a proxy to make connections to the Internet, you must configure Essentials so that requests to map services are handled via the proxy. However, Essentials may also use the proxy to make requests to Geocortex Core when retrieving roles and security settings despite being hosted on the same server. This can cause slow or unreliable performance in Manager. To avoid this problem, configure a proxy bypass list to exclude the Essentials server that hosts Geocortex Core.

To configure Essentials to run with a proxy:

In this procedure, you will edit two Web.config files: one for Manager and one for Essentials REST API. The procedure is the same for both.

  1. Open the Manager Web.config file as an administrator. By default, this file is located at:

    C:\Program Files (x86)\Latitude Geographics\Geocortex Essentials\Default\REST Elements\Manager\Web.config

  2. Within the <system.net> element, add or set the following:

        <defaultProxy>
          <proxy proxyaddress="http://MyProxyServer.com:1234" bypassonlocal="True" />
          <bypasslist>  
            <add address="MyComputerName" />
            <add address="10.0.0.1" />
          </bypasslist>  
        </defaultProxy>
  3. Save the file.

  4. Repeat this procedure for the Essentials REST API Web.config file. By default, this file is located at:

    C:\Program Files (x86)\Latitude Geographics\Geocortex Essentials\Default\REST Elements\REST\Web.config

© 2019 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 4.11