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 au Kit de développement logiciel (SDK) Bot Framework pour C# et JavaScript 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, l’émulateur 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

Vous ne pouvez pas créer de ressources d’inscription de bots et de canaux d’application web; toutefois, toutes ces ressources existantes configurées et déployées 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.

  1. Accédez au portail Azure.

  2. Dans le volet droit, sélectionnez Créer une ressource.

  3. Dans la zone de recherche, appuyez botsur Entrée.

  4. Sélectionnez la carte Azure Bot .

    Sélectionner une ressource de bot Azure

  5. Sélectionnez Create (Créer).

  6. Entrez des valeurs dans les champs requis et passez en revue et mettez à jour les paramètres.

    1. Fournissez des informations sous Détails du projet. Sélectionnez si votre bot aura une résidence globale ou locale des données. Actuellement, la fonctionnalité de résidence des données locales n’est disponible que pour les ressources de la région « westeurope ». Pour plus d’informations, consultez Régionalisation dans Azure Bot Service.

      Paramètres des détails du projet pour une ressource Azure Bot

    2. Fournissez des informations sous l’ID d’application Microsoft. Sélectionnez la façon dont votre identité de bot sera gérée dans Azure et si vous souhaitez créer une identité ou utiliser une identité existante.

      Paramètres d’ID d’application Microsoft pour une ressource Azure Bot

  7. Sélectionnez Revoir + créer.

  8. Si la validation réussit, sélectionnez Créer.

  9. 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é.

  10. Si vous n’avez pas encore le Kit de développement logiciel (SDK) Bot Framework, sélectionnez Télécharger à partir de GitHub pour découvrir comment utiliser les packages pour votre langue préférée.

    Créer un bot dans le Kit de développement logiciel (SDK)

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.

Langage Nom du 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.

Pour mettre à jour votre service d’application

Si vous disposez d’une ressource App Service existante (application web) 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 le service d’application de votre bot :

  1. Accédez au panneau App Service pour l’application web de votre bot.
  2. Sous Paramètres, sélectionnez Identité.
  3. Dans le panneau Identité , sélectionnez l’onglet Utilisateur affecté et Ajoutez (+).
  4. Dans le panneau Ajouter une identité managée affectée par l’utilisateur :
    1. Sélectionnez votre abonnement.

    2. 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.

    3. Sélectionnez Ajouter pour utiliser cette identité pour votre bot.

      Panneau d’identité App Service avec l’identité managée pour le bot sélectionné.

Pour obtenir votre application ou VOTRE ID de locataire

Pour obtenir l’id d’application ou de locataire de votre bot :

  1. Accédez au panneau de ressources Azure Bot pour votre bot.
  2. 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.

Pour générer un nouveau mot de passe

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 App Service du bot peut générer un nouveau mot de passe :

  1. Accédez au panneau de ressources Azure Bot pour votre bot.
  2. Accédez au panneau Configuration du bot.
  3. Sélectionnez Gérer, en regard de l’ID d’application Microsoft, pour accéder au panneau Certificats + secrets pour le service d’application.
  4. 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
Inscriptions des applications 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

Étapes suivantes