如何在Frappe中配置Exchange邮箱收发账户？解决认证失败问题

一、OAuth2配置关键补全项 #

• 权限配置必须到位：
  需在Azure AD应用注册中添加以下Delegated权限，并完成授权（企业账户需管理员同意，个人账户直接授权）：
  • SMTP.Send（发信权限）
  • IMAP.AccessAsUser.All（IMAP收信权限）
  • POP.AccessAsUser.All（若使用POP收信）
    同时注意：个人Microsoft账号需将应用注册的支持类型设置为"个人微软账户"，而非仅组织账户。
• 回调地址完全匹配：
  ERPNext中填写的OAuth回调地址，必须与Azure AD应用里的"重定向URI"完全一致，标准格式为https://你的ERP域名/api/method/frappe.integrations.oauth2_callback。
• 端点信息正确无误：
  确保使用Microsoft OAuth2 v2.0的官方端点：
  • 授权端点：https://login.microsoftonline.com/common/oauth2/v2.0/authorize
  • Token端点：https://login.microsoftonline.com/common/oauth2/v2.0/token
• 邮箱服务器参数验证：
  开启OAuth2后，收发信服务器参数需按以下配置：
  • SMTP：地址smtp.office365.com，端口587，加密方式STARTTLS
  • IMAP：地址outlook.office365.com，端口993，加密方式SSL/TLS

二、替代可行方案 #

如果OAuth2配置仍无法解决问题，可尝试以下方案：

• Exchange Web Services (EWS) 协议：
  切换到EWS协议收发信，需在Azure AD应用中添加Exchange.ManageAsApp应用权限并完成管理员同意，使用应用ID和客户端密钥进行认证。
• 强制现代认证适配：
  针对部分旧版ERPNext的兼容性问题，可手动修改邮箱账户的配置参数，强制开启现代认证适配，重点检查use_tls和oauth2_authorization_url的设置是否正确。

内容的提问来源于stack exchange，提问作者P-Godfroid