Microsoft hat die Unterstützung für einfache Passwort-Authentifizierung (Basic Auth) abgeschafft. Stattdessen wird OAuth2 verwendet. Diese Anleitung zeigt dir, wie du eine Microsoft-Adresse (Office 365 / Microsoft 365) für den E-Mail-Versand in DigitalMembers einrichtest.
Schritt 1: Authentifiziertes SMTP aktivieren
- Melde dich im Microsoft Admin Center an
- Gehe zu Aktive Benutzer
- Wähle den gewünschten Postfach-Account aus
- Klicke auf E-Mail → E-Mail-Apps verwalten
- Aktiviere Authentifiziertes SMTP und speichere
Schritt 2: App-Registrierung in Azure erstellen
- Melde dich im Azure-Portal an
- Gehe zu Azure Active Directory → App-Registrierungen
- Klicke auf Neue Registrierung
- Fülle die Felder aus:
- Name: z.B. «DigitalMembers»
- Kontotypen: Nur Konten in diesem Organisationsverzeichnis
- Klicke auf Registrieren
Notiere dir nach der Registrierung die Application (Client) ID und die Directory (Tenant) ID aus der Übersicht der App – du brauchst sie später.
Schritt 3: Client Secret erstellen
- Öffne deine App unter App-Registrierungen
- Gehe zu Zertifikate & Geheimnisse
- Klicke auf Neues Geheimnis
- Gib eine Beschreibung ein und wähle eine Gültigkeitsdauer (z.B. 24 Monate)
- Klicke auf Hinzufügen
- Kopiere den angezeigten Wert sofort – er wird danach nicht mehr angezeigt
Merke dir, wann das Secret abläuft. Du musst es vor Ablauf erneuern, sonst stoppt der E-Mail-Versand.
Schritt 4: API-Berechtigungen hinzufügen
- Gehe in der App zu API-Berechtigungen → Berechtigung hinzufügen
- Wähle APIs, die meine Organisation verwendet
- Suche nach Office 365 Exchange Online
- Wähle Anwendungsberechtigungen
- Aktiviere SMTP.SendAsApp
- Klicke auf Berechtigungen hinzufügen
- Klicke anschliessend auf Admin-Zustimmung erteilen und bestätige
Schritt 5: Service Principal registrieren (Exchange)
Damit Exchange dem App-Zugriff vertraut, musst du einen Service Principal einrichten. Führe folgenden PowerShell-Befehl aus (Exchange Online PowerShell-Modul erforderlich):
New-ServicePrincipal -AppId <APPLICATION_ID> -ObjectId <OBJECT_ID>
Weitere Details: Microsoft Dokumentation
Schritt 6: Absenderkonto in DigitalMembers anlegen
- Öffne Einstellungen → E-Mail und gehe zum Schritt Postfächer.
- Klicke bei Absenderkonten anderer Anbieter auf Absenderkonto hinzufügen.
- Trage bei E-Mail-Adresse deine Microsoft-Adresse ein und bei Host
smtp.office365.com. - Öffne Erweitert und wähle bei Authentifizierung den Eintrag OAuth2. Port 587 und STARTTLS sind schon vorgegeben.
- Fülle die Felder aus, die jetzt erscheinen:
- Benutzername: deine Microsoft-Adresse, sie ist vorausgefüllt
- Client-ID: Application (Client) ID aus Schritt 2
- Client Secret: der Wert aus Schritt 3
- Authority URL:
https://login.microsoftonline.com/<tenant-id>mit der Directory (Tenant) ID aus Schritt 2 - Scopes:
https://outlook.office365.com/.default
- Klicke auf Speichern und prüfe das Konto mit Test-Nachricht senden.
- Wähle das Konto im Schritt Absender als Standard-Absender oder für Finanzen oder Administration.
Erneuerst du das Client Secret vor Ablauf, trage im Absenderkonto den neuen Wert bei Client Secret ein und speichere.
Häufige Fehler
535 5.7.3 Authentication unsuccessful
Benutzername stimmt nicht mit der Microsoft-E-Mail überein, falsche Client-ID oder Secret, oder Admin-Zustimmung fehlt.
InvalidGrant / AADSTS70000
Token ist abgelaufen oder der Benutzer hat keinen SMTP-Zugriff.
Unable to get authority configuration
Die Authority URL stimmt nicht mit dem Azure-Endpunkt überein. Prüfe, ob die Tenant-ID korrekt ist.
535 5.7.139 / Network unreachable
Service Principal ist nicht registriert, API-Berechtigungen fehlen oder SmtpClientAuthentication ist in Exchange deaktiviert.
Änderungen in Azure können bis zu 5 Minuten dauern, bis sie wirksam sind.