/qlikoauth

This is a demonstration project how to get started with OAuth 2.0 for QlikView and Qlik Sense integration. After setup users will be able to authenticate using their Google account.

Primary LanguagePythonMIT LicenseMIT

Disclaimer: I no longer work for Qlik and I have no possibility to test or maintain this code any more. Most of my Qlik related repositories are a few years old and was built in an early stage of product releases as examples how to get started with the Qlik API's. Please take it for what it is and use as you like.

About

This is a demonstration project how to get started with OAuth 2.0 for QlikView and Qlik Sense integration. After setup users will be able to authenticate using their Google account. The example uses Google's OAuth 2.0 library available for both C# and Python, although the example is based on Python the code should be quite self-explaining and the workflow would more or less be the same for C#.

Note

  • OAuth 2.0 should only be implemented using SSL/TLS only!
  • Proper certificates needs to be used and converted to .pem format and copied to the same directory as the script. For testing purposes the included self-generated certificates may be used and the setup below uses localhost only for testing.

Installation

  • Download and install Python 2.x (NOT compatible with 3.x due to the Google library dependencies)

  • To install or upgrade pip, securely download git-pip.py. Then run the following (which may require administrator access):

python get-pip.py
  • After pip is installed run the following command:
pip install https://github.com/braathen/qlikoauth/zipball/master

The required dependencies and the project itself should now be downloaded and installed to C:\Qlik\ on Windows and we can continue with the configuration!

Configuration

The client_secrets.json file needs to be updated with your own CLIENT_ID, CLIENT_SECRET and proper redirect uri. For testing purposes it's ok to keep the defauilt uri as it is.

{
  "web": {
    "client_id": "YOUR_OWN_CLIENT_ID",
    "client_secret": "YOUR_OWN_CLIENT_SECRET",
    "redirect_uris": ["https://localhost:1443"],
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://accounts.google.com/o/oauth2/token"
  }
}

In the C:\Qlik\qlikoauth\qlikoauth.py file there are some things to consider and maybe adjust to your own liking or setup. Make sure to set the redirect_uri properly here as well.

flow = flow_from_clientsecrets('client_secrets.json',
                               scope='https://www.googleapis.com/auth/userinfo.email',
                               redirect_uri='https://localhost:1443')

This line checks the domain of the authenticated user. Note: If you don't have your own domain and take some precaution it means that every Google user on the planet will be able to authenticate against your QlikView/Sense server. It might be a good idea to prevent this, even though you can of course determine who can see what from a QlikView/Sense perspective.

if not userid.endswith('@gmail.com'):

The below line points to the QlikView Server, make sure it's correct. In this case it defaults to localhost, but it does not necessarily need to be on the same machine.

r = requests.post('http://localhost/QvAJAXZfc/GetWebTicket.aspx', data=xml)

Same thing with this line...

return 'http://localhost/QvAJAXZfc/Authenticate.aspx?type=html&webticket=%s&try=%s&back=%s' % (xmldoc[0].text, '/QlikView/', '')

And that's all there is to it! The only thing left to do is to setup QlikView Server to respond to webticket requests from the machine running this code. I recommend using IP whitelists. Also make sure to set the custom authentication url to https://localhost:1443 (you can change this in the script).

Running

Open a terminal window, change to the installed directory and give the following command:

python qlikoauth.py

License

This software is made available "AS IS" without warranty of any kind under The Mit License (MIT). QlikTech support agreement does not cover support for this software.

Meta