Licensing service proxy authentication

You can add a layer of authentication when using a proxy to handle the communication between the Qlik NPrinting licensing service and the license back-end. To set up the licensing service proxy without authentication, see Licensing service proxy Setup.

Setting up basic authentication for a proxy

To set up basic authentication for a proxy, do the following:

1. Stop the Qlik NPrinting license service.
2. Navigate to the service.conf file, which by default is located in:

   %Program Files%\NPrintingServer\NPrinting\License\license.config

3. Uncomment the following lines:

   <!-- <add key="proxy-uri" value="https://localhost:8888" /> -->

   <!-- <add key="proxy-basic-authentication" value="true" /> -->

   <!-- <add key="proxy-username" value="username-without-domain" /> -->

4. Set values for proxy-uri and proxy-username.
5. To use a plain text password, uncomment:

   <!-- <add key="proxy-password" value="clear-text-password" /> -->

6. Set the value for proxy-password.
7. To use an encrypted password (recommended) uncomment:

   <!-- <add key="proxy-encrypted-password" value="script-generated-password" /> -->

8. Open powershell and run the password encryption script located in:

   %Program Files%\NPrintingServer\NPrinting\License\lEncrypt-Password.ps1

   using the command:

   Encrypt-Password.ps1 -password clear-text-password

9. Set the output from the command as the value attribute in the tag.
10. Save the file and close it.
11. Restart the Qlik NPrinting licensing service.
    

Example configuration:

<appSettings>

<!--=========================================

License options

=========================================-->

<!--To be enabled if proxy tunneling is required-->

<add key="proxy-uri" value="https://localhost:8888" />

<!--NTLM authentication settings for proxy tunneling-->

<!--Enable Basic authentication-->

<add key="proxy-basic-authentication" value="true" />

<!--Enable NTLM authentication-->

<!-- <add key="proxy-ntlm-authentication" value="true" /> -->

<!--Domain for authentication-->

<!-- <add key="proxy-domain" value="windows-domain" /> -->

<!--Username for authentication (without domain)-->

<add key="proxy-username" value="myUser" />

<!--Encrypted password as generated by  Encrypt-Password.ps1 -password [user password]-->

<add key="proxy-encrypted-password" value="ASDHJNCE243454NNJFWEJFJKFSD8U843RJKJCNDWC98RFNSDJVSKJDVR8UFVC9SJV09439FJSDJVOIHVSKV" />

<!--Clear text password, if encrypted version cannot be used-->

<!-- <add key="proxy-password" value="clear-text-password" /> -->

</appSettings>

Setting up NTLM authentication for a proxy

1. Stop the Qlik NPrinting license service.
2. Navigate to the service.conf file, which by default is located in:

   %Program Files%\NPrintingServer\NPrinting\License\license.config

3. Uncomment the following lines

   <!-- <add key="proxy-uri" value="https://localhost:8888" /> -->

   <!--<add key="proxy-ntlm-authentication" value="true" />-->

   <!--<add key="proxy-domain" value="windows-domain" />-->

   <!-- <add key="proxy-username" value="username-without-domain" /> -->

4. Set values for proxy-uri, proxy-domain and proxy-username.
5. To use a plain text password, uncomment:

   <!-- <add key="proxy-password" value="clear-text-password" /> -->

6. Set the value for proxy-password.
7. To use encrypted password (recommended) uncomment:

   <!-- <add key="proxy-encrypted-password" value="script-generated-password" /> -->

8. Open powershell and run the password encryption script located in:

   %Program Files%\NPrintingServer\NPrinting\License\lEncrypt-Password.ps1

   using the command:

   Encrypt-Password.ps1 -password clear-text-password

9. Set the output from the command as the value attribute in the tag.
10. Save the file and close it.
11. Restart the Qlik NPrinting licensing service.
    

Example configuration:

<appSettings>

<!--=========================================

License options

=========================================-->

<!--To be enabled if proxy tunneling is required-->

<add key="proxy-uri" value="https://localhost:8888" />

<!--NTLM authentication settings for proxy tunneling-->

<!--Enable Basic authentication-->

<!--<add key="proxy-basic-authentication" value="true" />-->

<!--Enable NTLM authentication-->

<add key="proxy-ntlm-authentication" value="true" />

<!--Domain for authentication-->

<add key="proxy-domain" value="domain" />

<!--Username for authentication (without domain)-->

<add key="proxy-username" value="user" />

<!--Encrypted password as generated by  Encrypt-Password.ps1 -password [user password]-->

<add key="proxy-encrypted-password" value="ASDHJNCE243454NNJFWEJFJKFSD8U843RJKJCNDWC98RFNSDJVSKJDVR8UFVC9SJV09439FJSDJVOIHVSKV" />

<!--Clear text password, if encrypted version cannot be used-->

<!-- <add key="proxy-password" value="clear-text-password" /> -->

</appSettings>