您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

使用 Azure 注册机器人

适用于: SDK v4

本文介绍如何在 azure 中开发和托管机器人服务时向其注册一个机器人。

如果机器人托管在其他位置,还可以将其提供给 Azure,并将其连接到支持的通道。 提供托管机器人的 web 地址。

重要

只需注册一个机器人(如果它未托管在 Azure 中)。 使用 Azure 门户或命令行接口创建的 bot (CLI) 已注册到 Azure 机器人服务。 有关详细信息,请参阅 部署机器人

创建资源

创建 Azure 机器人 资源,使你能够向 Azure bot 服务注册你的机器人。

警告

Web 应用机器人****和机器人 通道注册将被弃用,但现有资源将继续工作。 应改为使用 Azure 机器人

  1. 转到 Azure 门户

  2. 在右侧窗格中,选择 " 创建资源"。

  3. 在搜索框中,输入 机器人,然后按 enter

  4. 选择 Azure 机器人 卡。

    选择 Azure 机器人资源

  5. 选择“创建”。

    创建 Azure 机器人资源

  6. 输入所需的值。 下图显示了 " 创建新的 Microsoft 应用 ID "。

    创建 Azure bot 资源值

    还可以选择 " 使用现有应用注册 " 并输入现有 应用 Id密码

    创建 Azure bot 资源现有值

  7. 选择“查看 + 创建”。

  8. 如果验证通过,请选择 " 创建"。

  9. 选择“转到资源组”。 应会看到机器人以及所选资源组中列出的相关 Azure Key Vault 资源。

    提示

    (密码) 的应用密钥存储在密钥保管库中,并且每个资源组都有一个密钥保管库。 建议使用 key vault,而不是复制和存储敏感数据。

  10. 选择 " 从 Github 获取 SDK" ,以通过 BOT Framework SDK 生成机器人。

    在 SDK 中创建机器人

Azure Key Vault

当 Azure 创建 Azure 机器人资源时,它还会生成一个 应用 Id 和一个 密码 ,并将该密码存储在 Azure Key Vault 中。

Key Vault 是一种提供集中式机密管理的服务,可以完全控制访问策略和审核历史记录。 有关详细信息,请参阅 为应用服务和 Azure Functions 使用 Key Vault 引用。 请注意,使用该服务需要支付少量费用。 有关详细信息,请参阅 Key Vault 定价

应用 ID 和密码

需要 Azure 机器人资源 应用 ID 和****密码 才能配置机器人进行部署。 将其值分配给机器人项目配置文件中包含的相关变量: 和 MicrosoftAppId MicrosoftAppPassword 。 文件因创建机器人时使用的编程语言不同而不同,如下所示。

该文件 appsettings.json 包含以下设置:

{
  "MicrosoftAppId": "<your app id>",
  "MicrosoftAppPassword": "<your password>"
}

获取 Azure 机器人资源应用 ID

  1. 转到 Azure 门户
  2. 选择 Azure 机器人资源以获取其应用 ID。
  3. 在左窗格中的"配置设置, 选择"配置"。
  4. 复制并保存"Microsoft 应用 ID"框中 包含的值。

从门户获取 Azure 机器人资源Azure Key Vault

Azure 创建 Azure 机器人资源时,它会将应用密码存储在 Azure Key Vault。 若要了解如何访问密钥保管库以获取密码,请参阅:

手动应用注册

对于下面这样的情况,需手动注册:

  • 你无法在组织中注册,需要另一方为你正在构建的机器人创建应用 ID。
  • 需要手动创建自己的应用 ID 和密码。

重要

创建应用时,在 " 支持帐户类型" 部分中,选择以下多租户类型选项之一:

类型 说明
任何组织目录中的帐户 (任何 Azure AD 多租户) 此选项通过限制访问而不受支持,因此不受支持。
任何组织目录中的帐户 (任何 Azure AD 多租户) 和个人 Microsoft 帐户 (例如,Xbox、Outlook.com) 此选项非常适用于支持 OAuth 和机器人身份验证。

有关详细信息,请参阅将应用程序注册到 Microsoft 标识平台

更新机器人

在文件中设置以下键值 appsettings.json

  • MicrosoftAppId = <appId>
  • MicrosoftAppPassword = <appSecret>

后续步骤