在 Copilot Studio 中配置用户身份验证

用户认证允许用户登录,这样你的代理就能代表他们访问受限资源或信息。 用户可以通过使用 Microsoft Entra ID 或 OAuth 2.0 身份提供者(如 Google 或 Facebook)登录。

Note

对于使用手动认证的 Microsoft Teams 部署,请在配置 SSO(单点登录)并使用 Microsoft Entra ID 中的 Teams 代理部署要求。

编辑主题时,您可以向主题添加用户身份验证。

Important

只有在发布代理后,对身份验证配置的更改才会生效。 在对代理进行认证更改之前,请提前做好规划。

选择身份验证选项

Note

在选择身份验证选项之前,请查看以下Power BI集成限制。 使用 Microsoft 身份验证 (Entra ID) 的 Copilot Studio 代理无法通过基于 iframe 的视觉对象嵌入到 Power BI 报表中。

Copilot Studio 支持多个身份验证选项。 选择并配置符合需求的选项。

  1. 转到您的智能体的设置,然后选择安全性。

  2. 选择身份验证。

  3. 选择身份验证选项并根据需要对其进行配置。 有以下身份验证选项可用:

  4. 选择“保存”。

无身份验证

不进行身份验证意味着您的智能体允许用户在未登录的情况下与智能体交互。 未经身份验证的配置意味着您的智能体只能访问公共信息和资源。 默认情况下,经典聊天机器人配置为不需要身份验证。

当 Power Platform 管理中心中的数据 策略 配置为需要认证时,这个选项不可用。

Caution

选择无身份验证选项将允许拥有链接的任何人与您的机器人或智能体聊天和交互。

我们建议您应用身份验证,特别是当您在组织内或针对特定用户使用机器人或智能体时,以及其他安全和治理控制。

向 Microsoft 进行身份验证

Important

通过内置的Teams + Microsoft 365渠道发布,请使用Microsoft认证。 如果你的认证配置阻挡了通道,请检查 代理状态。 对于在Teams中手动部署认证,请遵循 Teams的单点单和应用清单要求。

此外,Authenticate with Microsoft 选项不适用于与 Dynamics 365 Customer Service 集成的代理。

该配置会自动为Teams、SharePoint、Power Apps和Microsoft Copilot设置Microsoft Entra ID认证,无需手动配置。 在Teams中,除非你的客服要求扩展范围,否则用户不会被提示登录。

如果你需要在其他信道上进行认证,请选择 手动认证。

如果您选择“与 Microsoft 认证”,以下变量可在网页应用和 Teams 计划的主题创作画布中使用:

  • User.Id
  • User.DisplayName

在网页应用中, User.IsLoggedIn 以及额外的配置文件变量也可用。 在Teams套餐中, User.IsLoggedIn 这个选项没有。 了解更多内容,请参见 认证变量。

User.AccessToken 但这个选项没有。 如果你需要认证令牌,手动使用 认证。

如果你从“手动认证”改为“与 Microsoft 认证,引用将User.AccessToken变成未知变量。 在Teams计划中,引用也将 User.IsLoggedIn 成为 未知 变量。 在发布你的代理人之前,纠正任何主题错误。

手动进行身份验证

Copilot Studio 在手动身份验证选项下支持以下身份验证服务提供商:

  • 使用联合凭据Microsoft Entra ID V2
  • Microsoft Entra ID V2 使用证书
  • Microsoft Entra ID V2 配客户端机密
  • Microsoft Entra ID
  • 通用OAuth 2:任何符合OAuth 2.0标准的身份提供者

若选择手动认证,主题编辑画布中将提供以下变量:

  • User.Id
  • User.DisplayName
  • User.AccessToken
  • User.IsLoggedIn

在 “向主题添加用户认证”中了解更多关于这些变量的信息。

Note

  • 认证更改只有在你发布代理后才生效。
  • 通过 Power Platform 中的对应管理控制项管理此设置。 当你打开控制按钮时,它会阻止 Copilot Studio 内的“手动认证”选项被开启或关闭。 控件始终处于开启状态,且无法在 Copilot Studio 中修改 手动身份验证 选项。

要求用户登录和代理共享

“要求用户登录”设置决定用户是否需要登录才能与代理通话。 为需要访问敏感或受限信息的代理启用此设置。

此选项不适用于无身份验证和向 Microsoft 进行身份验证选项。

Note

当 Power Platform 管理中心中的数据策略设置为要求身份验证时,无法关闭此选项。 在 配置代理的数据策略中了解详细信息。

如果您关闭此选项,您的智能体不会要求用户登录,直到遇到需要用户登录的主题。

当您打开此选项时,它会创建一个名为需要用户登录的系统主题。 本主题仅与手动验证设置相关。 在支持的 Teams 聊天中自动登录,请使用 Microsoft 身份验证。

