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

Статья
09/26/2024

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

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

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

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

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

C#
JavaScript

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

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

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

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

В файле index.js код для создания адаптера должен выглядеть следующим образом:

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

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

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

C#
JavaScript

Добавьте следующие параметры в файл 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

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

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

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

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

C#
JavaScript

Добавьте следующие параметры в файл 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

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

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 и выполните действия, описанные в том, как добавить проверку подлинности в бот.

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

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

Войдите на портал Azure.
Выберите бот, который требуется настроить.
В области слева выберите каналы в разделе "Параметры".
В правой области выберите значок канала, который вы хотите добавить в бот. Чтобы просмотреть список всех доступных каналов, может потребоваться прокрутить вниз. Шаги подключения зависят от каждого канала. Дополнительные сведения о поддерживаемых каналах см. в связанных статьях.

Канал	Description
Direct Line	Интеграция бота в мобильное приложение, веб-страницу или другие приложения.
Microsoft Teams	Настройте бота для взаимодействия с пользователями через Microsoft Teams.
Веб-чат	Автоматически настраивается при создании бота со службой Bot Framework.

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

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

Поделиться через