Difference between revisions of "How to configure OAuth2 Authentication for Microsoft Office 365 Mailbox integration"
Line 11: | Line 11: | ||
=Hornbill Keysafe= | =Hornbill Keysafe= | ||
− | As instructed by the [[Hornbill_KeySafe|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. | + | As instructed by the [[Hornbill_KeySafe|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 authentication/credentials of the account that will be used as the point of integration with Hornbill. |
The following can be the series of steps. | The following can be the series of steps. | ||
− | # [[#page1|Page | + | # [[#page1|Page requesting for email address of account to use]] |
+ | # [[#page2|Page requesting the credentials for the account. This may include other multi-factor authentication mechanism.]] | ||
− | {| | + | {| border="1" |
|- | |- | ||
| id="page1" | Microsoft requests email address to be used | | id="page1" | Microsoft requests email address to be used | ||
| [[File:OAuth2_MS_page1.png|300px]] | | [[File:OAuth2_MS_page1.png|300px]] | ||
|- | |- | ||
− | | Microsoft requests authentication | + | | id="page2" | Microsoft requests authentication |
| [[File:OAuth2_MS_page2.png|300px]] | | [[File:OAuth2_MS_page2.png|300px]] | ||
* Can include other multi-factor authentication mechanisms | * Can include other multi-factor authentication mechanisms | ||
|- | |- | ||
− | | Microsoft asks user for permission to delegate the access rights that Hornbill requires | + | | id="page3" | Microsoft asks user for permission to delegate the access rights that Hornbill requires |
| | | | ||
[[File:OAuth2_MS_page3_app_access.png|300px]] | [[File:OAuth2_MS_page3_app_access.png|300px]] |
Revision as of 14:53, 30 April 2021
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:
- Create and link a Hornbill Keysafe
- 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 authentication/credentials of the account that will be used as the point of integration with Hornbill.
The following can be the series of steps.
- Page requesting for email address of account to use
- Page requesting the credentials for the account. This may include other multi-factor authentication mechanism.