Configure SMTP using Azure AD (Office 365)
Learn the steps to configure SMTP using Azure AD (Office 365), enabling communication between applications and users.
Table of Contents
Create an application registration, the following details are required:
Client ID – available on the Azure portal once you have registered your app
Client Secret – available on the Azure portal once you have registered your app
Tenant ID – available on the Azure portal once you have registered your app
- Sign into the Azure portal using an account with administrator permission.
- You must use an account in the same Microsoft 365 subscription (tenant) as you intend to register the app with.
- You can also access the Azure portal through the Microsoft 365 Admin centre by expanding the Admin centres item in the left navigation panel and selecting Azure Active Directory.
- In the Azure portal, select Azure Active Directory in the left pane and select App registrations and click on ‘New registration’.

Register the Application
- In the Register an application page, enter your application's registration information:
- In the Name section, enter a meaningful application name that will be displayed to the users.
- Select Accounts in any organizational directory option from Supported account types section.
- Set the Redirect URI.
- Enter the container URL followed by ‘callback_et/azure’. (For example if the URL is ‘https://unitrade400-xxxxxxxx.mendixcloud.com/’ you will enter ‘https://unitrade400-xxxxxxxx.mendixcloud.com/callback_et/azure’ as the URI
- Click on Register to create the application.

Creating a Client Secret
On the app Overview page, hover over Application (client) ID value, and select the Copy to clipboard icon to copy the value as you'll need to specify this in Merchanter/UT400

Scroll down and , hover over Directory (tenant) ID value, and select the Copy to clipboard icon to copy the value as you'll need to specify this in Merchanter/UT400.

Click on ‘Add a certificate or secret’ to create a new client secret.

Click on ‘+ New client secret’.



Setting to allow public client
Hover over Value and select the Copy to clipboard icon to copy the value as you'll need to specify this in Merchanter/UT400.
Select Manifest tab, in the manifest editor, set the allowPublicClient* property to true and click on Save.

Azure AD (AAD) Graph app manifests change
The “allowPulbicClient” property is part of the Azure AD (AAD) Graph app manifest and will be moved to Microsoft Graph app manifest in the future. The Microsoft Graph app manifest property equivalent is “isFallbackPublicClient”
Setting API Permissions
Select API permissions tab, click on Add a permission.

On the Azure portal, ensure that you have the following permissions enabled under API permissions tab on the sidebar:

Setting email configuration in Merchanter/UT400
- In Merchanter/UT400 go to Settings > Document Management Settings > Email Configuration
- Put a Tick next to Microsoft Azure AD
- enter the Client ID
- Client Secret
- Tenant ID
- click Save.
- Restart the environment.
- Go back to Email Configuration and click on Save and Re- Authorize
Following the online instructions to authorize the email with Office 365.
Testing email setup
Once done make sure to test the email using the Test Button.