Setting up OneLogin SSO

This article focuses just on setting up OneLogin SSO. For more general information on using SSO with Dado, please see our SSO help article.

Step 1: Start the integration set-up in Dado

1. Go to Settings > Integrations in your Dado admin account

2. Click on the SAML SSO card and a new window will appear

   

3. Make a note of the following information, or keep this window open in a separate tab while you complete step 2.
   1. ACS URL
   2. Entity ID
   3. Name ID Format

Step 2: Setting up the SAML application within OneLogin

1. Log into your OneLogin Admin Portal
2. Navigate to Applications in the top navigation, and then click Add Application

3. Now search for SAML Custom Connector and click SAML Custom Connector (Advanced)

   

4. In the next screen, input a name and a logo, then click Save in the top right.
   1. Here are links for a full Dado logo and a Dado icon
5. On the next screen, you will be asked for the configuration information you got from Dado in Step 1.
   1. Input the Entity ID from Dado into the Audience (EntityID) field
   2. Input the ACS URL from Dado into the Recipient field, the ACS (Consumer) URL Validator) field and the ACS (Consumer) URL fields
   3. In the Login URL field, input https://app.dadohr.com
   4. In the SAML initiator field, select Service Provider

   5. In the SAML nameID format field, select Email

      

6. Click Save in the top right
7. Click More actions in the top right and select SAML Metadata

8. An XML file will download to your computer. You'll need this for the Step 3, below.
9. Assign the newly created Dado application to the users who will need to access it via SSO
   1. Depending on what you set up in Dado in Step 3, you'll either need to assign the app to employees with Dado Admin accounts, or to these people plus any employees assigned tasks via Dado.
   2. We recommend using OneLogin's Roles feature to do this. Find instructions on how to set up Roles here.

Step 3: Finish your set-up in Dado

1. Go to the Dado Admin app, and navigate to Settings > Integrations.
2. Click on the SAML SSO card
3. Paste the contents of the XML file into the IDP XML Metadata field in the new window, then click Save.
4. You'll now be presented with two options: switching on SSO for End Users or Admin Users. For guidance on these two options, please see our general SSO help article.