Office365 Module

The office365_api module makes use of the O365 package.

Azure App Registration

Note: The author is not an expert on implementing Azure applications, or Azure anything for that matter. It behooves the reader to consider these configurations insecure. This is an of a "long enough to make it work" configuration.

An Azure App has to be registered for the sending domain in order for Postage to send emails on its behalf. This guidance has been largely adapted from the O365 package page and should assist with the registration process.

1. As an administrative user, using your domain credentials at Microsoft's Admin Portal.
2. Visit this URL to access RegisteredApps
3. Click New registration
4. In the Register an application form, apply the following configurations
   • Name - Enter Postage
   • Supported account types - Select Accounts in any organizational directory(Any Azure AD directory - Multitenant)
   • Redirect URI (optional) - Select Web from the drop down and enter this URI: https://login.microsoftonline.com/common/oauth2/nativeclient
5. Submit the form and take note of the Application (client) ID value for future reference
6. Click Certificates & secrets from the left-hand menu
7. Click the plus (+) symbol beside "New client secret"
8. In the pop-up window, supply Postage as the name and select a proper lifetime for the token. One year should suffice without issue.
9. Copy the value of the new secret. Note: This step is critical as the value will not be visually displayed a second time and is required for authentication.
10. Click API Permissions in the left-hand menu.

Authentication

Authentication is a bit funky.