> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Cloud Security OAuth 2.0 (Multiple Companies) connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 (Multiple Companies) for Google Cloud Security in StackOne to allow users to link their accounts.

> [!WARNING]
>
> Security Admin or Organization Admin privileges in Google Cloud are required to complete this setup.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Create a Google Cloud OAuth client

Set up a Google Cloud project with the IAM, Secret Manager and Cloud Resource Manager APIs enabled and an OAuth client for StackOne.

**1. Create or select a project**

Sign in to your [Google Cloud Console](https://console.cloud.google.com/), then open the project picker at the top of the page.

<ul>
  <li>**New project:** Click **New project**, fill in **Project name**, **Organization** and **Parent resource**, then click **Create**. Select the new project in the project picker.</li>
  <li>**Existing project:** Select it in the project picker.</li>
</ul>

![Select a resource dialog listing the projects in the organization, with the New project button highlighted.](https://mintcdn.com/stackone-60/GMnFH1albjmZuX8b/connectors/googlecloudsecurity/images/oauth2-setup-create-project.png?fit=max\&auto=format\&n=GMnFH1albjmZuX8b\&q=85\&s=005b60f516055cc475943350785f4efe)

**2. Enable the IAM, Secret Manager and Cloud Resource Manager APIs**

Open **APIs & Services** > **Library**.

<ul>
  <li>Search for `Identity and Access Management (IAM) API`.</li>
  <li>Click **Identity and Access Management (IAM) API**.</li>
  <li>Click **Enable**. If it shows **Manage**, it's already enabled.</li>
  <li>Repeat for `Secret Manager API` and `Cloud Resource Manager API`.</li>
</ul>

**3. Enter the app information**

Open **APIs & Services** > **OAuth consent screen** to open the Google Auth Platform dashboard.

<ul>
  <li>Click **Get started**. If the **OAuth Overview** page opens instead, open **Branding** from the sidebar.</li>
  <li>**App name**: A name that identifies this integration</li>
  <li>**User support email**: Email address for user inquiries</li>
  <li>Click **Next**.</li>
</ul>

![Branding page of the Google Auth Platform with the App information section, highlighting the App name and User support email fields (email redacted).](https://mintcdn.com/stackone-60/GMnFH1albjmZuX8b/connectors/googlecloudsecurity/images/oauth2-setup-branding-info.png?fit=max\&auto=format\&n=GMnFH1albjmZuX8b\&q=85\&s=32719258c5a3b9b0d45d8acde961d3de)

**4. Select the audience**

Choose the user type for your application.

<ul>
  <li>**Internal**: Only users within your Google Workspace organization can authorize (no app verification required)</li>
  <li>**External**: Any Google account can authorize (requires app verification for production use)</li>
  <li>Click **Next**.</li>
</ul>

![Audience page of the Google Auth Platform with the User type section highlighted, showing the current type and the Make internal button.](https://mintcdn.com/stackone-60/GMnFH1albjmZuX8b/connectors/googlecloudsecurity/images/oauth2-setup-select-audience.png?fit=max\&auto=format\&n=GMnFH1albjmZuX8b\&q=85\&s=80824472dc9f09b44343f14d0a4f7e2f)

**5. Enter contact information**

Google sends notices about changes to your project to these addresses. If you opened **Branding**, the field is under **Developer contact information** on the same page.

<ul>
  <li>**Email addresses**: Email addresses for project notices</li>
  <li>Click **Next**.</li>
</ul>

**6. Accept the user data policy**

Review your settings.

<ul>
  <li>Agree to the Google API Services User Data Policy.</li>
  <li>Click **Create**.</li>
</ul>

**7. Publish the app**

For **External** apps, open **Audience** in Google Auth Platform. **Internal** (Google Workspace) apps do not need this step.

<ul>
  <li>Check the **Publishing status**. If it shows **Testing**, click **Publish app**.</li>
  <li>Confirm the dialog.</li>
</ul>

**8. Add the scopes**

Enables actions: Access Secret Version, Add Secret Version, Create Deny Policy, Create Folder, Create Project, Create Project Role, Create Secret, Create Service Account, Create Service Account Key, Create Tag Key, Create Tag Value, Delete Deny Policy, Delete Folder, Delete Project, Delete Project Role, Delete Secret, Delete Service Account, Delete Service Account Key, Delete Tag Key, Delete Tag Value, Destroy Secret Version, Disable Secret Version, Disable Service Account, Disable Service Account Key, Enable Secret Version, Enable Service Account, Enable Service Account Key, Get Deny Policy, Get Deny Policy Status, Get Folder, Get Namespaced Tag Key, Get Namespaced Tag Value, Get Operation, Get Organization, Get Project, Get Project IAM Policy, Get Role, Get Secret, Get Secret IAM Policy, Get Secret Version, Get Service Account, Get Service Account Key, Get Tag Key, Get Tag Value, List Deny Policies, List Folders, List Predefined Roles, List Project Roles, List Projects, List Secret Versions, List Secrets, List Service Account Keys, List Service Accounts, List Tag Keys, List Tag Values, Search Folders, Search Organizations, Search Projects, Set Project IAM Policy, Set Secret IAM Policy, Test Project IAM Permissions, Undelete Project Role, Undelete Service Account, Update Deny Policy, Update Folder, Update Project, Update Project Role, Update Secret, Update Service Account, Update Tag Key, Update Tag Value

In Google Auth Platform, open **Data Access**.

<ul>
  <li>Click **Add or Remove Scopes**.</li>
  <li>Under **Manually add scopes** in the **Update selected scopes** side panel, paste each scope listed.</li>
  <li>Click **Add to table**.</li>
  <li>Click **Update**.</li>
  <li>On the **Data Access** page, click **Save**.</li>
</ul>

![Data Access page of the Google Auth Platform with the Add or remove scopes button highlighted above the list of configured scopes.](https://mintcdn.com/stackone-60/GMnFH1albjmZuX8b/connectors/googlecloudsecurity/images/oauth2-setup-select-scopes.png?fit=max\&auto=format\&n=GMnFH1albjmZuX8b\&q=85\&s=2e383274100ee3e50c881e50394e375a)

<ul>
  <li>
    [https://www.googleapis.com/auth/cloud-platform](https://www.googleapis.com/auth/cloud-platform)
  </li>
</ul>

**9. Create the OAuth client**

Open **APIs & Services** > **Credentials**.

<ul>
  <li>Click **Create credentials**.</li>
  <li>Select **OAuth client ID**.</li>
  <li>**Application type**: **Web application**</li>
  <li>**Name**: A name that identifies this OAuth client</li>
  <li>Under **Authorized redirect URIs**, click **Add URI**.</li>
  <li>Enter the **Callback URL** from your Connector Profile.</li>
  <li>Click **Create**.</li>
</ul>

![Create OAuth client ID form with Application type set to Web application, a Name filled in, the StackOne callback URL under Authorized redirect URIs, and the Create button highlighted.](https://mintcdn.com/stackone-60/GMnFH1albjmZuX8b/connectors/googlecloudsecurity/images/oauth2-setup-create-oauth-form.png?fit=max\&auto=format\&n=GMnFH1albjmZuX8b\&q=85\&s=a0ce96cb5816393116aca58d7764de03)

**10. Copy the Client ID and Client Secret**

A dialog shows your **Client ID** and **Client Secret**.

<ul>
  <li>Copy the **Client ID** and **Client Secret** into your Connector Profile.</li>
</ul>

## Google Cloud session control

Google Workspace administrators can enforce a **Google Cloud session control** window of 1 to 24 hours that applies to Google Cloud OAuth scopes. Once the window elapses, the refresh token for this connection stops working until a user re-authenticates.

<ul>
  <li>Sign in to the [Google Admin console](https://admin.google.com/). The setting is in the Google Workspace Admin console, not the Google Cloud console.</li>
  <li>Open **Security** > **Access and data control** > **Google Cloud session control**.</li>
  <li>Add this OAuth app to your trusted apps list, then check **Exempt Trusted apps**.</li>
  <li>**Alternative:** On the same page, select **Session never expires** to remove the window for every Google Cloud app in the organization, instead of exempting this one app.</li>
</ul>

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/googlecloudsecurity/guides/link-account/oauth-2-0-multiple-companies.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.