Skip to main content
Version: Latest

Google identity provider

PolicyArc uses Google as a pass-through identity provider: when a user signs in, PolicyArc redirects them to Google's standard OAuth flow and accepts the resulting OIDC identity. PolicyArc never sees or stores their Google password.

To wire this up, you'll create an OAuth client in Google Cloud Console, then hand its client ID and secret to PolicyArc.

You'll need
  • A Google Cloud project (any project — it just needs the credentials surface).
  • Permission to create OAuth credentials in that project.
  • The PolicyArc admin portal open in another tab.

Step 1 — Open the Add Identity Provider screen

In the Admin Portal, go to Identity and click Add identity provider.

Empty IDP list

Pick Google from the provider list.

Select Google as IDP

Keep this tab open — you'll come back to it after you create the credentials in Google.


Step 2 — Open the Google provider console

Click Open provider console. Google will ask you to sign in.

Google console sign-in

After you authenticate, you'll land on the Credentials page of Google Cloud Console.

Google Cloud credentials page


Step 3 — Enable the Google APIs you'll use

The IDP itself only needs Google's OIDC scopes, which are always available. But if you plan to use any of the Gmail, Drive, or Calendar connectors later, each one requires its own Google API to be enabled on this project. You're already in the Google Cloud Console — it's the right moment to do this.

From the left nav of APIs & Services, open Enabled APIs & services, then click + Enable APIs and services at the top.

APIs & Services dashboard with the Enable APIs and services button

In the API Library, search for the API that matches each connector you plan to use:

ConnectorAPI to enable
GmailGmail API
Google DriveGoogle Drive API
Google CalendarGoogle Calendar API

Searching for Gmail returns both the Gmail API (the one you want) and a Gmail MCP API — pick the one labelled Google Enterprise API.

Gmail search results in the API Library

Click the API card and then Enable.

Gmail API Enable button

You'll land on the API/Service Details page with the status set to Enabled — that's your confirmation. The button now reads Disable API, which is fine; that's just how Google displays an already-enabled API.

Gmail API enabled — status set to Enabled

Repeat for the other connectors you plan to use. The search and Enable flow is identical:

Google Drive API search

Google Calendar API search

You can come back to APIs & Services → Library any time to enable more APIs. There's no charge for enabling an API on its own — you only pay for actual API calls.

Why isn't this part of the IDP itself?

Google's OAuth consent screen requests scopes (e.g. https://www.googleapis.com/auth/gmail.readonly) on behalf of your users. If the matching API isn't enabled on the project, the consent flow fails — even though the IDP setup looks complete. Enabling the API now prevents a confusing failure later.


Step 4 — Create an OAuth client

Click + Create credentials and pick OAuth client ID.

Create credentials menu

For Application type, choose Web application.

OAuth app type — Web application

Give the OAuth client a name (for example, PolicyArc App), then add an Authorized redirect URI.

The redirect URI comes from the PolicyArc tab you left open in Step 1 — it's the value PolicyArc shows on the Add Identity Provider screen.

Authorized redirect URI

Your finished form should look like this:

OAuth client create form

Click Create.


Step 5 — Capture the client ID and client secret

Google now shows a pop-up with your new Client ID and Client secret. Don't dismiss this dialog yet — the secret is shown only once.

Client credentials popup

Client credentials popup detail

You have two options:

  1. Copy the Client ID and Client secret by hand into the PolicyArc Admin Portal tab.
  2. Click the Download JSON button to save them to a file you can paste from later.

Download JSON button

Once you've captured both values, dismiss the dialog. The credentials now show in your Google Cloud Credentials list.

Credentials saved


Step 6 — Finish the IDP in PolicyArc

Switch back to the PolicyArc Admin Portal tab. Paste the Client ID and Client secret into the form, then click Add identity provider.

Add identity provider button

You'll land back on the environment overview. The Google IDP is now connected and ready to use.

Overview after adding IDP

You can review or edit your IDPs any time from the Identity menu in the left navigation.

Identity providers list


Enabling and disabling an IDP

To temporarily disable an IDP without deleting it, open it from the Identity list and toggle Enabled off. Disabled IDPs are hidden from sign-in but their configuration is preserved.

Edit IDP — enabled toggle


What's next

The Google IDP is now authenticating users. Next, give them a resource to access:

Google service account (domain-wide delegation)

The walkthrough above uses pass-through OAuth — every user signs in with their own Google account. If instead you need a Workspace service account with domain-wide delegation impersonating a fixed user, instructions are coming soon. Contact us if you need it now.