Google Workspace Integration

Owned by William Crane (Unlicensed)
Last updated: Mar 27, 2024 by Ken Gordon
2 min read

Vivi can integrate with Google Workspace

Once set up, when users log in to the Vivi App, Vivi authenticates against your organization's Google Workspace environment.

Please note: Enabling Google authentication will disable Vivi standard authentication.

To use Workspace with Vivi you will need:

  • A Workspace domain
  • Be able to sign into the Domain Admin user account for the Workspace domain
  • Users need to be assigned to groups to support Vivi. See the group settings below.

To set up Workspace authentication Vivi Central:

  • Select the "Organization" link in Vivi Central.
  • Select the "Authentication" link in the menu at the top of the screen.
  • Click "Edit".
  • Set the Authentication Type as "Google" and save the changes. Do not start filling out the remaining fields
  • The screen will now show the Authentication Type as "Google". The next field is "Google Linked Admin". A link has now been created. Click on the link.
  • This will take you to a Google login screen. Log in in with a Domain Admin user account.  We recommend using the Google Workspace Primary Admin rather than an individual admin user's name.
  • Google will note that the "This app isn't verified". To pass this screen you will need to click "advanced" then "Go to vivi.io (unsafe)".
  • A permission page will be shown. To proceed you will need to click "Allow". You will then be returned to the Organization Authentication settings screen in Vivi Central.
  • Click "Edit" and fill out the required fields below.


Setting

Description

Authentication Type

Google

Google Hosted Domain

The default email domain in the case the user does not enter the full email address.


Google Group Settings

The following Google group settings are also required.

These values can be the email address, a group alias, or the unique group ID.

Multiple groups can be separated with | (pipe), then a user may be a member of any to receive the role.

Google Presenter Group

The group email address of the users who are to have full presenter rights

Google Student Group

The group email of the users who are to have student level access.

Google Emergency Authorised Group

The group email of the users who are allowed to trigger emergencies.

Google IT Admin Group

The group email of the users who have IT administrator privileges in Vivi Central. If the group is set, existing IT Admins will lose their admin access since the Vivi Central role will no longer be relevant.

Google E-Learning Admin Group

The group email of the users who have access to metrics in Vivi Central.

  • Once all of the settings have been added, click "Save Changes".

Google authentication should now be ready to test. Open the Vivi App (or restart if already open) and attempt to sign in with the username and password of an account in one of the appropriate groups.