Registro de un bot con AzureRegister a bot with Azure

se aplica a: SDK V4APPLIES TO: SDK v4

En este artículo se muestra cómo registrar un bot con el Azure Bot Service desarrollarlo y hospedarlo en Azure.This article shows how to register a bot with the Azure Bot Service when you develop and host it in Azure.

Si el bot se hospeda en otro lugar, también puede hacer que esté disponible en Azure y conectarlo a los canales admitidos.If the bot is hosted elsewhere, you can also make it available in Azure and connect it to the supported channels. Proporcione la dirección web donde se hospeda el bot.You supply the web address where your bot is hosted.

Importante

Solo tiene que registrar un bot si no está hospedado en Azure.You only need to register a bot if it is not hosted in Azure. Los bots creados mediante Azure Portal o la interfaz de la línea de comandos (CLI) ya están registrados con el Azure Bot Service.Bots created using the Azure portal or the Command Line Interface (CLI) are already registered with the Azure Bot Service. Para más información, consulte Implementación del bot.For more information, see Deploy your bot.

Crear el recursoCreate the resource

Cree el recurso bot de Azure, que le permitirá registrar el bot con el Azure Bot Service.Create the Azure Bot resource, which will allow you to register your bot with the Azure Bot Service.

Advertencia

El bot de aplicación web y el registro de canales de bot estarán en desuso, pero los recursos existentes seguirán funcionando.Web App Bot and Bot Channels Registration will be deprecated but existing resources will continue to work. En su lugar, debe usar el bot de Azure.You should use Azure Bot, instead.

  1. Vaya a Azure Portal.Go to the Azure portal.

  2. En el panel derecho, seleccione Crear un recurso.In the right pane, select Create a resource.

  3. En el cuadro de búsqueda, escriba bot y presione Entrar.In the search box enter bot, then press Enter.

  4. Seleccione la tarjeta Bot de Azure.Select the Azure Bot card.

    Selección del recurso de bot de Azure

  5. Seleccione Crear.Select Create.

    Creación de un recurso de bot de Azure

  6. Escriba los valores necesarios.Enter the required values. En la ilustración siguiente se muestra la opción Crear nuevo identificador de aplicación de Microsoft seleccionada.The following figure shows Create new Microsoft App ID selected.

    Creación de valores de recursos de bot de Azure

    También puede seleccionar Usar registro de aplicación existente y escribir el identificador y la contraseña de la aplicación existentes.You can also select Use existing app registration and enter your existing app Id and password.

    Creación de valores existentes de recursos de bot de Azure

  7. Seleccione Revisar + crear.Select Review + create.

  8. Si se supera la validación, seleccione Crear.If the validation passes, select Create.

  9. Seleccione Ir al grupo de recursos.Select Go to resource group. Debería ver el bot y los recursos de Azure Key Vault relacionados en el grupo de recursos que seleccionó.You should see the bot and the related Azure Key Vault resources listed in the resource group you selected.

    Sugerencia

    El secreto de la aplicación (contraseña) se almacena en el almacén de claves y hay un almacén de claves por grupo de recursos.The app secret (password) is stored in the the key vault and there is one key vault per resource group. Se recomienda usar el almacén de claves en lugar de copiar y almacenar datos confidenciales.Using key vault is recommended instead of copying and storing sensitive data.

  10. Seleccione Get the SDK from Github (Obtener el SDK de GitHub) para compilar el bot con el SDK Bot Framework sdk.Select Get the SDK from Github to build your bot with the Bot Framework SDK.

    Creación de un bot en el SDK

Azure Key VaultAzure Key Vault

Cuando Azure crea el recurso bot de Azure, también genera un identificador de aplicación y una contraseña, y almacena la contraseña en 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 es un servicio que proporciona administración centralizada de secretos, con control total sobre las directivas de acceso y el historial de auditoría.Key Vault is a service that provides centralized secrets management, with full control over access policies and audit history. Para más información, consulte Uso de referencias de Key Vault para App Service y Azure Functions.For more information, see Use Key Vault references for App Service and Azure Functions. Tenga en cuenta que se le cobrará una pequeña cuota por usar el servicio.Note that you will be charged a small fee for using the service. Para más información, vea Precios de Key Vault.For more information, see Key Vault pricing.

Id. de aplicación y contraseñaApp Id and password

Necesita el identificador y la contraseña de la aplicación de recursos del bot de Azure para configurar el bot para la implementación. You need the Azure bot resource app Id and password to configure your bot for deployment. Asignará sus valores a las variables relacionadas: MicrosoftAppId y MicrosoftAppPassword contenidas en el archivo de configuración del proyecto de bot.You will assign their values to the related variables: MicrosoftAppId and MicrosoftAppPassword contained in your bot project configuration file. El archivo difiere en función del lenguaje de programación que use para crear el bot, como se muestra a continuación.The file differs depending on the programming language you use to create the bot, as shown below.

El appsettings.json archivo contiene esta configuración:The appsettings.json file contains these settings:

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

Obtener el identificador de la aplicación de recursos de bot de AzureGet Azure bot resource app Id

  1. Vaya a Azure Portal.Go to the Azure portal.
  2. Seleccione el recurso del bot de Azure para obtener su identificador de aplicación.Select the Azure bot resource to obtain its app Id.
  3. En el panel izquierdo, en la Configuración, seleccione Configuración.In the left pane, in the Settings section, select Configuration.
  4. Copie y guarde el valor contenido en el cuadro Id. de aplicación de Microsoft.Copy and save the value contained in the Microsoft App ID box.

Obtenga la contraseña del recurso de bot de Azure Azure Key VaultGet Azure bot resource password from Azure Key Vault

Cuando Azure crea el recurso bot de Azure, almacena la contraseña de la aplicación en Azure Key Vault.When Azure creates the Azure Bot resource, it stores the app password in Azure Key Vault. Para obtener información sobre cómo acceder al almacén de claves para obtener la contraseña, consulte:For information on how to access the key vault to obtain your password, see:

Registro de aplicación manualManual app registration

Un registro manual es necesario en situaciones como:A manual registration is necessary for situations like:

  • No puede realizar registros en su organización y necesita otra entidad para crear el identificador de aplicación para el bot que está compilando.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.
  • Debe crear manualmente su propio identificador de aplicación y contraseña.You need to manually create your own app ID and password.

Importante

Al crear la aplicación, en la sección Admite tipos de cuenta, elija una de las siguientes opciones de tipos multiinquilino:When creating the app, in the section Supports account types, choose one of the following multi-tenant types options:

TipoType DescripciónDescription
Cuentas en cualquier directorio organizativo (cualquier Azure AD - Multitenant)Accounts in any organizational directory (Any Azure AD - Multitenant) Esta opción proporciona menos exposición mediante la restricción del acceso y, en caso de que no se admite OAuth.This option provides less exposure by restricting access and in case OAuth is not supported.
Cuentas en cualquier directorio organizativo (cualquier Azure AD - Multitenant) y cuentas personales de Microsoft (por ejemplo, Xbox, Outlook.com)Accounts in any organizational directory (Any Azure AD - Multitenant) and personal Microsoft accounts (for example, Xbox, Outlook.com) Esta opción es adecuada para admitir OAuth y la autenticación de bots.This option is well-suited to support OAuth and bot authentication.

Para más información, consulte Registro de una aplicación con la plataforma de identidad de Microsoft.For more information, see Register an application with the Microsoft identity platform.

Actualización del botUpdate the bot

Establezca los siguientes valores de clave en el appsettings.json archivo:Set the following key values in the appsettings.json file:

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

Pasos siguientesNext steps