E-Mails mit Microsoft Graph senden
Dieser Leitfaden erklärt, wie Sie die E-Mails von Casdoor über ein Microsoft 365-Postfach mit der sendMail-API von Microsoft Graph senden. Casdoor erhält ein App-only-Token von Microsoft Entra ID mit dem Client-Credentials-Flow und ruft POST /users/<mailbox>/sendMail auf. Es wird kein SMTP verwendet, daher funktioniert es in Mandanten, bei denen SMTP AUTH deaktiviert ist. Um stattdessen über SMTP zu senden, siehe Microsoft 365.
Lernziele
- Registrieren Sie eine App in Microsoft Entra ID, die als Postfach E-Mails senden darf.
- Fügen Sie Microsoft Graph in Casdoor als E-Mail-Anbieter hinzu und testen Sie ihn.
Voraussetzungen
- Ein Microsoft 365-Mandant und ein Postfach, das die E-Mails sendet, zum Beispiel
noreply@contoso.com. Ein freigegebenes Postfach funktioniert. - Ein Konto, das Apps registrieren und Administratorzustimmung in Microsoft Entra ID erteilen kann
- Administratorkonto für die Casdoor-Admin-Konsole
Registrieren einer App in Microsoft Entra ID
- Öffnen Sie im Microsoft Entra admin center App registrations und klicken Sie auf New registration. Geben Sie einen Namen ein, z. B.
Casdoor email, belassen Sie Accounts in this organizational directory only und klicken Sie auf Register. - Kopieren Sie auf der Seite Overview der App die Application (client) ID und die Directory (tenant) ID.
- Gehen Sie zu Certificates & secrets > Client secrets > New client secret und kopieren Sie den Value des Secrets. Er wird nur einmal angezeigt.
- Gehen Sie zu API permissions > Add a permission > Microsoft Graph > Application permissions, und wählen Sie Mail.Send aus.
- Klicken Sie auf Grant admin consent für Ihre Organisation.
Die Anwendungspermission Mail.Send erlaubt es der App, als jedes Postfach des Mandanten zu senden. Um dies auf das sendende Postfach zu beschränken, verwenden Sie RBAC for Applications in Exchange Online oder eine Anwendungs-Zugriffsrichtlinie.
Anbieter in Casdoor hinzufügen
-
Gehen Sie in der Casdoor-Admin-Konsole zu Identity > Providers und fügen Sie einen Anbieter hinzu.
-
Setzen Sie Category auf
Emailund Type aufMicrosoft Graph. Casdoor füllt den Endpoint, die Token-URL und den Scope automatisch aus. -
Füllen Sie die Felder aus:
Feld Wert Client ID Die Application (client) ID der App Client secret Der Value des Client Secrets From address Das Postfach, das die E-Mails sendet, zum Beispiel noreply@contoso.com. Casdoor ruftsendMailfür dieses Postfach auf, daher ist es erforderlichFrom name (Optional) Der Anzeigename des Absenders Endpoint https://graph.microsoft.com/v1.0. Ändern Sie dies nur für nationale Clouds, zum Beispielhttps://graph.microsoft.us/v1.0Token URL https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token, wobei<tenant-id>durch die Directory (tenant) ID ersetzt wirdScope https://graph.microsoft.com/.default -
Schreiben Sie den Email title und den Email content. Siehe Templates. Casdoor sendet den Inhalt als HTML und behält keine Kopie in Sent Items.
-
Speichern Sie den Anbieter.
Enable proxy sendet die Token-Anfrage und die API-Aufrufe über den SOCKS5-Proxy von Casdoor. Siehe Proxy.
Ergebnis überprüfen
- Klicken Sie auf Test SMTP Connection. Bei diesem Typ holt Casdoor nur ein Token, was die Token-URL, die Client-ID und das Client-Secret überprüft, ohne eine E-Mail zu senden.
- Klicken Sie auf Send Testing Email und prüfen Sie, ob die Nachricht im Test Email-Postfach eingeht.
Fügen Sie dann den Provider Ihrer Anwendung hinzu. Siehe Add providers to an application.
Fehlerbehebung
| Error | Cause |
|---|---|
the token URL of the Microsoft Graph email provider is required | Token URL ist leer oder enthält noch <tenant-id> |
the from address of the Microsoft Graph email provider must be the mailbox that sends the emails | From address ist leer oder ist keine E-Mail-Adresse |
oauth2: cannot fetch token mit einem AADSTS-Code | Microsoft Entra ID hat die Token-Anfrage abgelehnt. Prüfen Sie die Tenant-ID in Token URL, die Client ID und das Client secret, das der Secret-Wert sein muss, nicht seine ID, und darf nicht abgelaufen sein |
Microsoft Graph sendMail failed with status 403 | Die App hat keine Mail.Send-Anwendungspermission mit Administratorzustimmung, oder eine Zugriffsrichtlinie erlaubt ihr nicht, als From address zu senden |
Microsoft Graph sendMail failed with status 404 | Die From address ist kein Postfach des Mandanten |