Configuración de un bot en Microsoft Azure operado por 21Vianet

Artículo
09/26/2024

Esta guía ayuda a los clientes de Microsoft Azure a implementar bots de Bot Framework y Azure AI Bot Service en la plataforma de Microsoft Azure operada por 21Vianet.

Requisitos previos

Una cuenta en Microsoft Azure.
El proyecto de bot de C# o JavaScript que desea configurar.
Bot Framework SDK versión 4.14 o posterior.

Uso del adaptador para la nube

Asegúrese de que el bot utiliza el adaptador para la nube o un adaptador que deriva del adaptador para la nube. El adaptador de nube le permite especificar la configuración específica de la nube de Microsoft Azure.

C#
JavaScript

La clase ConfigurationBotFrameworkAuthentication lee la configuración de autenticación del archivo de configuración del bot. Tras la creación, el adaptador de nube utiliza esta configuración de autenticación.

Asegúrese de que el método ConfigureServices del archivo Startup.cs contiene esta línea.

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

El constructor ConfigurationBotFrameworkAuthentication lee la configuración de autenticación del archivo de configuración del bot.

En el archivo index.js, el código para crear el adaptador debe tener este aspecto:

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

Configuración del bot UserAssignedMSI/SingleTenant

Para asegurarse de que el bot funciona correctamente en la nube de Microsoft Azure, se necesitan opciones de autenticación adicionales. Reemplace "App-Tenant-ID" por el identificador de inquilino del bot.

C#
JavaScript

Agregue la configuración siguiente al archivo 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

Añada la configuración siguiente al archivo .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

Configuración del bot multiinquilino

Para el bot multiinquilino, use la siguiente configuración.

C#
JavaScript

Agregue la configuración siguiente al archivo 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

Añada la configuración siguiente al archivo .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

Adición de autenticación del usuario al bot

El bot puede utilizar varios proveedores de identidades para acceder a los recursos en nombre de un usuario, como Microsoft Entra ID y muchos otros proveedores de OAuth.

La nube de Microsoft Azure usa una dirección URL de redireccionamiento diferente de las usadas para otros entornos. Para configurar el bot para la autenticación, use https://token.botframework.azure.cn/.auth/web/redirect como dirección URL de redireccionamiento de OAuth y siga los pasos descritos en cómo agregar autenticación al bot.

Configuración de un bot para ejecutarlo en uno o más canales

Para configurar el bot para que se conecte a un canal, siga los pasos siguientes:

Inicie sesión en Azure Portal.
Seleccione el bot que quiera configurar.
En el panel izquierdo, seleccione Canales en Configuración.
En el panel derecho, haga clic en el icono del canal que desea agregar al bot. Es posible que tenga que desplazarse hacia abajo para ver la lista de todos los Canales disponibles. Los pasos de conexión varían para cada canal. Para obtener más información sobre los canales admitidos, consulte los artículos relacionados.

Canal	Descripción
Direct Line	Integre un bot en una aplicación móvil, una página web u otras aplicaciones.
Microsoft Teams	Configure el bot para que se comunique con los usuarios a través de Microsoft Teams.
Chat en web	Se configura automáticamente al crear un bot con Bot Framework Service.

Pasos siguientes

Con estos pasos, el bot debe configurarse para que funcione correctamente. Otras referencias útiles relacionadas con Bot Service.

Compartir a través de