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 にアプリを登録する
- Microsoft Entra admin center で App registrations を開き、New registration をクリックします。
Casdoor emailなどの名前を入力し、Accounts in this organizational directory only をそのままにして、Register をクリックします。 - アプリの Overview ページで、Application (client) ID と Directory (tenant) ID をコピーします。
- Certificates & secrets > Client secrets > New client secret に移動し、シークレットの Value をコピーします。これは一度だけ表示されます。
- API permissions > Add a permission > Microsoft Graph > Application permissions に移動し、Mail.Send を選択します。
- 組織に対して Grant admin consent をクリックします。
Mail.Send アプリケーション権限により、アプリはテナント内の任意のメールボックスとして送信できます。送信メールボックスに限定するには、Exchange Online のアプリケーション RBAC またはアプリケーションアクセスポリシーを使用してください。
Casdoor でプロバイダーを追加する
-
Casdoor 管理コンソールで Identity > Providers に移動し、プロバイダーを追加します。
-
Category を
Emailに、Type をMicrosoft Graphに設定します。Casdoor がエンドポイント、トークン URL、スコープを自動入力します。 -
フィールドに入力します:
フィールド 値 Client ID アプリの Application (client) ID Client secret クライアントシークレットの Value From address メールを送信するメールボックス(例: noreply@contoso.com)。Casdoor はこのメールボックスに対してsendMailを呼び出すため、必須ですFrom name (任意)送信者の表示名 Endpoint https://graph.microsoft.com/v1.0。国内クラウドの場合のみ変更してください(例:https://graph.microsoft.us/v1.0)Token URL https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token(<tenant-id>を Directory (tenant) ID に置き換えます)Scope https://graph.microsoft.com/.default -
Email title と Email content を記入します。Templates を参照してください。Casdoor はコンテンツを HTML として送信し、Sent Items にコピーを保存しません。
-
プロバイダーを保存します。
Enable proxy を有効にすると、トークンリクエストと API 呼び出しが Casdoor の SOCKS5 プロキシ経由で送信されます。Proxy を参照してください。
結果の確認
- Test SMTP Connection をクリックします。このタイプでは、Casdoor はトークンの取得のみを行い、トークン URL、クライアント ID、クライアントシークレットを検証しますが、メールは送信しません。
- Send Testing Email をクリックし、メッセージが Test Email メールボックスに届くことを確認します。
その後、アプリケーションにプロバイダーを追加します。Add providers to an application を参照してください。
トラブルシューティング
| Error | Cause |
|---|---|
the token URL of the Microsoft Graph email provider is required | Token URL が空であるか、まだ <tenant-id> を含んでいます |
the from address of the Microsoft Graph email provider must be the mailbox that sends the emails | From address が空であるか、メールアドレスではありません |
oauth2: cannot fetch token with an AADSTS code | Microsoft 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 404 | From address がテナント内のメールボックスではありません |