Web 和 Direct Line 频道安全控制客户端是否必须提供 Direct Line 密钥或令牌才能连接到您的 Copilot Studio 代理。 如果没有安全访问权限,任何知道智能体 ID 的人都可以通过演示网站和自定义网站渠道进行连接。
Note
在仅限Teams的体验中,你无法生成秘密。 安全访问令牌是自动创建的,且默认开启了安全访问。 有关许可要求,请参阅 Microsoft 产品条款。
开启“要求安全访问”,要求客户端提供密钥或令牌。 这些凭证授权访问Direct Line频道;它们本身不认证终端用户,也不限制访问特定网站。 当用户需要登录时,应单独配置 用户认证 。
你可以更换和重新生成密钥、刷新令牌,或者在不再需要时关闭安全访问。
Copilot Studio 使用 Bot Framework Direct Line 通道将网页或应用连接到代理。
启用或禁用 Web 通道安全
您可以强制对每个单独智能体使用机密和令牌。
启用此选项时,通道需要客户端 使用机密 或使用在运行时获取的 机密生成的令牌对请求进行身份验证。
尝试访问不提供此安全措施的代理不起作用。
转到代理的 “设置” 页,选择“ 安全性”,然后选择 “Web 通道安全性”。
启用 “需要安全访问”。
Warning
当你开启或关闭 “需要安全访问”时,新的系统设置可能需要长达两小时才能生效。 在此之前,上一个设置生效。 您不需要发布智能体来让此更改生效。
提前计划以避免无意中公开代理人。
要关闭网络通道安全,请关闭 “要求安全访问” 并确认更改。 变更最多可能需要两小时才能生效。
使用机密或令牌
对于服务到服务应用,请在你的服务发出的请求的授权标头中指定密钥。
如果编写的应用是客户端在 Web 浏览器或移动应用中运行,否则可能会对客户显示代码,则必须将机密更换为令牌。 如果不使用令牌,可能会泄露机密。 在你的服务中发起获取令牌的请求时,请在授权标头中指定机密。
令牌仅对单个对话有效,如果不刷新,则会到期。
选择最适合您的情况的安全模型。
Warning
请勿在浏览器中运行的任何代码中公开机密,无论是硬编码还是通过网络调用传输。
使用服务代码中的机密获取令牌是保护Copilot Studio代理的最安全方法。
获取机密
您需要机密,因此可以在应用的授权标头之类中指定。
在导航菜单中的设置下面,选择安全性。 然后选择“Web 通道安全”磁贴。
为机密 1或机密 2选择复制,将其复制到剪贴板中。 要显示密钥,请选择可见性图标并查看警告提示。
交换密钥
如果需要更改代理使用的机密,可以在不停机或中断的情况下对其进行更改。
Copilot Studio 提供两个密钥,它们可以同时运行。 可以将代理使用的密钥替换为另一个密钥。 交换机密并且用户都使用新机密进行连接后,可以重新生成机密。
重新生成密钥
若要重新生成密钥,请选择密钥旁边的重新生成。
Warning
使用原始机密或从该机密获取的令牌的用户配置文件都将断开。
生成令牌
你可以生成一个令牌来发起单一客服对话。 此流程将 Direct Line 密钥与服务代码中的对话令牌进行交换。 关于Copilot Studio令牌端点选项,请参见Get Direct Line令牌。
示例生成令牌请求
POST https://directline.botframework.com/v3/directline/tokens/generate
Authorization: Bearer <DirectLineSecret>
示例生成令牌响应
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "<DirectLineToken>",
"expires_in": 1800
}
如果请求成功,响应中将包含一个仅在本次对话中有效的令牌,以及一个 expires_in 值,该值表示令牌过期前的剩余秒数。
若要使令牌有用,必须在令牌过期之前 刷新令牌 。
刷新令牌
只要令牌未过期,就可以无限次刷新令牌。
无法刷新过期的令牌。
发送 样本刷新请求。 用 <DirectLineToken> 替换你想要刷新的未过期令牌。 用对话令牌,而不是 Direct Line 密钥。
示例刷新请求
POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer <DirectLineToken>
示例刷新响应
如果请求成功,响应中将包含一个对之前令牌的同一个对话有效的新令牌和一个指示新令牌还有多少秒将到期的 expires_in 值。
若要使新令牌很有用,请在令牌过期之前再次刷新令牌。
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "<DirectLineToken>",
"expires_in": 1800
}
更多详情请参阅刷新 Direct Line 令牌。