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

# Google Workspace

> How to configure SAML SSO with Google Workspace for your Tuple team

export const provider_1 = "Google Workspace"

export const children_0 = undefined

export const provider_0 = "Google Workspace"

This guide walks through configuring SAML SSO with Google Workspace as your identity provider.

<Info>
  Email addresses in {provider_0} and Tuple must match exactly. For example, `dev+tuple@company.com` does not match `dev@company.com`. Verify your team's email addresses before enabling SSO.
</Info>

<Steps>
  <Step title="Add a custom SAML app">
    Sign in to your Google Workspace Admin console. Navigate to **Apps > Web and mobile apps > Add app > Add custom SAML app**.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/google/navigation.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=4d09b0c7991136fcc8f85f08df6cde1d" alt="Navigate to add a custom SAML app" width="1430" height="960" data-path="images/team-management/sso/google/navigation.png" />
  </Step>

  <Step title="Create the app">
    Name the app "Tuple" and optionally upload an icon, which you can [download here](https://s3.wasabisys.com/tuple/images/tuple-sso.png).

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/google/add-custom-saml-app-1.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=6961bc7f25eb7a93696c307754d1cc07" alt="App details" width="2076" height="1362" data-path="images/team-management/sso/google/add-custom-saml-app-1.png" />
  </Step>

  <Step title="Configure your Tuple account">
    You are shown the Google Identity Provider details. Copy the values from this screen:

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/google/add-custom-saml-app-2.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=44c60d1007337168a827d367acf69fce" alt="Google Identity Provider details" width="2082" height="1818" data-path="images/team-management/sso/google/add-custom-saml-app-2.png" />

    Navigate to the **Settings** tab of the [team management dashboard](https://production.tuple.app/team_management/settings).

    <Info>
      Only [team owners](/team-management/team-owner-and-managers) can enable SAML. To find out who your team owner is, check [your profile](https://production.tuple.app/profile#team).
    </Info>

    Under **Sign-in methods**, set **Required Authentication Provider** to **SAML SSO**. The **Update SAML Configuration** form appears:

    <img src="https://mintcdn.com/tuple-0f82e5be/DYhTWyURiIllHPbV/images/team-management/sso/update-configuration.png?fit=max&auto=format&n=DYhTWyURiIllHPbV&q=85&s=e70c9481be3de1a3c3fca8b4ab6b71a4" alt="SAML configuration form in Tuple" width="1338" height="1163" data-path="images/team-management/sso/update-configuration.png" />

    Fill in the values with your {provider_1} metadata:

    {children_0}

    Select the **Email Domain** that SAML should apply to. Only domains with confirmed team members are available.

    Click **Save as draft**. Your draft is saved as a **Pending Update** alongside your current sign-in method, so no one on your team is affected yet.

    <img src="https://mintcdn.com/tuple-0f82e5be/DYhTWyURiIllHPbV/images/team-management/sso/pending-update.png?fit=max&auto=format&n=DYhTWyURiIllHPbV&q=85&s=3cd1871de2b84121fb99798a48d7acd0" alt="Pending SAML update showing Test and Publish actions" width="1190" height="835" data-path="images/team-management/sso/pending-update.png" />

    Click **Test** to verify the configuration end-to-end. Tuple signs you in through {provider_1} so you can confirm that authentication succeeds before the change affects anyone else on your team.

    Once the test succeeds, click **Publish** to make the configuration live. Active Tuple sessions persist, but new sign-ins are routed through {provider_1}.

    Use **Edit** to tweak the draft, or **Discard** to throw it away without publishing.
  </Step>

  <Step title="Service provider details">
    Return to the Google Workspace Admin console and fill in the following fields:

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/google/add-custom-saml-app-3.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=5869bdbc9769c73f9a3e672e1aa1305c" alt="Service provider details" width="2078" height="1534" data-path="images/team-management/sso/google/add-custom-saml-app-3.png" />

    **ACS URL**

    ```
    https://production.tuple.app/users/saml/auth
    ```

    **Entity ID**

    ```
    https://production.tuple.app/users/saml/metadata
    ```
  </Step>

  <Step title="Attribute mapping">
    Tuple requires two additional attributes: `first_name` and `last_name`.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/google/add-custom-saml-app-4.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=4564950ce9236e7795ce3ce64bf964da" alt="Attribute mapping" width="2084" height="1432" data-path="images/team-management/sso/google/add-custom-saml-app-4.png" />

    After finishing the install wizard, click **Test SAML Login** to verify the configuration.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/google/test-saml-login.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=d771aaed99ad660835294cb15043b7be" alt="Test SAML Login" width="764" height="714" data-path="images/team-management/sso/google/test-saml-login.png" />
  </Step>
</Steps>
