21Vianet에서 운영하는 Microsoft Azure에서 봇 구성
이 가이드는 Microsoft Azure 고객이 21Vianet에서 운영하는 Microsoft Azure 플랫폼에 Bot Framework 및 Azure AI Bot Service 봇을 배포하는 데 도움이 됩니다.
필수 조건
- Microsoft Azure의 계정입니다.
- 구성하려는 C# 또는 JavaScript 봇 프로젝트입니다.
- Bot Framework SDK 버전 4.14 이상.
클라우드 어댑터 사용
봇이 클라우드 어댑터 또는 클라우드 어댑터에서 파생되는 어댑터를 사용하는지 확인합니다. 클라우드 어댑터를 사용하면 Microsoft Azure Cloud와 관련된 설정을 지정할 수 있습니다.
클래스는 ConfigurationBotFrameworkAuthentication 봇 구성 파일에서 인증 설정을 읽습니다. 생성 시 클라우드 어댑터는 이러한 인증 설정을 사용합니다.
Startup.cs 파일의 ConfigureServices 메서드에 이 줄이 포함되어 있는지 확인합니다.
services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();
UserAssignedMSI/SingleTenant 봇 구성
Microsoft Azure Cloud에서 봇이 제대로 작동하도록 하려면 추가 인증 설정이 필요합니다. "App-Tenant-ID"를 봇의 테넌트 ID로 바꿉니다.
appsettings.json 파일에 다음 설정을 추가합니다.
"OAuthUrl": "https://token.botframework.azure.cn/",
"ToChannelFromBotLoginUrl": "https://login.partner.microsoftonline.cn/<App-Tenant-ID>",
"ToChannelFromBotOAuthScope": "https://api.botframework.azure.cn",
"ToBotFromChannelTokenIssuer": "https://api.botframework.azure.cn",
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.cn/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true
다중 테넌트 봇 구성
다중 테넌트 봇의 경우 다음 설정을 사용합니다.
appsettings.json 파일에 다음 설정을 추가합니다.
"OAuthUrl": "https://token.botframework.azure.cn/",
"ToChannelFromBotLoginUrl": "https://login.partner.microsoftonline.cn/microsoftservices.partner.onmschina.cn",
"ToChannelFromBotOAuthScope": "https://api.botframework.azure.cn",
"ToBotFromChannelTokenIssuer": "https://api.botframework.azure.cn",
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.cn/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true
봇에 사용자 인증 추가
봇은 다양한 ID 공급자를 사용하여 Microsoft Entra ID 및 기타 많은 OAuth 공급자와 같은 사용자를 대신하여 리소스에 액세스할 수 있습니다.
Microsoft Azure Cloud는 다른 환경에 사용되는 것과 다른 리디렉션 URL을 사용합니다.
인증을 위해 봇을 구성하려면 OAuth 리디렉션 URL로 사용하고 https://token.botframework.azure.cn/.auth/web/redirect 봇에 인증을 추가하는 방법의 단계를 따릅니다.
하나 이상의 채널에서 실행되도록 봇 구성
채널에 연결하도록 봇을 구성하려면 다음 단계를 완료합니다.
- Azure Portal에 로그인합니다.
- 구성하려는 봇을 선택합니다.
- 왼쪽 창의 설정에서 채널을 선택합니다.
- 오른쪽 창에서 봇에 추가할 채널의 아이콘을 선택합니다. 사용 가능한 모든 채널 목록을 보려면 아래로 스크롤해야 할 수 있습니다. 연결 단계는 각 채널에 따라 다릅니다. 지원되는 채널에 대한 자세한 내용은 관련 문서를 참조하세요.
| 채널 | 설명 |
|---|---|
| 직접 회선 | 모바일 앱, 웹 페이지 또는 기타 애플리케이션에 봇을 통합합니다. |
| Microsoft Teams | Microsoft Teams를 통해 사용자와 통신하도록 봇을 구성합니다. |
| 웹 채팅 | Bot Framework 서비스를 사용하여 봇을 만들 때 자동으로 구성됩니다. |
다음 단계
이러한 단계를 사용하면 봇이 성공적으로 작동하도록 구성되어야 합니다. Bot Service에 대한 기타 유용한 참조입니다.