---
title: GSuite
description: GSuite connections
documentId: access-control-gsuite
locale: en-US
---

## Configuring a GSuite connection

There are three steps to configure a **GSuite** connection:

- [Create a federated login in Access Control](/docs/en/gsuite#create-federated-login-acc)
- [Create a client app in Google Cloud Console](/docs/en/gsuite#create-app-google)
- [Configure the federated login in Access Control](/docs/en/gsuite#configure-federated-login-acc)

<Callout type="NOTE" title="NOTE">
- It is not possible to generate *Client Credentials* using federated logins.
- Each environment allows **only one** active Federated Login provider at a time.
  If there is already a provider with **Active** status, it will not be possible to activate or create another provider.
  To configure a new provider, first deactivate the active provider. Once the status has changed, the creation or activation of another provider will be allowed.
</Callout>

<Callout type="WARNING" title="WARNING">
When you delete a federated login provider:

- Users **originally created as local users** in Access Control regain access via login and password, after a password reset.
- Users **created exclusively through federated login**, who were never local users, are permanently deleted, automatically and without prior notice. This data cannot be recovered after deletion.
</Callout>

To configure a **GSuite** connection, follow the steps below:

<a id="create-federated-login-acc"></a>
### Create a federated login in Access Control

<Steps>
<Step>
Access the **Federated Login** screen from the left menu.
</Step>
<Step>
Select the **GSuite** federated login type and click **CONFIGURE FEDERATED LOGIN**.
</Step>
<Step>
Copy the URL from the **Callback URL** field.
![GSuite configuration screen highlighting the callback url field](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_federated_login_3c9affe82b.png)
</Step>
</Steps>

<Callout type="IMPORTANT" title="IMPORTANT">
This is the URL to which the user should be returned after authentication and will be used later in the Google Cloud Console configuration.
</Callout>

<a id="create-app-google"></a>
### Create a client app in Google Cloud Console

<Steps>
<Step>
In a new tab, access the [Google Cloud Console](https://console.cloud.google.com/cloud-resource-manager).
</Step>

<Step>
Create a new project by clicking **CREATE PROJECT** in the upper left corner of the screen.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_create_project_68580e8f65.png)
</Step>

<Step>
Enter the project name and location.
Then click **CREATE**.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_create_project_form_8fa2cf9cd4.png)
</Step>

<Step>
Wait for your project to be created.
A message will be displayed in the notifications icon ![bell icon](https://creative-ball-51b3fc85c0.media.strapiapp.com/notification_icon_143e4566bb.png).
</Step>

<Step>
Click the notifications icon and select the newly created project.
You can also use the search bar to locate and select it.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_project_search_bar_notification_f287b92377.png)
</Step>

<Step>
After selecting the project, in the left sidebar select **APIs & Services > Credentials**.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_api_services_credentials_390efecd64.png)
</Step>

<Step>
On the **Credentials** screen, click **Configure consent screen**.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_consent_screen_2d582f03bd.png)
</Step>

<Step>
On the **OAuth Overview** screen, click **Get started**.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_oauth_overview_51d6a3c194.png)
</Step>

<Step>
Fill in the fields in the **App information** section and click **Next**.

- App name
- User support email

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_app_info_1f0d7c8c4d.png)
</Step>

<Step>
In the **Audience** section, select **External** and click **Next**.

<Callout type="IMPORTANT" title="IMPORTANT">
The **External** option enables application creation in Google Cloud Console.

However, when using this option, any user with a Google Account may try to access the environment, which can increase exposure.

To reduce this risk, make sure to configure **test users** and any other restrictions correctly during the process.

If your organization requires stricter access control, consider using the **Internal** option, which limits access to users from the configured domain only.
</Callout>

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_consent_screen_create_c189c507bb.png)
</Step>

<Step>
In **Contact Information**, provide one or more email addresses and click **Next**.
The email addresses provided will be used by Google for notifications about changes made to the project.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_developer_info_2eaea6044e.png)
</Step>

<Step>
Review Google's data use policy and, if you agree, select the checkbox and click **Continue**, then **Create**.
</Step>

<Step>
On the **OAuth Overview** screen, click **Create OAuth client**.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_create_oauth_client_button_5d4c3f8513.png)
</Step>

<Step>
In **Create OAuth client ID**:

- in **Application type**, select **Web application**;
- in **Name**, enter the OAuth client name.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_create_oauth_client_name_3adb0edc2e.png)
</Step>

<Step>
In the **Authorized redirect URIs** section, click **ADD URI** and enter the address (*callback URL*) that you copied in step 3 of the integration creation stage in Access Control.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_oauth_redirect_uri_5899a85711.png)
</Step>

<Step>
Click **CREATE**.
Your OAuth client will be created and the **Client ID** and **Client secret** will be displayed.
Click **OK**.

<Callout type="IMPORTANT" title="IMPORTANT">
Save this data, as it will be used in the Access Control configuration.
</Callout>

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_oauth_client_id_secret_b9e84f8efa.png)
</Step>

<Step>
In the left sidebar, go to **Audience** and, in the **Test users** section, click **ADD USERS**.

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_test_users_f96759adae.png)
</Step>

<Step>
Enter a valid email managed by Google and click **Save**.

<Callout type="IMPORTANT" title="IMPORTANT">
This user will be used to access Access Control.
</Callout>

![](https://creative-ball-51b3fc85c0.media.strapiapp.com/gsuite_test_users_add_ceb2a70ffa.png)
</Step>
</Steps>

<a id="configure-federated-login-acc"></a>
### Configure the federated login in Access Control

<Steps>
<Step>
After creating the app in Google Cloud Console, return to Access Control and fill in the fields below with the obtained data:

- **Client ID**: information obtained in step 15 when creating a *client app* in Google Cloud Console.
- **Client secret**: like the Client ID, enter the Client secret, which you obtained in step 15 when creating a *client app* in Google Cloud Console.
- **Role**: select the role to be applied with this access.
</Step>
</Steps>

<Callout type="NOTE" title="NOTE">If there are roles configured on your identity provider side, they will prevail over this one.</Callout>

## Deleting or editing a GSuite connection

While active, the connection with GSuite can be updated at any time.
To do this, click any field you wish to edit, make the necessary modifications and click **Save Changes** to confirm and update or **Back** to cancel.

To disable a connection, click the **Delete Login** button.

<Callout type="WARNING" title="WARNING">
- When you click **Delete Login**, the federated login provider is deleted. Users originally created as local users in Access Control regain access via login and password after a password reset; users created exclusively through federated login are permanently deleted. See the details at the top of this page.
- To re-establish the connection, follow the steps above again (Configuring a GSuite connection).
- Clicking **Delete Login** does not change your settings with your identity provider.
</Callout>

## Login and user control

Unlike what happened with login through the Sensedia Platform, now login with username and password continues to be possible even after configuring GSuite.

A user will be able to log into Sensedia products both through GSuite and separately.
