Deskpro Single Sign On (SSO) with JWT

Deskpro

This solution allows you to setup Single Sign-On into Deskpro (which does not support SAML 2.0 standard) with your existing SAML IdP. This is achieved by protocol brokering between JWT and SAML.

Deskpro has support for SSO using JSON Web Token (JWT) tokens. miniOrange allows your users to Single Sign-On into Deskpro by verifying Identity with your existing SAML 2.0 compliant Identity Provider and passing JWT tokens to Deskpro.

Pre-requisites:

• SAML 2.0 supported Identity Provider (In case you don’t have IdP, you can use miniOrange as an Identity Provider)

Follow the Step-by-Step Guide given below for Deskpro JWT Single Sign On (SSO)

Step 1: Add Deskpro application in miniOrange:

• Login to your miniOrange dashboard.
• Go to Apps > Manage Apps.
• Click on Configure Apps and select tab External/JWT/PwdLess.
• Select app External /JWT App.



• Configure the name for Deskpro and configure Redirect-URL which tells where to send JWT response. Redirect-URL should be an endpoint on Deskpro i.e https://<your_domain>.deskpro.com where you want to achieve SSO.
• Copy Client ID, App Secret of generated application and keep it with you for next steps.

Step 2: Configure SAML 2.0 Identity (ADFS) in miniOrange:

• Login to your miniOrange dashboard.
• Go to Identity Provider tab and choose Add Identity Provider option.
• Select SAML tab.



• Configure your IdP details from your metadata file.

Step 3: Configure Deskpro to use JWT

• Login to Deskpro dashboard and navigate to Agents >> Auth & SSO or CRM >> Auth & SSO, depending on whether you want to authenticate agents or users.



• Click on Add button and select JSON Web Token (JWT).
• Enter Remote Login URL as https://login.xecurify.com/moas/broker/login/jwt/<customer-id>?client_id=<client-id>&redirect_uri=<your_domain>.deskpro.com and JWT Secret Code that you get from the above step.
• Enter Login Button Text as Login With JWT.
• Check Enabled? option and click on Install App button.



• Then, click on Save Settings and Test your configurations by clicking on Test Settings.

Step 4: Test your SSO configuration

• Under the login dropwdown options, click on Login with jwt button.



• It will redirect to miniOrange login screen. Here, enter your credentials and you will be logged in into your deskpro account.

For Further Details Refer:

Deskpro Documentation
Deskpro SSO With JWT