Skip to main content
Security Admin or Organization Admin privileges in Google Cloud are required to complete this setup.

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, then open the project picker at the top of the page.

  • New project: Click New project, fill in Project name, Organization and Parent resource, then click Create. Select the new project in the project picker.
  • Existing project: Select it in the project picker.
Select a resource dialog listing the projects in the organization, with the New project button highlighted.
2

Enable the IAM, Secret Manager and Cloud Resource Manager APIs

Open APIs & Services > Library.

  • Search for Identity and Access Management (IAM) API.
  • Click Identity and Access Management (IAM) API.
  • Click Enable. If it shows Manage, it’s already enabled.
  • Repeat for Secret Manager API and Cloud Resource Manager API.
3

Enter the app information

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

  • Click Get started. If the OAuth Overview page opens instead, open Branding from the sidebar.
  • App name: A name that identifies this integration
  • User support email: Email address for user inquiries
  • Click Next.
Branding page of the Google Auth Platform with the App information section, highlighting the App name and User support email fields (email redacted).
4

Select the audience

Choose the user type for your application.

  • Internal: Only users within your Google Workspace organization can authorize (no app verification required)
  • External: Any Google account can authorize (requires app verification for production use)
  • Click Next.
Audience page of the Google Auth Platform with the User type section highlighted, showing the current type and the Make internal button.
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.

  • Email addresses: Email addresses for project notices
  • Click Next.
6

Accept the user data policy

Review your settings.

  • Agree to the Google API Services User Data Policy.
  • Click Create.
7

Publish the app

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

  • Check the Publishing status. If it shows Testing, click Publish app.
  • Confirm the dialog.
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.

  • Click Add or Remove Scopes.
  • Under Manually add scopes in the Update selected scopes side panel, paste each scope listed.
  • Click Add to table.
  • Click Update.
  • On the Data Access page, click Save.
Data Access page of the Google Auth Platform with the Add or remove scopes button highlighted above the list of configured scopes.
9

Create the OAuth client

Open APIs & Services > Credentials.

  • Click Create credentials.
  • Select OAuth client ID.
  • Application type: Web application
  • Name: A name that identifies this OAuth client
  • Under Authorized redirect URIs, click Add URI.
  • Enter the Callback URL from your Connector Profile.
  • Click Create.
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.
10

Copy the Client ID and Client Secret

A dialog shows your Client ID and Client Secret.

  • Copy the Client ID and Client Secret into your Connector Profile.

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.

  • Sign in to the Google Admin console. The setting is in the Google Workspace Admin console, not the Google Cloud console.
  • Open Security > Access and data control > Google Cloud session control.
  • Add this OAuth app to your trusted apps list, then check Exempt Trusted apps.
  • 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.

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.
2

Link an Account

Once the Connector Profile is created, continue to link an account.