Preparing the On-Premises Environment

To prepare COSMO Graphical Extension in your On-Premises environment, you must set up a Reverse Proxy, which includes downloading and installing files and then executing a configuration script.

Important

This process is only necessary for installations prior to Microsoft Dynamics Business Central 18.00. To use Windows Authentication without a reverse proxy, at least the 2.10.70192.73998 version of COSMO Graphical Extension is required.

These processes can be performed either before or after the app is installed and registered.

Configuring the Internet Information Service (IIS)

The files needed for configuring the IIS as well as the script execution are described in this section.

Note

These instructions are also noted in the Readme.txt file in the COSMO Graphical Extension_[version] folder.

Prerequisites

The prerequisites for installing the Reverse Proxy are:

  1. Download URL Rewrite from:
    https://www.iis.net/downloads/microsoft/url-rewrite
  2. Install URL Rewrite on Server running the IIS for the Web client.
  3. Download Application Request Routing from:
    https://www.microsoft.com/download/details.aspx?id=47333
  4. Install Application Request Routing on Server running the IIS for the Web client.
  5. Download CORS module from:
    https://www.iis.net/downloads/microsoft/iis-cors-module
  6. Install CORS module on Server running the IIS for the Web client.

Set Up Reverse Proxy

Setting up the Reverse Proxy is done by executing the "ConfigureIIS.ps1" script, which is located in the "scripts" folder in the COSMO Graphical Extension_ folder.

  1. Open the Windows PowerShell as an administrator.

  2. Access the local drive that contains the "ConfigureIIS.ps1" script file.

  3. Enter the following script after .\ConfigureIIS.ps1:

    -AllowedCorsOriginNames @("localhost", "<IP address>", "<server name>", "<public IP address>") -WebServerPort <port number> -BCServiceName <name of your Business Central service>

The first command is a CORS policy array, which ensures that only identified servers and valid addresses are able to access the information.

  1. Execute the script.

Feedback

Submit feedback for this page .