Back to the app Website API Legal

SAML SSO - OneLogin

Here's how you can set up SAML SSO with OneLogin.

Part 1: Enable SAML SSO in Tability

  1. Go to your workspace SSO settings and select the SAML SSO option as the authentication method.

  2. Keep this screen open, we'll need it later.

Part 2: Create a new application for Tability in OneLogin

  1. Open a new tab and go to OneLogin to create a new SAML Test Connector (IdP w/ attr w/ sign response) app.

  2. In the configuration, screen change the display name to Tability and save.

Part 3: Configure SAML in OneLogin

  1. Go to the configuration section of your OneLogin app, and copy the values from your workspace SSO settings in Tability.

    1. Audience: copy the value of the SP Entity ID (https://api.tability.app/auth/saml/metadata/<workspace>)

    2. Recipient: copy the value of the SP Consumer URL (https://api.tability.app/auth/saml/consume/<workspace>)

    3. ACS (Consumer) URL Validator: copy the value of the SP Consumer URL (https://api.tability.app/auth/saml/consume/<workspace>)

    4. ACS (Consumer) URL: copy the value of the SP Consumer URL (https://api.tability.app/auth/saml/consume/<workspace>)

  2. Save the settings

Part 4: Update SAML SSO settings in Tability

  1. Go to the SSO section of your OneLogin application and click on View Details to see the content of the certificate.

  2. Copy the content of the certificate including the BEGIN CERTIFICATE and END CERTIFICATE to the IDP certificate field in Tability.

  3. Copy the SAML 2.0 Endpoint (HTTP) URL from OneLogin, and paste it into the IDP SSO URL field in Tability.

  4. Click on update to save the settings.

Part 5: Sign in via SSO to finalize your setup

Once SAML is activated, it will be the only authentication method for your workspace. Make sure that your admin account in Tability is associated with a user in your OneLogin, otherwise, you might lose access to your workspace settings.

To finalize the integration you need to sign in once via SAML SSO to validate your configuration.

Click on the Log in via SSO button to sign in.

Once you're logged in you should see a confirmation message at the top of your screen saying that "SAML SSO is enabled for all users."

Last updated