US Government müşterileri için Bot Framework botlarını yapılandırma

Makale
10/24/2023

Bu makale, Bot Framework ve Azure AI Bot Hizmeti botlarını Microsoft Azure Kamu buluta dağıtan ABD kamu müşterilerine yöneliktir.

Bahşiş

Microsoft Teams'e bağlanan Azure Kamu botların Microsoft Office 365 Kamu Community Cloud (GCC) High ortamını kullanması gerekir.

Bu makalede, botu Azure Kamu bulutuyla ve Office 365 GCC High ortamıyla çalışacak şekilde yapılandırma açıklanmaktadır.

Ön koşullar

Azure Kamu buluttaki bir hesap.
Office 365 GCC High ortamında oluşturulan bir Azure Bot kaynağı olan Teams'i genişletmek için.
Yapılandırmak istediğiniz C# veya JavaScript bot projesi.
Bot Framework SDK'sı sürüm 4.14 veya üzeri.

Bulut bağdaştırıcısını kullanma

Botunuzun bulut bağdaştırıcısını veya bulut bağdaştırıcısından türetilen bir bağdaştırıcıyı kullandığından emin olun. Bulut bağdaştırıcısı, Azure Kamu buluta ve Office 365 GCC High ortamına özgü ayarları belirtmenize olanak tanır.

C#
JavaScript

sınıfı, ConfigurationBotFrameworkAuthentication bot yapılandırma dosyanızdan kimlik doğrulama ayarlarını okur. Bulut bağdaştırıcısı oluşturulduğunda bu kimlik doğrulama ayarlarını kullanır.

Startup.cs dosyanızdaki yönteminin ConfigureServices bu satırı içerdiğinden emin olun.

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

Oluşturucu, ConfigurationBotFrameworkAuthentication bot yapılandırma dosyanızdan kimlik doğrulama ayarlarını okur.

index.js dosyanızda bağdaştırıcınızı oluşturma kodu şu şekilde görünmelidir:

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

Azure Kamu için yapılandırma

Azure Kamu bulutu kanal hizmeti uç noktası için kullanırhttps://botframework.azure.us. Çoğu kanal için kanal hizmet uç noktasını ayarlamak yeterlidir.

Office 365 GCC High ortamında Microsoft Teams'i desteklemek için gereken ek ayarlar için sonraki bölüme bakın.

C#
JavaScript

Appsettings.json dosyanıza aşağıdaki ayarı ekleyin.

"ChannelService": "https://botframework.azure.us",

.env dosyanıza aşağıdaki ayarı ekleyin.

ChannelService=https://botframework.azure.us

Office 365 GCC High için yapılandırma

Office 365 hizmetlerinde, kullanıcı kimlik doğrulamasını doğru şekilde işlemek için ek ayarlar gerekir. Şu anda Office 365 GCC High ortamında yalnızca Microsoft Teams kanalı kullanılabilir.

C#
JavaScript

Appsettings.json dosyanıza aşağıdaki ayarları ekleyin.

"ChannelService": "https://botframework.azure.us", 
"OAuthUrl": "https://tokengcch.botframework.azure.us/", 
"ToChannelFromBotLoginUrl": "https://login.microsoftonline.us/MicrosoftServices.onmicrosoft.us",
"ToChannelFromBotOAuthScope": "https://api.botframework.us", 
"ToBotFromChannelTokenIssuer": "https://api.botframework.us", 
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.us/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.microsoftonline.us/cab8a31a-1906-4287-a0d8-4eef66b95f6e/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true,

.env dosyanıza aşağıdaki ayarları ekleyin.

ChannelService=https://botframework.azure.us
OAuthUrl=https://tokengcch.botframework.azure.us/
ToChannelFromBotLoginUrl=https://login.microsoftonline.us/MicrosoftServices.onmicrosoft.us
ToChannelFromBotOAuthScope=https://api.botframework.us
ToBotFromChannelTokenIssuer=https://api.botframework.us
ToBotFromChannelOpenIdMetadataUrl=https://login.botframework.azure.us/v1/.well-known/openidconfiguration
ToBotFromEmulatorOpenIdMetadataUrl=https://login.microsoftonline.us/cab8a31a-1906-4287-a0d8-4eef66b95f6e/v2.0/.well-known/openid-configuration
ValidateAuthority=true

DoD ortamı için yapılandırma

Ayrıca, Office 365 GCC High ortamıyla çoğu ayarı paylaşan (ancak tümünü paylaşmayan) bir DoD ortamı da vardır. DoD ortamı için aşağıdaki ayarları kullanın.

C#
JavaScript

Appsettings.json dosyanıza aşağıdaki ayarları ekleyin.

"ChannelService": "https://botframework.azure.us", 
"OAuthUrl": "https://apiDoD.botframework.azure.us", 
"ToChannelFromBotLoginUrl": "https://login.microsoftonline.us/MicrosoftServices.onmicrosoft.us",
"ToChannelFromBotOAuthScope": "https://api.botframework.us", 
"ToBotFromChannelTokenIssuer": "https://api.botframework.us", 
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.us/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.microsoftonline.us/cab8a31a-1906-4287-a0d8-4eef66b95f6e/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true,

.env dosyanıza aşağıdaki ayarları ekleyin.

ChannelService=https://botframework.azure.us
OAuthUrl=https://apiDoD.botframework.azure.us
ToChannelFromBotLoginUrl=https://login.microsoftonline.us/MicrosoftServices.onmicrosoft.us
ToChannelFromBotOAuthScope=https://api.botframework.us
ToBotFromChannelTokenIssuer=https://api.botframework.us
ToBotFromChannelOpenIdMetadataUrl=https://login.botframework.azure.us/v1/.well-known/openidconfiguration
ToBotFromEmulatorOpenIdMetadataUrl=https://login.microsoftonline.us/cab8a31a-1906-4287-a0d8-4eef66b95f6e/v2.0/.well-known/openid-configuration
ValidateAuthority=true

Botunuza kullanıcı kimlik doğrulaması ekleme

Botunuz, Microsoft Entra Id ve diğer birçok OAuth sağlayıcısı gibi bir kullanıcı adına kaynaklara erişmek için çeşitli kimlik sağlayıcıları kullanabilir.

Office 365 GCC High ortamı, diğer ortamlar için kullanılanlardan farklı bir yeniden yönlendirme URL'si kullanır. Botunuzu Office 365 GCC High ortamında kimlik doğrulaması için yapılandırırken, OAuth yeniden yönlendirme URL'si olarak kullanın https://tokengcch.botframework.azure.us/.auth/web/redirect ve botunuza kimlik doğrulaması ekleme adımlarını izleyin.

Ek bilgiler

Microsoft Azure Kamu ve Office 365 Kamu High hakkında daha fazla bilgi için bkz:

Sonraki adımlar

Bu adımlarla botunuz Azure Kamu bulutunda ve Office 365 GCC High ortamında başarıyla çalışacak şekilde yapılandırılmalıdır. Azure Kamu Bot Hizmeti ile ilgili diğer yararlı başvurular.

Aracılığıyla paylaş