FreeScout连接Microsoft 365 Exchange时OAuth重定向URI配置指南

在使用FreeScout邮件帮助台系统与Microsoft 365 Exchange集成时，OAuth认证环节可能会出现重定向URI不匹配的问题。本文将详细说明如何正确配置Microsoft Entra ID（原Azure AD）应用的重定向URI。

问题现象

当用户尝试通过OAuth方式连接FreeScout与Microsoft 365 Exchange时，系统返回错误提示：

AADSTS50011: The redirect URI 'https://example.com/artisan/mailbox/oauth' specified in the request does not match the redirect URIs configured for the application

根本原因

此错误表明Microsoft Entra ID应用中配置的重定向URI与FreeScout实际使用的回调地址不匹配。特别需要注意的是：

1. 当FreeScout部署在子目录（如/artisan/）时，必须包含完整的路径
2. 默认文档可能遗漏了子目录情况下的配置说明

解决方案

标准部署配置

对于直接部署在网站根目录的FreeScout实例，需要在Microsoft Entra ID应用中配置以下重定向URI：

https://您的域名/mailbox/oauth

子目录部署配置

如果FreeScout部署在子目录中（例如使用Docker compose方式部署），则需要配置包含完整路径的重定向URI：

https://您的域名/子目录名/mailbox/oauth

以常见的/artisan/子目录为例，正确配置应为：

https://您的域名/artisan/mailbox/oauth

配置步骤详解

1. 登录Microsoft Entra ID管理门户
2. 找到对应的应用注册
3. 进入"认证"设置页面
4. 在"重定向URI"部分添加上述完整URI
5. 确保URI协议为https
6. 保存配置

验证方法

完成配置后，可尝试以下验证步骤：

1. 在FreeScout后台重新发起OAuth连接
2. 观察是否仍出现重定向错误
3. 检查浏览器地址栏是否跳转到了配置的URI

注意事项

1. 生产环境必须使用HTTPS协议
2. 域名必须与FreeScout访问地址完全一致
3. 对于容器化部署，需确认实际的访问路径
4. 配置变更可能需要几分钟生效时间

通过以上配置，即可解决FreeScout与Microsoft 365 Exchange集成时的OAuth认证问题，实现邮件的正常收发功能。