Passer au contenu principal

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​

  1. 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.
  2. Sur la page Overview de l'application, copiez l'Application (client) ID et le Directory (tenant) ID.
  3. Accédez à Certificates & secrets > Client secrets > New client secret, et copiez la Value du secret. Elle n'est affichée qu'une seule fois.
  4. Accédez à API permissions > Add a permission > Microsoft Graph > Application permissions, puis sélectionnez Mail.Send.
  5. 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​

  1. Dans la console d'administration Casdoor, accédez à Identity > Providers et ajoutez un fournisseur.

  2. Définissez Category sur Email et Type sur Microsoft Graph. Casdoor remplit automatiquement le point de terminaison, l'URL de jeton et le scope.

  3. Remplissez les champs :

    ChampValeur
    Client IDL'Application (client) ID de l'application
    Client secretLa Value du secret client
    From addressLa boîte aux lettres qui envoie les e-mails, par exemple noreply@contoso.com. Casdoor appelle sendMail pour cette boîte aux lettres ; ce champ est donc obligatoire
    From name(Facultatif) Le nom d'affichage de l'expéditeur
    Endpointhttps://graph.microsoft.com/v1.0. Modifiez-le uniquement pour un cloud national, par exemple https://graph.microsoft.us/v1.0
    Token URLhttps://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token, avec <tenant-id> remplacé par le Directory (tenant) ID
    Scopehttps://graph.microsoft.com/.default
  4. 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.

  5. 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​

  1. 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.
  2. 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​

ErrorCause
the token URL of the Microsoft Graph email provider is requiredToken URL est vide ou contient encore <tenant-id>
the from address of the Microsoft Graph email provider must be the mailbox that sends the emailsFrom address est vide ou n'est pas une adresse e-mail
oauth2: cannot fetch token avec un code AADSTSMicrosoft 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 403L'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 404From address n'est pas une boîte aux lettres du locataire

Voir aussi​