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.

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
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>
```
- In the <proxy> element, set the proxyaddress attribute to the URL of your proxy server, followed by a colon and its port number. For example, http://MyProxyServer.com:1234.
  
  Your IT department should be able to supply the URL and port number of your proxy server. You may also be able to determine these values by opening Internet Explorer on your Essentials server, and viewing Internet Options > Connections > LAN settings.
- In the first <add> element, set the address attribute to the computer name of the Essentials server. For example, MyComputerName.
- In the second <add> element, set the address attribute to the IP address of the Essentials server. For example, 10.0.0.1.
Save the file.
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