メインコンテンツにスキップ

Microsoft Graph でメールを送信する

このガイドでは、Microsoft Graph の sendMail API を使用して、Microsoft 365 のメールボックスから Casdoor のメールを送信する方法について説明します。Casdoor はクライアントクレデンシャルフローを使用して Microsoft Entra ID からアプリ専用トークンを取得し、POST /users/<mailbox>/sendMail を呼び出します。SMTP は使用しないため、SMTP AUTH が無効になっているテナントでも動作します。代わりに SMTP を介して送信する場合は、Microsoft 365 を参照してください。


学習目標​

  • メールボックスとしてメールを送信できるアプリを Microsoft Entra ID に登録します。
  • Casdoor に Microsoft Graph をメールプロバイダーとして追加し、テストします。

必要なもの​

  • Microsoft 365 テナントと、メールを送信するメールボックス(例:noreply@contoso.com)。共有メールボックスも利用可能です。
  • Microsoft Entra ID でアプリの登録および管理者同意の付与ができるアカウント
  • Casdoor 管理コンソールへの管理者アクセス権限

Microsoft Entra ID にアプリを登録する​

  1. Microsoft Entra admin center で App registrations を開き、New registration をクリックします。Casdoor email などの名前を入力し、Accounts in this organizational directory only をそのままにして、Register をクリックします。
  2. アプリの Overview ページで、Application (client) ID と Directory (tenant) ID をコピーします。
  3. Certificates & secrets > Client secrets > New client secret に移動し、シークレットの Value をコピーします。これは一度だけ表示されます。
  4. API permissions > Add a permission > Microsoft Graph > Application permissions に移動し、Mail.Send を選択します。
  5. 組織に対して Grant admin consent をクリックします。

Mail.Send アプリケーション権限により、アプリはテナント内の任意のメールボックスとして送信できます。送信メールボックスに限定するには、Exchange Online のアプリケーション RBAC またはアプリケーションアクセスポリシーを使用してください。

Casdoor でプロバイダーを追加する​

  1. Casdoor 管理コンソールで Identity > Providers に移動し、プロバイダーを追加します。

  2. Category を Email に、Type を Microsoft Graph に設定します。Casdoor がエンドポイント、トークン URL、スコープを自動入力します。

  3. フィールドに入力します:

    フィールド値
    Client IDアプリの Application (client) ID
    Client secretクライアントシークレットの Value
    From addressメールを送信するメールボックス(例:noreply@contoso.com)。Casdoor はこのメールボックスに対して sendMail を呼び出すため、必須です
    From name(任意)送信者の表示名
    Endpointhttps://graph.microsoft.com/v1.0。国内クラウドの場合のみ変更してください(例:https://graph.microsoft.us/v1.0)
    Token URLhttps://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token(<tenant-id> を Directory (tenant) ID に置き換えます)
    Scopehttps://graph.microsoft.com/.default
  4. Email title と Email content を記入します。Templates を参照してください。Casdoor はコンテンツを HTML として送信し、Sent Items にコピーを保存しません。

  5. プロバイダーを保存します。

Enable proxy を有効にすると、トークンリクエストと API 呼び出しが Casdoor の SOCKS5 プロキシ経由で送信されます。Proxy を参照してください。

結果の確認​

  1. Test SMTP Connection をクリックします。このタイプでは、Casdoor はトークンの取得のみを行い、トークン URL、クライアント ID、クライアントシークレットを検証しますが、メールは送信しません。
  2. Send Testing Email をクリックし、メッセージが Test Email メールボックスに届くことを確認します。

その後、アプリケーションにプロバイダーを追加します。Add providers to an application を参照してください。

トラブルシューティング​

ErrorCause
the token URL of the Microsoft Graph email provider is requiredToken URL が空であるか、まだ <tenant-id> を含んでいます
the from address of the Microsoft Graph email provider must be the mailbox that sends the emailsFrom address が空であるか、メールアドレスではありません
oauth2: cannot fetch token with an AADSTS codeMicrosoft Entra ID がトークンリクエストを拒否しました。Token URL のテナント ID、Client ID、および Client secret(ID ではなくシークレット値であり、期限切れではないこと)を確認してください
Microsoft Graph sendMail failed with status 403アプリに Mail.Send アプリケーション権限が付与されていないか、管理者同意がありません。または、アクセスポリシーにより From address としての送信が許可されていません
Microsoft Graph sendMail failed with status 404From address がテナント内のメールボックスではありません

関連項目​