Installation of Welle Proxy

Preparing for Installation

  • Obtain the installation package from the distribution channels
  • Ensure that a Tomcat is already installed and running on the proxy server

Installation

  1. Unzip the installation package into a working folder /home/user/installation and confirm that the proxy.war is extracted

  2. Edit the properties file in the proxy.war at proxy.war/WEB-INF/classes/proxy.properties to add in the Internal FQDN for IC Governor and the API Key for Mobile Login, which can be obtained from Mobile Login

    ../_images/installation-proxy-properties.png
  3. Next, deploy the proxy.war into Tomcat by copying the file into the webapps folder.

  4. Check the Tomcat logs to confirm that the application is deployed and started successfully.

    INFO [main] org.apache.catalina.startup.HostConfig.deployWAR Deployment of web application archive [<apache-tomcat>\webapps\proxy.war] has finished in [16,785] ms
    

Configuration of WeChat Integration

Note

Read WeChat Login for more information.

  1. After installation of the Welle Proxy, go to IC Governor and login as the default administrator.

  2. Enter Admin Mode by clicking the button at the top right.

    ../_images/installation-admin-mode.png
  3. Navigate to the Settings > External Integrations page.

    ../_images/installation-settings-ext-int.png
  4. In the WeChat Login tab,

  • Enable WeChat Login
  • Enter App ID and App Secret in Basic Information section
  • Enter Login Page and User Profile Page in Redirect URLs section
  • Enter Public FQDN and Private FQDN in Proxy Server section
  1. Once the configurations are saved, logout as the default administrator. Verify that the WeChat QR Code is rendered properly on the login page.

Configuration of Mobile Login Integration

Note

Read Mobile Login for more information.

  1. After installation of the Welle Proxy, go to IC Governor and login as the default administrator.

  2. Enter Admin Mode by clicking the button at the top right.

    ../_images/installation-admin-mode.png
  3. Navigate to the Settings > External Integrations page.

    ../_images/installation-settings-ext-int.png
  4. In the Mobile Login tab,

  • Enable Mobile Login
  • Review the Encryption Key, Timeout (seconds) and Theme in Basic Information section. This Encryption Key is used to encrypt the data being passed between the mobile applications and IC Governor, thus generate a new key, if necessary.
  • Check the Enable Proxy Server checkbox, and enter Public FQDN in Proxy Server section. Review the API Key, and generate a new key, if necessary. Update the proxy properties file accordingly.
  1. Once the configurations are saved, logout as the default administrator. Verify that the Mobile QR Code is rendered properly on the login page.