Регистрация бота в Azure
ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4
Если вы в настоящее время не размещаете бота в Azure, вы по-прежнему можете сделать его доступным в Azure и использовать Azure для подключения бота к каналам. Для этого введите в Azure веб-адрес, в котором размещен бот.
В этой статье показано, как зарегистрировать такого бота в Служба Bot Azure AI.
Важно!
Необходимо зарегистрировать бот только в том случае, если он не размещен в Azure. Боты, созданные с помощью Azure CLI, уже зарегистрированы в Служба Bot Azure AI.
Удостоверение бота можно управлять в Azure несколькими способами.
- В качестве управляемого удостоверения, назначаемого пользователем, поэтому вам не нужно самостоятельно управлять учетными данными бота.
- Как однотенантное приложение.
- В качестве мультитенантного приложения.
Поддержка управляемого удостоверения, назначаемого пользователем, и типов приложений с одним клиентом была добавлена в пакет SDK Bot Framework для C# и JavaScript версии 4.15.0. Эти типы приложений не поддерживаются на других языках или в Bot Framework Composer, эмуляторе Bot Framework или ngrok.
| Тип приложения | Поддержка |
|---|---|
| Управляемое удостоверение, назначаемое пользователем | Служба Bot ИИ Azure и пакеты SDK для JavaScript и C# |
| Один клиент | Служба Bot ИИ Azure и пакеты SDK для JavaScript и C# |
| Несколько клиентов | Azure AI Служба Bot, все языки пакета SDK Bot Framework, Composer, эмулятор и ngrok |
В этой статье не описывается создание или развертывание бота для регистрации. Дополнительные сведения см. в разделе:
- Краткое руководство по созданию бота
- Руководство по развертыванию базового бота
Создание ресурса
Создайте ресурс Azure Bot, который позволит зарегистрировать бота в Служба Bot Azure AI.
Совет
Новые ресурсы регистрации каналов веб-приложения ибота не могут быть созданы. Однако все существующие ресурсы, настроенные и развернутые, будут продолжать работать. Боты, созданные из шаблона VSIX или Yeoman из пакета SDK версии 4.14.1.2 или более поздней, содержат шаблоны ARM, которые будут создавать ресурс Azure Bot.
Переход на портал Azure.
В правой области выберите "Создать ресурс".
В поле поиска введите
bot, а затем нажмите клавишу ВВОД.Выберите карта Azure Bot.
Нажмите кнопку создания.
Введите значения в обязательных полях и проверьте и обновите параметры.
Укажите сведения в разделе "Сведения о проекте". Выберите, будет ли бот иметь глобальное или локальное расположение данных. В настоящее время функция расположения локальных данных доступна для ресурсов в регионе "westeurope" и "centralindia". Дополнительные сведения см. в разделе "Регионизация" в azure AI Служба Bot.
Укажите сведения в разделе идентификатора приложения Майкрософт. Выберите способ управления удостоверением бота в Azure и создание нового удостоверения или использование существующего.
Выберите Review + create (Просмотреть и создать).
Если проверка проходит, нажмите кнопку "Создать".
После завершения развертывания выберите "Перейти к ресурсу". Вы увидите бота и связанные ресурсы, перечисленные в выбранной группе ресурсов.
Если у вас еще нет пакета SDK Bot Framework, выберите "Скачать" из GitHub , чтобы узнать, как использовать пакеты для предпочитаемого языка.
Теперь вы готовы к созданию бота с помощью пакета SDK Bot Framework.
Совет
При создании ресурса Azure с одним клиентом или несколькими клиентами Azure Bot с новым идентификатором приложения он также создает пароль.
Сведения об удостоверениях бота
Выполните следующие действия, чтобы добавить сведения об удостоверениях в файл конфигурации бота. Файл отличается в зависимости от языка программирования, используемого для создания бота.
Важно!
Версии пакета SDK Bot Framework для Java и Python поддерживают только многотенантные боты. Версии C# и JavaScript поддерживают все три типа приложений для управления удостоверением бота.
| Язык | Имя файла | Примечания. |
|---|---|---|
| C# | appsettings.json | Поддерживает все три типа приложений для управления удостоверениями бота. |
| JavaScript | env. | Поддерживает все три типа приложений для управления удостоверениями бота. |
| Java | application.properties | Поддерживает только многотенантные боты. |
| Python | config.py | Поддерживает только многотенантные боты. Укажите свойства удостоверения в качестве аргументов для вызовов os.environ.get метода. |
Сведения об удостоверениях, которые необходимо добавить, зависят от типа приложения бота. Укажите следующие значения в файле конфигурации.
Доступно только для ботов C# и JavaScript.
| Свойство | Значение |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
Идентификатор клиента управляемого удостоверения, назначаемого пользователем. |
MicrosoftAppPassword |
Неприменимо. Оставьте это пустым для бота управляемого удостоверения, назначаемого пользователем. |
MicrosoftAppTenantId |
Идентификатор клиента управляемого удостоверения, назначаемого пользователем. |
Обновление службы приложений
Если у вас есть существующий ресурс Служба приложений (веб-приложение) для бота, а бот — это приложение управляемого удостоверения, назначаемое пользователем, может потребоваться обновить службу приложений бота:
- Перейдите в колонку Служба приложений для веб-приложения бота.
- В разделе Параметры выберите пункт Удостоверение.
- В колонке "Удостоверение" выберите вкладку "Назначаемый пользователем" и "Добавить " (+).
- В колонке "Добавление назначаемого пользователем управляемого удостоверения ":
Выберите свою подписку.
Для управляемых удостоверений, назначенных пользователем, выберите управляемое удостоверение для бота. Если управляемое удостоверение было автоматически создано для вас, оно будет иметь то же имя, что и бот.
Выберите "Добавить ", чтобы использовать это удостоверение для бота.
Получение идентификатора приложения или клиента
Чтобы получить идентификатор приложения или клиента бота:
- Перейдите в колонку ресурсов Azure Bot для бота.
- Перейдите в колонку конфигурации бота. В этой колонке можно скопировать идентификатор приложения Майкрософт или идентификатор клиента приложения бота.
Создание нового пароля
Боты с одним клиентом и несколькими клиентами имеют секрет приложения или пароль, необходимый для некоторых операций. Azure AI Служба Bot скрывает секрет бота. Однако владелец ресурса Служба приложений бота может создать новый пароль:
- Перейдите в колонку ресурсов Azure Bot для бота.
- Перейдите в колонку конфигурации бота.
- Выберите "Управление", рядом с идентификатором приложения Майкрософт, чтобы перейти в колонку "Сертификаты и секреты " для службы приложений.
- Следуйте инструкциям в колонке, чтобы создать новый секрет клиента и записать значение в безопасном месте.
Регистрация приложений вручную
Регистрация вручную необходима, если:
- Вы не можете сделать регистрацию в вашей организации и требуется другая сторона, чтобы создать идентификатор приложения для создаваемого бота.
- Необходимо вручную создать собственный идентификатор приложения и пароль.
Обновление бота
Чтобы обновить файл конфигурации бота, чтобы включить его идентификатор приложения и пароль, ознакомьтесь с идентификатором приложения и паролем в настройке параметров регистрации бота.
Дополнительная информация:
Дополнительные сведения о приложениях Azure см. в этих статьях.
| Тема | Статья |
|---|---|
| Регистрация приложения | Краткое описание: регистрация приложения на платформе Microsoft Identity |
| Управляемые удостоверения | Что такое управляемые удостоверения для ресурсов Azure? |
| Однотенантные и мультитенантные приложения | Арендочность в идентификаторе Microsoft Entra |