如何设置 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