Inscrire un bot sur AzureRegister a bot with Azure

s’applique à : SDK v4APPLIES TO: SDK v4

Cet article explique comment inscrire un bot auprès du Azure Bot Service lorsque vous le développez et l’hébergez dans Azure.This article shows how to register a bot with the Azure Bot Service when you develop and host it in Azure.

Si le robot est hébergé ailleurs, vous pouvez également le rendre disponible dans Azure et le connecter aux canaux pris en charge.If the bot is hosted elsewhere, you can also make it available in Azure and connect it to the supported channels. Vous fournissez l’adresse Web où votre robot est hébergé.You supply the web address where your bot is hosted.

Important

Vous devez uniquement inscrire un bot s’il n’est pas hébergé dans Azure.You only need to register a bot if it is not hosted in Azure. Les robots créés à l’aide du Portail Azure ou de l’interface de ligne de commande (CLI) sont déjà inscrits auprès du Azure Bot Service.Bots created using the Azure portal or the Command Line Interface (CLI) are already registered with the Azure Bot Service. Pour plus d’informations, consultez déployer votre robot.For more information, see Deploy your bot.

Créer la ressourceCreate the resource

Créez la ressource Azure bot , ce qui vous permettra d’inscrire votre robot auprès du Azure bot service.Create the Azure Bot resource, which will allow you to register your bot with the Azure Bot Service.

Avertissement

L’inscription des canaux bot et bot de l' application Web sera déconseillée, mais les ressources existantes continueront à fonctionner.Web App Bot and Bot Channels Registration will be deprecated but existing resources will continue to work. Vous devez utiliser Azure bot à la place.You should use Azure Bot, instead.

  1. Accédez au portail Azure.Go to the Azure portal.

  2. Dans le volet droit, sélectionnez créer une ressource.In the right pane, select Create a resource.

  3. Dans la zone de recherche, entrez bot, puis appuyez sur entrée.In the search box enter bot, then press Enter.

  4. Sélectionnez la carte du robot Azure .Select the Azure Bot card.

    Sélectionner une ressource de robot Azure

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

    Créer une ressource de robot Azure

  6. Entrez les valeurs requises.Enter the required values. L’illustration suivante montre l’option créer un nouvel ID d’application Microsoft sélectionnée.The following figure shows Create new Microsoft App ID selected.

    Créer des valeurs de ressource de robot Azure

    Vous pouvez également sélectionner utiliser l’inscription d’application existante et entrer votre ID d’application et votre mot de passe existants.You can also select Use existing app registration and enter your existing app Id and password.

    Créer une ressource de robot Azure valeurs existantes

  7. Sélectionnez Revoir + créer.Select Review + create.

  8. Si la validation réussit, sélectionnez créer.If the validation passes, select Create.

  9. Sélectionnez Accéder au groupe de ressources.Select Go to resource group. Vous devez voir le bot et les ressources de Azure Key Vault associées dans le groupe de ressources que vous avez sélectionné.You should see the bot and the related Azure Key Vault resources listed in the resource group you selected.

    Conseil

    La clé secrète de l’application (mot de passe) est stockée dans le coffre de clés et il existe un coffre de clés par groupe de ressources.The app secret (password) is stored in the the key vault and there is one key vault per resource group. Il est recommandé d’utiliser le coffre de clés au lieu de copier et de stocker des données sensibles.Using key vault is recommended instead of copying and storing sensitive data.

  10. Sélectionnez Télécharger le kit de développement logiciel (SDK) à partir de GitHub pour générer votre robot avec le kit de développement logiciel (SDK) robot FrameworkSelect Get the SDK from Github to build your bot with the Bot Framework SDK.

    Créer un bot dans le SDK

Azure Key VaultAzure Key Vault

Quand Azure crée la ressource Azure bot, il génère également un ID d’application et un mot de passe , puis stocke le mot de passe dans Azure Key Vault.When Azure creates the Azure Bot resource, it also generates an app Id and a password and stores the password in Azure Key Vault.

