在由 21Vianet 運作的 Azure Microsoft中設定 Bot

發行項
09/26/2024

本指南可協助Microsoft Azure 客戶在由 21Vianet 運作的 Microsoft Azure 平臺上部署 Bot Framework 和 Azure AI Bot Service Bot。

必要條件

Microsoft Azure 中的帳戶。
您想要設定的 C# 或 JavaScript Bot 專案。
Bot Framework SDK 4.14 版或更新版本。

使用雲端配接器

請確定您的 Bot 使用 雲端配接器，或衍生自雲端配接器的配接器。雲端配接器可讓您指定 azure 雲端Microsoft特定的設定。

C#
JavaScript

類別 ConfigurationBotFrameworkAuthentication 會從 Bot 組態檔讀取驗證設定。建立時，雲端配接器會使用這些驗證設定。

請確定ConfigureServicesStartup.cs檔案中的方法包含這一行。

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

建 ConfigurationBotFrameworkAuthentication 構函式會從 Bot 組態檔讀取驗證設定。

在 index.js 檔案中，建立配接器的程式代碼看起來應該像這樣：

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

設定 UserAssignedMSI/SingleTenant Bot

若要確保 Bot 在 Microsoft Azure 雲端中正常運作，則需要額外的驗證設定。將「App-Tenant-ID」取代為 Bot 的租用戶識別碼。

C#
JavaScript

將下列設定新增至您的 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

將下列設定新增至 .env 檔案。

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

設定 MultiTenant Bot

針對多租使用者 Bot，請使用下列設定。

C#
JavaScript

將下列設定新增至您的 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

將下列設定新增至 .env 檔案。

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

將使用者驗證新增至 Bot

您的 Bot 可以使用各種身分識別提供者來代表使用者存取資源，例如Microsoft Entra ID 和其他許多 OAuth 提供者。

Microsoft Azure Cloud 會使用不同於用於其他環境的重新導向 URL。若要設定 Bot 以進行驗證，請使用 https://token.botframework.azure.cn/.auth/web/redirect 作為 OAuth 重新導向 URL，並遵循如何將驗證新增至 Bot 中的步驟。

設定 Bot 以在一或多個通道上執行

若要設定 Bot 以連線到通道，請完成下列步驟：

登入 Azure 入口網站。
選取您要設定的 Bot。
在左窗格中，選取 [設定] 底下的 [通道]。
在右窗格中，選取您要新增至 Bot 之通道的圖示。您可能需要向下卷動，才能查看所有 可用通道的清單。每個通道的連線步驟會有所不同。如需支援通道的詳細資訊，請參閱相關文章。

管道	描述
Direct Line	將 Bot 整合到行動應用程式、網頁或其他應用程式。
Microsoft Teams	設定 Bot 以透過 Microsoft Teams 與用戶通訊。
網路聊天	當您使用 Bot Framework 服務建立 Bot 時，會自動為您設定。

下一步

使用這些步驟時，您的 Bot 應該設定為能夠順利運作。關於 Bot Service 的其他實用參考。

共用方式為