Using a Proxy Page with the HTML5 viewer

Overview:
In order to see a map image in a viewer, your web browser must be able to make a web request for the map image. Sometimes, restrictions beyond our control prevent this, such as:

• Making a request to the server violates a cross-domain, cross-scheme, or cross-zone policy
• The services we wish to consume are published on a network we can't access directly
• The services are secured in a way that our plugin / API / browser cannot traverse
• The remote site administrator has not configured a cross domain policy file

To overcome these issues, a proxy page can be configured to make requests on behalf of the Viewer. ESRI has a proxy application that can be configured in IIS: http://resources.arcgis.com/en/help/silverlight-viewer/concepts/index.html#//01770000004q000000

A similar application is included with the Geocortex Viewer for HTML5. The purpose of the proxy page is to provide access to resources that you would otherwise be unable to access.

Solution:
To configure the Geocortex Viewer for HTML5 to use a proxy page:

1. Configure the Proxy Page to Connect to the Map Service
2. Configure a Viewer, Service Connection or Map Service to use the Proxy Page

Configure the Proxy Page to Connect to The Map Service

To configure the proxy page, edit the proxy.config file that exists where you've deployed the Viewer template (default: C:\inetpub\wwwroot\Html5Viewer). Add an entry for the URL that you want to allow the proxy to pass requests to. For your password protected services, you may also provide a token (a long-lived token), or modify the proxy.ashx code to have it request a token on-demand.

The line in proxy.config would be something like:

<serverUrl url="https://MyServerURL.com/ArcGIS/rest/services/"
matchAll="true"></serverUrl>

Configure a Viewer, Service Connection or Map Service to use the Proxy Page

Configure a Viewer to use the Proxy Page:

1. In Essentials Manager, open the Viewer for editing.
2. In the left-side menu, select Application.
3. In the Proxy URI: field, specify the URI of your proxy page. A relative URL is preferred, since the proxy page is being used to ensure that we're connecting to a known URL. For the proxy page that comes with the HTML5 Viewer, enter: proxy.ashx?
4. Apply Changes and Save Site. 

Configure a Service Connection to use the Proxy Page:

1. In Essentials Manager, open Service Connections.
2. Select your Service Connection in the left menu, or click Add Connection to create a new one.
3. Under Proxy Settings, in the Proxy URL: field, specify the URI of your proxy page. 
4. Apply Changes and Save Site. 

Configure a Map Service to use the Proxy Page:

1. In Essentials Manager, open the Site for editing.
2. In the left-side menu, select Map, then go to the Map Services tab.
3. Click the Edit map service icon.
4. Click the Edit Connection Settings button.
5. Under Proxy Settings, select Proxy Page.
6. In the Proxy URL: field, specify the URL of your proxy page. 
7. Apply Changes and Save Site. 

You can test the configuration by requesting a URL that is the combination of the proxy page and the service address, for example:

http://myserver.domain.com/proxy.ashx?https://remote.server.com/ArcGIS/rest/services?f=json

If you're having trouble using a proxy page with the HTML5 Viewer, please contact Geocortex Support (support@geocortex.com)