Equisys technical notes

Technical guidance, explanations and fixes for our products

FIX: Zetadocs Delivery fails to send after Basic authentication disabled in Exchange Online

Print

ZTN4577

This Zetadocs technical note applies to:

  • Zetadocs Extension for Business Central version 2.0 and later
  • Zetadocs for NAV version 9.0 and later
  • Exchange Online

Symptom


When trying to use Zetadocs Delivery to send a record you are given an error message "Zetadocs has encountered an error when making the webapi request. Please contact your administrator." or if you are using Zetadocs for NAV "Error sending the message. Please review the Zetadocs Delivery Outbox and the Zetadocs Delivery Settings.". 

To understand if this the resolution in this technote applies to you, install the ExchangePowerShell and ExchangeOnlineManagement PowerShell Modules. Run the following PowerShell script to check your authentication settings, where <YourMailboxIdentity> is the email address from your Zetadocs Delivery Settings e.g. accounts@contoso.com and logging in with an Exchange Adminstrator account when prompted.

Connect-ExchangeOnline 
Get-CASMailbox -Identity <YourMailboxIdentity> | Format-List SmtpClientAuthenticationDisabled

If the output is "SmtpClientAuthenticationDisabled : True" then your account has had SMTP Auth disabled and so you will need to follow the steps in the Resolution section in order to use Zetadocs Delivery.

If the output is "SmtpClientAuthenticationDisabled : False" this technote does not apply to you and you should contact your VAR/Equisys to help resolve your problem.

Cause

In October 2022 Microsoft deprecated Basic Authentication for Exchange Online. As part of this they disabled SMTP Authentication for all new tenants and all tenants that weren't using it. SMTP Auth can be re-enabled as it is still needed by many multi-function devices such as printers and scanners that can't be updated to use modern authentication.

In order to check if the cause is due to the authentication method not being correct, please follow the steps in the following technical note: HOWTO: Test SMTP on Exchange Online is working for use with Zetadocs

Resolution

Follow HOWTO: Use Zetadocs Delivery with Exchange Online and to get Zetadocs Delivery working again.

Status

A solution for this behaviour is detailed in the technote mentioned above.

Last updated: 9th August 2022 (MP/CR)

Keywords: Zetadocs Delivery, Email, Send, Basic Auth, SMTP

Equisys Logo, Document Management and Expense Management for Business Central
 

Replaced by script

Attending Community Summit 2022

The Zetadocs team is heading to Community Summit 2022 in Orlando, Florida. Discover more about the Summit event and why it is so important for the NAV community through this blog post. 

Read more