如何設定 Microsoft 365 OAuth SMTP

因應 Microsoft 將終止 SMTP 的基本帳號密碼驗證，若你目前的 SMTP 設定中是使用 smtp.office365.com，你有以下三種應對方式可選擇：

1. 停用自訂 SMTP，改用 Ragic 預設的 AWS SMTP 寄信機制。

2. 改用其他 SMTP 服務供應商。

3. 改用 Microsoft 365 的 OAuth SMTP

若選擇使用 Microsoft 365 OAuth SMTP，請依下列步驟完成設定。此流程分為兩部分：

一、Microsoft 365 端設定

請前往此網址登入 Microsoft 365 並完成以下設定：

備註：以下設定步驟如有遇到問題請先跟 Microsoft 客服確認。

1. 取得使用者主體名稱 (UPN)、租用戶識別碼 (Tenant ID)、應用程式識別碼 (Client ID)、以及應用程式密碼 (Client Secret)。

2. 在應用程式需要加入下圖的三個 API 權限。

3. 在應用程式的「驗證」中，在重新導向 URI 加入 https://對應 ragic 網域/ms365auth.jsp

例如：網域在 ap2 的話，就要加入：https://ap2.ragic.com/ms365auth.jsp

4. 使用者要開啟支援 SMTP 驗證，請到此網址設定開啟。

在「使用者」中選取「作用中的使用者」後，選擇目標使用者，於開啟的視窗中點擊「郵件」下的「管理電子郵件 App」。

接著勾選「已驗證的 SMTP」。

二、Ragic 端設定

前往公司設定的系統信件設定，在啟用自訂 SMTP 選擇 「MS365 OAuth Mail」。

備註：若沒有此選項請先將系統表單更新至最新版本。

選擇後，原本的 SMTP 帳號與密碼欄位將會隱藏，並顯示 Microsoft 365 OAuth 所需的設定欄位。請填入以下四項資訊：

使用者主體名稱 (UPN)

租用戶識別碼 (Tenant ID)

應用程式識別碼 (Client ID)

應用程式密碼 (Client Secret)

填寫完後，請先儲存公司設定表單，右側就會出現「連結至 Microsoft 365」的動作按鈕。

點擊後將開啟一個新分頁，讓使用者登入 Microsoft 帳戶並授權存取權限。授權完成後，該分頁會自動關閉。

這樣就完成了 Ragic 端的 OAuth SMTP 設定。

補充說明：

OAuth 授權可能會有期限，若過一段時間後發現無法寄信，請重新點選「連結至 Microsoft 365」按鈕以重新授權。

若發生寄信失敗的情況，可至下列 log 檔中查詢是否有相關錯誤訊息：

failMail.txt

ms365OAuth.log