To begin, you will need to login to your Microsoft Entra admin center and navigate to App registrations. Make sure you have selected Identity from the menu, then select App registrations under Applications.
We now need to register a new application for your OAuth2 integration. To do this, first select New registration at the top of the page.
To register an application, you need to fill out the following details:
Name: This is an identifying name for the app, so you know where it is used.
Supported account types: This requires a Multitenant account, i.e. ‘Accounts in any organizational directory (Any Azure AD directory – Multitenant)’
Redirect URI: This is where you specify the URI the application will redirect the user after login. For this, you will need to use one of the following addresses based on your Deskpro version: Deskpro Horizon:
https://<helpdesk_url>/admin-api/office365/tokenDeskpro v5:https://<helpdesk_url>/admin/office365/tokenFor both, you will need to change<helpdesk_url>with the URL for your helpdesk.
The Redirect URI must be secure (i.e. uses https://), it must direct back to your helpdesk and the <helpdesk_url> must match the Helpdesk URL set in Admin > Configuration > Branding.
If you are using a private On-Premise instance, this will work as long as your browser can reach the helpdesk through this URL and trusts the certificate on the helpdesk.
Office365 does not require access to your helpdesk directly, as it will send any information Deskpro needs to authenticate through your browser.
Once you have filled out the form correctly, click the ‘Register’ button at the bottom of the page
This should now create an app which will be available within the App registrations page.
If you click on the Display name for the application, you should see a brief overview of the application. From this list, you will need to make a note of the Application (client) ID. You should also confirm that the Redirect URIs specifies that there is at least 1 web redirect in place. 
You now need to create a client secret in order to connect to the app. Within the App settings, select Certificates & secrets from the menu, then select New client secret within that page.
This requires an identifying description and an expiry date set. These can be whatever you want, but we recommend setting the secret to the longest available length. Click the ‘Add’ button to create the secret. 
This will create a new Client Secret associated with this application. We need the Value from this secret, not the Secret ID.
This client secret will not be available if you leave this page or close the window, so we highly recommend making a note of secret by clicking the Copy icon for the Value.
It may also take a few minutes for the client secret to activate, so if you are experiencing a invalid_client error, please wait a few moments and try again.
You should now have the Client ID and Secret required to configure your OAuth2 integration within Deskpro. 
Please log in or register to submit a comment.