プリザンターからM365のSMTPサーバを使ってメールを送信できるように設定する

概要¶

プリザンターからMicrosoft 365のSMTPサーバでOAuth 2.0認証を使い、メールを送信するために必要な設定について説明します。マイクロソフト社はSMTPサーバの認証方式をベーシック認証からOAuth 2.0認証へ移行させており、この変更に伴う対応が必要な場合は、以下の情報を確認してください。

本マニュアルでは、Microsoft 365側の設定と、プリザンター側の設定とに分けて説明します。Microsoft 365側の設定については概略を示すにとどめます。詳細は本マニュアルの末尾にまとめたマイクロソフト社のドキュメントを確認してください。

前提条件¶

1. Microsoft 365 テナントの管理者権限が必要です。
2. Entra ID（旧Azure Active Directory）へのアクセス権限が必要です。
3. 事前に送信に使用するメールボックス（共有メールボックスまたはユーザメールボックス）の作成が必要です。
4. 管理者権限で実行できるWindows PowerShellが必要です。

1. Microsoft 365側の設定¶

1.1. アプリケーションの登録¶

管理者権限を持つアカウントでMicrosoft Azure Portal にサインインし、アプリケーションを新規登録してください。登録後、以下の情報をメモしてください。

1.2. クライアントシークレットの作成¶

「新しいクライアント シークレット」を作成・追加してください。表示された「値」をコピーして安全な場所に保存してください。シークレットの値は一度しか表示されません。必ずコピーして保存してください。保存した値は、後ほどパラメータOAuthClientSecretに設定します。

1.3. APIアクセス許可の設定¶

Office 365 Exchange Onlineに対し、SMTP.SendAsAppの許可を追加してください。
また、当該テナントへ管理者の同意を付与してください。この操作は、テナントの全体管理者の権限が必要です。

1.4. テナント全体のSMTP AUTH設定¶

PowerShellを使い、テナント全体に対してSMTP AUTHを有効化してください。

この操作には、Exchange OnlineのOrganization Management（組織管理）ロールグループに属する権限が必要です。

1.5. Exchange Onlineの設定¶

PowerShellを使い、以下を実施してください。

1. 送信用共有メールボックスの作成
   Exchangeの管理ポータルにアクセスし、送信用の共有メールボックスを作成してください。

2. サービスプリンシパルの登録
   Exchange Online PowerShellに接続して、アプリケーションにSMTP送信権限を付与してください。
   この操作には、Organization Management（組織管理）ロールグループに属する権限が必要です。

3. メールボックスへのアクセス許可を付与
   送信に使用するメールボックスに対してアクセス許可を付与してください。
   この操作には、Organization Management（組織管理）またはRecipient Management（受信者管理）ロールグループに属する権限が必要です。

2. プリザンター側の設定¶

2.1. Mail.jsonの設定¶

設定ファイルMail.jsonのパラメータを以下のように設定してください。

{
    "SmtpHost": "smtp.office365.com",
    "SmtpPort": 587,
    "SmtpUserName": "{{送信用共有メールボックスの所有者のメールアドレス}}",
    "SmtpPassword": "",
    "SmtpEnableSsl": true,
    "SecureSocketOptions": "StartTls",
    "UseOAuth": true,
    "OAuthClientId": "{{アプリケーション (クライアント) ID}}",
    "OAuthClientSecret": "{{クライアントシークレットの値}}",
    "OAuthScope": "https://outlook.office365.com/.default",
    "OAuthGrantType": "client_credentials",
    "OAuthTokenEndpoint": "https://login.microsoftonline.com/{{ディレクトリ (テナント) ID}}/oauth2/v2.0/token",
    "Encoding": "UTF-8",
    "FixedFrom": "{{送信用共有メールボックスの所有者のメールアドレス}}",
    "SupportFrom": "{{送信用共有メールボックスの所有者のメールアドレス}}"
}

設定項目の説明¶

【固定値】とある設定項目には、既定の値を設定してください。

2.2. OAuthClientIdとOAuthClientSecretを環境変数で設定する¶

セキュリティ上の理由から、以下のパラメータは環境変数で設定することを推奨します。

1. OAuthClientId
2. OAuthClientSecret

Linux/macOS Bash¶

export Pleasanter_Mail_OAuthClientId="{{アプリケーション (クライアント) ID}}"
export Pleasanter_Mail_OAuthClientSecret="{{クライアントシークレットの値}}"

Windows PowerShell¶

$env:Pleasanter_Mail_OAuthClientId = "{{アプリケーション (クライアント) ID}}"
$env:Pleasanter_Mail_OAuthClientSecret = "{{クライアントシークレットの値}}"

1. 環境変数名のプレフィックスは{EnvironmentName}_Mail_または{ServiceName}_Mail_の形式です。
2. デフォルトのServiceNameはPleasanterです。
3. 環境変数で設定する場合、Mail.jsonのOAuthClientIdとOAuthClientSecretは空欄（""）にしてください。

すべての設定が済んだら、プリザンターを再起動してください。

3. エラーが表示された場合の確認事項¶

エラー: "OAuth token acquisition failed"が表示される¶

1. OAuthClientId、OAuthClientSecret、OAuthTokenEndpointの値を確認してください。
2. EntraアプリケーションのAPI許可が正しく付与されているかを確認してください。
3. 管理者の同意が付与されているかを確認してください。

エラー: "Authentication failed"が表示される¶

1. SmtpUserNameが正しいメールアドレスかを確認してください。
2. Exchange Onlineでサービスプリンシパルが正しく登録されているかを確認してください。
3. メールボックスへのアクセス許可が付与されているかを確認してください。

エラー: "5.7.3 Authentication unsuccessful"が表示される¶

1. OAuthScopeがhttps://outlook.office365.com/.default になっているかを確認してください。
2. SMTP AUTH がメールボックスで有効になっているかを確認してください。

4. セキュリティに関する注意事項¶

対応バージョン¶

関連情報¶

• Microsoft: Authenticate an IMAP, POP or SMTP connection using OAuth
• Microsoft: Register an application with the Microsoft identity platform
• Microsoft: SMTP AUTH clients submission