Adding an Email Account

Incoming Mail

OAuth Connection

The Incoming Mail section of the email account configuration displays an additional selection at the top once an OAuth Connection was added. It allows to select the configured OAuth Connection provider to be used instead of custom settings.

Figure 1: OAuth Provider with configured Office 365 connection

Below the selection is a button to authenticate an account against the selected OAuth connection. This authentication is required to have the INETAPP server use the connection for incoming emails.

Note: With OAuth, authentication is done by a security token instead of a password. This token is created by clicking "Set up OAuth connection". It is important that you set up the OAuth connection with the user who has permission to access the desired mailbox. In case you are already logged in to the mail provider with your own account in the browser, it is recommended to perform the settings in Incognito mode of the browser or to log out from the mail provider (not INETAPP) beforehand. In the field Username you identify the specific mailbox via e-mail address, which is to be read in.

"App-Only" Provider

The button "Set Up OAuth Connection" is not available when the "App-Only" provider is selected, e.g., for the Office 365 connection. The advantage of using the App-Only provider is that you do not have to authenticate against the OAuth service in an additional step because your OAuth connection is already pre-authenticated using a separate mechanism. For details, see the specific provider configuration.

Using the App-Only provider may result in improved connection stability when reading emails from the service.