Key Vault est un service qui fournit une gestion centralisée des secrets, avec un contrôle total sur les stratégies d’accès et l’historique d’audit.Key Vault is a service that provides centralized secrets management, with full control over access policies and audit history. Pour en savoir plus, consultez la section Utiliser des références Key Vault pour App Service et Azure Functions.For more information, see Use Key Vault references for App Service and Azure Functions. Notez que vous êtes facturé pour l’utilisation du service.Note that you will be charged a small fee for using the service. Pour plus d’informations, consultez Tarification de Key Vault.For more information, see Key Vault pricing.

ID d’application et mot de passeApp Id and password

Vous avez besoin de l’ID et du mot de passe de l' application de ressource Azure bot pour configurer votre robot en vue de son déploiement.You need the Azure bot resource app Id and password to configure your bot for deployment. Vous allez affecter leurs valeurs aux variables associées : MicrosoftAppId et MicrosoftAppPassword contenues dans le fichier de configuration de votre projet bot.You will assign their values to the related variables: MicrosoftAppId and MicrosoftAppPassword contained in your bot project configuration file. Le fichier diffère selon le langage de programmation que vous utilisez pour créer le robot, comme indiqué ci-dessous.The file differs depending on the programming language you use to create the bot, as shown below.

Le appsettings.json fichier contient les paramètres suivants :The appsettings.json file contains these settings:

{
  "MicrosoftAppId": "<your app id>",
  "MicrosoftAppPassword": "<your password>"
}

Obtient l’ID d’application de ressource du robot AzureGet Azure bot resource app Id

  1. Accédez au portail Azure.Go to the Azure portal.
  2. Sélectionnez la ressource Azure bot pour obtenir son ID d’application.Select the Azure bot resource to obtain its app Id.
  3. dans le volet gauche, dans la section Paramètres , sélectionnez Configuration.In the left pane, in the Settings section, select Configuration.
  4. Copiez et enregistrez la valeur contenue dans la zone ID de l' application Microsoft .Copy and save the value contained in the Microsoft App ID box.

Obtient le mot de passe de la ressource du robot Azure à partir de Azure Key VaultGet Azure bot resource password from Azure Key Vault

Quand Azure crée la ressource de robot Azure, il stocke le mot de passe d’application dans Azure Key Vault.When Azure creates the Azure Bot resource, it stores the app password in Azure Key Vault. Pour plus d’informations sur l’accès au coffre de clés pour obtenir votre mot de passe, consultez :For information on how to access the key vault to obtain your password, see:

Inscription manuelle de l’applicationManual app registration

Une inscription manuelle est nécessaire dans les situations suivantes :A manual registration is necessary for situations like:

  • Vous ne pouvez pas effectuer les inscriptions dans votre organisation et devez demander à une tierce personne de créer l’ID d’application pour le bot que vous créez.You are unable to make the registrations in your organization and need another party to create the App ID for the bot you're building.
  • Vous devez créer manuellement votre propre ID d’application et votre propre mot de passe.You need to manually create your own app ID and password.

Important

Lors de la création de l’application, dans la section prend en charge les types de comptes, choisissez l’une des options suivantes pour les types multi-locataires :When creating the app, in the section Supports account types, choose one of the following multi-tenant types options:

TypeType DescriptionDescription
Comptes dans n’importe quel annuaire d’organisation (n’importe quel Azure AD-multi-locataire)Accounts in any organizational directory (Any Azure AD - Multitenant) Cette option offre moins d’exposition en restreignant l’accès et dans le cas où OAuth n’est pas pris en charge.This option provides less exposure by restricting access and in case OAuth is not supported.
Comptes dans n’importe quel annuaire d’organisation (Azure AD-mutualisée) et comptes Microsoft personnels (par exemple, Xbox, Outlook.com)Accounts in any organizational directory (Any Azure AD - Multitenant) and personal Microsoft accounts (for example, Xbox, Outlook.com) Cette option est bien adaptée à la prise en charge de l’authentification OAuth et bot.This option is well-suited to support OAuth and bot authentication.

Pour plus d’informations, consultez Inscrire une application auprès de la plateforme d’identités Microsoft.For more information, see Register an application with the Microsoft identity platform.

Mettre à jour le botUpdate the bot

Définissez les valeurs de clé suivantes dans le appsettings.json fichier :Set the following key values in the appsettings.json file:

  • MicrosoftAppId = <appId>
  • MicrosoftAppPassword = <appSecret>

Étapes suivantesNext steps