Google OAuth

Single Sign On with Google G-Suite

Introduction

By integrating Google OAuth with Kubit’s Self-Service Analytics, every user in your organization can sign in to Kubit using their Google G-Suite credential. This Single Sign On approach eliminates yet another set of username/password to be remembered, simplify user management, and also can improve security through G-Suite's Multi-Factor Authentication.

Requirements

• Your organization uses Google G-Suite.
• You have Admin role in G-suite. 

JIT Provision

With SAML integration, once a user is created on your end (optionally included in a Security Group which has access to Kubit), that user can login to Kubit immediately. The user profile information will also be automatically updated at every login time. 

When a user is deleted/deactivated on your end, they will lose access to Kubit immediately too. There is no offline communication required.

Configure Google OAuth

• Go to Google API Console
• Choose an existing project or create a new project, call it "Kubit OAuth". Make sure to select the correct target Organization and Location. 

• Switch to the newly created "Kubit OAuth" project. Click on "CONFIGURE CONSENT SCREEN"

• Select "Internal" for User Type, click CREATE

• Enter the following information 
  • App Information
    • App name: Kubit
    • User support email: select an internal email from your organization, like IT or support department.
    • App Logo: please use this Kubit Logo

• • App Domain
    • Application home page: https://YOUR-ORG.kubit.ai (provided by Kubit)
    • Application privacy policy link: https://www.kubit.ai/privacy
    • Application terms of service link: https://www.kubit.ai/tos
    • Authorized domains: kubit.ai
  • Developer contact information: support@kubit.ai

• You don' t need to config any scopes. Just click "SAVE AND CONTINUE"

• Go to Credentials, click on "CREATE CREDENTIALS", select "OAuth client ID"

• Select Application type: "Web application"
  • Name: Kubit
  • Authorized Javascript origins: https://auth.kubit.ai and https://kubit.auth0.com
  • Authorized redirect URIs: https://auth.kubit.ai/login/callback and https://kubit.auth0.com/login/callback

• Click CREATE. Copy "Your Client ID" and "Your Client Secret", then send them to Kubit team through a communicated secure channel (Slack, Google Hangout or Discord). 

Test Integration

• Only after Kubit inform you that the configuration is completed on their part, go to https://YOUR_ORG.kubit.ai
• At the login screen, start typing in your company email address. The password field will disappear once the full email is entered.
• Click on "LOG IN" and use your company G-Suite credential to login. 

References

• Google: Setting up OAuth 2.0
• Google: Setting up OAuth Consent Screen