Bot Framework SDK Python应用：MultiTenant正常，UserAssignedMSI连接失败

问题概述 #

我用Bot Framework SDK开发了Python机器人，部署在Azure Web App上，通过Azure Bot Service连接。当MicrosoftAppType设为MultiTenant时，Azure Web Chat测试功能可正常使用，但切换为UserAssignedMSI后，Web Chat无法连接机器人，且无详细错误信息。已在Azure Web App的标识部分添加用户标识，UserAssignedMSI在Azure中配置正确，且因特定要求无法使用MultiTenant或SingleTenant。

可能原因 #

• 缺少UserAssignedMSI专属的配置参数
• Azure Bot Service与Web App的UserAssignedMSI之间权限关联缺失
• Bot Framework SDK的MSI认证逻辑未正确加载UserAssignedMSI的标识信息
• Web App的环境变量配置不完整

修复步骤 #

1. 补充UserAssignedMSI专属配置参数 #

在config.py中，除设置MicrosoftAppType="UserAssignedMSI"外，必须添加以下关键配置：

MicrosoftAppId = "<你的UserAssignedMSI的Client ID>"
MicrosoftTenantId = "<你的Azure租户ID>"
UserAssignedMSIClientId = "<你的UserAssignedMSI的Client ID>"

注意：MicrosoftAppId和UserAssignedMSIClientId都要填写UserAssignedMSI的Client ID，这是SDK识别UserAssignedMSI的核心依据。

2. 配置Azure Bot Service对UserAssignedMSI的权限 #

• 进入Azure Bot Service的「权限」页面，点击「添加角色分配」：
  • 角色选择「Bot Contributor」或「Bot Creator」
  • 分配对象类型选择「托管标识」，然后选中你的UserAssignedMSI资源
• 确保UserAssignedMSI拥有对Azure Bot Service的Microsoft.BotServices/bots/read和Microsoft.BotServices/bots/write权限

3. 验证Web App的MSI令牌获取能力 #

在app.py中添加调试代码，确认Web App能正确获取UserAssignedMSI的令牌：

from azure.identity import DefaultAzureCredential
import os

# 加载环境变量中的UserAssignedMSI Client ID
msi_client_id = os.getenv("UserAssignedMSIClientId")
credential = DefaultAzureCredential(managed_identity_client_id=msi_client_id)

try:
    # 请求Bot Framework API的令牌
    token = credential.get_token("https://api.botframework.com/.default")
    print(f"MSI令牌获取成功，令牌前缀: {token.token[:10]}...")
except Exception as e:
    print(f"MSI令牌获取失败: {str(e)}")

部署后查看Web App的应用日志，若令牌获取失败，需检查Web App的UserAssignedMSI是否已正确关联，以及网络是否允许访问Azure AD的令牌端点。

4. 更新Bot Framework SDK及依赖包 #

旧版本的Bot Framework SDK可能存在UserAssignedMSI认证的兼容性问题，执行以下命令升级相关包：

pip install --upgrade botbuilder-core botbuilder-integration-aiohttp azure-identity

替代方案 #

若上述步骤仍无法解决问题，可尝试以下方案：

• 将机器人托管到Azure Functions，Azure Functions对UserAssignedMSI的集成支持更成熟
• 临时使用Service Principal替代UserAssignedMSI（需确认符合你的特定要求）

内容的提问来源于stack exchange，提问作者RushikeshB