Okta Identity Platform

This document brings an agile tutorial on how to set up Single-sign-on authentication method for Okta Identity provider platform.

Creating Desko Application on Okta Admin Portal and setting up SSO (SAML 2.0)

Access your Okta Admin Console at https://<YourCompanyName>-admin.okta.com/admin go to Applications and click on Create App Integration

2. Choose SAML 2.0 option and click on Next

3. Enter a name for your application, add a logo (optional) by clicking on the upload button, and click on Next

Note: Before move on to the SAML settings, it is necessary to get the Desko’s URLs that is going to be inserted into the URL fields in the next step.

4. Go to your Desko panel heading over to https://<YourCompanyName>.painel.desko.com.br

Note: You have to log in using a Master or Admin account.

5. Expand Integrations and click on Authentication

6. Turn on SSO SAML 2.0 authentication,

7. Go to the bottom of the page at SAML Basic setup and copy the Entity ID and the ACS response URL as shown below. **** The Logout URL is optional.

8. Go back to your Okta Admin portal, and paste the 2 URLs mentioned in the previous item into the proper fields as shown below:

URLs from Desko Panel that should match on Okta Admin Portal:

9. Change the fields Name ID format and Application username to the values “Persistent” and “Email” respectively as shown below

10. On Attribute Statements section, add the first Claim value as “user.firstName”, and insert the User Name attribute from Desko panel as shown below. Keep Name format option as “Unspecified”. Click on Add Another button and do the same for the Claims “user.lastName” and “user.email” just like shown below.

11. Download and save the Okta certificate, you will need to upload on Desko panel later on

12. Click on Next

13. On Feedback tab, just select the proper options according to your Okta client profile and click on Finish button.

14. In the next screen, click on View Setup Instructions and a new tab will be open with the settings needed to configure Desko application

Here you have all the information needed to set up Desko application:

15. Go back to your Desko panel. On Connection name field, enter a name for your connection and insert the proper URLs matching the fields as shown below

URLs from Okta Admin portal that should match on Desko Panel:

16. Upload Okta Certificate that you downloaded in the item 11 by clicking on Update certificate field. Before select the cert file, rename it from okta.cert to okta.cer (just change the file extension). Then select okta.cer and upload it

17. Scroll down to the bottom of the page and click on Save button

18. In order to make the Desko app available to allowed users, do not forget to add them in your Okta Admin portal by clicking on Applications and Assign Users to App

19. To access your Desko app, just head over to https://<YourCompanyName>.desko.com.br and click on the button you named for your login method.