A proxy server is a server application (or hardware appliance) that acts as an intermediary between a client machine and the resources that another server provides.
The client machine rather than connecting directly to a server to request a file or web page, connects to the proxy server which actually performs the requested network transactions.
This allows the proxy to control what information or functionality is available and can provide additional advantages such as load balancing, privacy or security.
Proxy Settings File
The proxy settings need to be setup in one of two places:
- Client Machine that communicates directly with the Thales Licensing System.
- License Manager Server that communicates with the Thales Licensing System and client machine on the network.
In both cases the settings file, that needs to be modified, is located in the following location:
%programdata%\Innovyze\Licensing\sntlcloudp_configuration_innovyzeltd.xml
The file can be opened in any text editor, e.g. Notepad. Locate the following section within the file and remove the comment start <!-- and end --> markers.
<!--
<ProxySettings>
<ProxyMode value="3"/> <ProxyHost value="localhost" /> <ProxyUser value="abc" /> <ProxyPassword value="test" /> <ProxyPort value="8080" /> <ProxyPAC value="http://ProxyScriptHostUrl/proxy.pac"/>
</ProxySettings>
-->
The following section details the various settings that can be modified to allow Innovyze products to communicate with the license server over a proxy.
To change a setting, edit the text between the double quote (speech marks) ".."
ProxyMode
This values sets the proxy connection mode, valid values are listed in the table below:
| Proxy Mode Value | Description |
|---|---|
| 1 | Indicates that the proxy is disabled. NOTE: Any licensed products will not connect to the cloud if the client/license manager machine is in a proxy environment and the proxy setting are not defined. |
| 2 | Indicates that the proxy is configured manually and the ProxyHost and ProxyPort setting must be defined as a minimum (along with ProxyUser and ProxyPassword if authentication is enabled on the proxy server). |
| 3 | Indicates that the proxy settings are automatically detected. |
Manual Proxy Settings
The following settings must be used if the ProxyMode is set to a value of 2.
| Proxy Setting | Description |
|---|---|
| ProxyHost | Proxy server host name of IP address. |
| ProxyPort | Port number at which the proxy server is running. |
The following setting must be used if authentication is enabled on the proxy server.
| Proxy Setting | Description |
|---|---|
| ProxyUser | User name used for proxy server authentication. |
| ProxyPassword | Proxy password used for proxy server authentication. |
Automatic Proxy Settings
The proxy server settings will be automatically detected using one of the two following automatic proxy detection methods detailed below:
Web Proxy Autodiscovery Protocol (WPAD)
Proxy detection is completed via Domain Name System (DNS) or Dynamic Host Configuration Protocol (DHCP) discovery methods.
NOTE: DHCP has a higher priority than DNS. The WPAD-enabled client first uses DHCP to find a proxy server, and if the desired information is not obtained, DNS is used. If the wpad.dat file is not
found or if proxy is not detected while running wpad.dat, no error is returned. Instead the client tries to connect in the manner similar to when the proxy is disabled (No Proxy - ProxyMode="1").
Proxy Auto-Configuration (PAC)
The location of the proxy script file should be specified when PAC is being used.
| Proxy Setting | Description |
|---|---|
| ProxyPAC | Location of the auto-proxy configuration (.pac) file to be used for proxy detection. Use |
NOTE: In the auto proxy mode (ProxyMode="3"), Web Proxy Autodiscovery Protocol (WPAD) has precedence over Proxy Auto-Configuration (PAC).