Configurer un bot dans Microsoft Azure géré par 21Vianet

Article
09/26/2024

Ce guide aide les clients Microsoft Azure à déployer Bot Framework et les bots Azure AI Bot Service sur la plateforme Microsoft Azure gérée par 21Vianet.

Prérequis

Un compte dans Microsoft Azure.
Projet de bot C# ou JavaScript que vous souhaitez configurer.
SDK Bot Framework version 4.14 ou ultérieure.

Utiliser l’adaptateur cloud

Assurez-vous que votre bot utilise l’adaptateur cloud ou un adaptateur dérivé de l’adaptateur cloud. L’adaptateur cloud vous permet de spécifier des paramètres spécifiques au cloud Microsoft Azure.

C#
JavaScript

La classe ConfigurationBotFrameworkAuthentication lit les paramètres d’authentification à partir de votre fichier de configuration de bot. Lors de la création, l’adaptateur cloud utilise ces paramètres d’authentification.

Assurez-vous que la méthode ConfigureServices dans votre fichier Startup.cs contient cette ligne.

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

Le constructeur ConfigurationBotFrameworkAuthentication lit les paramètres d’authentification à partir de votre fichier de configuration de bot.

Dans votre fichier index.js, le code pour créer votre adaptateur doit ressembler à ceci :

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

Configurer UserAssignedMSI/SingleTenant Bot

Pour garantir que le bot fonctionne correctement dans le cloud Microsoft Azure, des paramètres d’authentification supplémentaires sont nécessaires. Remplacez « App-Tenant-ID » par l’ID de locataire du bot.

C#
JavaScript

Ajoutez les paramètres suivants à votre fichier 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

Ajoutez les paramètres suivants à votre fichier .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

Configurer le bot MultiTenant

Pour le bot multilocataire, utilisez les paramètres suivants.

C#
JavaScript

Ajoutez les paramètres suivants à votre fichier 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

Ajoutez les paramètres suivants à votre fichier .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

Ajouter l’authentification utilisateur à votre bot

Votre bot peut utiliser différents fournisseurs d’identité pour accéder aux ressources pour le compte d’un utilisateur, comme Microsoft Entra ID et de nombreux autres fournisseurs OAuth.

Microsoft Azure Cloud utilise une URL de redirection différente de celle utilisée pour d’autres environnements. Pour configurer votre bot pour l’authentification, utilisez https://token.botframework.azure.cn/.auth/web/redirect l’URL de redirection OAuth et suivez les étapes de l’ajout de l’authentification à votre bot.

Configurer un bot pour qu'il s'exécute sur un ou plusieurs canaux

Pour configurer un bot afin de le connecter à un canal, procédez comme suit :

Connectez-vous au portail Azure.
Sélectionnez le bot à configurer.
Dans le volet de gauche, sous Paramètres, sélectionnez Canaux.
Dans le volet de droite, sélectionnez l’icône du canal que vous souhaitez ajouter à votre bot. Vous devrez peut-être faire défiler vers le bas pour afficher la liste de tous les canaux disponibles. Les étapes de connexion varient pour chaque canal. Pour plus d’informations sur les canaux pris en charge, consultez les articles connexes.

Canal	Description
Direct Line	Intégrez un bot à une application mobile, à une page Web ou à d’autres applications.
Microsoft Teams	Configurez un bot pour communiquer avec des utilisateurs via Microsoft Teams.
Chat Web	Configuré automatiquement pour vous lorsque vous créez un bot avec Bot Framework Service.

Étapes suivantes

Avec ces étapes, votre bot doit être configuré pour fonctionner correctement. Autres références utiles concernant Bot Service.

Partager via