Azure에 봇 등록Register a bot with Azure

적용 대상: SDK v4APPLIES TO: SDK v4

이 문서에서는 Azure에서 봇을 개발하고 호스트할 때 Azure Bot Service 봇을 등록하는 방법을 보여줍니다.This article shows how to register a bot with the Azure Bot Service when you develop and host it in Azure.

봇이 다른 곳에서 호스트되는 경우 Azure에서 사용할 수 있도록 하고 지원되는 채널에 연결할 수도 있습니다.If the bot is hosted elsewhere, you can also make it available in Azure and connect it to the supported channels. 봇이 호스트되는 웹 주소를 입력합니다.You supply the web address where your bot is hosted.

중요

봇이 Azure에서 호스트되지 않은 경우에만 봇을 등록해야 합니다.You only need to register a bot if it is not hosted in Azure. Azure Portal 또는 CLI(명령줄 인터페이스)를 사용하여 만든 봇은 이미 Azure Bot Service 등록되어 있습니다.Bots created using the Azure portal or the Command Line Interface (CLI) are already registered with the Azure Bot Service. 자세한 내용은 봇 배포를 참조하세요.For more information, see Deploy your bot.

리소스 만들기Create the resource

Azure Bot Service에 봇을 등록할 수 있도록 하는 Azure bot 리소스를 만듭니다.Create the Azure Bot resource, which will allow you to register your bot with the Azure Bot Service.

경고

웹 앱 봇봇 채널 등록 은 더 이상 사용 되지 않지만 기존 리소스는 계속 작동 합니다.Web App Bot and Bot Channels Registration will be deprecated but existing resources will continue to work. 대신 Azure Bot 를 사용 해야 합니다.You should use Azure Bot, instead.

  1. Azure 포털로 이동합니다.Go to the Azure portal.

  2. 오른쪽 창에서 리소스 만들기 를 선택 합니다.In the right pane, select Create a resource.

  3. 검색 상자에 bot 를 입력 한 다음 enter 키를 누릅니다.In the search box enter bot, then press Enter.

  4. Azure Bot card를 선택 합니다.Select the Azure Bot card.

    Azure 봇 리소스 선택

  5. 만들기 를 선택합니다.Select Create.

    Azure 봇 리소스 만들기

  6. 필요한 값을 입력 합니다.Enter the required values. 다음 그림은 선택한 새 Microsoft 앱 ID 만들기 를 보여 줍니다.The following figure shows Create new Microsoft App ID selected.

    Azure bot resource 값 만들기

    기존 앱 등록 사용 을 선택 하 고 기존 앱 Id암호 를 입력할 수도 있습니다.You can also select Use existing app registration and enter your existing app Id and password.

    Azure bot 리소스 기존 값 만들기

  7. 검토 + 만들기 를 선택합니다.Select Review + create.

  8. 유효성 검사에 통과 하면 만들기 를 선택 합니다.If the validation passes, select Create.

  9. 리소스 그룹으로 이동 을 선택합니다.Select Go to resource group. 선택한 리소스 그룹에 나열 된 봇 및 관련 Azure Key Vault 리소스가 표시 됩니다.You should see the bot and the related Azure Key Vault resources listed in the resource group you selected.

    앱 암호 (암호)는 주요 자격 증명 모음에 저장 되 고 리소스 그룹당 하나의 키 자격 증명 모음이 있습니다.The app secret (password) is stored in the the key vault and there is one key vault per resource group. 중요 한 데이터를 복사 하 고 저장 하는 대신 key vault를 사용 하는 것이 좋습니다.Using key vault is recommended instead of copying and storing sensitive data.

  10. Github에서 Sdk 가져오기 를 선택 하 여 봇 Framework SDK로 봇을 빌드합니다.Select Get the SDK from Github to build your bot with the Bot Framework SDK.

    SDK에서 봇 만들기

Azure Key VaultAzure Key Vault

