StifleR Dashboard Configuration File

The StifleR Dashboard configuration file is used to configure how the Dashboard accesses the StifleR Server service. The config file (config.json) is located within the program files directory in which the StifleR Dashboard was installed.

For example, if the StifleR Dashboard was installed under C:\Program Files\2Pint Software

...then the configuration file would be located in this location: C:\Program Files\2Pint Software\StifleR Dashboards\Dashboard Files\assets\config

The most important settings in the config.json file are referenced in the "apiServers" section. The values for backendServerUrl and backendLocationServerUrl are set during the StifleR Dashboard Installation.

  "apiServers": {
    "backendServerUrl": "http://StifleRServer.domain.com:1414",
    "backendLocationServerUrl": "http://StifleRServer.domain.com:9000/api",
    "chainHomeSystemVersion": ""
  },

Note: If when the StifleR Dashboard was installed, you entered the above URLs as HTTP and later enabled HTTPS, then the above values should be modified to HTTPS.

You can check whether StifleR is configured to use HTTPS by checking the StifleR Server Configuration File and reviewing the ListenToUrl and LocationWSListenToUrl values.

Configuring the Dashboard to Use HTTPS

If when the StifleR Dashboard was installed, you entered the above URLs as HTTP and would like to switch to HTTPS you will need to make modifications to several files.

Note: The StifleR SignalR communications protocol uses port 1414 by default, and is primarily used for client communications. This section does not address switching clients to use HTTPS based communications.

To switch from HTTP to HTTPS communications for the Dashboard, you will need to complete several steps:

• Acquire a Web Server certificate - see this page for more information on how to configure a web certificate for IIS.

• Prepare the StifleR Dashboard Web Site for SSL

• Copy the thumbprint value from the web server certificate - see this page to find your certificate thumbprint.

1. Edit the config.json file on the server hosting the Dashboard: C:\Program Files\2Pint Software\StifleR Dashboards\Dashboard Files\assets\config.

2. Modify the URL for the backendLocationServerUrl value to https://. Example:

   "apiServers": {      
         "backendLocationServerUrl": "http://StifleRServer.domain.com:9000/api",

3. Edit the StifleR Server Config file (StifleR.Service.exe.config) which is located in the Program Files folder on the StifleR Server.

4. Modify the value: LocationWSListenToUrl to: https://*:9000"/ Modify the value: WebServiceCertificateThumbprint to your web server certificate thumbprint.

5. Restart the "2Pint Software StifleR Server" service. Example:

   <add key="LocationWSListenToUrl" value="https://*:9000"/>
   <add key="WebServiceCertificateThumbprint" value="3d6ccb8c908b5986d6fa1669dad5e44dfd7715c9"/>