Wyn Enterprise Administration Guide

Wyn Enterprise: Using IIS as Reverse Proxy

This article describes the HTTPS configuration steps to use IIS as a reverse proxy to deploy Wyn Enterprise with HTTPS. However, the primary objective of this article is to configure the reverse proxy to map a public URL to the internal server in the reverse proxy.

Deploy Wyn Enterprise with HTTPS

  1. Install Wyn Enterprise.
  2. In Control Panel, open Administrative Tools > Internet Information Services (IIS) Manager.
  3. In IIS Manager, in the right pane under Actions, select Wyn Enterprise server and click the Create Self-Signed Certificate.. to create a self-signed https certificate.

    Internet Information Services (ISS) Manager

  4. In the Create Self-Signed Certificate dialog, choose the following options and click OK.

    Create Self-Signed Certificate

    You can view the certificate in the Server Certificates dialog.

    Server Certificates dialog

  5. Create a website in IIS, use https as the binding type.

    Add Website Dialog

    Note: For the purpose of this guide, we will use 'wyn-on-iis.grapecity.net' as the hostname setting. You should use the name of the web URL you are setting up to be the website the end users use. Also, the certificate used here is the one initialized in the previous step.

  6. To install the Web Platform Installer, you can download the installer from here: https://www.iis.net/downloads/microsoft/web-platform-installer.

  7. Run the Web Platform Installer and install the URL Rewrite model and the Application Request Routing model. For that, first search for URL Rewrite and click Add.

    Web Platform Installer Dialog

  8. Search for Application Request Routing and click Add.

    Search results for 'Application Request Routing' in Web Platform Installer

  9. Click Install and I Accept in the Web Platform Installer.

    Instal Application Request Routing in Web Platform Installer

  10. In the IIS Manager, add reverse proxy. To do that, select URL Rewrite.

    IIS Manager Dialog

  11. In the right pane under Actions, select Add Rule(s)... for URL Rewrite.

    Add Rules in IIS Manager Dialog

  12. Enter the server name in the Add Reverse Proxy Rules dialog.

    Add Reverse Proxy Rules Dialog

    Note: This is the internal URL which points to the Wyn Enterprise server installation. The incoming requests from the end users will be redirected to this location by IIS. For the purpose of this guide, we have used 'localhost:51980' as an example.

  13. In the right pane under Actions, select Open Feature for Configuration File.

    Open Feature for Confiuration File

  14. Choose the path system.webServer/proxy from the section dropdown in the Configuration Editor.

    Configuration Editor

  15. Set the value for preserveHostHeader to True.

    Configuration Editor

  16. Modify the configuration file as shown below.

    <?xml version="1.0" encoding="utf-8"?>
    <SystemConfig xmlns:sys="https://extendedxmlserializer.github.io/system" xmlns="clr-namespace:ConfigMigration.Configuration.V32;assembly=ConfigMigration">
       <Version>3.2</Version>
       <GlobalSettings>
         <IdentityServerUrl>https://wyn-on-iis.grapecity.net</IdentityServerUrl>
       </GlobalSettings>
       <Services>
         <Server>
           <Urls>http://*:51981</Urls>
         </Server>
         <Portal>
           <Urls>http://*:51980</Urls>
           <RequireHttps>true</RequireHttps>
           <AuthorizedWebApplicationUrls>
             <sys:string>https://wyn-on-iis.grapecity.net</sys:string>
           </AuthorizedWebApplicationUrls>
         </Portal>
         <Worker>
           <Urls>http://localhost:51982</Urls>
         </Worker>
         <CotWorker>
           <Urls>http://localhost:51983</Urls>
         </CotWorker>
       </Services>
    </SystemConfig>
    
  17. Restart the Wyn Service.
    Now you can visit the Portal page at the following URL: http://wyn-on-iis.grapecity.net.