Google Workspace

Set up single sign-on using Google Workspace. The integration uses OpenID Connect (OIDC) to authenticate your team members.

Prerequisites

• A Google Workspace account with administrative privileges to manage API and application settings
• An Instruqt account with access to your team’s SSO settings

Step 1 – Create a Google Cloud project

In the Google Cloud Console:

1. Click NEW PROJECT in the project selector.
2. Enter a project name, for example Instruqt SSO Integration.
3. Click CREATE.

Step 2 – Configure the OAuth consent screen

Still in the Google Cloud Console:

1. Go to APIs & Services → OAuth consent screen.
2. Select the user type (Internal or External).
3. Enter the application name, for example Instruqt SSO.
4. Enter a user support email and developer contact information.
5. Click SAVE AND CONTINUE.

Step 3 – Create OAuth 2.0 credentials

1. Go to APIs & Services → Credentials.
2. Click CREATE CREDENTIALS and select OAuth client ID.
3. Choose Web application as the application type.
4. Enter a client name, for example Instruqt SSO Client.
5. Under Authorized redirect URIs, click ADD URI and enter:

   https://sso.play.instruqt.com/login/callback

6. Click CREATE.

Step 4 – Retrieve the connection details

1. Copy the displayed Client ID.
2. Copy the displayed Client secret.
3. Note your Google Workspace domain (for example your-company.com).

Step 5 – Finish in Instruqt

1. In the sidebar, click Settings → SSO.
2. Select Google Workspace.
3. Enter the Domain, Client ID, and Client Secret.
4. Click Save.

Your team members can now sign in with their Google Workspace credentials through your team’s login URL – see SSO overview.