Twingate

Google Workspace Configuration

Twingate integrates with Google Workspace in order to synchronize user accounts, to delegate user authentication to Google, and to optionally enable group synchronization.

User and group synchronization are performed using the Google Workspace Directory API, authorized via OAuth. In order to enable synchronization, an admin must authorize Twingate to access user and group information for your Google Workspace domain. This connection is initiated from the Identity Provider subsection of Settings in the Twingate Admin Console.

Note: Twingate requires the permission to read Google Workspace groups to function, even if you do not choose to enable Twingate group synchronization. (Group synchronization is disabled by default.)

User Sync

Only users that are active in your Google Workspace domain will be able to sign in to your Twingate Network. Inactive users will also be synced, but will be marked as inactive in Twingate and unable to sign in. Once synced, users can be given access to Twingate Resources based on Group membership.

User Authentication

Twingate delegates user authentication to Google. The user's email address must match the Google Workspace domain you configured at activation for access to be authorized. Users without an address matching your domain will not be able to authenticate and use Twingate.

This domain restriction also applies to admin users of the Twingate Admin Console. Additional admin users can be set within the Twingate Admin Console.

Permissions

User and group synchronization is performed via the Google Workspace API. In order to enable synchronization, an admin must authorize Twingate to access user and groups information for your Google Workspace domain. This is done from the Identity Provider subsection section of Settings in the Twingate Admin Console.

Minimum admin permissions

The user authorizing user sync must have one of the following admin roles in G Suite:

  • A Super Admin
  • A Groups Admin
  • A User Management Admin
  • A Help Desk Admin
  • A custom admin role with at least a "Users: Read" and "Groups: Read" permissions under the Admin API.

(More information on Google Workspace administrator roles can be found in Google's Help Center.)

API access control

If attempts to authorize Twingate access to your Google Workspace account fail with an authorization error, you likely have restricted access to third party applications. You can verify this in the Security > API Controls > Manage Google Services section of your Google Workspace admin console, by checking if Google Workspace Admin is listed as a Restricted.

In order to complete the process of connecting Twingate to Google Workspace, there are two options:

  1. Change Google Workspace Admin to Unrestricted
  2. In Security > API Controls > Manage Third-Party App Access, find Twingate and click Change access. Select Trusted: Can access all Google services and click Change.

Data privacy

Twingate only syncs the information that is necessary to provide our service:

  • User first and last names
  • User email addresses
  • User avatars
  • Group membership (if Group Sync is enabled)

Group Sync

By default, Google Workspace group sync is disabled within the Twingate admin console. If you would like Twingate to sync groups, choose "Enable Group Sync" in the Settings > Identity Provider section.

Updated about a month ago


Google Workspace Configuration


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.