Symfony Mailer Office365
This module provides integration for sending emails through Office365 using OAuth authentication. It allows Drupal sites to continue sending emails via Office365 after basic authentication via SMTP is deprecated. The module handles OAuth token refreshing automatically via Drupal cron or a Drush command.
Symfony Mailer Office365 Integration
Why?
Office365 stops support for sending via SMTP with Basic Auth information (Username & Password).
A modern OAuth Flow is required. Since there is no feasable Drupal solution as of writing, this module provides a gap until there is an implementation provided by Symfony itself or a different solution.
How-To
1. Register your app with Microsoft Entra and provide Redirect URL: `https://example.com/office365/oauth/callback`
2. Configure with given credentials
`admin/config/system/mailer/office365`
3. Add "Office 365 - OAuth" Transport to your mailing policy
4. Login to save OAuth State with Drupal (Link available here: `admin/config/system/mailer/office365`)
Refreshing the token state
Using OAuth requires you to keep refreshing the access token with the given refresh token once it expired.
This module provides two ways to do that.
a) Drupal Cron
Refreshing (if necessary) happens when the Drupal Cron is run.
In that case make sure it gets run at least every 12 hours to be on the safe side.
See Token Lifetime: https://learn.microsoft.com/en-us/entra/identity-platform/refresh-tokens...
b) Drush Command
If you want to refresh the token (if necessary) in an own interval separate to the cron you can run the following drush command:
drush office365:refresh
Please choose an appropriate interval for this method as well.
Troubleshooting
You should check the status page `admin/config/system/mailer/office365` and check the system logs (watchdog f.e) for any error messages.
Credits
This was insipired by the following gists
- https://gist.github.com/dbu/3094d7569aebfc94788b164bd7e59acc
- https://gist.github.com/beerendlauwers/03acb112c80af0bf91546a05f790057a
Even though a lot has been rewritten, this inspired a lot how this concept was implemented. Thanks!
Please also see https://github.com/symfony/symfony/pull/52585 for development with symfony, which would make this module probably obsolete.