README

This is a TYPO3 extension that makes it possible to send emails in TYPO3 via Microsoft 365 using oAuth authentication (using the Microsoft Graph SDK).

Prerequisites

You need to configure a user in Microsoft 365 which is allowed to send out mails:

* Microsoft Graph
  * Mail.Send - Application - Send mail as any user
  * User.ReadBasicAll - Application - Read all users basic profiles

Note: The administrator must review the permissions on a case-by-case basis. The permissions suggested here should enable email sending, but may be too extensive for your specific use case.

You will need the following data:

User ID (email address)
Client ID
Client Secret
Tenant ID

Installation

This extension must be installed via composer because it installs some dependencies (microsoft/microsoft-graph and guzzlehttp/guzzle).

composer req innocoding/ms365-oauthmailer

Configuration

Put this in your additional.php:

'MAIL' => [
	'transport' => 'InnoCoding\Ms365oAuthMailer\Mail\Ms365Transport',
	'transport_user_id' => 'myuser@example.com',
	'transport_client_id' => 'the-client-id',
	'transport_client_secret' => 'the-client-secret',
	'transport_tenant_id' => 'the-tenant-id',
],

Notes

Only an HTML body is set in the mail. If the HTML body of the TYPO3 mail object is empty, the text body is used.
Sender name and email address cannot be overwritten, this is taken from the Microsoft 365 user.
Multiple receivers ("to") are supported
CC, BCC and Reply-To is supported
Attachments are supported

Issues

If you find bugs or have feature requests, please refer to

https://gitlab.com/innocoding/typo3/public/ms365-oauthmailer/-/issues

Support

If you need support, please write an email to typo3@innocoding.com

Changelog

You can find the changelog at

https://gitlab.com/innocoding/typo3/public/ms365-oauthmailer/-/blob/main/CHANGELOG.md

innocoding / ms365-oauthmailer

Maintainers

Details