提示
受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。
Microsoft Entra单一登录 (SSO) 身份验证使用户能够使用其现有的 Microsoft Entra ID 凭据进行身份验证。 这种集成简化了访问管理,并确保与模型上下文协议 (MCP) 服务器或 API 的安全连接,而无需额外的凭据。 您的 MCP 服务器或 API 必须使用 Entra ID 来控制访问。
本文使用 MCP 插件作为默认演练。 除非另有说明,否则相同的步骤适用于从 OpenAPI 文档生成的 API 插件。
分四个步骤配置 Entra SSO 身份验证:注册 Entra 应用以保护您的 MCP 服务器、创建身份验证配置、更新 Entra 应用注册,以及将新的令牌受众添加到您的 API。
第 1 步:注册 Entra 应用程序以保护您的 MCP 服务器
您的 MCP 服务器或 API 必须通过 Entra 应用注册进行保护。 如果还没有,请在 Microsoft Entra 管理中心注册一个应用。 请注意应用的 客户端 ID - 它在 步骤 2 中创建身份验证配置时提供。
第 2 步:创建 Entra SSO 身份验证配置
Entra SSO 身份验证依赖于身份验证配置 (身份验证配置) - 存储在 Microsoft Enterprise 令牌存储中的记录,智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®用于为 MCP 插件获取令牌。 对于受支持的专业代码项目,从 WIQD 开始。 工具包、开发人员技能和 Teams 开发人员门户过程仍作为备选方案提供。
无论创建方式如何,身份验证配置都具有身份验证 配置 ID 和 应用程序 ID URI。 在步骤 3 和步骤 4 中使用应用程序 ID URI。
使用 Work IQ 开发工具 (推荐)
对于 MCP 操作,wiqd agent add action请与 --mcp-server-url一起使用,--mcp-auth-type entra-sso并--mcp-client-id设置为步骤 1 中 Entra 应用的客户端 ID。 对于 OpenAPI 操作,请使用 --openapi-auth-identity-provider microsoft-entra 和 --openapi-auth-client-id。 有关其他所需的操作选项,请参阅 WIQD 操作命令指南 。
对于现有插件清单, wiqd agent add auth 请与 --plugin-manifest、 --auth-name和 --auth-type microsoft-entra一起使用。 提供为该命令记录的标识提供程序选项,包括 --oauth-client-id。 完成项目的预配工作流,获取身份验证配置的 应用程序 ID URI,然后继续执行步骤 3 和步骤 4。
使用 Microsoft 365 代理工具包
使用 Microsoft 365 代理工具包中的 MCP 插件生成代理时,该工具包会在添加 MCP 服务器插件时提示输入身份验证类型。 选择 Microsoft Entra SSO,并提供步骤 1 中 Entra 应用的客户端 ID。 Agents Toolkit 在企业令牌存储中创建身份验证配置,生成身份验证配置 ID,并自动更新插件清单中的 运行时身份验证对象 。
使用声明式代理开发人员技能
声明式代理开发人员技能 (declarative-agent-developer) 是 Microsoft Work IQ 中的一项代理技能,包含构建声明式代理所需的知识。 不用自己运行命令或编辑清单,而是用自然语言向 Copilot 或 GitHub CLI 描述你想要的内容。 此技能将支持声明式代理、添加 MCP 插件,并处理身份验证配置。 该技能仅支持 MCP 插件。 当您添加使用 Entra SSO 的 MCP 服务器时,该技能将在企业令牌存储中创建身份验证配置并更新插件清单,而无需手动步骤。
提示
有关使用声明式代理开发人员技能的视频演练,请参阅 使用声明式代理开发人员技能生成声明式代理。
使用 Teams 开发人员门户
如果使用代理工具包或声明式代理开发人员技能,则可以选择在 Teams 开发人员门户中注册。 当您想要手动创建身份验证配置时,或者更常见的是管理 Agents Toolkit 或技能已创建的身份验证配置时,请使用它。 在门户中,可以将身份验证配置限制为特定的 Teams 应用或 Microsoft 365 组织,并修改其他属性。
打开 Teams 开发人员门户。 选择“工具”->“Microsoft Entra SSO 客户端 ID 注册)。
如果没有现有注册,请选择 “注册客户端 ID”。 如果已有注册,请选择 “新建客户端注册”。
填写以下字段。
- 注册名称:注册的友好名称。
-
基 URL:API 的基本 URL。 此值应对应于基于 MCP 的插件的插件清单中 MCP 服务器规范对象属性中的
urlURL,或 API 插件的 OpenAPI 文档中数组中的servers条目。 - 按组织限制使用情况:选择哪个 Microsoft 365 组织有权访问你的应用以访问 API 终结点。
- 按应用限制使用: 如果不知道最终应用 ID,请选择“ 任何 Teams 应用 ”。 发布应用后,将此注册与已发布的应用 ID 绑定。
- 客户端 ID:在 Entra 中注册的应用的客户端 ID。
- 范围:插件从 Entra 请求的权限。 与 OAuth 2.0 一样,使用 Entra 应用和 API 所需的范围值。
选择“保存”。
完成注册将创建身份验证配置,并生成身份验证配置 ID (当前在 Teams 开发人员门户) 中标记为 Microsoft Entra SSO 注册 ID 和应用程序 ID URI。
将身份验证配置 ID 添加到插件清单
在 Teams 开发人员门户中手动创建身份验证配置时,请type将运行时身份验证对象OAuthPluginVault的属性设置为 ,并将 设置为reference_id身份验证配置 ID。 代理工具包和声明式代理开发人员技能可为你执行此操作。
"auth": {
"type": "OAuthPluginVault",
"reference_id": "auth config ID"
},
步骤 3:更新 Entra 应用注册
无论你在步骤 2 中如何创建身份验证配置,请完成以下步骤。
打开 Microsoft Entra 管理中心。 使用 SSO 注册中的应用程序 ID URI 更新保护 MCP 服务器或 API 的 Entra 应用注册。 如果已将现有应用程序 ID URI 映射到应用注册,请使用清单编辑器在 identifierUris 部分中添加另一个 URI。
"identifierUris": [ "<<URI1>>", "<<URI2>>" ]注意
无法通过 Entra 管理中心的 UI 添加多个 URI。 UI 仅显示列表中的第一个 URI。 添加多个 URI 不会影响现有 URI 和范围,即使它们在 UI 中的显示方式不同。
选择“管理”下的“身份验证”。 添加到
https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirectWeb 平台中的重定向 URI。在“管理”下选择“公开 API”。 选择“添加客户端应用程序”,并添加 Microsoft 企业令牌存储的客户端 ID。
ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b
步骤 4:将新的令牌受众添加到 API
更新 MCP 服务器或 API,允许新标识符 URI 作为令牌受众。 如果 MCP 服务器或 API 验证客户端应用程序 ID,请确保将 Microsoft Enterprise 令牌存储的客户端 ID (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) 添加为允许的客户端应用程序。
提示
如果 MCP 服务器或 API 使用 代表流 访问另一个需要用户授予同意的 Web API,请返回一个 401 Unauthorized 错误,以使代理提示用户登录以授予同意。