本文介绍在 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中运行的代理中为模型上下文协议 (MCP) 和 API 插件配置身份验证时的常见问题。
若要查看代理响应中的身份验证错误, 请启用开发人员模式。 本文中的许多错误都显示在调试信息卡中。
- 用户无法登录或令牌交换失败
-
307 Temporary Redirect令牌终结点 - 卸载代理后,存储的凭据仍保留
- 未提示 Microsoft Entra SSO 同意
- 身份验证配置与插件之间的应用 ID 不匹配
- 身份验证配置中的基 URL 与插件不匹配
- 插件清单中的引用 ID 不正确或缺失
- 组织策略限制访问
- “登录”按钮处于非活动状态或显示一般错误
- 登录弹出窗口无法打开
- 登录弹出窗口打开但卡住或从不关闭
- “凭据不正确”错误
- 找不到登录 URL
- 身份验证期间出现内部服务器错误
- 登录期间显示“同意”对话框
用户无法登录或令牌交换失败
OAuth 提供程序、身份验证配置和插件清单之间的值不匹配是登录失败的最常见原因。 验证以下值:
- 身份验证配置中的基 URL 与 MCP 插件插件清单中 MCP 服务器规格对象的属性,或 API 插件的 OpenAPI 文档中数组中的
servers条目匹配url。 - 重定向 URI
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect已向 OAuth 提供程序注册为允许的重定向 URI 或授权回调 URL。 -
reference_id运行时身份验证对象与 Microsoft Teams 开发人员门户生成的身份验证配置 ID 匹配。 - 应用限制 (“ 按应用) 限制使用 ”和“组织限制” (“ 按组织限制使用 ”设置允许 Teams 应用和租户) 。
307 Temporary Redirect 令牌终结点
不支持从令牌终结点返回 307 Temporary Redirect HTTP 状态代码的 OAuth 2.0 服务器。 将提供程序配置为使用直接令牌终结点。
卸载代理后,存储的凭据仍保留
用户可以从对话助手设置>注销代理 智能智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®中的代理。 对于 OAuth 2.0,注销将清除存储的令牌。 对于 Microsoft Entra SSO,无法直接清除令牌,并且由于 SSO 缓存、租户设置或客户端差异,在卸载代理后可能会继续保留。
若要强制对 Entra SSO 进行重新身份验证,请删除用户的同意或使用 Microsoft Graph revokeSignInSessions API 撤销其会话。
未提示 Microsoft Entra SSO 同意
如果 MCP 服务器或 API 使用 代表流 访问另一个需要用户授予同意的 Web API,请返回一个 401 Unauthorized 错误,以使代理提示用户登录以授予同意。
另请确认:
- Teams 开发人员门户生成的应用程序 ID URI 将添加到 Entra 应用注册的 identifierUri。
-
https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirect将添加到 Web 平台的重定向 URI。 - Microsoft Enterprise 令牌存储客户端 ID (
ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) 将添加到“公开 API ”下并添加为允许的客户端应用程序,并且在验证客户端应用 ID 的情况下,添加为允许的令牌受众。
身份验证配置与插件之间的应用 ID 不匹配
如果在调试信息卡中看到类似于以下内容的错误:
OAuth authentication failed: The App ID used in the request does not match the App ID in the authentication configuration. (HTTP 404)
转到 Teams 开发人员门户。 查找 OAuth 客户端或单一登录 (SSO) 客户端注册,并验证插件中的应用 ID 是否与注册的应用 ID 匹配。
身份验证配置中的基 URL 与插件不匹配
如果在调试信息卡中看到类似于以下内容的错误:
OAuth authentication failed: The base URL in your authentication configuration does not match the server URL. (HTTP 401)
转到 Teams 开发人员门户。 查找 OAuth 客户端或 SSO 客户端注册,并验证插件中的 MCP 服务器 URL 是否与注册的基 URL 匹配。
插件清单中的引用 ID 不正确或缺失
如果在调试信息卡中看到类似于以下内容的错误:
OAuth authentication failed: No matching configuration found for referenceID in 'runtime.auth' section of the action manifest
转到 Teams 开发人员门户。 查找 OAuth 客户端或 SSO 客户端注册,并验证 MCP 服务器运行时 auth.reference_id 中的 ID 是否与 Teams 开发人员门户中的身份验证配置 ID 匹配。
组织策略限制访问
如果在调试信息卡中看到类似于以下内容的错误:
OAuth authentication failed: Access is restricted by your organization's policy. (HTTP 404)
请与组织的管理员联系,查看并启用应用的访问权限。
“登录”按钮处于非活动状态或显示一般错误
如果登录按钮处于非活动状态或禁用状态,或者选择它会出现一般性“无法处理请求”错误,则这种情况可能表示临时身份验证或会话问题。 重试查询。 如果问题仍然存在,请重新安装应用或与组织的管理员联系。
登录弹出窗口无法打开
在浏览器的设置中为网站启用弹出窗口,然后重试。
登录弹出窗口打开但卡住或从不关闭
如果打开登录弹出窗口,用户完成身份验证,但弹出窗口从未关闭,并且 Copilot 未收到身份验证结果,则弹出窗口的 window.opener 引用很可能在 OAuth 重定向链中被销毁。 如果没有 window.opener,弹出窗口无法将身份验证结果传回 Copilot。 常见的症状是首次登录失败,但重试成功,因为缓存的凭据会跳过销毁的 window.opener页面。
检查 OAuth 重定向链中的以下项。
-
JavaScript nullifying
window.opener: 某些登录页面设置为window.opener = null针对反向 tabnabbing 的一揽子安全措施。 如果身份验证重定向链中的任何页面运行此代码,弹出窗口将失去与 Copilot 的连接。 将选项卡捕获保护的范围限定为仅用户启动的导航,并且在弹出窗口重定向期间不清除window.opener。 -
Cross-Origin-Opener-Policy标头设置为same-origin: 如果重定向链中的任何页面提供Cross-Origin-Opener-Policy: same-origin响应标头,浏览器会永久切断window.opener跨源导航上的引用。 确保 OAuth 重定向链中的所有页面省略Cross-Origin-Opener-Policy默认为unsafe-none) 的标头 (或显式将其unsafe-none设置为 。 -
使用以下内容的链接:
rel="noopener"从目标页面使用条带window.opener的rel="noopener"锚标签。 请勿用于rel="noopener"身份验证弹出窗口中的导航。
若要调试此问题,请在弹出窗口中打开浏览器的开发人员工具,并在重定向链的每个步骤中键入window.opener控制台。 如果在最终重定向之前返回null,请window.opener确定哪个页面清除了它。 您还可以检查链中每个页面上的值的Cross-Origin-Opener-Policy网络选项卡响应标头。
“凭据不正确”错误
如果在登录弹出窗口或聊天响应中看到“凭据不正确”错误,请确保输入正确的凭据。 如果错误仍然存在,请确保用户具有所需的权限。
找不到登录 URL
卸载并重新安装应用,然后再次尝试登录。
身份验证期间出现内部服务器错误
检查身份验证弹出窗口中的详细信息,并联系组织的管理员了解权限问题。
登录期间显示“同意”对话框
如果出现请求权限或业务理由的同意对话框,请查看请求的权限,并在必要时提供业务理由。 如果不确定,或者如果同意对话框请求需要管理员同意的权限,请联系组织的管理员。