Skip to main content

Installing Qlik NPrinting certificates

You can install a self-signed or CA-signed Qlik NPrinting certificate.

To generate certificates, see: Managing keys and certificates. The certificate file name is NPrinting.crt and the private key file name is NPrinting.key. You can rename them, but this is not recommended.

Installing certificates on Qlik NPrinting Server June 2017 or later

Do the following:

  1. Copy the certificate NPrinting.crt and the related private key NPrinting.key into the appropriate folders:
    1. For the NewsStand: %ProgramData%\NPrinting\newsstandproxy\.

      Typical path is C:\ProgramData\NPrinting\newsstandproxy\.

    1. For the Qlik NPrinting web console: %ProgramData%\NPrinting\webconsoleproxy\.

      Typical path is C:\ProgramData\NPrinting\webconsoleproxy.

  2. Change both proxy configuration files to refer to the new certificate file:
    1. Edit the NewsStand proxy configuration file: %ProgramData%\NPrinting\newsstandproxy\app.conf.

      Uncomment by removing the # and change or add the following lines to:

      http.sslcert=${ProgramData}\NPrinting\newsstandproxy\NPrinting.crt. Change the certificate file name if necessary.

      http.sslkey=${ProgramData}\NPrinting\newsstandproxy\NPrinting.key. Change the private key file name if necessary.

      ${ProgramData} is the Windows ProgramData environment variable with the notation for the configuration file. As alternative you can insert your full path, for example C:\ProgramData\NPrinting\newsstandproxy\NPrinting.crt.

    2. Edit the Qlik NPrinting web console proxy configuration file: %ProgramData%\NPrinting\webconsoleproxy\app.conf.

      Uncomment by removing the # and change or add the following lines to:

      http.sslcert=${ProgramData}\NPrinting\webconsoleproxy\NPrinting.crt. Change the certificate file name if necessary.

      http.sslkey=${ProgramData}\NPrinting\webconsoleproxy\NPrinting.key. Change the private key file name if necessary.

      ${ProgramData} is the Windows ProgramData environment variable with the notation for the configuration file. As alternative you can insert your full path, for example C:\ProgramData\NPrinting\webconsoleproxy\NPrinting.crt.

  3. You must stop and restart the Qlik NPrinting web engine service because new certificates are read only during the service start-up process.

Installing certificates on Qlik NPrinting Server 17.3 or earlier

Qlik NPrinting web console and NewsStand 17.0 to 17.3 have different configuration folders structure than June 2017 or higher.

Do the following:

  1. Copy the certificate NPrinting.crt and the related private key NPrinting.key into the appropriate folders:
    1. For the NewsStand:

      [proxy installation root]\proxy\newsstandproxy\src\qlik.com\newsstandproxy\conf. For example C:\Program Files\NPrintingServer\proxy\newsstandproxy\src\qlik.com\newsstandproxy\conf.

    1. For the Qlik NPrinting web console: [proxy installation root]\proxy\webconsoleproxy\src\qlik.com\webconsoleproxy\conf.

      For example C:\Program Files\NPrintingServer\proxy\newsstandproxy\src\qlik.com\newsstandproxy\conf.

  2. Change both proxy configuration files to refer to the new certificate file:
    1. Edit the NewsStand proxy configuration file: [proxy installation root]\proxy\newsstandproxy\src\qlik.com\newsstandproxy\conf\app.conf.

      Change or add the following lines to:

      http.sslcert=.\src\qlik.com\ newsstandproxy\conf\NPrinting.crt. Change the certificate file name if necessary.

      http.sslkey=.\src\qlik.com\ newsstandproxy\conf\NPrinting.key. Change the private key file name if necessary.

      The path is related to the proxy executable location, in this case %ProgramFiles%\NPrintingServer\proxy\newsstandproxy.

    2. Edit the Qlik NPrinting web console proxy configuration file: [proxy installation root]\proxy\webconsoleproxy\src\qlik.com\webconsoleproxy\conf\app.conf.

      Change or add the following lines:

      http.sslcert=.\src\qlik.com\webconsoleproxy\conf\NPrinting.crt. Change the certificate file name if necessary.

      http.sslkey=.\src\qlik.com\webconsoleproxy\conf\NPrinting.key. Change the private key file name if necessary.

      The path is related to the proxy executable location, in this case %ProgramFiles%\NPrintingServer\proxy\webconsoleproxy.

  3. You must stop and restart the Qlik NPrinting web engine service because new certificates are read only during the service start-up process.

Checking the installation

Connect to the Qlik NPrinting web console and ask to your browser to display certificate details to verify that the web site is using the certificates you installed:

  • If you used CA-signed certificates the browser warning message disappears.
  • If you used a self-signed certificate you still have the warning message. To remove the warning message from all browsers, you need to add the self-signed certificates to the trusted roots of your local computer. Refer to official Microsoft documentation related to your operating system to perform this action Manage Trusted Root Certificates.