Setting up user authentication for the Qlik Web Connectors

By default, the Qlik Web Connectors are configured for a single user without authentication. This means that when you download Qlik Web Connectors for the first time, user authentication and user management are disabled. To change these settings, you can copy the pre-configured sample files into the root directory or you can manually change the files that are already in the root directory.

Copy the sample files

The simplest way to enable user authentication is to copy the pre-configured sample files and move them into the Qlik Web Connectors root directory. The sample files are located at \%root%\Sample Configs\Forms Auth and Remote Access. In this folder, there are three files: deploy.config, logins.xml, and a readme file.

Authentication and user profiles are determined by the deploy.config and the logins.xml files in the root directory. You can copy the two files from \%root%\Sample Configs\Forms Auth and Remote Access and replace the same two files in the root directory.

By replacing the deploy.config file, you enable authentication and you allow remote access from other machines. By replacing the logins.xml file, you create two users with login credentials. Once you complete the advance installation, you can add, edit, and delete users from the Qlik Web Connectors Manage Users menu.

Adding users

The default user accounts are:

Username

admin@yourdomain.com

password01

user@yourdomain.com

password01

Note: You may also need to open up the firewall on the machine to allow TCP connections to be made through the port. Qlik Web Connectors is configured on port 5555 by default. Please contact your network/system administration for assistance.

Manually change the deploy.config file

To change the authentication settings manually, open the deploy.config file that is in the root directory in a text editor. Find authentication section and change the value from None to FormsAuthentication.

<Authentication> <Type>FormsAuthentication</Type> </Authentication>
Note: You can leave the Authentication type element set to None, but this means that anybody will be able to browse to and use the Qlik Web Connectors installation. We do not recommend this option.

To access the Qlik Web Connectors from other machines on your network and to load data from QlikView or Qlik Sense installations running on other machines, you need to change the AllowRemoteAccess value to true.

<AllowRemoteAccess>true</AllowRemoteAccess>
Note: If you allow remote access you may also need to open up the firewall on the machine to allow TCP connections to be made through the port. Qlik Web Connectors is configured on port 5555 by default. Please contact your network/system administration for assistance.

Enable SSL encryption

When you allow remote access, you expose the Qlik Web Connectors over HTTP, which is not encrypted. After you configure the Qlik Web Connectors for authentication, either by copying the sample files or by manually changing the deploy setting, you should enable SSL encryption.

Open the deploy.config file in a text editor and find the RequireSSL section. Change the value to true.

<RequireSSL>true</RequireSSL>
Warning:

If you enable SSL encryption, you must allow remote access. If remote access is disabled and you enable SSL encryption, you will receive an error message when you open the Qlik Web Connectors.

Creating an SSL certificate for the Qlik Web Connectors

Did this information help you?

Thanks for letting us know. Is there anything you'd like to tell us about this topic?

Can you tell us why it did not help you and how we can improve it?