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

  Tuple falls back to the SAML NameID when no email attribute is present in the response, so if your provider's NameID defaults to something other than email (such as a username or UPN), set it to the user's email address as well.
</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>
