Envoyer des e-mails avec Microsoft Graph
Ce guide explique comment envoyer les e-mails de Casdoor depuis une boîte aux lettres Microsoft 365 avec l'API sendMail de Microsoft Graph. Casdoor obtient un jeton d'application uniquement auprès de Microsoft Entra ID via le flux d'identifiants client et appelle POST /users/<mailbox>/sendMail. Il n'utilise pas SMTP, il fonctionne donc dans les locataires où l'authentification SMTP est désactivée. Pour envoyer via SMTP à la place, voir Microsoft 365.
Objectifs d'apprentissage
- Enregistrez une application dans Microsoft Entra ID autorisée à envoyer des e-mails en tant que boîte aux lettres.
- Ajoutez Microsoft Graph comme fournisseur d'e-mails dans Casdoor et testez-le.
Prérequis
- Un locataire Microsoft 365 et une boîte aux lettres qui envoie les e-mails, par exemple
noreply@contoso.com. Une boîte aux lettres partagée fonctionne. - Un compte pouvant enregistrer des applications et accorder le consentement administrateur dans Microsoft Entra ID
- Accès administrateur à la console d'administration Casdoor
Enregistrer une application dans Microsoft Entra ID
- Dans le centre d'administration Microsoft Entra, ouvrez App registrations et cliquez sur New registration. Saisissez un nom, tel que
Casdoor email, conservez Accounts in this organizational directory only, puis cliquez sur Register. - Sur la page Overview de l'application, copiez l'Application (client) ID et le Directory (tenant) ID.
- Accédez à Certificates & secrets > Client secrets > New client secret, et copiez la Value du secret. Elle n'est affichée qu'une seule fois.
- Accédez à API permissions > Add a permission > Microsoft Graph > Application permissions, puis sélectionnez Mail.Send.
- Cliquez sur Grant admin consent pour votre organisation.
L'autorisation d'application Mail.Send permet à l'application d'envoyer des messages en tant que n'importe quelle boîte aux lettres du locataire. Pour la limiter à la boîte aux lettres d'envoi, utilisez RBAC for Applications in Exchange Online ou une stratégie d'accès d'application.
Ajouter le fournisseur dans Casdoor
-
Dans la console d'administration Casdoor, accédez à Identity > Providers et ajoutez un fournisseur.
-
Définissez Category sur
Emailet Type surMicrosoft Graph. Casdoor remplit automatiquement le point de terminaison, l'URL de jeton et le scope. -
Remplissez les champs :
Champ Valeur Client ID L'Application (client) ID de l'application Client secret La Value du secret client From address La boîte aux lettres qui envoie les e-mails, par exemple noreply@contoso.com. Casdoor appellesendMailpour cette boîte aux lettres ; ce champ est donc obligatoireFrom name (Facultatif) Le nom d'affichage de l'expéditeur Endpoint https://graph.microsoft.com/v1.0. Modifiez-le uniquement pour un cloud national, par exemplehttps://graph.microsoft.us/v1.0Token URL https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token, avec<tenant-id>remplacé par le Directory (tenant) IDScope https://graph.microsoft.com/.default -
Renseignez le Email title et le Email content. Voir Templates. Casdoor envoie le contenu au format HTML et ne conserve pas de copie dans Sent Items.
-
Enregistrez le fournisseur.
Enable proxy envoie la demande de jeton et les appels API via le proxy SOCKS5 de Casdoor. Voir Proxy.
Vérifier le résultat
- Cliquez sur Test SMTP Connection. Pour ce type, Casdoor récupère uniquement un jeton, ce qui vérifie l'URL du jeton, l'ID client et le secret client, sans envoyer d'e-mail.
- Cliquez sur Send Testing Email et vérifiez que le message arrive bien dans la boîte aux lettres Test Email.
Ajoutez ensuite le fournisseur à votre application. Voir Add providers to an application.
Dépannage
| Error | Cause |
|---|---|
the token URL of the Microsoft Graph email provider is required | Token URL est vide ou contient encore <tenant-id> |
the from address of the Microsoft Graph email provider must be the mailbox that sends the emails | From address est vide ou n'est pas une adresse e-mail |
oauth2: cannot fetch token avec un code AADSTS | Microsoft Entra ID a refusé la demande de jeton. Vérifiez l'ID du tenant dans Token URL, le Client ID, et le Client secret, qui doit être la valeur du secret, et non son ID, et ne doit pas avoir expiré |
Microsoft Graph sendMail failed with status 403 | L'application ne dispose pas de l'autorisation d'application Mail.Send avec consentement administrateur, ou une stratégie d'accès ne lui permet pas d'envoyer des messages en tant que From address |
Microsoft Graph sendMail failed with status 404 | From address n'est pas une boîte aux lettres du locataire |