Azure는 Azure Bot 리소스를 만들 때 앱 Id암호 를 생성 하 고 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는 중앙 집중화 된 비밀 관리를 제공 하 고 액세스 정책 및 감사 기록에 대 한 모든 권한을 제공 하는 서비스입니다.Key Vault is a service that provides centralized secrets management, with full control over access policies and audit history. 자세한 내용은 App Service 및 Azure Functions에 대 한 Key Vault 참조 사용을 참조 하세요.For more information, see Use Key Vault references for App Service and Azure Functions. 서비스 사용에 대 한 요금은 작은 요금으로 청구 됩니다.Note that you will be charged a small fee for using the service. 자세한 내용은 Key Vault 가격 책정을 참조하세요.For more information, see Key Vault pricing.

앱 ID 및 암호App Id and password

배포를 위해 봇을 구성하려면 Azure 봇 리소스 앱 ID암호가 필요합니다.You need the Azure bot resource app Id and password to configure your bot for deployment. 봇 프로젝트 구성 파일에 포함된 및 관련 변수에 해당 값을 MicrosoftAppId MicrosoftAppPassword 할당합니다.You will assign their values to the related variables: MicrosoftAppId and MicrosoftAppPassword contained in your bot project configuration file. 파일은 아래와 같이 봇을 만드는 데 사용하는 프로그래밍 언어에 따라 다릅니다.The file differs depending on the programming language you use to create the bot, as shown below.

appsettings.json파일에는 다음 설정이 포함됩니다.The appsettings.json file contains these settings:

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

Azure 봇 리소스 앱 ID를 얻습니다.Get Azure bot resource app Id

  1. Azure 포털로 이동합니다.Go to the Azure portal.
  2. Azure 봇 리소스를 선택하여 앱 ID를 얻습니다.Select the Azure bot resource to obtain its app Id.
  3. 왼쪽 창의 설정 섹션에서 구성을 선택합니다.In the left pane, in the Settings section, select Configuration.
  4. Microsoft 앱 ID 상자에 포함된 값을 복사하여 저장합니다.Copy and save the value contained in the Microsoft App ID box.

Azure Key Vault Azure Bot 리소스 암호 받기Get Azure bot resource password from Azure Key Vault

Azure는 Azure Bot 리소스를 만들 때 앱 암호를 Azure Key Vault 저장합니다.When Azure creates the Azure Bot resource, it stores the app password in Azure Key Vault. 키 자격 증명 모음에 액세스하여 암호를 가져오는 방법에 대한 자세한 내용은 다음을 참조하세요.For information on how to access the key vault to obtain your password, see:

수동 앱 등록Manual app registration

다음과 같은 상황에서는 수동 등록이 필요합니다.A manual registration is necessary for situations like:

  • 조직에 등록을 만들 수 없으며, 빌드 중인 봇의 앱 ID를 다른 당사자가 만들도록 해야 합니다.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.
  • 사용자 고유의 앱 ID와 암호를 수동으로 만들어야 합니다.You need to manually create your own app ID and password.

중요

앱을 만들 때 계정 유형 지원 섹션에서 다음 다중 테넌트 유형 옵션 중 하나를 선택합니다.When creating the app, in the section Supports account types, choose one of the following multi-tenant types options:

TypeType DescriptionDescription
모든 조직 디렉터리(모든 Azure AD - 다중테넌트)의 계정Accounts in any organizational directory (Any Azure AD - Multitenant) 이 옵션은 OAuth가 지원되지 않는 경우 액세스를 제한하여 노출을 줄입니다.This option provides less exposure by restricting access and in case OAuth is not supported.
모든 조직 디렉터리(모든 Azure AD - 다중테넌트) 및 개인 Microsoft 계정(예: Xbox, Outlook.com)의 계정Accounts in any organizational directory (Any Azure AD - Multitenant) and personal Microsoft accounts (for example, Xbox, Outlook.com) 이 옵션은 OAuth 및 봇 인증을 지원하는 데 적합합니다.This option is well-suited to support OAuth and bot authentication.

자세한 내용은 Microsoft ID 플랫폼을 사용하여 애플리케이션 등록을 참조하세요.For more information, see Register an application with the Microsoft identity platform.

봇 업데이트Update the bot

파일에서 다음 키 값을 설정합니다. appsettings.jsonSet the following key values in the appsettings.json file:

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

다음 단계Next steps