Inscrire un bot sur Azure
S’APPLIQUE À : Kit de développement logiciel (SDK) v4
Si vous n’hébergez pas votre bot dans Azure, vous pouvez toujours le rendre disponible dans Azure et utiliser Azure pour connecter votre bot à des canaux. Pour ce faire, entrez dans l’adresse web Azure où votre bot est hébergé.
Cet article montre comment inscrire un tel bot auprès d’Azure Bot Service.
Important
Vous devez uniquement inscrire un bot s’il n’est pas hébergé dans Azure. Les bots créés à l’aide d’Azure CLI sont déjà inscrits auprès d’Azure Bot Service.
Votre identité de bot peut être gérée de différentes manières dans Azure.
- En tant qu’identité managée affectée par l’utilisateur, vous n’avez pas besoin de gérer les informations d’identification du bot vous-même.
- En tant qu’application monolocataire .
- En tant qu’application mutualisée .
La prise en charge de l’identité managée affectée par l’utilisateur et des types d’applications monolocataires a été ajoutée pour C# et JavaScript au Kit de développement logiciel (SDK) Bot Framework dans la version 4.15.0. Ces types d’application ne sont pas pris en charge dans les autres langues ou dans Bot Framework Composer, Bot Framework Emulator ou ngrok.
| Type d’application | Support |
|---|---|
| Identité managée affectée par l’utilisateur | Sdk Azure Bot Service et C# et JavaScript |
| Monolocataire | Sdk Azure Bot Service et C# et JavaScript |
| Multi-locataire | Azure Bot Service, tous les langages sdk Bot Framework, Composer, les Emulator et ngrok |
Cet article ne décrit pas comment créer ou déployer le bot à inscrire. Pour plus d'informations, consultez les pages suivantes :
Créer la ressource
Créez la ressource Azure Bot, qui vous permettra d’inscrire votre bot auprès d’Azure Bot Service.
Conseil
Les types de ressources Azure Web App Bot et Bot Channels Registration sont déconseillés. Les ressources configurées et déployées avant la dépréciation continuent de fonctionner. Les bots créés à partir d’un modèle VSIX ou Yeoman à partir du SDK version 4.14.1.2 ou ultérieure contiennent des modèles ARM qui généreront une ressource Azure Bot.
Accédez au portail Azure.
Dans le volet droit, sélectionnez Créer une ressource.
Dans la zone de recherche, appuyez
botsur Entrée.Sélectionnez la carte Azure Bot .
Sélectionnez Create (Créer).
Entrez des valeurs dans les champs requis. Choisissez le type d’application à créer et s’il faut utiliser des informations d’identité existantes ou créer de nouvelles informations d’identité.
Sélectionnez Revoir + créer.
Si la validation réussit, sélectionnez Créer.
Une fois le déploiement terminé, sélectionnez Accéder à la ressource. Vous devez voir le bot et les ressources associées répertoriées dans le groupe de ressources que vous avez sélectionné.
Si vous n’avez pas encore le Kit de développement logiciel (SDK) Bot Framework, sélectionnez Télécharger à partir de GitHub pour apprendre à utiliser les packages pour votre langue préférée.
Vous êtes maintenant prêt à créer votre bot avec le Kit de développement logiciel (SDK) Bot Framework.
Conseil
Quand Azure crée une ressource Azure Bot à locataire unique ou mutualisée avec un nouvel ID d’application, elle génère également un mot de passe.
Informations sur l’identité du bot
Suivez ces étapes pour ajouter des informations d’identité au fichier de configuration de votre bot. Le fichier diffère selon le langage de programmation que vous utilisez pour créer le bot.
Important
Les versions Java et Python du Kit de développement logiciel (SDK) Bot Framework prennent uniquement en charge les bots multilocataires. Les versions C# et JavaScript prennent en charge les trois types d’applications pour gérer l’identité du bot.
| Language | Nom de fichier | Notes |
|---|---|---|
| C# | appsettings.json | Prend en charge les trois types d’applications pour gérer l’identité de votre bot. |
| JavaScript | .env | Prend en charge les trois types d’applications pour gérer l’identité de votre bot. |
| Java | application.properties | Prend uniquement en charge les bots multilocataires. |
| Python | config.py | Prend uniquement en charge les bots multilocataires. Fournissez les propriétés d’identité en tant qu’arguments aux os.environ.get appels de méthode. |
Les informations d’identité que vous devez ajouter dépendent du type d’application du bot. Fournissez les valeurs suivantes dans votre fichier de configuration.
Disponible uniquement pour les bots C# et JavaScript.
| Propriété | Valeur |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
ID client de l’identité managée affectée par l’utilisateur. |
MicrosoftAppPassword |
Non applicable. Laissez cette valeur vide pour un bot d’identité managée affectée par l’utilisateur. |
MicrosoftAppTenantId |
ID de locataire de l’identité managée affectée par l’utilisateur. |
Si vous disposez d’une ressource d’application web existante pour votre bot et que votre bot est une application d’identité managée affectée par l’utilisateur , vous devrez peut-être mettre à jour l’application web de votre bot :
- Accédez au panneau App Service pour l’application web de votre bot.
- Sous Paramètres, sélectionnez Identité.
- Dans le panneau Identité , sélectionnez l’onglet Utilisateur affecté et Ajoutez (+).
- Dans le panneau Ajouter une identité managée affectée par l’utilisateur :
Sélectionnez votre abonnement.
Pour les identités managées affectées par l’utilisateur, sélectionnez l’identité managée pour votre bot. Si l’identité managée a été générée automatiquement pour vous, elle aura le même nom que votre bot.
Sélectionnez Ajouter pour utiliser cette identité pour votre bot.
Pour obtenir l’id d’application ou de locataire de votre bot :
- Accédez au panneau de ressources Azure Bot pour votre bot.
- Accédez au panneau Configuration du bot. Dans ce panneau, vous pouvez copier l’ID d’application Microsoft du bot ou l’ID de locataire d’application.
Les bots à locataire unique et multilocataire ont un secret d’application ou un mot de passe dont vous avez besoin pour certaines opérations. Azure Bot Service masque votre secret de bot. Toutefois, le propriétaire de la ressource d’application web du bot peut générer un nouveau mot de passe :
- Accédez au panneau de ressources Azure Bot pour votre bot.
- Accédez au panneau Configuration du bot.
- Sélectionnez Gérer, en regard de l’ID d’application Microsoft, pour accéder au panneau Certificats + secrets de l’application web.
- Suivez les instructions du panneau pour créer une clé secrète client et enregistrer la valeur dans un endroit sûr.
Inscription manuelle de l’application
Une inscription manuelle est nécessaire lorsque :
- Vous ne parvenez pas à effectuer les inscriptions dans votre organisation et avez besoin d’une autre partie pour créer l’ID d’application pour le bot que vous créez.
- Vous devez créer manuellement votre propre ID d’application et votre mot de passe.
Mettre à jour le bot
Pour mettre à jour le fichier de configuration de votre bot afin d’inclure son ID d’application et son mot de passe, consultez l’ID d’application et le mot de passe dans la procédure de configuration des paramètres d’inscription de bot.
Informations supplémentaires
Consultez ces articles pour plus d’informations sur les applications Azure en général.
| Objet | Article |
|---|---|
| Inscription d'application | Démarrage rapide : Inscrire une application à l’aide de la plateforme d’identités Microsoft |
| Identités managées | Que sont les identités managées pour les ressources Azure ? |
| Application monolocataire et application multilocataire | Locataires dans Azure Active Directory |