Wyn Enterprise: Deploying with a Reverse Proxy

You can use IIS as reverse proxy to 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.

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

  2. 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

  3. Search for Application Request Routing and click Add.

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

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

    Instal Application Request Routing in Web Platform Installer

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

    IIS Manager Dialog

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

    Add Rules in IIS Manager Dialog

  7. 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.

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

    Open Feature for Confiuration File

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

    Configuration Editor

  3. Set the value for preserveHostHeader to True.

    Configuration Editor

  4. 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>
  1. Restart the Wyn Service.
    Now you can visit the Portal page at the following URL: http://wyn-on-iis.grapecity.net.