How to configure OAuth2 Authentication for Microsoft Office 365 Mailbox integration

Introduction

In order to enable Hornbill to use OAuth2 protocol to authenticate to Microsoft Office 365 for mailbox integration, a Hornbill Keysafe item is required that contains the OAuth2 authentication token. This is then used to configure any of Hornbill's integration components, namely the following

• Email's Outbound Mail Routing Smart Host Configuration, -or-
• Inbound Mail Service Components of the Shared Mailboxes.

The steps to configure this is the following:

1. Create and link a Hornbill Keysafe
2. Configure the Inbound Mail Service Component, either
   • The POP3 service -or-
   • The IMAP4 service

Hornbill Keysafe

As instructed by the Hornbill KeySafe page, create a keysafe whose type is Microsoft Office 365 Mail Connector. Once the keysafe is named and created, invoke the Connect button to initiate the authentication and generation of the OAuth2 authentication token. A new webpage should appear originating from Microsoft requesting the credentials of the account that will be used as the point of integration with Hornbill.