Messenger: E-Mail Konfiguration mit Microsoft Office 365

Microsoft Office 365 erfordert einige zusätzliche Schritte, um den E-mail Versand zu aktivieren.

Sie finden die Einrichtung auch auf der offiziellen Microsoft-Seite: https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth#use-client-credentials-grant-flow-to-authenticate-smtp-imap-and-pop-connections

1. Neue Anwendung registrieren

Registrieren Sie eine neue Anwendung: https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app

2. IMAP und SMTP Berechtigung zur Anwendung hinzufügen

1. Wählen Sie im Azure-Portal in der Verwaltungsansicht Ihrer Anwendung „API Permissions“ aus.
2. Wählen Sie „Add permission“.
3. Wählen Sie „APIs my organization uses“ und suchen Sie nach „Office 365 Exchange Online“.
4. Klicken Sie auf „Application permissions“.
5. Wählen Sie die Berechtigungen IMAP.AccessAsApp und SMTP.SendAsApp aus.
6. Erteilen Sie die Admin-Erlaubnis „Grant Admin Consent“.
7. Die API Permissions sollten in der Liste folgendermaßen aufscheinen:

3. Service Principals in Exchange registrieren

Der Service Principal der Anwendung muss in Exchange mit der Exchange Online PowerShell registriert werden. Dies wird mit dem New-ServicePrincipal Befehl durchgeführt.

Installieren Sie ExchangeOnlineManagement und verbinden Sie sich zu ihrem Tenant:

Install-Module -Name ExchangeOnlineManagement
Import-module ExchangeOnlineManagement 
Connect-ExchangeOnline -Organization <tenantId>

Wenn Sie bei diesem Befehl einen Fehler bekommen, überprüfen Sie Ihre Berechtigungen und Lizenzen.

Registrieren Sie den Service Principal der Anwendung:

New-ServicePrincipal -AppId <APPLICATION_ID> -ObjectId <OBJECT_ID>

Geben Sie dem Service Principal Zugriff auf die Mailbox:

Add-MailboxPermission -Identity "john.smith@contoso.com" -User 
<SERVICE_PRINCIPAL_ID> -AccessRights FullAccess

Die Anwendung kann jetzt mit dem OAuth 2.0 client credentials grant flow auf IMAP und SMTP zugreifen.

4. Erstellung und Übermittlung Zugangsdaten

Erstellen Sie ein Secret für die Anwendung:

Übermitteln Sie die folgenden Zugangsdaten der Anwendung an support@onboard.org:

• Application (client) ID
• Object ID
• Directory (tenant) ID
• Secret Value
• Mailbox (über diese Adresse werden die E-Mails verschickt)
• Scope (normalerweise https://outlook.office365.com/.default)
• IMAP Server (normalerweise outlook.office365.com)
• E-Mail Adresse für Benachrichtigungen (an diese Adresse werden Benachrichtigungen gesendet, z.B. wenn eine E-Mail keiner Bewerbung zugewiesen werden konnte). Achtung: Diese Adresse muss eine andere Adresse als die Mailbox sein!

Beispiel:

Application (client) ID: 123345678-1234-1234-1234-123456789012
Object ID: 12345678-1234-1234-1234-123456789012
Directory (tenant) ID: 12345678-1234-1234-1234-610c45febcff
Secret Value: *********************
Mailbox: john.smith@contoso.com
Scope: https://outlook.office365.com/.default
IMAP Server: outlook.office365.com
E-Mail Adresse für Benachrichtigungen: daniela.rossi@contoso.com