Registrieren eines Bots bei AzureRegister a bot with Azure

gilt für: SDK v4APPLIES TO: SDK v4

In diesem Artikel erfahren Sie, wie Sie einen Bot beim Azure Bot Service registrieren, wenn Sie ihn in Azure entwickeln und hosten.This article shows how to register a bot with the Azure Bot Service when you develop and host it in Azure.

Wenn der Bot an anderer Stelle gehostet wird, können Sie ihn auch in Azure verfügbar machen und mit den unterstützten Kanälen verbinden.If the bot is hosted elsewhere, you can also make it available in Azure and connect it to the supported channels. Sie stellen die Webadresse zur Verfügung, unter der Ihr Bot gehostet wird.You supply the web address where your bot is hosted.

Wichtig

Sie müssen einen Bot nur registrieren, wenn er nicht in Azure gehostet wird.You only need to register a bot if it is not hosted in Azure. Bots, die mit dem Azure-Portal oder der Befehlszeilenschnittstelle (COMMAND Line Interface, CLI) erstellt wurden, sind bereits beim Azure Bot Service registriert.Bots created using the Azure portal or the Command Line Interface (CLI) are already registered with the Azure Bot Service. Weitere Informationen finden Sie unter Bereitstellen Ihres Bots.For more information, see Deploy your bot.

Erstellen einer Azure Bot-RessourceCreate an Azure Bot resource

Mit der Azure Bot-Ressource können Sie Ihren Bot Framework Composer- oder SDK-Bot in Azure Bot Service registrieren.The Azure Bot resource enables you to register your Bot Framework Composer or SDK bot in Azure Bot Service. Sie können Bots erstellen, verbinden und verwalten, um mit Ihren Benutzern überall zu interagieren, von Ihrer App oder Website über Teams, Messenger und viele andere Kanäle.You can build, connect, and manage bots to interact with your users wherever they are, from your app or website to Teams, Messenger and many other channels.

Warnung

Die Registrierung von Web-App-Bots und Botkanälen ist veraltet, vorhandene Ressourcen funktionieren jedoch weiterhin. Web App Bot and Bot Channels Registration will be deprecated but existing resources will continue to work. Stattdessen sollten Sie den Azure-Bot verwenden.You should use Azure Bot, instead.

  1. Öffnen Sie das Azure-Portal.Go to the Azure portal.

  2. Wählen Sie im rechten Bereich Ressource erstellen aus.In the right pane, select Create a resource.

  3. Geben Sie im Suchfeld bot ein, und drücken Sie dann die EINGABETASTE.In the search box enter bot, then press Enter.

  4. Wählen Sie die Azure Bot-Karte aus.Select the Azure Bot card.

    Auswählen der Azure-Botressource

  5. Klicken Sie auf Erstellen.Select Create.

    Erstellen einer Azure-Botressource

  6. Geben Sie die erforderlichen Werte ein.Enter the required values. Die folgende Abbildung zeigt Die Option Create new Microsoft App ID (Neue Microsoft-App-ID erstellen) ausgewählt.The following figure shows Create new Microsoft App ID selected.

    Erstellen von Azure Bot-Ressourcenwerten

    Sie können auch Vorhandene App-Registrierung verwenden auswählen und Ihre vorhandene App-ID und Das Kennwort eingeben.You can also select Use existing app registration and enter your existing app Id and password.

    Erstellen vorhandener Werte einer Azure-Botressource

  7. Klicken Sie auf Überprüfen + erstellen.Select Review + create.

  8. Wenn die Überprüfung erfolgreich ist, wählen Sie Erstellen aus.If the validation passes, select Create.

  9. Wählen Sie Zu Ressourcengruppe wechseln aus.Select Go to resource group. Der Bot und die zugehörigen Azure Key Vault Ressourcen sollten in der ausgewählten Ressourcengruppe aufgeführt werden.You should see the bot and the related Azure Key Vault resources listed in the resource group you selected.

    Tipp

    Das App-Geheimnis (Kennwort) wird im Schlüsseltresor gespeichert, und es gibt einen Schlüsseltresor pro Ressourcengruppe.The app secret (password) is stored in the the key vault and there is one key vault per resource group. Die Verwendung von Key Vault wird empfohlen, anstatt vertrauliche Daten zu kopieren und zu speichern.Using key vault is recommended instead of copying and storing sensitive data.

  10. Wählen Sie In Composer öffnen aus.Select Open in Composer. Dies ist der empfohlene Pfad, wenn Sie noch nicht mit der Botentwicklung oder mit dem Erstellen eines ganz neuen Bots noch nicht in der Lage sind.This is the recommended path, if you are new to bot development or if you are building a brand new bot. Führen Sie die Schritte aus, die im Artikel Erstellen eines Bots in Composer beschrieben sind.Follow the steps described in the Create a bot in Composer article.

    Erstellen eines Bots in Composer

    Wählen Sie optional SDK von GitHub herunterladen aus, um Ihren Bot mit dem Bot Framework SDK zu erstellen, das Ihnen hilft, alles zu erstellen– von einem moderaten Chatbot bis hin zu erstklassigen Unternehmenslösungen.Optionally, select Get the SDK from Github to build your bot with the Bot Framework SDK that helps you create everything from a modest chatbot to world class, enterprise solutions.

    Erstellen eines Bots im SDK

