How to Configure Azure for OAUTH 2.0

In order for Netreo to make use of the OAUTH 2.0 options in its email configuration some setup is required in your Microsoft Azure account.

Azure Configuration

The instructions below make use of the following official Microsoft documentation: Quickstart: Register an application with the Microsoft identity platform

For your convenience, each step in the instructions below will include a link directly to the applicable section of those instructions.

1. Register an application in Azure using the instructions found here.
   1. When done registering your application, a summary page appears. Many of the values required to configure Netreo to work with this application can be found on this summary page. The summary page can later be found in Azure by clicking on the name of the application in the applications list while logged in to the Azure portal.
2. Configure the platform settings for your application using the instructions found here.
   1. For the application type, select "Web" under the Web Application section.
   2. While configuring the settings, use the following for the redirect URI: https://localhost/fw/index.php?r=email-art/authenticate-oauth2 (Replace "localhost" with the address of your Netreo deployment)
3. Add credentials to your application using the instructions found here.
   1. When done adding credentials, make note of the "Value" of your client secret (not its "Secret ID"). You will need this value when configuring Netreo to work with this application.
4. Add API permissions to your application using the instructions below.
   1. From your application's Manage menu on the left select API permissions.
   2. In the Configured permissions area select Add a permission.
      1. Select Microsoft Graph.
      2. Select Delegated Permissions.
         1. In the permissions list, locate and select the following permissions:
            • offline_access
            • IMAP.AccessAsUser.All
            • POP.AccessAsUser.All
            • SMTP.Send
            • User.Read
      3. Select Add permission.
   3. Once all permissions are added, select Grant admin consent for (your application) at the top of the permissions list to ensure all permissions are correctly granted.
5. You are finished configuring Azure for OAUTH 2.0 use in Netreo.