# Google SSO

## Integrating Google as an Identity Provider

#### Prerequisites

Before you begin:

* You have access to the **Google Cloud Console** with permissions to create OAuth credentials.
* Request the **ZITADEL Callback URL** for your instance from Blockbrain

#### 1. Google Configuration[​](https://zitadel.com/docs/guides/integrate/identity-providers/google#google-configuration) <a href="#google-configuration" id="google-configuration"></a>

**Register a new client**[**​**](https://zitadel.com/docs/guides/integrate/identity-providers/google#register-a-new-client)

1. Go to the Google Cloud Platform and choose your project: <https://console.cloud.google.com/apis/credentials>
2. Choose or create a project.
3. Click on "+ CREATE CREDENTIALS" and choose "OAuth client ID".
4. Choose "Web application" as application type and give a name.
5. Set a name (e.g., `Blockbrain SSO Client`).
6. Paste the **ZITADEL Callback URL** you copied before to the Authorised redirect URIs.

<figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2FKjfRddKWaqFFfyyCHUZk%2Fimage.png?alt=media&#x26;token=ad054472-d635-4cca-9152-a8288e566101" alt=""><figcaption></figcaption></figure>

#### 2. Finalize the Configuration in ZITADEL <a href="#client-id-and-secret" id="client-id-and-secret"></a>

**Client ID and Key (Secret)**[**​**](https://zitadel.com/docs/guides/integrate/identity-providers/google#client-id-and-secret)

After you've created the project, you will receive **Client ID** and **Client Key (Secret)**.&#x20;

> **Important**: For security reasons, do not send your Client Secret or Client ID to Blockbrain via email or chat.
>
> You can configure Google as your identity Provider directly in your Blockbrain account admin interface.

**To complete the setup**:

1. Log in to your Blockbrain admin interface with your admin account
2. Navigate to **Admin** > **Integrations** > **Google Identity Providers**
3. Click **Add connection**
4. Enter your **Client ID** and **Client Secret** from your Google Cloud project
5. Save your changes by clicking **Connect**

If you encounter any issues, please contact Blockbrain support.

<figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2FG7Iqu6DsA2lvi3nHeJWI%2Fimage.png?alt=media&#x26;token=bb1660d8-9190-48ba-ab05-9542e2024643" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2Fh99OURToN3OSOzJKKqjH%2FScreenshot%202026-01-08%20at%2010.58.44.png?alt=media&#x26;token=b44185d7-4171-4b6a-8b43-98e8d73ad6cc" alt=""><figcaption></figcaption></figure>

#### 3. Logging in <a href="#zitadel-configuration" id="zitadel-configuration"></a>

After successful completion of the setup your contact at Blockbrain will let you know that Google SSO is now available to users of your instance. \
Just click the "Google"-Button and enter your credentials to sign on.<br>

<figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2F7Ccfe2Ggslf5DwPXBlAb%2FBildschirmfoto%202025-04-14%20um%2013.36.42.png?alt=media&#x26;token=67d2aac0-8799-4dbe-ae42-5f837f43e65d" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3232460952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIabFtGTeQzwfWCzp8vd6%2Fuploads%2Fw7DqRVNSyRkc9AwhA2y1%2Fimage.png?alt=media&#x26;token=fb124462-9623-4ee5-b2a0-2b131ce50f72" alt=""><figcaption></figcaption></figure>