Informationen zu Azure Key VaultAbout Azure Key Vault

Azure Key Vault ist ein Dienst, der eine zentralisierte Verwaltung von Geheimnissen mit voller Kontrolle über Zugriffsrichtlinien und Überprüfungsverlauf ermöglicht.Azure Key Vault is a service that provides centralized secrets management, with full control over access policies and audit history. Weitere Informationen erhalten Sie unter Verwenden von Key Vault-Verweisen in App Service und Azure Functions.For more information, see Use Key Vault references for App Service and Azure Functions. Beachten Sie, dass Ihnen eine kleine Gebühr für die Nutzung des Diensts in Rechnung gestellt wird. Weitere Informationen finden Sie unter Key Vault Preise.Note that you will be charged a small fee for using the service, For more information, see Key Vault pricing.

App-ID und KennwortApp Id and password

Sie benötigen die Azure Bot-Ressourcen-App-ID und das Kennwort, um Ihren Bot für die Bereitstellung zu konfigurieren.You need the Azure bot resource app Id and password to configure your bot for deployment. Sie weisen deren Werte den zugehörigen Variablen zu: MicrosoftAppId und sind in Ihrer MicrosoftAppPassword Botprojektkonfigurationsdatei enthalten.You will assign their values to the related variables: MicrosoftAppId and MicrosoftAppPassword contained in your bot project configuration file. Die Datei unterscheidet sich je nach Programmiersprache, die Sie zum Erstellen des Bots verwenden, wie in der folgenden Tabelle gezeigt.The file differs depending on the programming language you use to create the bot, as shown in the table below.

SpracheLanguage DateinameFile Name
CsharpCsharp appsettings.json
JavaScriptJavaScript .env
PythonPython config.py
JavaJava application.properties

Get Azure bot resource app IdGet Azure bot resource app Id

  1. Öffnen Sie das Azure-Portal.Go to the Azure portal.
  2. Wählen Sie die Azure-Botressource aus, um ihre App-ID zu erhalten.Select the Azure bot resource to obtain its app Id.
  3. Wählen Sie im linken Bereich im Abschnitt Einstellungen die Option Konfiguration aus.In the left pane, in the Settings section, select Configuration.
  4. Kopieren und speichern Sie den wert, der im Feld Microsoft-App-ID enthalten ist.Copy and save the value contained in the Microsoft App ID box.

Erhalten des Azure Bot-Ressourcenkennworts aus dem Azure-SchlüsseltresorGet Azure bot resource password from the Azure key vault

Sie können auf die Azure Key Vault zugreifen, um Ihr gespeichertes Kennwort für die Ressource zu erhalten.You can access the Azure Key Vault to obtain your resource stored password. Azure Key Vault ist ein Dienst, der eine zentralisierte Verwaltung von Geheimnissen mit voller Kontrolle über Zugriffsrichtlinien und Überprüfungsverlauf ermöglicht.Azure Key Vault is a service that provides centralized secrets management, with full control over access policies and audit history. Weitere Informationen finden Sie unter Use Key Vault references for App Service and Azure Functions.Fpr more information, see Use Key Vault references for App Service and Azure Functions.

Zusätzliche InformationenAdditional information

Manuelle App-RegistrierungManual app registration

Eine manuelle Registrierung ist in folgenden Situationen erforderlich:A manual registration is necessary for situations like:

  • Sie können keine Registrierungen in Ihrer Organisation vornehmen und benötigen eine Drittpartei, um die App-ID für den Bot zu erstellen, den Sie entwickeln.You are unable to make the registrations in your organization and need another party to create the App ID for the bot you're building.
  • Sie müssen manuell Ihre eigene App-ID und Ihr Kennwort erstellen.You need to manually create your own app ID and password.

Wichtig

Wählen Sie beim Erstellen der App im Abschnitt Unterstützt Kontotypen eine der folgenden Optionen für mehr mandantenbasierte Typen aus:When creating the app, in the section Supports account types, choose one of the following multi-tenant types options:

typeType BeschreibungDescription
Konten in einem beliebigen Organisationsverzeichnis (beliebige Azure AD – mehrstantig)Accounts in any organizational directory (Any Azure AD - Multitenant) Diese Option bietet weniger Gefährdung durch Einschränken des Zugriffs und für den Fall, dass OAuth nicht unterstützt wird.This option provides less exposure by restricting access and in case OAuth is not supported.
Konten in einem beliebigen Organisationsverzeichnis (beliebige Azure AD – mehrtenant) und persönliche Microsoft-Konten (z. B. Xbox, Outlook.com)Accounts in any organizational directory (Any Azure AD - Multitenant) and personal Microsoft accounts (for example, Xbox, Outlook.com) Diese Option eignet sich gut für die Unterstützung der OAuth- und Botauthentifizierung.This option is well-suited to support OAuth and bot authentication.

Weitere Informationen finden Sie unter Registrieren einer Anwendung bei Microsoft Identity Platform.For more information, see Register an application with the Microsoft identity platform.

Aktualisieren des BotsUpdate the bot

Legen Sie die folgenden Schlüsselwerte in der appsettings.json Datei fest:Set the following key values in the appsettings.json file:

  • MicrosoftAppId = <appId>
  • MicrosoftAppPassword = <appSecret>

Nächste SchritteNext steps