要求用户登录主题会自动触发与代理对话的任何用户,而无需进行身份验证。 如果用户登录失败,主题将重定向到升级系统主题。

此主题是只读的,无法自定义。 要查看,选择转到创作画布。

控制谁可以与在该组织内的代理聊天

你的代理认证类型和 “要求用户登录 ”设置的组合决定了你是否可以 共享代理 ,从而控制组织内谁可以与它聊天。 身份验证设置不会影响用于协作的代理共享。

  • 无身份验证:任何获得代理链接的用户(例如,在您的网站上)都可以与代理聊天。 您无法控制组织中的哪些用户可以与智能体聊天。

  • 通过 Microsoft 认证:该代理在 Teams、SharePoint、Power Apps 和 Microsoft Copilot 中使用 Microsoft Entra ID 认证。 用户已经登录了,所以你不需要设置 “要求用户单独登录 ”。 您可以使用智能体共享来控制组织中的哪些人可以与智能体聊天。

  • 手动身份验证:

    • 如果服务提供商是 Microsoft Entra ID,则可以打开 要求用户登录以控制组织中的谁可以使用代理共享与代理聊天。

    • 如果服务提供商是 通用OAuth 2,你可以选择“ 要求用户登录 ”或关闭“。 打开后,登录的用户可以与智能体聊天。 您无法使用智能体共享控制组织中的哪些特定用户可以与智能体聊天。

当智能体的身份验证设置不允许控制聊天权限时,若在智能体概览页面选择共享,系统将提示任何人都可与该智能体聊天。

手动身份验证字段

下表描述了配置手动身份验证时可能会遇到的字段。 具体显示的字段取决于您选择的服务提供商。

字段名称 Description
授权 URL 模板 用于授权的 URL 模板,由标识提供者定义。 例如: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
授权 URL 查询字符串模板 用于授权的查询模板,由您的标识提供者提供。 查询字符串模板里的密钥因身份提供者的不同而有所变化 (?client_id={ClientId}&response_type=code&redirect_uri={RedirectUrl}&scope={Scopes}&state={State})。
客户端 ID 从身份提供者获取的客户 ID。
客户端密码 您的客户端密码,在您创建标识提供者应用注册时获取。
客户端证书 KeyVault URL 存储客户端证书的 KeyVault 的 URL。 Microsoft Entra ID 证书认证必填项。
授予类型 你想用的OAuth 2.0资助类型。
是否需要声明 x5c 指定令牌请求中是否需要 x5c 声明。 Microsoft Entra ID 证书认证必填项。
登录链接 将用户定向到登录页面的 URL。
刷新正文模板 刷新正文 (refresh_token={RefreshToken}&redirect_uri={RedirectUrl}&grant_type=refresh_token&client_id={ClientId}&client_secret={ClientSecret}) 的模板。
刷新 URL 查询字符串模板 令牌 URL 的刷新 URL 查询字符串分隔符,通常为问号 (?)。
刷新 URL 模板 刷新的 URL 模板;例如,https://login.microsoftonline.com/common/oauth2/v2.0/token
资源 URL 请求令牌所需的资源 URL。
范围列表分隔符 范围列表的分隔字符。 此字段不支持空格。1
作用域 您希望用户在登录后获取的权限列表。 使用范围列表分隔符分隔多个范围。1只设置必要的范围,遵照最小特权访问控制原则。
服务提供商 您要用于身份验证的服务提供程序。 了解更多请访问 OAuth仿制药提供者。
租户 ID 您的 Microsoft Entra ID 租户 ID。 了解更多内容,请参阅“如何查找您的 Microsoft Entra 租户 ID”。
令牌正文模板 令牌主体模板。 (code={Code}&grant_type=authorization_code&redirect_uri={RedirectUrl}&client_id={ClientId}&client_secret={ClientSecret})
单点登录(SSO)所需的令牌交换 URL 配置单点登录时必须操作;否则为可选。
令牌 URL 模板 令牌的 URL 模板,由您的标识提供者提供;例如,https://login.microsoftonline.com/common/oauth2/v2.0/token。
令牌 URL 查询字符串模板 令牌 URL 的查询字符串分隔符,通常是问号 (?)。

1 如果身份提供者需要,您可以在Scopes字段中使用空格。 在这种情况下,在,中输入逗号 (),在范围字段中输入空格。

关闭身份验证

  1. 打开代理后,选择顶部菜单栏上的设置。

  2. 选择 “安全性”,然后选择“ 身份验证”。

  3. 选择无身份验证。

    如果主题使用身份验证变量,它们将成为 未知 变量。 转到主题页面,查看哪些主题有错误,并在发布前修复这些错误。

  4. 选择 保存,然后发布代理。

Important

如果你的代理设置了 需要用户凭证的工具,不要在代理层关闭认证。 此操作可防止这些工具正常工作。