--- title: "Connect Clarity Security to G-Suite" slug: "google-workspace" description: "Learn how to connect Clarity Security to GSuite to automate your identity life cycle management and user access reviews." tags: ["marketplace", "How-To", "Integrations", "application", "Google"] updated: 2024-05-03T16:07:34Z published: 2024-05-03T16:07:34Z canonical: "help.claritysecurity.com/google-workspace" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.claritysecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Google Workspace This guide will teach you how to set up the connector between [Google Workspace](https://workspace.google.com) and [Clarity Security](https://claritysecurity.io). **Estimated time to complete:** 10 minutes If you encounter any problems, please contact your support team or [support@claritysecurity.io](mailto:support@claritysecurity.io). ## Supported Connector Capabilities ## Below are capabilities supported by the connector at this time. | **Method** | **Supported** | | --- | --- | | Provision User | Yes | | List Groups, Policies, and Roles | Yes | | Add User to Groups, Policies, and Roles | Yes | | Remove User from Groups, Policies, and Roles | No | | Deactivate User | No | | Delete User | Yes | ## ## How to Setup the Connector Note Using a service account when configuring this connector is advised, as you will use the email address when configuring this in Clarity. ### Step 1: Log into the Google Cloud Portal > [https://console.cloud.google.com/](https://console.cloud.google.com/) ### Step 2: Hover over APIs and Services > Library ![GCP Landing Page](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20gcp%20splash%20page.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=D1eSp485nHxJc4jHmBmSEtBOPl4%2BioUXE0%2FG165dAU0%3D) ### Step 3: In the API Library, search for Admin SDK API ![Search for admin sdk api](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20search%20for%20sdk.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=Yxw%2FoonSrKDXoBz%2FLeoFO60ujDeVwQkwm4%2Bgp0mf4f8%3D) ### Step 4: Click Admin SDK API ![Click Admin SDK API](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20admin%20sdk%20api.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=lUZfT6ccMlr46kl9hGNCU3CUxoCRNb8lkOGuWTTbFEk%3D) ### Step 5: Click Enable for the Admin SDK API ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20enable%20admin%20api.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=6aGzskcA9RdCqKBGq1sm5Id8uvd5A6b75jMMI5R54bA%3D) ### Step 6: After being redirected, click Credentials ![Admin SDK > Click Credentials](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20admin%20sdk%20api%20credentials.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=tczDx5BNrhCrLcu425e1kMyFk3kdt6ldYW3gA5%2B621Y%3D) ### Step 7: Click Create Credentials > Service Account ![Create Credentials > Service Account](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20create%20service%20account.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=ZnDmZ1TvNXFDH8tdSfdIY9HvalKpYKT2hYHkq5D7XQA%3D) ### Step 8: Configure the Service Account Provide a descriptive name (like **Clarity Connector**), then click **Create and Continue** (you may want to also provide a description.) ![Configure Service Account](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20configure%20account.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=WtJu8oF5f%2BnQ2cgOS2MDcedBzaXElNfQIDMnv%2BzBncw%3D) ### Step 9: Grant this service service account access > Basic > Editor Click the "Select a role" drop down option to find the **Basic > Editor** role. Once this role has been added, you can click **Done** to skip the third step and continue. ![Configure Service Account > Select a role](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20configure%20service%20select%20role.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=WKkwjUJQz1MGOnTj90e00CCD3DpFJvbl1vhAvckDaIA%3D) ### Step 10: Once redirected, click on your new Service Account Once you are redirected after creating the new service account, click on the service account in the list. ![Click on the new service account in the list](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20click%20new%20service%20account.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=9SPEBzaErf3P9nytDiuhnWZQvxWFqQJ5fj0jqw1RGRk%3D) ### Step 11: Copy the Unique ID Copy the unique id value for use in a later step. ![Copy the unique id value](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20copy%20unique%20id(1).png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=oIMXJ6mAmJJ1RsfvjpnyM9AmRYm%2BppsbJfShF5cXwEI%3D) ### Step 12: Open a new web browser tab with the following link > [admin.google.com](http://admin.google.com/) Note Keep your current Google Cloud tab open; you will need this again in Step 21 ### Step 13: Navigate to Account > Account Settings ![Google Admin Portal > Account > Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20acount%20settings.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=6TF0ZFgiKxl18IBrKB%2FHobErdFSW2FgoVfp%2FzjsFwgY%3D) ### Step 14: Copy the Customer ID for the Clarity configuration Copy the Customer ID and save this value for use in a later step. ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20customer%20id.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=JVHU8q0w%2F8csULQEP0MsoChcPZS0j%2F7wD%2Fi8JWfWPCI%3D) ### Step 15: Click Security > Access and data controls > API controls ![Security > Access and data controls > API controls](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20api%20controls.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=PpyBmcqY0st9K8ptVQtTxjNLMwMYKSf8Ko7GIjFe4y8%3D) ### Step 16: Scroll to the bottom and Click Manage Domain Wide Delegation ![Find "Manage Domain Wide Delegation" near the bottom](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20manage%20domain%20wide%20delegation.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=nXCYyVZvvmPyirWjUB8FhkOv8hqHmiqkZRypan3EBVA%3D) ### Step 17: Click Add new ![Click Add new under the Domain-wide delegation page](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20add%20new%20api%20clients.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=zz5lS5PZmrlr6qJxjarzHZR7GoxAgUoH6reb1C3iaJg%3D) ### Step 18: Enter the Unique ID copied from Step 11 ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20enter%20unique%20id.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=5Ya63kFpBsOJlt2Rsg6pC11jNB5qiJZTRb3WXhVhtZI%3D) ### Step 19: Copy the below text into the OAuth scopes Copy the following text into the **OAuth scopes** field, then click **Authorize**. ```plaintext https://www.googleapis.com/auth/admin.directory.customer,https://www.googleapis.com/auth/admin.directory.group,https://www.googleapis.com/auth/admin.directory.user,https://www.googleapis.com/auth/admin.directory.rolemanagement ``` ![OAuth Scopes](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20oauth%20scopes(1).png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=IgTrqwQp1KWqHEUX69gl5cGJMiFNzWtIj%2BNQTZdvnJc%3D) ### Step 20: Verify the content is populated. ### Step 21: Return to your Google Cloud Console web browser tab (from Steps 1-11) and click on the Service account Return to your initial **Google Cloud Platform** tab, and click on the **Service account** again. In case you closed the original tab, this was the Credentials screen located under the configuration page for the Admin SDK API. ![Click on your Admin SDK API service account](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20go%20back%20service%20account.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=8e2fS3nmA88AOcJMYsLsXBEN4qaQwF3bnclTBtFCGW0%3D) ### Step 22: Navigate to the Keys tab ![Click Keys near the top](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20click%20keys.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=4W%2Fyhz7jOhYm1p3NaaQQ3fVjXaZrH4DPcKqw%2F5X8gdU%3D) ### Step 23: Click Add Key > Create New Key Click on the Add Key button, then choose Create new key. ![Add Key > Create new key](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20create%20new%20key.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=o8dwhQUUgrWjSErK4vcZ%2B0eB93plFb2jy8m8OoxYI38%3D) ### Step 24: Select JSON > Click Create Select the recommended **JSON** option from the private key creation screen, then **click** **Create**. This will prompt a download of a JSON text file, the contents of which will need to be provided (copy and pasted) into the Clarity web UI. Warning This file contains secure API information which provides access to your Google environment; make sure to store this file securely. ![Choose JSON and the click Create](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20JSON%20create.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=Ec%2FQXZ8V1OWfn9yYWNaHN5959pwm%2FJkb0y1vvYJLe80%3D) ### **Step 25: Log in to Clarity** Login to your Clarity Security tenant. > https://your_tenant.claritysecurity.io ### **Step 26: Navigate to Applications, then Marketplace** Click on the Applications side tab, then click on the Marketplace to list all the available connectors. ![Applications > Marketplace](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679518028210.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=v5L2Ee4%2BPym3USvR%2BFZ%2BNkKqVarYQJqvtN%2F0GB7IAvE%3D) ### **Step 27: Find Goole Workspace** Scroll to or search for **Google Workspace** in the list of applications from the marketplace, then click **Connect**. ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1710338863284.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=WLet7zOULB6OCTbGhhTUGONWZyRvYwkC8u3kU%2FYH9eo%3D) ### **Step 28: Connect App** Complete the App Settings form. Details for fields common to all applications can be found in the following article: [Common App Configuration Steps](https://portal.document360.io/v1/docs/common-app-steps#step-1-connect-app). - **customerId**: Paste the **Customer ID** value collected in **Step 14**. - **adminAccount**: This value is the **email address** for an admin account of your GSuite account (it is advised to use a service account). - **cred_json**: Paste the entire contents of the **JSON file** downloaded in **Step 24**. ![Configure App > Connect App - G-suite](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/gsuite%20connect%20app.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=jMTct8fQmb06QEtUEkPE3ZTpzy1cT2Lz6mBR5yvaQ%2FA%3D) ### **Step 29: App Settings** Complete the App Settings form. Details for each field can be found in the following article: [Common App Configuration Steps](https://portal.document360.io/v1/docs/common-app-steps#step-2-app-settings). ![Configure App Step 2 - App Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%202(3).png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=NVz3RxYAffEcdIARRxLvp2ttbJCrSzBMa7H%2FCw3RCkQ%3D) ### **Step 30: User Settings** Complete the User Settings form, check the table at the top to see if any features are unsupported. Details for each field can be found in the following article: [Common App Configuration Steps](https://portal.document360.io/v1/docs/common-app-steps#step-3-user-settings). ![Configure App Step 3 - User Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%203(2).png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A23%3A05Z&se=2026-11-22T18%3A23%3A05Z&sr=b&sp=r&sig=%2BfPB0fs8syXlV9MFy5dRlCAwLZgv9RnRnqFlJIJV1uA%3D) ### **Step 31: Validate Your Selections and Save** **Save** Clicking the Save button will trigger the first full sync for your application (even if you selected Manual syncing). This includes Service Users, Entitlements, Service User Entitlements, Service User Attributes. ## **Need Help?** If you have any problems, contact your customer success team. You can also get in touch with our general support [via email](mailto:support@claritysecurity.io), open a [support ticket](https://support.claritysecurity.com/home). Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST. A Service User is a user, or service account, discovered by Clarity in a downstream application. An Entitlement is an assignable permission found in a downstream application. Common examples include licenses, groups, and policies. Service User Entitlements are the pairings of users and active entitlement access in downstream applications. An attribute is a piece of information used to describe a service user, entitlement, or identity. Common examples include First Name, Last Name, Job Title, Department, etc.