Skip to content

Google Workspace

Let your users sign in to Vipilink with their Google Workspace account, in the web platform and in the agent.

You set up one OAuth client in the Google Cloud console and add its client ID and secret in Vipilink.

Before you start

  • You're a super admin in Google Workspace and an admin in Vipilink.
  • You know your Vipilink workspace address, for example https://example.vipilink.com. In the steps below, replace example with your workspace name.
  • Every user who signs in with Google must already have a Vipilink account with the same email address. Signing in with Google doesn't create Vipilink users.

Step 1: Create a project in Google Cloud

We recommend a new project only for Vipilink. You can also use an existing project if its Audience is already Internal. Then skip to Step 3.

  1. Sign in to the Google Cloud console as a Google Workspace super admin.
  2. Click the project picker at the top of the page. In Select a resource, click New project.

    Select a resource with New project highlighted

  3. Fill in the form:

    New Project form with the project name, organization, parent resource and Create numbered

    Field Value
    1 Project name Vipilink
    2 Organization Your company's organization, for example example.com
    3 Parent resource Your company's organization
  4. Click Create (4). Google Cloud opens the new project.

  1. Open the navigation menu, point to APIs & Services (1) and click OAuth consent screen (2).

    Navigation menu with APIs & Services and OAuth consent screen numbered

  2. Google Auth Platform opens. Click Get started.

    Google Auth Platform not configured yet with Get started highlighted

  3. Under App Information, enter the App name Vipilink (1) and choose the User support email (2). Click Next (3).

    App Information with the app name, user support email and Next numbered

    Users can see the User support email on Google's sign-in page, so choose an address for questions about sign-in, such as your IT support address, not a personal one.

  4. Under Audience, choose Internal (1) and click Next (2). Only users in your organization can then sign in.

    Audience with Internal and Next numbered

  5. Under Contact Information, enter the Email addresses where Google sends notices about the project (1). Click Next (2).

    Contact Information with the email addresses and Next numbered

  6. Under Finish, select I agree to the Google API Services: User Data Policy. (1) and click Continue (2). Then click Create (3).

    Finish with the agreement, Continue and Create numbered

Step 3: Create the OAuth client

  1. In Google Auth Platform, click Clients (1), then Create client (2).

    Clients page with Clients and Create client numbered

  2. Fill in the form:

    Create OAuth client ID with the application type, name, redirect URI and Create numbered

    Field Value
    1 Application type Web application
    2 Name Vipilink
    3 Authorized redirect URIs Click Add URI and enter https://example.vipilink.com/callback

    Leave Authorized JavaScript origins empty.

  3. Click Create (4).

Step 4: Copy the client ID and secret

The OAuth client created dialog shows the Client ID (1) and the Client secret (2). Click the copy icon next to each one and keep them for the next step.

OAuth client created with the client ID and client secret numbered

The client secret is shown only once

After you close this dialog, Google doesn't show the client secret again. To keep a copy, click Download JSON before you click OK.

  1. In Vipilink, go to Settings → Identity Providers and click Add Provider.
  2. Choose Google Workspace (1) and click Next (2).

    Add Identity Provider with Google Workspace and Next numbered

  3. Fill in the form:

    Google Workspace form with the domain, client ID, client secret and Finish numbered

    Field What to enter
    1 Google App Domain Your company's Google Workspace domain, for example example.com.
    2 Client ID The client ID from Google.
    3 Client Secret The client secret from Google.

    Domain Aliases is optional: other email domains of your company that should sign in with Google Workspace, for example example.co.uk next to example.com.

  4. Click Finish (4). Google Workspace appears on the Identity Providers page with your domain under Domains.

    Identity Providers page with the Google Workspace provider highlighted

Step 6: Test the sign-in

Open your workspace address in a private browser window. The sign-in page now has a Sign In With Google Workspace button. Click it and sign in with a Google Workspace account that has a Vipilink account.

Vipilink sign-in page with Sign In With Google Workspace highlighted

If the user has no Vipilink account with the same email address, Vipilink shows: "No Vipilink account found for user@example.com. Contact your workspace administrator." To add users, see Users.

On Google's sign-in page, users can click Vipilink to see the Developer info: the app name and the User support email from Step 2.

Google sign-in page with the Developer info showing the app name and support email

Desktop and mobile

The Vipilink agent on desktop and mobile uses the same OAuth client. You don't need to set up anything else in Google.

In the mobile app, enter your workspace, tap Sign In With Google, then tap Continue to let the app use accounts.google.com, and sign in with Google.

Mobile sign-in with Sign In With Google highlighted iOS prompt with Continue highlighted Google sign-in in the mobile app

SCIM provisioning

SCIM provisioning is available on the Enterprise plan. The setup guide for Google Workspace is coming soon. Contact support if you'd like help setting it up now.

Two-factor authentication and access

In the Google Workspace card's ... menu you can also:

  • Manage 2FA: ask Google Workspace users for a code from an authenticator app. See Two-factor authentication.
  • Manage Access: choose which Vipilink groups can sign in with Google Workspace. See Access groups.