Jump to:

Configuring OneLogin and Central Desktop for SSO
Testing the Configuration
Creating Additional Users in OneLogin
Troubleshooting Tips

Configuring OneLogin and Central Desktop for SSO

To configure single sign-on with OneLogin and sign users into Central Desktop using SAML, follow the steps below.

In OneLogin

1.  In OneLogin, navigate to Apps > Find apps and search for Central Desktop. Click Add.
2.  In the Add Central Desktop screen select the app to be used by the Organization and select SAML 2.0 for the Connector Version. Press Continue.
3. Type your Central Desktop subdomain into the Subdomain field within the Configuration tab.
   
    
4. Under the Single Sign-on tab copy the HTTP Endpoint under SAML Endpoints to use in Central Desktop later. Set the credentials to "Configured by admin" and select a default User name value of "email" to use as the Central Desktop credential.
   
   
5. Under the Access Control tab, choose which roles will have access to Central Desktop.

In Central Desktop

1. In the top right corner, select Account > Company Setup.
2. Click the Advanced tab, and then the Single Sign On link.
   
   
   
   
3. Complete the fields SSO URL and SSO Logout URL as shown above (i.e. https://app.onelogin.com/saml/metadata/1234 & https://app.onelogin.com/client/apps). 
4. In the field SSO Login URL, paste the SAML HTTP Endpoint you previously copied (i.e. https://app.onelogin.com/trust/saml2/http-post/sso/1234). 
5. In OneLogin, click Security > SAML and copy the SHA-1 fingerprint. Paste that into the field SSO Certificate Fingerprint in Central Desktop. 
6. Enable SAML SSO by checking "Enable SAMLv2 Single Sign On."
7. Click Update to save the setting.  

Testing the configuration

1. Make sure you are logged out of Central Desktop.
2. Login to OneLogin.as
3. Click the Central Desktop icon on your dashboard. This should log you into your Central Desktop account.

If you're not using the same email address in Central Desktop as you are in OneLogin, do the following:

1. Click Apps > Company Apps. 
2. Edit the Central Desktop application. 
3. Navigate to the Logins tab.
4. Locate your user and click Edit. 
5. Enter your Central Desktop email address in the Email field and and click Update.
6. Navigate to the portal and re-test by clicking the Central Desktop icon.

Creating additional users in OneLogin

If you want to allow additional users to log into Central Desktop through OneLogin, you will need to create additional users 

1. Click on People > New User
2. Fill in the user profile and click Update
3. Click Apps > Add App > Select Central Desktop > click Continue
4. The user should now be able to log into OneLogin and click on the Central Desktop icon to log in 

Troubleshooting tips

If you run into any issues logging into Central Desktop via SSO after following this guide, review the following troubleshooting tips.  

1. If  you are seeing the below error when attempting to log in from OneLogin, please contact support@centraldesktop.com and provide your email domain which will be used to authenticate your SSO.  For example, the domain listed here is superco.com.  
2. Visist OneLogin's Support page or send an email to support@onelogin.com with your issue.