Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Tenant (Realm / Directory Id)

  • Client Id (Application Id)

  • Client secrets

  • Username(username can be any email address that you want the system to listen to new incoming emails).

Step-by-step guide to configure Azure account

Register Application
  1. Login to your organizations Azure account.

  2. Select Azure Active Directory in the left-hand navigation, then select App registrations under Manage.

  3. Select New registration. On the Register an application page, set the values as follows.

    • Set Name to a friendly name for your app.

    • Set Supported account types to the choice that makes sense for your scenario.

    • For Redirect URI, set the value that is shown in the MXTS Communication Channel page.

      • Redirect URI - https://<concern-code>.maxxton.net/customercare/en-us/azure-oauth-callback.html

  4. Choose Register. On the next page, copy the values of the Application (client) ID and Directory (tenant) ID and save them, you will need them later.

...

Copy the values of the Application (client) ID and Directory (tenant) ID and save them,

...

API Permission

Once the app is registered, then provide the API permissions that are required: -

...

...

Generate client secrets

Once the API permissions are added to the registered application, it's time to generate the client secrets.

...

Once Register Application, API Permission and Generate client secrets all three of this steps are completed you can start setting up outlook account in the communication channel.

...

Setup communication channel (Video)

Below is the step-by-step video guide to setup Email (Outlook / Azure) communication channel type.

...

The system will take two minutes to begin polling the emails from the mail client server if the communication channel is set to "Enabled" and "Authenticated.”

Some of the common errors that you can get during communication channel registration

Error Code

Error Description

Solution

Authorization code should not be empty or null for generating the access token

Try to re-authenticate the communication channel by updating the auth-info (you can find this by clicking the (blue star) (three dot button) → update auth info. )

MS-AADSTS53003

AADSTS53003: Access has been blocked by Conditional Access policies. The access policy does not allow token issuance.

Check the Conditional Access policy of your organization (https://portal.azure.com/#view/Microsoft_AAD_ConditionalAccess/ConditionalAccessBlade/~/Policies), it might be that your organization have put some restriction on MS applications like location or device or sign in restrictions, due to which our service (outside of your organization) not able to connect/authenticate.

Useful links

References

https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth

...