Configurar um bot no Microsoft Azure operado pela 21Vianet

Artigo
09/26/2024

Este guia ajuda os clientes do Microsoft Azure a implantar bots do Bot Framework e do Azure AI Bot Service na plataforma do Microsoft Azure operada pela 21Vianet.

Pré-requisitos

Uma conta no Microsoft Azure.
O projeto de bot C# ou JavaScript que você deseja configurar.
SDK do Bot Framework versão 4.14 ou posterior.

Use o adaptador de nuvem

Verifique se o bot usa o adaptador de nuvem ou um adaptador derivado do adaptador de nuvem. O adaptador de nuvem permite especificar configurações específicas para a nuvem do Microsoft Azure.

C#
JavaScript

A classe ConfigurationBotFrameworkAuthentication lê as configurações de autenticação do arquivo de configuração do bot. Após a criação, o adaptador de nuvem utiliza essas configurações de autenticação.

Certifique-se de que o método ConfigureServices no arquivo Startup.cs contenha essa linha.

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

O construtor ConfigurationBotFrameworkAuthentication lê as configurações de autenticação do arquivo de configuração do bot.

No arquivo index.js, o código para criar o adaptador deve ter a seguinte aparência:

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

Configurar o bot UserAssignedMSI/SingleTenant

Para garantir que o bot funcione corretamente na nuvem do Microsoft Azure, são necessárias configurações de autenticação extras. Substitua a "ID do Locatário do Aplicativo" pela ID do locatário do bot.

C#
JavaScript

Adicione as configurações a seguir ao arquivo 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

Adicione as configurações a seguir ao arquivo .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

Configurar o bot multilocatário

Para o bot multilocatário, use as configurações a seguir.

C#
JavaScript

Adicione as configurações a seguir ao arquivo 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

Adicione as configurações a seguir ao arquivo .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

Adicionar autenticação de usuário ao seu bot

Seu bot pode usar vários provedores de identidade para acessar recursos em nome de um usuário, como o Microsoft Entra ID e muitos outros provedores OAuth.

A nuvem do Microsoft Azure usa uma URL de redirecionamento diferente das usadas para outros ambientes. Para configurar seu bot para autenticação, use https://token.botframework.azure.cn/.auth/web/redirect como a URL de redirecionamento OAuth e siga as etapas em como adicionar autenticação ao bot.

Configurar um bot para execução em um ou mais canais

Para configurar um bot para se conectar a um canal, conclua as seguintes etapas:

Entre no portal do Azure.
Selecione o bot que você deseja configurar.
No painel à esquerda, em Configurações, selecione Canais.
No painel à direita, selecione o ícone do canal que deseja adicionar ao seu bot. Talvez seja necessário rolar para baixo para ver a lista de todos os canais disponíveis. As etapas de conexão variam para cada canal. Para obter mais informações sobre os canais compatíveis, consulte os artigos relacionados.

Canal	Descrição
Direct Line	Integre um bot a um aplicativo móvel, página da Web ou outros aplicativos.
Equipes da Microsoft	Configure um bot para se comunicar com os usuários por meio do Microsoft Teams.
Web Chat	Configurado automaticamente para ser usado quando você criar um bot com o Bot Framework Service.

Próximas etapas

Com essas etapas, seu bot deve ser configurado para funcionar com êxito. Outras referências úteis sobre o Bot Service.

Compartilhar via