Benutzerdefinierte ConnectorsCustom Connectors

Während Azure Logic Apps, Microsoft Power Automate, und Microsoft Power Apps über 325+ Konnektoren die Verbindung zu Microsoft und Nicht-Microsoft-Diensten ermöglichen, möchten Sie vielleicht mit Diensten kommunizieren, die nicht als vorgefertigte Konnektoren verfügbar sind.While Azure Logic Apps, Microsoft Power Automate, and Microsoft Power Apps offer over 325+ connectors to connect to Microsoft and non-Microsoft services, you may want to communicate with services that aren't available as prebuilt connectors. Hier kommen benutzerdefinierte Connectors ins Spiel: Mit diesen Connectors können Sie einen Connector mit eigenen Triggern und Aktionen erstellen (und sogar freigeben).Custom connectors address this scenario by allowing you to create (and even share) a connector with its own triggers and actions.

LebenszyklusLifecycle

1. Erstellen Sie Ihre API1. Build your API

Ein benutzerdefinierter Konnektor ist ein Wrapper um eine REST-API (Logic Apps unterstützt auch SOAP-APIs), der es Logic Apps, Power Automate oder Power Apps, ermöglicht, mit dieser REST- oder SOAP-API zu kommunizieren.A custom connector is a wrapper around a REST API (Logic Apps also supports SOAP APIs) that allows Logic Apps, Power Automate, or Power Apps to communicate with that REST or SOAP API. Diese APIs können es sein:These APIs can be:

  • Öffentlich (sichtbar im öffentlichen Internet), wie z.B. Spotify, Slack, Rackspace, oder eine von Ihnen verwaltete APIPublic (visible on the public internet) such as Spotify, Slack, Rackspace, or an API you manage
  • Privat (nur für Ihr Netzwerk sichtbar)Private (visible only to your network)

Für öffentliche APIs, die Sie erstellen und verwalten möchten, sollten Sie die Verwendung eines dieser Microsoft Azure-Produkte in Betracht ziehen:For public APIs that you plan to create and manage, consider using one of these Microsoft Azure products:

Für private APIs bietet Microsoft eine lokale Datenkonnektivität über ein on-premises Daten-Gateway an.For private APIs, Microsoft offers on-premises data connectivity through an on-premises data gateway. Diese Gateways werden von Logic Apps, Power Automate und Power Apps, unterstützt.These gateways are supported by Logic Apps, Power Automate, and Power Apps.

2. Sichern Sie Ihre API2. Secure your API

Verwenden Sie eine dieser Standardauthentifizierungsmethoden für Ihre APIs und Konnektoren (Azure Active Directory wird empfohlen):Use one of these standard authentication methods for your APIs and connectors (Azure Active Directory is recommended):

Sie können eine Azure AD-Authentifizierung für Ihre API im Azure-Portal einrichten, sodass Sie keine Authentifizierung implementieren müssen, oder Sie können eine Authentifizierung im Code Ihrer API verlangen und durchsetzen.You can set up Azure AD authentication for your API in the Azure portal so you don't have to implement authentication, or you can require and enforce authentication in your API's code. Weitere Informationen zu Azure AD für benutzerdefinierte Connectors finden Sie unter Sichern von APIs und Connectors mithilfe von Azure AD.For more information about Azure AD for custom connectors, see Secure your API and connector with Azure AD.

3. Beschreiben Sie die API und definieren Sie den benutzerdefinierten Konnektor3. Describe the API and define the custom connector

Sobald Sie über eine API mit authentifiziertem Zugriff verfügen, müssen Sie als Nächstes Ihre API beschreiben, damit Logic Apps, Power Automate oder Power Apps, mit Ihrer API kommunizieren können.Once you have an API with authenticated access, the next thing to do is to describe your API so that Logic Apps, Power Automate, or Power Apps can communicate with your API. Die folgenden Ansätze werden unterstützt:The following approaches are supported:

OpenAPI-Definitionen und Postmann-Sammlungen verwenden unterschiedliche Formate, aber beide sind sprachunabhängige, maschinenlesbare Dokumente, die Ihre API beschreiben.OpenAPI definitions and Postman collections use different formats, but both are language-agnostic, machine-readable documents that describe your API. Sie können diese Dokumente aus verschiedenen Tools generieren, die auf der von Ihrer API verwendeten Sprache und Plattform basieren.You can generate these documents from various tools based on the language and platform used by your API. Hinter den Kulissen verwenden Logic Apps, Power Automate und Power Apps OpenAPI, um Konnektoren zu definieren.Behind the scenes, Logic Apps, Power Automate, and Power Apps use OpenAPI to define connectors.

4. Verwenden Sie Ihren Konnektor in einer Logic App, Power Automate oder Power Apps Anwendung4. Use your connector in a Logic App, Power Automate, or Power Apps app

