# SSO using Google Workspace

{% hint style="success" %}
You need Admin access to your Google Workspace and DinMo organisation to be able to use the Google Workspace SSO.
{% endhint %}

### In Google Workspace

**Step 1: Create a custom SAML application for DinMo**

1. Sign in to your [Google Admin account](https://admin.google.com/) as an admin
2. Go to **Apps/Web and mobile apps**.

   ![](https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FCWoH0Op8TeT5yK1Fdwen%2Fimage.png?alt=media\&token=689e3660-fc7e-4c4c-886a-1387b29c90a2)
3. &#x20;In the upper panel, select **Add App**

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FaKLZWrR7R8LFkU3p1cRG%2Fimage%201.png?alt=media&#x26;token=22ca85ed-4f73-4a61-9c49-65fc1c1ac29f" alt=""><figcaption></figcaption></figure>

4. Choose Add custom SAML app from the suggested options ![](https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2F1Y9snblJ71thxVF8neO3%2Fimage%202.png?alt=media\&token=75025de2-598b-40c6-8eb0-82dba471854b)
5. Name your App **DinMo** and click **Continue** to access the **Google IdP** page

&#x20;![](https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2F3yWKOVoOK4TcYXThm4YD%2Fimage%203.png?alt=media\&token=b7b5760f-2e44-4cd4-9a90-52bbc106f72c)

**Step 2: Collect the SAML app details**

1. Make note of **SSO URL** and the **Entity ID. Y**ou will need them to configure the SSO for your DinMo organisation.
2. Download the Certificate&#x20;
3. Click **Continue** to proceed to the app configuration.

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FaNI2XUWIeqqdQmFdAtDh%2Fimage%204.png?alt=media&#x26;token=24d4274e-38b4-41b8-be83-30c5bfe204e7" alt=""><figcaption></figcaption></figure>

**Step 3: Configure Google SAML SOO in DinMo**

1. Sign in to your [DinMo workspace](https://app.dinmo.io) as an organization admin
2. Go to your organization management space

   * Click on your workspace name in the top left navigation menu.
   * Select **Manage Workspaces**.

   <figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FqSzwsBm30RiB0rd4Ml5v%2FCleanShot%202025-09-22%20at%2017.13.52%402x.png?alt=media&#x26;token=a5fcf4eb-02fc-4ac5-9212-a771a735cec5" alt="" width="222"><figcaption></figcaption></figure>

   * Go to the **Organization Settings** tab.
   * Select Google SSO.

   &#x20;
3. Click on **Google Workspace SSO** button

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FqtlroTc5MBn7UAQLIuMf%2Fimage.png?alt=media&#x26;token=26d26868-fe02-4338-964b-1940ceb2cfb7" alt="" width="563"><figcaption></figcaption></figure>

4. Fill in the Authentification Settings:

* **SSO Portal Key**: Choose a unique key to identify your SSO organization (e.g., `<company-name>_SSO`).
* **Sign on URL**: Enter the SSO URL collected in Step 2.
* **Application Identifier (Entity ID):** Enter the Entity ID collected in Step 2.
* Click **Save**

5. Collect the generated values:

* **DinMo’s Entity ID**
* **DinMo’s Callback URL**
* **Your Portal URL**: The URL used to connect to your DinMo workspace through SSO.

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FFGFcH0MLifKy7aBCmYsf%2Fimage%208.png?alt=media&#x26;token=7bb6c251-2ca9-44b6-a35d-c4571fed1157" alt=""><figcaption></figcaption></figure>

**Step 4: Complete the SAML App Configuration in Google Workspace**

1. In the **ACS URL** field, enter DinMo’s **Callback URL** collected in the previous step.
2. In the **Entity ID** field, enter DinMo’s **Entity ID** collected earlier.
3. Click **Save**.

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2F4aOhagXnDEBurFZoGMlA%2Fimage%209.png?alt=media&#x26;token=5eda6bbe-3450-4aa5-91c4-744d54e5c30a" alt=""><figcaption></figcaption></figure>

### **Step 5: Limit Access to Authorized Users (Optional)**

For additional security, you can restrict access to your DinMo workspace to authorized users only in your IdP. To enable this, toggle the **Enable SAML-only authentication** option.

***

{% hint style="success" %}
:tada: Congratulations! You have successfully enabled SSO for all your DinMo account workspaces.
{% endhint %}

### Connecting to a workspace using SSO

#### Method 1: using DinMo sign-in

* Go to <https://app.dinmo.io/sign-in>
* Click on "Continue with SSO"

<figure><img src="https://3204318043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxzBTp1t4OfqV67nXkVse%2Fuploads%2FgrhVUHnf09qDSSdogACQ%2FCleanShot%202025-09-23%20at%2011.31.04%402x.png?alt=media&#x26;token=f954cb19-3ad4-461a-809f-788a4a798ffd" alt="" width="563"><figcaption></figcaption></figure>

* Enter your **SSO Portal Key**
* Validate your connection with Google

#### Method 2: using your specific URL

* Go to [https://app.dinmo.io/sso?key=your\_key](https://app.dinmo.io/sso?key=dinmo)
* Validate your connection with Google
