Guide

How to setup SSO with OneLogin


BlueTally lets you save time and headaches with our Single Sign-on integration with OneLogin that lets your team members log in and use the app without the need to manually create accounts and new passwords.

1) Log in to your OneLogin account and click on "Applications", then on "Add App"

How to setup SSO with OneLogin

2) Search for "saml custom connector" and select "SAML Custom Connector (Advanced)"

How to setup SSO with OneLogin

3) Give it a name (like BlueTally SAML SSO), upload icons (click here for the rectangular icon, click here for the square icon) and click "Save"

How to setup SSO with OneLogin

4) Click on "Configuration" in the left menu bar

How to setup SSO with OneLogin

5) Enter "https://CUSTOMLINK.bluetallyapp.com/" in the RelayState field,
"https://CUSTOMLINK.bluetallyapp.com/users/auth/saml_CUSTOMLINK/metadata" in the Audience (EntityID) field,
"https://CUSTOMLINK.bluetallyapp.com/users/auth/saml_CUSTOMLINK/callback" in the Recipient field,
"https://CUSTOMLINK.bluetallyapp.com/users/auth/saml_CUSTOMLINK/callback" in the ACS (Consumer) URL Validator field,
"https://CUSTOMLINK.bluetallyapp.com/users/auth/saml_CUSTOMLINK/callback" in the ACS (Consumer) URL field and scroll down
(replace CUSTOMLINK with the custom link you want to use to log into the app with)

If your custom link contains a "-", please replace it with a "_" in the last CUSTOMLINK in the Audience (EntityID) field, Recipient field, ACS (Consumer) URL Validator field, and ACS (Consumer) URL field, for example: "https://my-custom-link.bluetallyapp.com/users/auth/saml_my_custom_link/callback"

How to setup SSO with OneLogin

6) Enter "https://CUSTOMLINK.bluetallyapp.com/" in the Login URL field, change the SAML Initiator to "Service Provider", ensure the SAML nameID format is "Email" and click "Save"

How to setup SSO with OneLogin

7) Click on "Parameters" in the left menu bar, and click on "+" to add a new field

How to setup SSO with OneLogin

8) Enter "first_name" as the Field Name, tick the "Include in SAML assertion" checkbox and click "Save"

How to setup SSO with OneLogin

9) Select "First Name" from the list of values and click "Save"

How to setup SSO with OneLogin

10) Enter "last_name" as the Field Name, tick the "Include in SAML assertion" checkbox and click "Save"

How to setup SSO with OneLogin

11) Select "Last Name" from the list of values and click "Save"

How to setup SSO with OneLogin

12) Click on "Save"

How to setup SSO with OneLogin

13) Click on "SSO" in the left menu bar, then copy the "SAML 2.0 Endpoint (HTTP)" and note it down for later, and click on "View Details" under X.509 Certificate

How to setup SSO with OneLogin

14) Scroll down and download the certificate

How to setup SSO with OneLogin

15) Click on Users and select a user you'd like to be able to sign into BlueTally using SSO

How to setup SSO with OneLogin

16) Click on "Applications" in the left menu bar

How to setup SSO with OneLogin

17) Click on "+" to add a new application for the user

How to setup SSO with OneLogin

18) Select the app you just made (BlueTally SAML SSO) and click "Continue"

How to setup SSO with OneLogin

19) Make sure "Allow the user to sign in" is checked and click on "Save". Repeat this process (Step 15-19) for all the groups or users you'd like to have SSO login

How to setup SSO with OneLogin

20) Go to your BlueTally account settings and enter the "CUSTOMLINK" you decided on earlier, paste in the "SAML 2.0 Endpoint (HTTP)", upload the certificate and decide on which role you'd like new users to have by default.

How to setup SSO with OneLogin

That's it! Once you upload these details into your account settings, we'll complete the setup on our end - this usually takes less than 1 hour. You'll receive an email when everything is ready.

If you have any questions regarding this integration, send us an email to [email protected] and we'll assist you with your setup!

You can also receive notifications directly to Microsoft Teams and Slack, integrate BlueTally with Intune, or into your existing workflows by using our powerful API.


Get started for free now

Our Free Plan includes all features and up to 50 assets