KB

Sign In

Single Sign-On (SSO)




(Available for Enterprise level plans only)


OneDesk lets you set up Single Sign-On (SSO) to permit your users and customers to log in using their existing credentials. If the user does not exist, once they log in using SSO, OneDesk will create a user record for them. 


OneDesk supports OpenID Connect for customer accounts and SAML and OpenID Connect for users.


Accessing SSO in OneDesk


To enable SSO for your users or customers, head to more applications > Administration > Integrations > Single Sign On.



From this menu, toggle “Enable SSO for users” or “Enable SSO for customers” depending on what you want to set up.


Enabling SSO for Users


Toggle the “Enable SSO for users” button in the single sign-on menu. You can choose whether to go through SAML/OpenID Connect, as well as Azure Active Directory and Okta. For more detailed information on setting up SSO for your users, refer to: Setting up SSO for Users


Enabling SSO for Customers


After toggling the “Enable SSO for customers” button, you are prompted to add an OpenID client record and begin setup. For more detailed information on setting up SSO for your customers, refer to: Setting up SSO for Customers.



Troubleshooting - SSO is not, or has stopped working

  • Make sure the client secret has not expired. During initial set-up of SSO, you are prompted to select an expiry date for your client secret. The expiry date can be customized, but it is always necessary to set an expiry. If your SSO has stopped work, ensure your client secret has not expired. If it has expired, the connection will need to be reset.


  • Disable SSO and try again.  Disabling/disconnecting your SSO and connecting again often fixes the issue.


  • Screenshot the error message. Send us a screenshot of the error message your are receiving.



Related Articles

 



Other Related Features: