Configuring Unifier to Connect with Microsoft Exchange Online

You can connect with Microsoft Exchange Online by using the API to access emails from inbound email accounts. To use the API, you will need to configure Unifier to request tokens using OAuth authentication.

Prerequisites

Ensure the following:

The application is registered in Azure Active Directory. To configure Unifier, you will need the Tenant Id, Client Id, and Client Secret values that are generated for the registered application.
IMAP.AccessAsApp, Mail.Read, and Mail.ReadWrite application permissions have to be granted. You can find these permissions under the Office 365 Exchange Online API in the APIs my organization uses tab.
Service Principals are registered for those Microsoft Exchange email accounts that will connect to Unifier. Instructions for registering Service Principal are available at: https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth#register-service-principals-in-exchange

Configuration Procedure

To connect with Microsoft Exchange Online via token authentication:

Stop Unifier in WebLogic. For detailed instructions, see Stopping Unifier in WebLogic on Linux.
Run the Unifier Configurator as follows:
1. In the Unifier Home folder, open the WebLogic directory .
2. Run configure.sh.
In the Configurator, select the tabs and modify the settings listed below:
1. In the Email tab, modify the following fields
  1. In the Inbound Email Server field, enter outlook.office365.com.
    Note: Change the server URL if Microsoft updates it.
  2. In the Inbound Email Protocol field, select IMAP or IMAPS.
  3. In the Inbound Email Password field, enter the Client Secret value generated for your registered application.
  4. Click Save.
2. In the Advanced tab select the Include Custom Properties option and click Save.
  If you already have a custom.properties file, proceed to the next step.
Modify the custom.properties file as follows:
1. Add the following properties and set values:
  - skire.action.email.auth = microsoftoauth
  - skire.action.email.msoauth.tenantid = <Tenant ID generated for your registered application>
  - skire.action.email.msoauth.clientid = <Client ID generated for your registered application>
2. Click Save.
Start Unifier in WebLogic. For detailed instructions, see Starting Unifier in WebLogic on Linux.

Related Topics