Mail Services

All users of an organization can access the connections to IMAP or Exchange servers to archive emails from their mailboxes in DocuWare.

Assign in Connect to Mail a mail service to your mail account to establish the connection to the mail provider.

With September 24, DocuWare has switched the authentication for third-party applications from cookie authentication to the modern and secure oAuth2 authentication. Support for Basic Authentication in DocuWare will continue unchanged and can still be utilized if your mail service supports it.

However, for Gmail (Workspace) customers, Basic Authentication is becoming obsolete. The discontinuation of sign-ins via Basic Authentication or app passwords announced by Google by the end of September 2024. oAuth2 is set to replace Basic Authentication as the more secure alternative.

For details see below.

Receiving

Create connections to IMAP or Exchange servers to import and store emails from your mail accounts into DocuWare.

Assign a mail service to your email account to connect to the mail provider. All users of your organization can access the mail connections created here.

Note for connecting Exchange mail services

DocuWare conncets to your Exchange mailbox via an Exchange impersonator account and the use of "Exchange Web Services". This impersonator account has been authenticated by the basic authentication method in earlier Docuware versions. Starting second half of 2021 this authentication method will be deprecated for Office 365 and Exchange Online accounts. That is why DocuWare relies on “oAuth2” as an authentication method.

  • Cloud customers: DocuWare Cloud delivers already everything for connecting to your Office 365 mail account with oAuth2. Go to your General Email plugin and connect directly with your Office 365 account.
    On the other hand a registration of the oAuth app is required for Office 365 / Exchange Online mail accounts that are hosted on Azure National Cloud, In this case the registration is the same as for on-premises customers - see below.

  • On-premises customers: Follow the instructions on Microsofts Office Dev Center for properly setting up an OAuth app registration in your companies Azure Active Directory.

More information on setting up an oAuth2 connection can be found at the DocuWare Support.

Note for connecting IMAP mail services

To enable IMAP Mail service connections using OAuth2 authentication for Gmail (Workspace) or other oAuth-supporting IMAP servers, certain configuration updates are necessary.

If you aim to use oAuth2 for accessing their Gmail, Outlook.com, or other IMAP services establish an oAuth client app within their corresponding platform accounts, such as Google Cloud Console or Azure AD/Entra, you can find some useful information on the subjects below.

Sending

DocuWare offers the option of sending email to users directly from the system. For example, a customer can receive an invoice by email as part of a workflow. Or an employee can be notified when a relevant document has been archived.

Enter a connection to your own SMTP server to send emails from a personalized address - for example, "workflow@peters-engineering.com" - and not from the DocuWare system address.

You can use one SMTP connection for notifications and one for workflows. Activate the connection for the respective component.

Basic Authentication (via username & password) is deprecated for Office 365 and Gmail (Workspace) SMTPs. The successor of the basic authentication method is oAuth2. This authentication method requires you to create your own SMTP Mail service connections with the OAuth2 authentication to your Office365 or Gmail (Workspace) SMTPs.

Note for administrators:  

A mail service configuration which is not working properly and fails to deliver emails to DocuWare users, will trigger automatic email notifications to the DocuWare administrator of the respective organization. it provides information related to the issue and suggestions on how to solve the problem.

Email notifications will be sent for up to three weeks, during which administrators are advised to resolve the issues. After that period, notifications will discontinue. The related email logs will be deleted and cannot be restored.