Admin – Mail & Azure OAuth2

Version 3.4.00 (Changelog bis 3.4.08)Status StableStand 2026-10-02

Auf dieser Seite

English (summary)
Deutsch
Tabs und Aktionen
Transport
Azure OAuth2 (SMTP mit Microsoft 365)
Microsoft Graph
Mail-Log
Mail-Queue
Für Entwickler
Verwandte Dokumente

English (summary)

Outgoing mail is configured at /admin/mail-settings (CMS/admin/mail-settings.php → CMS/admin/modules/system/MailSettingsModule.php → CMS/admin/views/system/mail-settings.php). Transport is PHP mail() or SMTP (Symfony Mailer under CMS/assets/mailer/), optionally with Microsoft 365 Azure OAuth2 / XOAUTH2 (AzureMailTokenProvider). A separate Microsoft Graph app registration (GraphApiService) provides tokens for Graph-based features and plugins. Mail can be queued (cms_mail_queue, MailQueueService) and is processed by cron.php. All settings live in the mail settings group; secrets are stored AES-256 encrypted (SettingsService, prefix enc:).

Deutsch

Tabs und Aktionen

Tab	Aktionen
`transport`	`save_transport`, `send_test_email`
`azure`	`save_azure`, `clear_azure_cache`
`graph`	`save_graph`, `test_graph_connection`, `clear_graph_cache`
`logs`	`clear_logs`
`queue`	`save_queue`, `run_queue_now`, `release_queue_stale`, `enqueue_queue_test`

Transport

Feld	Werte
Treiber (`driver`)	`mail` (PHP-`mail()`) oder `smtp`
SMTP-Host / Port / Verschlüsselung	z. B. `smtp.office365.com`, 587, `tls` (auch `ssl` oder leer)
Authentifizierung (`auth_mode`)	`credentials` (Benutzername + Passwort) oder `oauth2` (Azure OAuth2 / XOAUTH2)
Benutzername / Passwort	Passwort verschlüsselt gespeichert; „Passwort löschen“ entfernt es
Absender (`from_email`, `from_name`)	Fallback `SMTP_FROM_EMAIL` / `SMTP_FROM_NAME` aus `config/app.php`

send_test_email verschickt eine Testmail an die angegebene Adresse und zeigt den verwendeten Transport an.

Ohne gespeicherte Einstellungen gilt: ist SMTP_HOST in config/app.php gesetzt, wird SMTP verwendet, sonst mail().

Azure OAuth2 (SMTP mit Microsoft 365)

Feld	Hinweis
Tenant-ID, Client-ID, Client-Secret	App-Registrierung in Entra ID; Secret verschlüsselt
Postfach (`azure_mailbox`)	Absenderpostfach für XOAUTH2
Scope (`azure_scope`)	Standard `https://outlook.office365.com/.default`
Token-Endpunkt	optional, Standard `login.microsoftonline.com/<tenant>/oauth2/v2.0/token`

Die App benötigt die Anwendungsberechtigung SMTP.SendAsApp, das Postfach muss für SMTP AUTH freigegeben und dem Dienstprinzipal zugeordnet sein. clear_azure_cache verwirft das zwischengespeicherte Token.

Microsoft Graph

Eigene App-Registrierung (Client-Credentials) für Graph-Zugriffe, z. B. durch M365-Plugins: Tenant-ID, Client-ID, Secret, Scope (Standard https://graph.microsoft.com/.default), Basis-URL, Token-Endpunkt. test_graph_connection holt ein Token und meldet Erfolg/Fehler; clear_graph_cache leert den Token-Cache. API-Test auch per POST /api/v1/admin/graph/test.

Mail-Log

cms_mail_log protokolliert jeden Versand (Empfänger, Betreff, Status, Fehler, Transport, Metadaten). clear_logs leert das Protokoll; einsehbar auch über GET /api/v1/admin/mail/logs.

Mail-Queue

Option	Standard	Bereich
`queue_enabled`	aus	–
`queue_batch_size`	10	1–100
`queue_max_attempts`	5	1–20
`queue_retry_delay_seconds`	300	60–86400
`queue_throttle_delay_seconds`	900	60–86400 (bei Drosselung durch den Provider)
`queue_lock_timeout_seconds`	900	60–86400
`queue_rate_limit_per_minute`	8	1–600

Verarbeitung: cron.php --task=mail-queue (CLI) oder Web-Cron mit Token. Die Seite zeigt die fertige CLI-Zeile und die Web-Cron-URL; als Token-Header wird X-CMS-Cron-Token empfohlen. regenerate_queue_cron_token erzeugt einen neuen Token.
run_queue_now verarbeitet fällige Jobs sofort, release_queue_stale gibt hängende Jobs (älter als Lock-Timeout) frei, enqueue_queue_test legt eine Test-Mail in die Queue.
Fehlgeschlagene Jobs werden mit Fehlerkategorie und empfohlener Wartezeit erneut eingeplant, bis queue_max_attempts erreicht ist.

Für Entwickler

$mail = \CMS\Services\MailService::getInstance();
$result = $mail->sendDetailed('kunde@example.com', 'Betreff', '<p>HTML-Inhalt</p>');
// $result['success'], $result['error'], $result['transport']

Header-Injection wird verhindert (gesperrte Headernamen, Längenbegrenzung Betreff 255 / Body 200 000 Zeichen).

English (summary)#

Deutsch#

Tabs und Aktionen#

Transport#

Azure OAuth2 (SMTP mit Microsoft 365)#

Microsoft Graph#

Mail-Log#

Mail-Queue#

Für Entwickler#

Verwandte Dokumente#

Bereit für ein CMS, das mitdenkt?