Enabling OAuth Authentication for IMAP/POP3/SMTP

Breaking change in v7.14/v8.6 and higher versions for IMAP/POP3

Microsoft is deprecating basic authentication in Exchange Online servers from October 1, 2022 (reference article Deprecation of Basic authentication in Exchange Online). This deprecation will cause a breaking change in flows / processes using IMAP or POP3 steps to interact with emails on Exchange Online Servers (On-Premises servers require no changes). Generally, processes that scrape, search or fetch emails from inboxes will be affected. You may be affected if you have a process with this structure or you are using these steps and interacting with an Exchange Online server.

To check if any Flow is using any POP3 or IMAP steps.
Navigate to Settings > Administration > System Tools > Flow Management > Flow Structure. Search for IMAP/POP3 in the search bar. Check for any of the below steps is visible.

If you return any of the above steps, and it is related to an active process, AND you are connecting to an Exchange Online Server, then there is a strong chance the authentication will fail, and the process will break.
You might need to reconfigure all the affected IMAP/POP3 steps to use OAuth. It will not be automatic. It will be on a per-step basis.

Refer to the following table to map the inputs of the step.

Refer to IMAP/POP3 step library articles to map all the steps.

For additional Reference, refer to the official Microsoft documentation,

• Authenticate an IMAP, POP or SMTP connection using OAuth

• POP, IMAP, and SMTP settings

Enabling OAuth Authentication for Email Accounts (SMTP configuration)

Due to Microsoft's depreciation of basic authentication for Office 365 accounts, in 8.6+, users with Office 365 accounts will need additional configuration to ensure the accounts will work with email steps.

Prerequisites:

• OAuth provider

• OAuth Token

Configuration

1. Navigate to C:\Program Files\Decisions\Decisions Server and open the Settings.xml file.

2. Locate <Mail> and add the below code. Ensure to update the necessary elements with the appropriate information

   <SmtpServer>
   	<ServerAddress>smtp.office365.com</ServerAddress>
   	<ClientDomain />
   	<Port>587</Port>
   	<RequiresAuthentication>true</RequiresAuthentication>
   	<UseOauth>true</UseOauth>
   	<OauthTokenId>YOURTOKENHERE</OauthTokenId>
   	<Username>MICROSOFTACCOUNTUSEDFORTOKENHERE</Username>
   	<Password />
   	<UseSSL>true</UseSSL>
   	<UseImplicitSSL />
   	<SkipCertificateRevocationCheck>false</SkipCertificateRevocationCheck>
   </SmtpServer>

   

3. Click Save to save the file.