Einführung

  • 12 Minuten

Dieses Modul untersucht benutzerdefinierte Konnektoren und erklärt, wie sie konfiguriert und mit Microsoft Power Apps, Microsoft Power Automate und Microsoft Azure Logic Apps verwendet werden.

In diesem Modul lernen Sie Folgendes:

  • Mehr über die Rolle von benutzerdefinierten Konnektoren erfahren

  • Einen Konnektor erstellen und ihn in einem Power Automate-Flow verwenden

Mithilfe von Konnektoren können App‑ und Flowentwickler auf folgende Weise eine Verbindung zu anderen Apps, Daten und Geräten in der Cloud herstellen:

  • Die Verbindung wird auf eine konsistente, wiederholbare Weise hergestellt, die von den Entwicklern entdeckt werden kann.

  • Konnektoren verfügen über Aktionen, mit denen Entwickler steuern können, wann ein Vorgang ausgeführt wird.

  • Konnektoren können Trigger haben, mit denen die Automatisierung gestartet werden kann, wenn das auslösende Ereignis auftritt.

Diagramm mit API in der Mitte, umgeben von Konnektor und dann Power Automate, Power Apps und Logic Apps

Ein Konnektor ist ein Proxy oder ein Wrapper einer API, mit dem der zugrunde liegende Dienst mit Power Automate, Power Apps und Logic Apps kommunizieren kann. Viele Konnektoren sind vordefiniert und können verwendet werden, ohne dass Sie etwas definieren müssen. Diese integrierten Konnektordefinitionen umfassen Dienste von Microsoft und anderen. Wenn der Dienst oder die API, die Sie verwenden möchten, keinen vorgefertigten Konnektor hat, können Sie Ihren eigenen benutzerdefinierten Konnektor erstellen. Wenn ein vorgefertigter Konnektor nicht alle Trigger und Aktionen verfügbar macht, die Sie von der API benötigen, können Sie zusätzlich zu dem verfügbaren einen benutzerdefinierten Konnektor erstellen, um diese zusätzlichen Anforderungen zu erfüllen. Nachdem der benutzerdefinierte Konnektor definiert wurde, kann er verwendet werden, wenn Sie Apps und Flows in dieser Umgebung erstellen, ähnlich wie bei den integrierten Konnektoren.

Ein übergeordneter Prozess ist das Identifizieren oder Erstellen einer API, das Beschreiben der API, das Verwenden des Konnektors und das Zertifizieren von Open Source

Die API identifizieren oder erstellen

Ihre erste Aufgabe ist es, die Anschlussreferenz zu überprüfen, um festzustellen, ob für die API/den Service bereits ein geeigneter Konnektor vorhanden ist. Wenn noch kein geeigneter Konnektor vorhanden ist, können Sie Ihren eigenen benutzerdefinierten Konnektor erstellen. Sie können den benutzerdefinierten Konnektor so definieren, dass er jede öffentliche (im Internet verfügbare) oder private (nur in Ihrem internen Netzwerk) REST-API beschreibt. Private APIs erfordern das Lokale Datengateway für Zugriff auf interne Ressourcen.

Wenn noch keine kompatible API vorhanden ist, können Entwickler eine erstellen, indem sie eine beliebige Technologie verwenden, die eine REST-API hosten kann, einschließlich Microsoft Azure-Funktionen und Azure App Services. Sie können auch zur Verbesserung der Verwaltbarkeit und Steuerung der APIs Azure API Management verwenden.

Die API beschreiben

Um mit Power Apps und Power Automate herauszufinden, welche Trigger und Aktionen in der API verfügbar sind, müssen Sie sie beim Erstellen Ihres benutzerdefinierten Konnektors identifizieren. Sie können diese Aufgabe ausführen, indem Sie die Konnektordefinition im Entwicklerportal manuell bearbeiten oder eine Definition in ein unterstütztes Format importieren. Dieser Prozess umfasst das Identifizieren der Authentifizierungsanforderungen für die API.

Den Konnektor verwenden

Nachdem sie in einer Umgebung erstellt wurden, können benutzerdefinierte Konnektoren auf dieselbe Weise wie integrierte Konnektoren verwendet werden. Diese Konnektoren können auch in einer anderen Umgebung als der verwendet werden, in der Sie sie erstellt haben. Die Konnektordefinition muss aus der Umgebung exportiert, in der sie erstellt wurde, und dann in jede Umgebung importiert werden, in der sie benötigt wird. Sie können den Konnektor auch für andere Personen freigeben, damit diese ihn wie andere freigegebene Ressourcen verwenden können.

Den Konnektor als Open Source zertifizieren und teilen

Da benutzerdefinierte Konnektoren nur in Umgebungen verfügbar sind, in denen ihre Definition vorhanden ist, stehen sie anderen Microsoft-Kunden nicht zur Verfügung. Indem Sie eine benutzerdefinierte Konnektordefinition als Open Source freigeben, stellen Sie sie auf GitHub anderen Kunden zum Import in ihre Umgebungen zur Verfügung. Durch die Zertifizierung Ihres Konnektors können Sie den von Ihnen erstellten benutzerdefinierten Konnektor in allen Kundenumgebungen als vorgefertigten Konnektor verfügbar machen. Für die Zertifizierung eines Konnektors müssen Sie Eigentümer der API sein oder über die ausdrückliche Berechtigung zum Veröffentlichen eines Konnektors vom API-Eigentümer verfügen.

Weitere Informationen finden Sie unter Zertifizierungsprozess.

Dieser Schritt im Prozess ist optional und nur erforderlich, wenn Sie Ihren Konnektor freigeben und als zertifiziert auflisten lassen möchten. Interne Konnektoren müssen diesen Zertifizierungsprozess nicht abschließen.

