Create an Azure Bot resource
APPLIES TO: SDK v4
The Azure Bot resource (bot resource) allows you to register your bot with Azure Bot Services and to connect your bot to channels. You can build, connect, and manage bots to interact with your users wherever they are, from your app or website to Teams, Messenger and many other channels. To learn how to create a bot, see the Create a bot with the Bot Framework SDK quickstart.
This article describes how to create a bot resource through the Azure portal. For information on how to create a bot resource through the Azure CLI, see how to Deploy your bot in Azure.
When you create a bot resource, Azure creates associated resources. Some of the resources created depend on how you decide to manage your bot's identity.
Your bot identity can be managed in Azure in a few different ways.
- As a user-assigned managed identity, so that you don't need to manage the bot's credentials yourself.
- As a single-tenant app.
- As a multi-tenant app.
Support for the user-assigned managed identity and single-tenant app types was added for C# and JavaScript to the Bot Framework SDK in version 4.15.0. These app types aren't supported in the other languages or in Composer, the Emulator, or ngrok.
| App type | Support |
|---|---|
| User-assigned managed identity | Azure Bot Service and the C# and JavaScript SDKs |
| Single-tenant | Azure Bot Service and the C# and JavaScript SDKs |
| Multi-tenant | Azure Bot Service, all Bot Framework SDK languages, Composer, the Emulator, and ngrok |
Prerequisites
- If you don't have an Azure subscription, create a free account before you begin.
- The Bot Framework SDK for C# or JavaScript version 4.15.0 or later, for user-assigned managed identity and single-tenant bots.
Create the resource
Create the Azure Bot resource, which will allow you to register your bot with the Azure Bot Service.
Tip
The Azure Web App Bot and Bot Channels Registration resource types are deprecated. Resources configured and deployed prior to deprecation will continue to work. Bots created from a VSIX or Yeoman template from SDK version 4.14.1.2 or later contain ARM templates that will generate an Azure Bot resource.
Go to the Azure portal.
In the right pane, select Create a resource.
In the search box enter
bot, then press Enter.Select the Azure Bot card.
Select Create.
Enter values in the required fields. Choose which type of app to create and whether to use existing or create new identity information.
Select Review + create.
If the validation passes, select Create.
Select Go to resource group. You should see the bot and related resources listed in the resource group you selected.
Select Get the SDK from GitHub to build your bot with the Bot Framework SDK.
Tip
When Azure creates a new single-tenant or multi-tenant Azure Bot resource with a new app ID, it also generates a password and stores the password in Azure Key Vault.
Key Vault is a service that provides centralized secrets management, with full control over access policies and audit history. For more information, see Use Key Vault references for App Service and Azure Functions. You're charged a small fee for using the service. For more information, see Key Vault pricing.
Bot identity information
Follow these steps to add identity information to your bot's configuration file. The file differs depending on the programming language you use to create the bot.
Important
The Java and Python versions of the Bot Framework SDK only support multi-tenant bots. The C# and JavaScript versions support all three application types for managing the bot's identity.
| Language | File name | Notes |
|---|---|---|
| C# | appsettings.json | Supports all three application types for managing your bot's identity. |
| JavaScript | .env | Supports all three application types for managing your bot's identity. |
| Java | application.properties | Only supports multi-tenant bots. |
| Python | config.py | Only supports multi-tenant bots. Provide the identity properties as arguments to the os.environ.get method calls. |
The identity information you need to add depends on the bot's application type. Provide the following values in your configuration file.
Only available for C# and JavaScript bots.
| Property | Value |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
The client ID of the user-assigned managed identity. |
MicrosoftAppPassword |
Not applicable. Leave this blank for a user-assigned managed identity bot. |
MicrosoftAppTenantId |
The tenant ID of the user-assigned managed identity. |
If your bot is a user-assigned managed identity application, update your bot's web app:
- Go to the app service page for your bot's web app.
- In the navigation pane under Settings, select Identity.
- On the Identity pane, select the User assigned tab and Add (+).
- On the Add user assigned managed identity pane:
Select your subscription.
For User assigned managed identities, select the managed identity for your bot. If the managed identity was auto-generated for you, it will have the same name as your bot.
Select Add to use this identity for your bot.
To get your bot's app or tenant ID:
- Go to the Azure Bot resource page for your bot.
- Go to the bot's Configuration pane. From here you can copy the bot's Microsoft App ID or App Tenant ID.
Tip
When Azure creates a single-tenant or multi-tenant bot, it stores the app password in Azure Key Vault.
To get the bot's app password from Azure Key Vault, see:
- About Azure Key Vault
- Use Key Vault references for App Service and Azure Functions.
- Assign a Key Vault access policy using the Azure portal
- Quickstart: Set and retrieve a secret from Azure Key Vault using the Azure portal
Additional information
- For information about identity management with Azure Active Directory, see What is Azure Active Directory?.
- For information about Azure App Service and App Service plans, see the App Service overview.
- For information about Azure resources and how they're managed in general, see the Azure Resource Manager overview.
Note
The Bot Framework Composer and Emulator currently only support multi-tenant bots. The Bot Framework SDK for C# or JavaScript version 4.15.0 or later is required for user-assigned managed identity and single-tenant bots.
Skill support
Some types of skill consumers are not able to use some types of skill bots. The following table describes which combinations are supported.
| Multi-tenant skill | Single-tenant skill | User-assigned managed identity skill | |
|---|---|---|---|
| Multi-tenant consumer | Supported | Not supported | Not supported |
| Single-tenant consumer | Not supported | Supported if both apps belong to same tenant | Supported if both apps belong to same tenant |
| User-assigned managed identity consumer | Not supported | Supported if both apps belong to same tenant | Supported if both apps belong to same tenant |
For information on how to configure a skill or skill consumer, see Implement a skill or Implement a skill consumer.
Next steps
الملاحظات
إرسال الملاحظات وعرضها المتعلقة بـ