GithubHelp home page GithubHelp logo

hugocalean / qlik-auth-google Goto Github PK

View Code? Open in Web Editor NEW

This project forked from braathen/qlik-auth-google

0.0 2.0 0.0 140 KB

Qlik Sense OAuth2 authentication module designed specifically for Google services.

License: MIT License

JavaScript 34.62% PowerShell 65.38%

qlik-auth-google's Introduction

Disclaimer: I no longer work for Qlik and I have no possibility to test, support 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.

Introduction

These instructions installs a Qlik Sense OAuth2 authentication module designed specifically for Google services. This will allow you to authenticate yourself in Qlik Sense through a Google (Gmail) account.

Step by Step

  1. In the Google Developer Console, first create a new project.

  2. On the APIs & auth -> Credentials page select Add credentials and choose OAuth 2.0 client ID. Google Developer Console

  3. Select Web application and give it a name, authorized origin and redirect uri.

    Note: The module we are installing need to run on it's own port and this is where you make that decision. The module will pick whatever port you use in the Authorized redirect URI. This port is also important to remember when configuring the Virtual Proxy. The Authorized redirect URI must end with /oauth2callback.

    Callback Options

  4. A popup screen will appear with your new Client ID and Client secret. Ignore this and close the popup. Instead, click on the new credentials that you created.

  5. At the top of the page there is a Download JSON button. Click the button to download the json file.

  6. Copy the client_secret*.json file to C:\Temp (for example).

  7. Launch PowerShell in Administrator mode (right-click and select Run As Administrator)

  8. Change directory to C:\Temp or where you placed the json file (enter cd \Temp)

  9. Enter the below command exactly as it is (including parentheses):

   (Invoke-WebRequest "http://bit.ly/qlik-auth-google" -OutFile setup.ps1) | .\setup.ps1

This will download and execute the setup script.

When the downloading and installation of the modules including their dependencies are finished you will be prompted for some configuration options. If you copied the client_secret*.json file to the same directory above you can just confirm the questions regarding ClientID, Client Secret and Redirect URI by pressing return.

Note: The question regarding valid domain for email address is important. If you do not have your own domain, then it means that EVERYONE with a Google (gmail) account will be able to login to your Qlik Sense environment, so be careful! This will in many cases be a showstopper for this kind of solution.

Setup is now done, restart the Qlik Sense Service Dispatcher service to activate the module.

Virtual Proxy

  1. Create a new Virtual Proxy in QMC
  2. For Authentication module redirect URI enter the same servername and port you used for Authorized redirect URI in the Google console. Virtual Proxy
  3. Finish the Virtual Proxy configuration. The proxy will restart and the new module should be good to go!

Troubleshooting

Missing client certificate or key If the module is unable to find a client certificate, please make sure the Qlik Sense Service Dispatcher service is running with the administrator account which was used to install Qlik Sense and that there is a QlikClient certificate in MMC->Certificates (Current User)->Personal->Certificates for this user.

Summary & Future

I would like to ask for feedback regarding the module, especially if you run into problems with the setup script. There are a lot of parameters which can go wrong with different environments, please let me know if something doesn't work!

Currently the module does not support HTTPS which more or less is a requirement for production use. This is something I will be looking into shortly.

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

qlik-auth-google's People

Contributors

braathen avatar

Watchers

James Cloos avatar Hugo Andrade avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.