Zum Hauptinhalt springen

SMTP mit OAuth über Microsoft Exchange Online konfigurieren

Microsoft Exchange Online hat die Standardauthentifizierung für SMTP im März 2026 eingestellt; OAuth ist der Standard. iGrafx Process360 LiveProcess360 Live Die Cloud-Plattform von iGrafx für durchgängiges Prozessmanagement – sie vereint Prozessdesign, Mining, Simulation und Automatisierung in einer einzigen Umgebung. unterstützt weiterhin die SMTP-Standardauthentifizierung und außerdem SMTP mit OAuth – allerdings nur über Microsoft Exchange Online.

Hinweis

Der E-Mail-Versand per SMTP mit OAuth wird nur über Microsoft Exchange Online unterstützt. Andere Anbieter werden nicht unterstützt.

Voraussetzungen​

  • Berechtigungen in Microsoft Entra ID (früher Azure AD), um eine App-Registrierung und ein Dienstkonto zu erstellen.
  • Einen Microsoft-Entra-Mandantenadministrator, der die API-Berechtigungen genehmigt.
  • Exchange Online PowerShell (die Installationsbefehle stehen in diesem Artikel).

Unterstützte Versionen​

  • Process360 LiveProcess360 Live Die Cloud-Plattform von iGrafx für durchgängiges Prozessmanagement – sie vereint Prozessdesign, Mining, Simulation und Automatisierung in einer einzigen Umgebung. 19.20 und höher.

Konfiguration​

Eine App-Registrierung erstellen​

  1. Melden Sie sich im Azure-Portal an, suchen Sie nach App registrations und öffnen Sie den Dienst.
  2. Klicken Sie auf + New registration.
  3. Wählen Sie unter Supported account types die Option, die zu Ihrer Organisation passt, und klicken Sie dann auf Register.
  4. Öffnen Sie die neue App-Registrierung. Kopieren Sie unter Overview die Application (client) ID und die Directory (tenant) ID und bewahren Sie sie sicher auf.

Einen geheimen Clientschlüssel erstellen​

  1. Gehen Sie in der App-Registrierung zu Manage → Certificates & secrets → Client secrets.
  2. Klicken Sie auf + New client secret, geben Sie eine Beschreibung ein und wählen Sie eine Ablaufzeit, die Ihrer Sicherheitsrichtlinie entspricht.
  3. Klicken Sie auf Add.
  4. ⚠️ Kopieren Sie den Wert des geheimen Schlüssels sofort und bewahren Sie ihn sicher auf – den Wert, nicht die ID des geheimen Schlüssels.

API-Berechtigungen gewähren​

  1. Gehen Sie in der App-Registrierung zu Manage → API permissions und klicken Sie auf + Add a permission.
  2. Wählen Sie APIs my organization uses, suchen Sie nach Office 365 Exchange Online und wählen Sie es aus.
  3. Wählen Sie Application permissions, klappen Sie SMTP auf und wählen Sie SMTP.SendAsApp.
  4. Klicken Sie auf Add permissions.
  5. Ein Mandantenadministrator muss die Berechtigungen genehmigen: Wählen Sie unter API permissions der App-Registrierung die neue Berechtigung aus und klicken Sie dann auf Grant admin consent for {organization}.

Ein Dienstkonto hinzufügen​

  1. Ermitteln Sie die Object ID der App-Registrierung (nicht identisch mit der Application (client) ID): Öffnen Sie im Azure-Portal Enterprise applications → All applications, suchen Sie Ihre App-Registrierung, öffnen Sie sie und kopieren Sie die Object ID von der Seite „Overview“.

  2. Installieren Sie auf einem Windows-Rechner Exchange Online PowerShell und stellen Sie eine Verbindung her (ersetzen Sie <TENANT_ID> durch die Directory (tenant) ID):

    Install-Module -Name ExchangeOnlineManagement
    Import-Module ExchangeOnlineManagement
    Connect-ExchangeOnline -Organization <TENANT_ID>
  3. Erstellen Sie das Dienstkonto (ersetzen Sie die Platzhalter durch die Application (client) ID und die Object ID):

    New-ServicePrincipal -AppId <APPLICATION_CLIENT_ID> -ObjectId <OBJECT_ID> [-Organization <TENANT_ID>]
  4. Rufen Sie die Details des neuen Dienstkontos ab und kopieren Sie seine ObjectId (⚠️ nicht identisch mit der vorherigen Object ID – diese gehört zum Dienstprinzipal):

    Get-ServicePrincipal | fl
  5. Geben Sie dem Dienstkonto Zugriff auf ein Postfach (<SERVICE_PRINCIPAL_ID> ist die ObjectId aus dem vorherigen Befehl):

    Add-MailboxPermission -Identity "mailboxAddress@example.com" -User <SERVICE_PRINCIPAL_ID> -AccessRights FullAccess

Process360 Live konfigurieren​

  1. Öffnen Sie Verwaltung → E-Mail-Verwaltung → E-Mail-Einstellungen.
  2. Unter Einstellungen für ausgehende E-Mails:
    • Angezeigter Name des Absenders – muss genau mit dem Anzeigenamen des Dienstkontos übereinstimmen (wenn keiner festgelegt wurde, ist es wahrscheinlich die E-Mail-Adresse).
    • E-Mail-Adresse des Absenders – die E-Mail-Adresse des Dienstkontos.
    • Präfix des E-Mail-Betreffs – Ihr eigener Wert.
    • Fehlermeldung per E-Mail senden an – optionale Adresse für Benachrichtigungen über Sendefehler.
  3. Wählen Sie unter Serverdetails die Option SMTP.
  4. Wählen Sie unter Authentifizierung die Option Microsoft Exchange Online.
  5. Geben Sie die Client-ID, den geheimen Clientschlüssel und die Mandanten-ID aus den vorherigen Schritten ein.

Überprüfen​

Geben Sie eine E-Mail-Zieladresse testen ein und klicken Sie auf Test-E-Mail senden. Unten erscheint eine grüne Erfolgsmeldung; bei einem Fehler erscheint eine rote Fehlermeldung. Sobald die Test-E-Mail eingetroffen ist, klicken Sie auf E-Mail-Einstellungen speichern.

Fehlerbehebung​

  • Keine E-Mail erhalten – vergewissern Sie sich, dass die Erfolgsmeldung erschienen ist, und prüfen Sie Ihren Junk- bzw. Spam-Ordner. Möglicherweise filtert Ihre IT-Abteilung die Nachrichten.
  • Authentication unsuccessful – prüfen Sie alle Anmeldedaten erneut, einschließlich Angezeigter Name des Absenders und E-Mail-Adresse des Absenders. Wenn für den Absender kein Anzeigename festgelegt wurde, versuchen Sie es mit der E-Mail-Adresse des Absenders als Angezeigter Name des Absenders.
  • Folgen Sie in allen anderen Fällen der Microsoft-Anleitung zum Einrichten einer App-Registrierung und eines Dienstkontos. ⚠️ Verwenden Sie den Client Credential Grant Flow – andere Flows funktionieren mit Process360 LiveProcess360 Live Die Cloud-Plattform von iGrafx für durchgängiges Prozessmanagement – sie vereint Prozessdesign, Mining, Simulation und Automatisierung in einer einzigen Umgebung. nicht.