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

在使用 FreeScout 与 Microsoft 365 Exchange 通过 OAuth 进行连接时，许多用户会遇到重定向 URI 不匹配的问题。本文将详细介绍如何正确配置 Microsoft Entra ID（原 Azure Active Directory）应用的重定向 URI，确保 OAuth 认证流程能够顺利完成。

常见错误现象

当配置不正确时，系统会返回如下错误信息：

Error occurred refreshing oAuth Access Token: {"error":"invalid_client","error_description":"AADSTS50011: The redirect URI 'https://example.com/artisan/mailbox/oauth' specified in the request does not match the redirect URIs configured for the application

这个错误表明应用程序请求的重定向 URI 与在 Microsoft Entra ID 中配置的不一致。

解决方案

标准安装配置

对于标准安装的 FreeScout，您需要在 Microsoft Entra ID 应用中配置以下重定向 URI：

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

子目录安装配置

如果您使用的是 Docker 容器或其他将 FreeScout 安装在子目录下的部署方式（例如 /artisan/ 目录），则需要配置包含子目录路径的重定向 URI：

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

配置步骤详解

1. 登录 Microsoft Entra ID 管理门户
2. 导航到"应用注册"，选择您的 FreeScout 应用
3. 在左侧菜单中选择"身份验证"
4. 在"重定向 URI"部分，添加上述适合您安装方式的重定向 URI
5. 确保 URI 完全匹配，包括协议(https)、域名、路径和大小写
6. 保存更改

注意事项

• 重定向 URI 必须使用 HTTPS 协议
• 确保域名与您的 FreeScout 安装地址完全一致
• 对于生产环境，建议配置多个重定向 URI 以覆盖所有可能的访问路径
• 更改配置后可能需要等待几分钟才能生效

通过正确配置重定向 URI，您将能够顺利建立 FreeScout 与 Microsoft 365 Exchange 之间的 OAuth 连接，实现邮件的自动收发功能。