Showing results for 
Search instead for 
Do you mean 

How to make Consumer Portal working with HTTPS?

by Technical Evangelist ‎11-15-2017 01:37 AM - edited ‎05-24-2018 01:35 AM (4,598 Views)


How can I configure Consumer Portal layout to work under secured (HTTPS) protocol?


In order to make Consumer Portal work under secured connections there are few additional configuration settings needed.

Background Information

The Consumer Portal is a lightweight client application and thus requires a server backend service to provide necessary data and search services. There are two backend services used:

  • Backend
    Default Application Pool assigned: BackendAppPool
    Location: C:\Program Files\Common Files\Hexagon\Services\AdminInstances\Backend
  • BackendWMPS
    Default Application Pool assigned: BackendWMPSAppPool
    Please see comment below how to properly configure this service...

Those backend services use unsecured HTTP protocol by default and this will cause either mixed-content errors or service unavailable errors (depending on IIS settings) when HTTPS Consumer Portal tries to access them.


To fix this, make copies of the backend services under the secured web site, or simply make sure that you can access them through HTTPS.


This sample request can be used to check if the backend works with HTTPS: https://<server_address>/backend/v2/connection/setcookie

It should respond with a blank page and 200 OK status (e.g. when checking in browser developer console).


Please refer to attached screenshot showing a sample configuration.

Additional Constraints

  • In default configuration, OSM tiles will throw mixed-content errors in the console, since they use HTTP protocol. Still, they will display.
    • You can specify different OSM tile server which supports HTTPS in the <ConsumerInstance>\data\Default_OSM.json file, "services" JSON configuration section.
  • Only HTTPS services (WMS/WMTS) can be used in such Consumer portal configuration
  • WMPS won't work as it currently does not support HTTPS
by Technical Evangelist
on ‎01-11-2019 02:06 AM

Hi Colin,

I suspect there's some problem with the BackendWMPS - please check browser's Developer tools > Network tab to see what requests are being sent to the BackendWMPS and what is the response. It may give you some information.


Please also note that Consumer and its Backends vs. HTTPS protocol are currently still-in-progress by development team. Full out-of-the-box HTTPS support is planned for the next major release.



on ‎01-11-2019 03:15 AM


My understanding is the BackendWMPS is only used for WMPS searches. I am not using any of these. Instead I have a Workspace that is connected to a WebMap Publisher Service. The Consumer Portal and WMPS were running under HTTPS. Network traffic shows communication directly to the WMPS and not via BackendWMPS.


Can I check what version of software the web.config file you have attached to this article comes from? 



by Technical Evangelist
on ‎01-11-2019 03:42 AM

Correct, it's actually Backend service that is used for obtaining information about the WMPS service. Can you check the following calls and their response if there's some more information?


The GET and PUT requests are against Backend service, the GetMap POSTs are against the actual WMPS. Some additional information can be found in WMPS log.


This article was originally written for release 2016 EP03 or EP04

on ‎01-13-2019 07:50 PM

Check out and the comment against that post - looks like solution is in development (cross fingers).

‎04-02-2019 07:10 PM - edited ‎04-04-2019 02:43 PM

Hi Jan,

Is there any fix or workaround to the 'red pin' not appearing on the Consumer 16.5.02? I am asking that because the https configuration and the 'red pin' used to work fine on the Consumer 15.0.05. I tried to figure out what is happening, but wherever it is, there is no error neither in the Network nor in the Console.

Kind regards,