Configuration

This section covers all aspects of configuring the Microsoft Exchange 365 Mailer extension for TYPO3.

After completing the Azure Configuration, you need to configure the TYPO3 extension with the values obtained from Microsoft Entra ID.

Quick Configuration Overview

The extension requires the following key configuration variables:

Mail Transport: Set to use Exchange365Transport
Tenant ID: Your Microsoft Entra ID tenant identifier
Client ID: Your Azure application identifier
Client Secret: Your Azure application secret
From Email: The sender email address
Graph Sender User ID (optional): Mailbox used for the Microsoft Graph /users/{id}/sendMail call. Decouples the Graph mailbox from the visible From header for Send As / Send On Behalf scenarios.
Save to Sent Items: Whether to save emails to sent folder

For detailed step-by-step instructions, see:

Essential Configuration - For server-side email sending (recommended for production)
Site Set Configuration - For frontend email sending on TYPO3 v13 and v14
Frontend Configuration - The TypoScript constants, required on TYPO3 v12

Configuration Methods

You can configure this extension using:

Essential Configuration (Recommended)

Environment variables (.env file)
TYPO3 config/system/settings.php
TYPO3 Admin Panel (if available)

Site Set (TYPO3 v13 and v14, for Forms)

Activated per site, edited in Site Management > Sites
The modern replacement for the static TypoScript template

Frontend Configuration (TYPO3 v12, for Forms)

TypoScript configuration via the static template
Required for Powermail, Form Framework, and other frontend forms

Choose the method that best fits your deployment workflow and security requirements.

Configuration Precedence

The two sources are merged per setting, not all-or-nothing:

The global mail settings ($GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_exchange365_*']) are the baseline and apply in every context — frontend, backend, command line and scheduler.
In the frontend, any non-empty value from the site set or from TypoScript overrides the corresponding mail setting. Values left empty fall through to the baseline.

This lets you keep the credentials in environment variables while still adjusting, for example, fromEmail per site in the backend.

Attention

Security Recommendation: Use backend configuration with environment variables for production environments to avoid exposing sensitive Azure credentials in TypoScript or in config/sites/<identifier>/settings.yaml.