Azure에 봇 등록
적용 대상: SDK v4
현재 Azure에서 봇을 호스트하지 않는 경우에도 Azure에서 봇을 사용할 수 있도록 하고 Azure를 사용하여 봇을 채널에 연결할 수 있습니다. 이렇게 하려면 봇이 호스트되는 웹 주소를 Azure에 입력합니다.
이 문서에서는 Azure AI Bot Service에 이러한 봇을 등록하는 방법을 보여줍니다.
Important
Azure에서 호스트되지 않은 경우에만 봇을 등록해야 합니다. Azure CLI를 사용하여 만든 봇은 이미 Azure AI Bot Service에 등록되어 있습니다.
봇 ID는 몇 가지 다른 방법으로 Azure에서 관리할 수 있습니다.
- 봇의 자격 증명을 직접 관리할 필요가 없도록 사용자가 할당한 관리 ID입니다.
- 단일 테넌트 앱입니다.
- 다중 테넌트 앱입니다.
사용자가 할당한 관리 ID 및 단일 테넌트 앱 유형에 대한 지원이 버전 4.15.0의 C# 및 JavaScript용 Bot Framework SDK에 추가되었습니다. 이러한 앱 유형은 다른 언어 또는 Bot Framework Composer, Bot Framework Emulator 또는 ngrok에서 지원되지 않습니다.
| 앱 유형 | 지원 |
|---|---|
| 사용자 할당 관리 ID | Azure AI Bot Service 및 C# 및 JavaScript SDK |
| 단일 테넌트 | Azure AI Bot Service 및 C# 및 JavaScript SDK |
| 다중 테넌트 | Azure AI Bot Service, 모든 Bot Framework SDK 언어, 작성기, 에뮬레이터 및 ngrok |
이 문서에서는 등록할 봇을 만들거나 배포하는 방법을 설명하지 않습니다. 자세한 내용은 다음을 참조하세요.
리소스 만들기
Azure AI Bot Service에 봇을 등록할 수 있는 Azure Bot 리소스를 만듭니다.
팁
새 웹앱 봇 및 봇 채널 등록 리소스는 만들 수 없습니다. 그러나 구성되고 배포된 이러한 기존 리소스는 계속 작동합니다. SDK 버전 4.14.1.2 이상에서 VSIX 또는 Yeoman 템플릿에서 만든 봇에는 Azure Bot 리소스를 생성하는 ARM 템플릿이 포함되어 있습니다.
Azure Portal로 이동합니다.
오른쪽 창에서 리소스 만들기를 선택합니다.
검색 상자에 입력
bot한 다음 Enter 키를 누릅니 다.Azure Bot 카드 선택합니다.
만들기를 실행합니다.
필수 필드에 값을 입력하고 설정을 검토하고 업데이트합니다.
프로젝트 세부 정보 아래에 정보를 제공합니다. 봇에 전역 또는 로컬 데이터 상주 여부를 선택합니다. 현재 로컬 데이터 상주 기능은 "westeurope" 및 "centralindia" 지역의 리소스에 사용할 수 있습니다. 자세한 내용은 Azure AI Bot Service의 지역화를 참조 하세요.
Microsoft 앱 ID 아래에 정보를 제공합니다. Azure에서 봇 ID를 관리하는 방법과 새 ID를 만들거나 기존 ID를 사용할지 여부를 선택합니다.
검토 + 만들기를 선택합니다.
유효성 검사가 통과하면 만들기를 선택합니다.
배포가 완료되면 리소스로 이동을 선택합니다. 선택한 리소스 그룹에 나열된 봇 및 관련 리소스가 표시됩니다.
Bot Framework SDK가 아직 없는 경우 GitHub에서 다운로드를 선택하여 기본 설정 언어로 패키지를 사용하는 방법을 알아봅니다.
이제 Bot Framework SDK를 사용하여 봇을 빌드할 준비가 되었습니다.
팁
Azure에서 새 앱 ID를 사용하여 새 단일 테넌트 또는 다중 테넌트 Azure Bot 리소스를 만들면 암호도 생성됩니다.
봇 ID 정보
다음 단계에 따라 봇의 구성 파일에 ID 정보를 추가합니다. 파일은 봇을 만드는 데 사용하는 프로그래밍 언어에 따라 다릅니다.
Important
Java 및 Python 버전의 Bot Framework SDK는 다중 테넌트 봇만 지원합니다. C# 및 JavaScript 버전은 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다.
| 언어 | File name | 주의 |
|---|---|---|
| C# | appsettings.json | 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다. |
| JavaScript | .env | 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다. |
| Java | application.properties | 다중 테넌트 봇만 지원합니다. |
| Python | config.py | 다중 테넌트 봇만 지원합니다. 메서드 호출에 대한 인수 os.environ.get 로 ID 속성을 제공합니다. |
추가해야 하는 ID 정보는 봇의 애플리케이션 유형에 따라 달라집니다. 구성 파일에 다음 값을 제공합니다.
C# 및 JavaScript 봇에만 사용할 수 있습니다.
| 속성 | 값 |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
사용자 할당 관리 ID의 클라이언트 ID입니다. |
MicrosoftAppPassword |
해당 없음. 사용자가 할당한 관리 ID 봇에 대해 이 값을 비워 둡니다. |
MicrosoftAppTenantId |
사용자 할당 관리 ID의 테넌트 ID입니다. |
앱 서비스를 업데이트하려면
봇에 대한 기존 App Service 리소스(웹앱)가 있고 봇이 사용자 할당 관리 ID 애플리케이션인 경우 봇의 앱 서비스를 업데이트해야 할 수 있습니다.
- 봇의 웹앱에 대한 App Service 블레이드로 이동합니다.
- 설정에서 ID를 선택합니다.
- ID 블레이드에서 사용자 할당 탭을 선택하고 추가(+)를 선택합니다.
- 사용자 할당 관리 ID 추가 블레이드에서 다음을 수행합니다 .
구독을 선택합니다.
사용자가 할당한 관리 ID의 경우 봇의 관리 ID를 선택합니다. 관리 ID가 자동으로 생성된 경우 봇과 동일한 이름을 갖습니다.
추가를 선택하여 봇에 이 ID를 사용합니다.
앱 또는 테넌트 ID를 가져오려면
봇의 앱 또는 테넌트 ID를 가져오려면 다음을 수행합니다.
- 봇에 대한 Azure Bot 리소스 블레이드로 이동합니다.
- 봇의 구성 블레이드로 이동합니다. 이 블레이드에서 봇의 Microsoft 앱 ID 또는 앱 테넌트 ID를 복사할 수 있습니다.
새 암호를 생성하려면
단일 테넌트 및 다중 테넌트 봇에는 일부 작업에 필요한 앱 비밀 또는 암호가 있습니다. Azure AI Bot Service는 봇 비밀을 숨깁니다. 그러나 봇의 App Service 리소스 소유자는 새 암호를 생성할 수 있습니다.
- 봇에 대한 Azure Bot 리소스 블레이드로 이동합니다.
- 봇의 구성 블레이드로 이동합니다.
- Microsoft 앱 ID 옆에 있는 관리를 선택하여 앱 서비스에 대한 인증서 + 비밀 블레이드로 이동합니다.
- 블레이드의 지침에 따라 새 클라이언트 비밀을 만들고 안전한 장소에 값을 기록합니다.
수동 앱 등록
다음과 같은 경우 수동 등록이 필요합니다.
- 조직에서 등록할 수 없으며 빌드 중인 봇에 대한 앱 ID를 만들 다른 당사자가 필요합니다.
- 사용자 고유의 앱 ID와 암호를 수동으로 만들어야 합니다.
봇 업데이트
앱 ID 및 암호를 포함하도록 봇의 구성 파일을 업데이트하려면 봇 등록 설정을 구성하는 방법에서 애플리케이션 ID 및 암호를 참조하세요.
추가 정보
일반적으로 Azure 애플리케이션에 대한 자세한 내용은 다음 문서를 참조하세요.
| Subject | 문서 |
|---|---|
| 앱 등록 | 빠른 시작: Microsoft ID 플랫폼에 애플리케이션 등록 |
| 관리 ID | Azure 리소스에 대한 관리 ID란? |
| 단일 테넌트 및 다중 테넌트 앱 | Microsoft Entra ID의 테넌트 |