Настройка бота в Microsoft Azure под управлением 21Vianet

Это руководство помогает клиентам Microsoft Azure развертывать боты Bot Framework и Azure AI Служба Bot на платформе Microsoft Azure, работающей под управлением 21Vianet.

Необходимые компоненты

  • Учетная запись в Microsoft Azure.
  • Проект бота C# или JavaScript, который вы хотите настроить.
  • Пакет SDK Bot Framework версии 4.14 или более поздней версии.

Использование облачного адаптера

Убедитесь, что бот использует облачный адаптер или адаптер, производный от облачного адаптера. Облачный адаптер позволяет указать параметры, относящиеся к Microsoft Azure Cloud.

Класс ConfigurationBotFrameworkAuthentication считывает параметры проверки подлинности из файла конфигурации бота. После создания адаптер облака использует эти параметры проверки подлинности.

Убедитесь, что ConfigureServices метод в файле Startup.cs содержит эту строку.

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

Настройка UserAssignedMSI/SingleTenant Bot

Чтобы обеспечить правильность работы бота в облаке Microsoft Azure, необходимы дополнительные параметры проверки подлинности. Замените "App-Tenant-ID" идентификатором клиента бота.

Добавьте следующие параметры в файл appsettings.json .

"OAuthUrl": "https://token.botframework.azure.cn/", 
"ToChannelFromBotLoginUrl": "https://login.partner.microsoftonline.cn/<App-Tenant-ID>",
"ToChannelFromBotOAuthScope": "https://api.botframework.azure.cn",
"ToBotFromChannelTokenIssuer": "https://api.botframework.azure.cn",
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.cn/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true

Настройка мультитенантного бота

Для мультитенантного бота используйте следующие параметры.

Это важно

  • Создание многотенантного бота будет прекращено после 31 июля 2025 г.
  • Существующие многотенантные боты будут продолжать функционировать, но создание нового мультитенантного бота больше не будет поддерживаться после этой даты.
  • Чтобы обеспечить постоянную поддержку, используйте одноарендное или управляемое удостоверение, назначенное пользователем.

Добавьте следующие параметры в файл appsettings.json .

"OAuthUrl": "https://token.botframework.azure.cn/", 
"ToChannelFromBotLoginUrl": "https://login.partner.microsoftonline.cn/microsoftservices.partner.onmschina.cn",
"ToChannelFromBotOAuthScope": "https://api.botframework.azure.cn",
"ToBotFromChannelTokenIssuer": "https://api.botframework.azure.cn",
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.cn/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true

Добавление проверки подлинности пользователей в бот

Бот может использовать различные поставщики удостоверений для доступа к ресурсам от имени пользователя, например идентификатора Microsoft Entra и многих других поставщиков OAuth.

Microsoft Azure Cloud использует URL-адрес перенаправления, отличный от тех, которые используются для других сред. Чтобы настроить бот для проверки подлинности, используйте https://token.botframework.azure.cn/.auth/web/redirect в качестве URL-адреса перенаправления OAuth и выполните действия, описанные в том, как добавить проверку подлинности в бот.

Настройка бота для запуска в одном или нескольких каналах

Чтобы настроить бот для подключения к каналу, выполните следующие действия.

  1. Войдите на портал Azure.
  2. Выберите бот, который требуется настроить.
  3. В области слева выберите каналы в разделе "Параметры".
  4. В правой области выберите значок канала, который вы хотите добавить в бот. Чтобы просмотреть список всех доступных каналов, может потребоваться прокрутить вниз. Шаги подключения зависят от каждого канала. Дополнительные сведения о поддерживаемых каналах см. в связанных статьях.
Канал Описание
Прямая линия Интеграция бота в мобильное приложение, веб-страницу или другие приложения.
Microsoft Teams Настройте бота для взаимодействия с пользователями через Microsoft Teams.
Веб-чат Автоматически настраивается при создании бота со службой Bot Framework.

Следующие шаги

С помощью этих действий бот должен быть настроен для успешной работы. Другие полезные ссылки на Служба Bot.

  • Last updated on