Konfigurieren eines Bots in Microsoft Azure, betrieben von 21Vianet

Artikel
09/26/2024

Dieser Leitfaden hilft Microsoft Azure-Kunden bei der Bereitstellung von Bot Framework und Azure AI Bot Service-Bots auf der Von 21Vianet betriebenen Microsoft Azure-Plattform.

Voraussetzungen

Ein Konto in Microsoft Azure.
Das C#- oder JavaScript-Botprojekt, das Sie konfigurieren möchten.
Bot Framework SDK Version 4.14 oder höher.

Verwenden des Cloudadapters

Stellen Sie sicher, dass Ihr Bot den Cloudadapter oder einen Adapter verwendet, der vom Cloudadapter abgeleitet ist. Mit dem Cloudadapter können Sie Einstellungen angeben, die für die Microsoft Azure Cloud spezifisch sind.

C#
JavaScript

Die ConfigurationBotFrameworkAuthentication Klasse liest die Authentifizierungseinstellungen aus Ihrer Bot-Konfigurationsdatei. Bei der Erstellung verwendet der Cloudadapter diese Authentifizierungseinstellungen.

Stellen Sie sicher, dass die ConfigureServices Methode in derDatei Startup.cs diese Zeile enthält.

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

ConfigurationBotFrameworkAuthentication Konstruktor liest die Authentifizierungseinstellungen aus Ihrer Bot-Konfigurationsdatei.

In der Datei index.js sollte der Code zum Erstellen des Adapters wie folgt aussehen:

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

Konfigurieren von UserAssignedMSI/SingleTenant Bot

Um sicherzustellen, dass der Bot in der Microsoft Azure Cloud ordnungsgemäß funktioniert, sind zusätzliche Authentifizierungseinstellungen erforderlich. Ersetzen Sie die "App-Tenant-ID" durch die Mandanten-ID des Bots.

C#
JavaScript

Fügen Sie der Datei appsettings.json die folgenden Einstellungen hinzu.

"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

Fügen Sie der Datei .env die folgende Einstellungen hinzu.

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

Konfigurieren des MultiTenant-Bots

Verwenden Sie für den Multitenant-Bot die folgenden Einstellungen.

C#
JavaScript

Fügen Sie der Datei appsettings.json die folgenden Einstellungen hinzu.

"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

Fügen Sie der Datei .env die folgende Einstellungen hinzu.

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

Benutzer-Authentifizierung zu Ihrem Bot hinzufügen

Ihr Bot kann verschiedene Identitätsanbieter verwenden, um im Namen eines Benutzers auf Ressourcen zuzugreifen, z. B. Microsoft Entra ID und viele andere OAuth-Anbieter.

Die Microsoft Azure Cloud verwendet eine Umleitungs-URL, die sich von den für andere Umgebungen verwendeten unterscheidet. Um Ihren Bot für die Authentifizierung zu konfigurieren, verwenden Sie https://token.botframework.azure.cn/.auth/web/redirect die OAuth-Umleitungs-URL, und führen Sie die Schritte zum Hinzufügen der Authentifizierung zu Ihrem Bot aus.

Konfigurieren eines Bots zur Ausführung in einem oder mehreren Kanälen

Führen Sie die folgenden Schritte aus, um einen Bot für eine Verbindung mit einem Kanal zu konfigurieren:

Melden Sie sich beim Azure-Portal an.
Wählen Sie den Bot aus, den Sie konfigurieren möchten.
Wählen Sie im linken Bereich unter Einstellungen die Option Einstellungen.
Klicken Sie im rechten Blatt auf das Symbol des Kanals, den Sie Ihrem Bot hinzufügen möchten. Möglicherweise müssen Sie nach unten scrollen, um die Liste aller verfügbaren Kanäle anzuzeigen. Die Verbindungsschritte variieren je nach Kanal. Weitere Informationen zu unterstützten Kanälen finden Sie in den zugehörigen Artikeln.

Kanal	Beschreibung
Direct Line	Integrieren Sie einen Bot in eine mobile App, Webseite oder andere Anwendungen.
Microsoft Teams	Sie können Ihren Bot so konfigurieren, dass er mit Benutzern über Microsoft Teams kommuniziert.
Webchat	Automatisch für Sie konfiguriert, wenn Sie einen Bot mit Bot Framework Service erstellen.

Nächste Schritte

Mit diesen Schritten sollte Ihr Bot so konfiguriert werden, dass er erfolgreich funktioniert. Weitere nützliche Referenzen zu Bot Service.

Freigeben über