Den Konnektor beschreiben

Um die Aktionen und Trigger eines Konnektors zu definieren, müssen Sie den Konnektor beschreiben. Ein benutzerdefinierter Konnektor kann definiert werden, indem nur die API-Trigger und ‑Aktionen beschrieben werden, die Sie benötigen. Wenn für eine API beispielsweise 100 Aktionen und 10 Trigger verfügbar sind, können Sie einen benutzerdefinierten Konnektor mit einer einzelnen Aktion erstellen. Sie können später auch mehr beschreiben, wenn sich Ihre Anforderungen ändern.

Wenn Sie die API beschreiben, verwenden Sie mindestens einen der folgenden Ansätze. Wenn Sie eine OpenAPI-Definition importieren möchten, können Sie die Definition Ihres Konnektors im Portal weiterhin manuell bearbeiten.

  • Manuell im Portal erstellen – Wenn Sie diesen Ansatz verwenden, verwenden Sie die API-Dokumentation und Beispiele für Ein‑ und Ausgaben. Definieren dann jede Aktion und jeden Trigger. Dieser Ansatz eignet sich für einfache APIs, bei denen Sie die Definition nicht importieren können. Sie können diesen Ansatz auch verwenden, um die Definitionen nach dem Import zu verfeinern.

  • OpenAPI-Definition importieren - OpenAPI ist eine Spezifikation, die REST beschreibt und die Aufgaben beim Entwickeln und Konsumieren einer API vereinfacht, indem alle damit verbundenen Ressourcen und Vorgänge effektiv zugeordnet werden. Viele Services/APIs veröffentlichen eine OpenAPI-Definition, und Sie können sie importieren, um die API im benutzerdefinierten Konnektor zu beschreiben. Das Importieren von Version 2.0 wird unterstützt, Version 3.0 wird derzeit jedoch nicht unterstützt. Dieser Ansatz ist nützlich, wenn eine OpenAPI-Definition beim API-Herausgeber verfügbar ist oder wenn Sie die API entwickeln, können Sie eine veröffentlichen.

  • Von GitHub importieren – Importieren Sie Konnektoren aus dem Power Platform-Konnektorenrepository. Dies ist der beste Ansatz, wenn bereits ein Konnektor im Repository veröffentlicht ist und Sie ihn importieren möchten, um ihn zu ändern oder als benutzerdefinierten Konnektor zu verwenden.

  • Aus Azure exportieren – Wenn Ihre API als Azure App Service oder Microsoft Azure Functions erstellt wurde oder von Microsoft Azure API Management verwaltet wird, können Sie aus diesen Services exportieren, und es wird automatisch die anfängliche benutzerdefinierte Konnektordefinition erstellt.

Mit authentifizierten APIs arbeiten

Die benutzerdefinierte Konnektorarchitektur unterstützt das Arbeiten mit authentifizierten APIs. Wenn Sie den benutzerdefinierten Konnektor definieren, legen Sie fest, wie er sich bei der API authentifizieren soll. Die Authentifizierungsoptionen unterstützen den anonymen, kennwortgeschützten Zugriff auf OAuth 2.0 und API-Schlüssel.

  • Keine Authentifikation – Diese Option gilt für APIs, die anonymen Zugriff ermöglichen. Sie ist die Standardeinstellung, wenn Sie keinen bestimmten Authentifizierungstyp konfigurieren.

  • Standardauthentifizierung – Diese Option gilt für APIs, für die bei jeder Anforderung ein Benutzer und ein Kennwort gesendet werden müssen.

  • OAuth 2.0 - OAuth 2.0 ist das Industriestandardprotokoll für die Autorisierung. Diese Option kann für jede API konfiguriert werden, die OAuth 2.0 verwendet. Vorgefertigte Konfigurationen stehen Ihnen zur Auswahl bereit, z. B. für Microsoft-Dienste wie Microsoft Entra ID, GitHub und Azure DevOps. Ähnliche vorgefertigte Konfigurationen sind für andere Dienste wie Dropbox, Slack, Stripe und mehr verfügbar. Die vorgefertigten Konfigurationen vereinfachen das, was Sie zum Konfigurieren des Identitätsanbieters bereitstellen müssen.

  • API-Schlüssel – Ein API-Schlüssel ist ein Token, das ein Client beim Ausführen von API-Aufrufen bereitstellt. Der API-Herausgeber stellt normalerweise den Schlüssel bereit und muss in jeder Anforderung über den benutzerdefinierten Konnektor enthalten sein.

Benutzerdefinierte Konnektoren erleichtern App‑ und Flowentwicklern die Verwendung von APIs/Diensten. Meistens könnten Entwickler die API ohne Konnektor direkt aufrufen. Sie müssten jedoch wissen, wie sie die Anforderung zusammenstellen, die Ergebnisse interpretieren und dann die Authentifizierung durchführen. Dieser Vorgang muss jedes Mal abgeschlossen werden, wenn die App oder der Flow benutzerdefinierte Konnektoren verwendet.

Darüber hinaus ist es für einen Entwickler nicht immer einfach, benutzerdefinierte Konnektoren mit Triggern zu erstellen, mit denen Flows durch Ereignisse gestartet werden können. Mit benutzerdefinierten Konnektoren können Sie leichter feststellen, wie Aktionen und deren Ergebnisse verwendet werden, wenn Sie eine App oder einen Flow erstellen, der den Konnektor verwendet.

In der nächsten Lerneinheit wird erläutert, wie Sie einen benutzerdefinierten Konnektor erstellen.