Skip to main content

Configuring a proxy for Qlik License Service communication in QlikView Server

You can handle the communication between the Qlik License Service and the License Back-end with a proxy .

The Qlik License Service is included in QlikView April 2019 and later releases and is used when QlikView Server is activated using a signed key license. The Qlik License Service stores the information about the license, and communicates with a License Back-end Service, hosted by Qlik, for product activations and entitlement management. Port 443 is used for accessing the License Back-end Service and retrieving license information.

In a multi-node deployment, the Qlik License Service is installed on the machine running the QlikView Management Service (QMS). You can manage the status of the Qlik License Service by starting and stopping the Qlik Service Dispatcher, listed in the list of services running in the Windows machine.

You can configure the communication between Qlik License Service and the Qlik License Back-end to be handled by a proxy.

In QlikView Server, configuration of a proxy for the Qlik License Service is done using command line parameters. Both HTTP and HTTPS scheme are supported.

With QlikView Server June 2020 or later NTLM and basic authentication capabilities to the licenses service when communicating over a HTTP tunnel are available. This allows you to require authentication on tunneling proxies and configure a more secure environment.

Do the following:

  1. Stop the Qlik Service Dispatcher, which handles the execution of the Qlik License Service.

  2. Navigate to the service.conf file, which by default is located in:
  3. %Program Files%\QlikView\ServiceDispatcher\service.conf

  4. Locate the section [licenses.parameters], which by default contains the following lines:
  5. [licenses.parameters]
    -qv-mode=true
    -qv-auth-mode=ntlm

  6. Add the line -proxy-uri=http://myproxy.example.com:8888 as shown below:
  7. [licenses.parameters]
    -qv-mode=true
    -proxy-uri=http://myproxy.example.com:8888
    -qv-auth-mode=ntlm

    Where "http://myproxy.example.com" is the address of your company's proxy, and "8888" is the port used by the proxy.

  8. To require authentication on tunneling proxies add the following lines:

    -proxy-uri=[the uri of the proxy]
    -proxy-auth-mode=ntlm|basic|(leave empty for no authentication)
    -proxy-user=[username without domain]
    -proxy-encrypted-password=[password]
    -proxy-domain=[the domain] (only for NTLM)

  9. Run Encrypt-Password.ps1 -password [user password].

  10. Save the file and close.
  11. Restart the Qlik Service Dispatcher.