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

  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="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>