Benutzerdefinierte Connectors werden auf die gleiche Weise verwendet wie von Microsoft verwaltete Connectors.Custom connectors are used the same way Microsoft-managed connectors are used. Sie müssen eine Verbindung mit Ihrer API erstellen, die Sie dann zum Aufrufen der Vorgänge verwenden können, die Sie in Ihrem benutzerdefinierten Connector verfügbar gemacht haben.You'll need to create a connection to your API and then you can use that connection to call any operations that you've exposed in your custom connector.

Konnektoren, die in Power Automate erstellt wurden, sind in Power Apps verfügbar.Connectors created in Power Automate are available in Power Apps. Ebenso sind Konnektoren, die in Power Apps erstellt wurden, in Power Automate verfügbar.Likewise, connectors created in Power Apps are available in Power Automate. Dies gilt nicht für Konnektoren, die in Logik-Apps erstellt wurden, aber Sie können die OpenAPI-Definition oder die Postman-Sammlung wiederverwenden, um den Konnektor in jedem dieser Dienste neu zu erstellen.This is not true for connectors created in Logic Apps, but you can reuse the OpenAPI definition or Postman collection to recreate the connector in any of these services. Weitere Informationen finden Sie im entsprechenden Tutorial:For more information, see the appropriate tutorial:

5. Teilen Sie Ihren Konnektor5. Share your connector

Sie können Ihren Konnektor für Benutzer in Ihrer Organisation auf dieselbe Weise freigeben, wie Sie Ressourcen in Logic Apps, Power Automate oder Power Apps, freigeben.You can share your connector with users in your organization in the same way that you share resources in Logic Apps, Power Automate, or Power Apps. Die gemeinsame Nutzung ist optional, aber möglicherweise gibt es Szenarien, in denen Sie Ihre Konnektoren für andere Benutzer freigeben möchten.Sharing is optional, but you may have scenarios where you want to share your connectors with other users.

Weitere Informationen finden Sie unter Benutzerdefinierte Konnektoren in Ihrer Organisation gemeinsam nutzen.For more information, see Share custom connectors in your organization.

6. Zertifizieren Sie Ihren Konnektor6. Certify your connector

Wenn Sie Ihren Konnektor für alle Benutzer von Logic Apps Power Automate und Power Apps freigeben möchten, können Sie Ihren Konnektor zur Microsoft-Zertifizierung einreichen.If you'd like to share your connector with all users of Logic Apps, Power Automate, and Power Apps, you can submit your connector for Microsoft certification. Microsoft überprüft den Connector und untersucht die technische und inhaltliche Konformität sowie die Funktionalität.Microsoft will review your connector, check for technical and content compliance, and validate functionality.

Weitere Informationen finden Sie unter Senden Sie Ihre Konnektoren für die Microsoft-Zertifizierung ein.For more information, see Submit your connectors for Microsoft certification.

LernprogrammTutorial

Das Lernprogramm verwendet die Cognitive Services Text Analytics API.The tutorial uses the Cognitive Services Text Analytics API. Microsoft stellt bereits einen Konnektor für diese API zur Verfügung, aber er ist ein gutes Beispiel für die Vermittlung des Lebenszyklus von benutzerdefinierten Konnektoren und dafür, wie benutzerdefinierte Konnektoren einzigartige Szenarien unterstützen können.Microsoft already provides a connector for this API, but it is a good example for teaching the custom connector lifecycle and how custom connectors can support unique scenarios.

SzenarioScenario

Der Connector, den Sie erstellen, macht den Stimmungsvorgang der Textanalyse verfügbar. Dieser gibt den Stimmungswert (0,000 bis 1,000) für die Texteingabe zurück.The connector you'll build exposes the Text Analytics Sentiment operation, which returns the sentiment score (0.000 to 1.000) for the text input.

VoraussetzungenPrerequisites

  • Eines der folgenden Abonnements:One of the following subscriptions:
  • Grundlegendes Verständnis für die Erstellung von Logik-Apps, Power Automate-Flows oder Power AppsBasic understanding of how to create Logic Apps, Power Automate flows, or Power Apps
  • API-Schlüssel für die Cognitive Services-API zur TextanalyseAPI key for the Cognitive Services Text Analytics API

Einen API-Schlüssel erhaltenGet an API key

Die Textanalyse-API verwendet einen API-Schlüssel zur Authentifizierung von Benutzern.The Text Analytics API uses an API key to authenticate users. Wenn ein Benutzer eine Verbindung zur API über einen benutzerdefinierten Konnektor herstellt, gibt der Benutzer den Wert dieses Schlüssels an.When a user creates a connection to the API through a custom connector, the user specifies the value of this key. Sie können einen API-Schlüssel erhalten, indem:You can get an API key by:

Starten Sie das TutorialStart the tutorial

Fortgeschrittene TutorialsAdvanced tutorials

Die folgenden Tutorials bieten mehr Details für spezifische benutzerdefinierte Konnektor-Szenarien:The following tutorials provide more detail for specific custom connector scenarios: