Enabling OAuth for DDPortal

OAuth is our latest login method for DDPortal, it allows end users to log in using their Office 365 credentials instead of using the Passwordless login or a username and password. 

Note: If you are using custom domain you will not be able to add both URLs in step 6. You will have to choose between the DeskDirector url and your custom domain, so the redirect url might look like this: https://custom.url.com/api/v2/auth/portal/microsoft/oauth2/sessions/redirect

This is due to restrictions set from Microsoft. 


Here is how to set it up:


1. In your admin console, go to the OAuth Tab and click the link in the explanation paragraph1a.png


2. This will take you to the sign in page for the Application Registration Portal, once here, enter your Microsoft credentials and login



3. Once authenticated, you will be taken to the My Applications page. Here, click "Add an app"3.png


4. Enter a name for your application and hit create. There is no need for the guided setup. 4.png


5. Once in tha main application page, under 'Platforms' click 'Add Platform'. In the 'Add Platform' menu, select 'Web'.6.png


6. Once you add the Web Platform, add the Redirect URL from the DeskDirector Admin Console into the app's redirect URL. Leave the 'Allow Implicit Flow' option selected.7.png


7. Under the 'Applications Secrets' menu, click 'Generate New Password' and copy the password that appears on the screen. Note that after you press 'OK' it will no longer be displayed. 8.png


8. Back in the admin console, add the password you got in the previous step to the 'Application Secrets' field, and the Application ID to the 'Application ID' field. Then click 'Save Application'9.png

9. Now the Login screen in DDPortal will have the added OAuth 'Sign in with Microsoft' option