Sdílet prostřednictvím

Konfigurace robotů bot Framework pro zákazníky státní správy USA

Tento článek je určený pro zákazníky státní správy USA, kteří nasazují roboty služby Bot Framework a Azure AI Bot Service do cloudu Microsoft Azure Government.

Tip

Roboti ve službě Azure Government, kteří se připojují k Microsoft Teams, musí používat prostředí systém Microsoft Office 365 Government Community Cloud (GCC) High.

Tento článek popisuje, jak nakonfigurovat robota pro práci s cloudem Azure Government a s prostředím Office 365 GCC High.

Předpoklady

  • Účet v cloudu Azure Government
  • Pokud chcete rozšířit Teams, prostředek Azure Bot vytvořený v prostředí Office 365 GCC High.
  • Projekt robota C# nebo JavaScriptu, který chcete nakonfigurovat.
  • Sada BOT Framework SDK verze 4.14 nebo novější

Použití cloudového adaptéru

Ujistěte se, že robot používá cloudový adaptér nebo adaptér odvozený z cloudového adaptéru. Cloudový adaptér umožňuje zadat nastavení specifická pro cloud Azure Government a prostředí Office 365 GCC High.

Třída ConfigurationBotFrameworkAuthentication čte nastavení ověřování z konfiguračního souboru robota. Cloudový adaptér po vytvoření použije tato nastavení ověřování.

Ujistěte se, že ConfigureServices metoda v souboru Startup.cs obsahuje tento řádek.

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

Konfigurace pro Azure Government

Cloud Azure Government se používá https://botframework.azure.us pro koncový bod služby kanálu. U většiny kanálů stačí nastavit koncový bod služby kanálu.

Další nastavení vyžadovaná pro podporu Microsoft Teams v prostředí Office 365 GCC High najdete v další části.

Do souboru appsettings.json přidejte následující nastavení.

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

Konfigurace pro Office 365 GCC High

U služeb Office 365 jsou pro správné zpracování ověřování uživatelů potřeba další nastavení. V současné době je v prostředí Office 365 GCC High dostupný jenom kanál Microsoft Teams.

Do souboru appsettings.json přidejte následující nastavení.

"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,

Konfigurace pro prostředí DoD

Existuje také prostředí DoD, které sdílí většinu (ale ne všechny) nastavení s prostředím Office 365 GCC High. Pro prostředí DoD použijte následující nastavení.

Do souboru appsettings.json přidejte následující nastavení.

"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,

Přidání ověřování uživatelů do robota

Robot může používat různé zprostředkovatele identity pro přístup k prostředkům jménem uživatele, jako je Microsoft Entra ID a mnoho dalších zprostředkovatelů OAuth.

Prostředí Office 365 GCC High používá adresu URL přesměrování, která se liší od adresy URL používané pro jiná prostředí. Při konfiguraci robota pro ověřování v prostředí Office 365 GCC High použijte https://tokengcch.botframework.azure.us/.auth/web/redirect jako adresu URL pro přesměrování OAuth a postupujte podle pokynů v postupu přidání ověřování do robota.

Další informace

Další informace o Microsoft Azure Government a Office 365 Government High najdete v tématech:

Další kroky

Pomocí těchto kroků by měl být robot nakonfigurovaný tak, aby úspěšně fungoval v cloudu Azure Government a v prostředí Office 365 GCC High. Další užitečné reference týkající se služby Bot Service ve službě Azure Government