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

# OneLogin

> How to configure SAML SSO with OneLogin for your Tuple team

export const provider_1 = "OneLogin"

export const children_0 = undefined

export const provider_0 = "OneLogin"

This guide walks through configuring SAML SSO with OneLogin 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="Create a SAML connector">
    After signing in to your OneLogin account, click **Applications > Applications** in the top navigation bar.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/1-add-app.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=1c07499cd810a8f3ca13dda29a7951a2" alt="Add SSO SAML App" width="1243" height="695" data-path="images/team-management/sso/onelogin/1-add-app.png" />

    In the search field, enter `SAML Test` and select **SAML Test Connector (Advanced)** from the results.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/2-saml-connector.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=33b1f19b7c84f343c03e6cf17d6be5bf" alt="Locate App From Search" width="1243" height="695" data-path="images/team-management/sso/onelogin/2-saml-connector.png" />

    Fill in any required metadata, upload company logos, and save the new application.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/3-connector-metadata.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=4eae3421e5413865a1bf780a4c925268" alt="SAML Metadata" width="1269" height="1099" data-path="images/team-management/sso/onelogin/3-connector-metadata.png" />
  </Step>

  <Step title="Configure Tuple's metadata">
    After saving, click **Configuration** in the left-hand sidebar.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/4-tuple-config.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=c4fcff11ab216520e5f1f489a0905543" alt="Tuple Metadata" width="1287" height="1247" data-path="images/team-management/sso/onelogin/4-tuple-config.png" />

    Fill in the following fields:

    **Audience (EntityID)**

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

    **Recipient**

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

    **ACS (Consumer) URL Validator**

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

    **ACS (Consumer) URL**

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

    **Login URL**

    ```
    https://production.tuple.app
    ```
  </Step>

  <Step title="Attach required parameters">
    Navigate to the **Parameters** section in the sidebar and click the plus button to add new fields.

    Tuple requires three fields in the SSO response: `email`, `first_name`, and `last_name`.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/5-user-param-add.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=fe995f0e514aa566922d3512bf731e03" alt="Add User Parameters" width="1287" height="788" data-path="images/team-management/sso/onelogin/5-user-param-add.png" />

    When adding each field, check the **Include in SAML Assertion** checkbox.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/6-include-assert.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=c7206824f8f1352fd8daec4ed0862661" alt="Check assertion" width="1287" height="788" data-path="images/team-management/sso/onelogin/6-include-assert.png" />

    Repeat for `first_name` and `last_name`.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/7-first-name.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=7497f59f71744a3aedd5cd190b13a9b9" alt="Adding First Name" width="1287" height="788" data-path="images/team-management/sso/onelogin/7-first-name.png" />

    Once all required parameters are added, the screen looks like this:

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/8-all-params.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=86069883eaa7154476bbbc4b802f7f05" alt="All Required Tuple Params" width="1287" height="788" data-path="images/team-management/sso/onelogin/8-all-params.png" />
  </Step>

  <Step title="Enable SAML in Tuple">
    Download your X.509 certificate. Click **SSO** in the sidebar and find the link to **View Details**:

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/9-next-steps-cert.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=234e2f4ee9613f95ac9a7aeefb4c50c6" alt="View certificate" width="1321" height="780" data-path="images/team-management/sso/onelogin/9-next-steps-cert.png" />

    Click **Download** to save the certificate file.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/10-next-steps-download.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=29ed8a311fa15e3cf293e98215014c98" alt="Download certificate" width="1321" height="780" data-path="images/team-management/sso/onelogin/10-next-steps-download.png" />

    Return to the **SSO** screen and locate the **Issuer URL** and **SAML 2.0 Endpoint (HTTP)**.

    <img src="https://mintcdn.com/tuple-0f82e5be/mvUxndXY5Na4FaZB/images/team-management/sso/onelogin/11-next-steps-urls.png?fit=max&auto=format&n=mvUxndXY5Na4FaZB&q=85&s=b11ce4f60ff3d67697ced9ea5d5d1322" alt="Entity ID and auth URL" width="1310" height="930" data-path="images/team-management/sso/onelogin/11-next-steps-urls.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>
</Steps>
