Freigeben über

Übersicht über benutzerdefinierte Connectors

  • Artikel

Obwohl Azure Logic Apps, Microsoft Power Automate und Microsoft Power Apps über 1.000 Konnektoren für die Verbindung mit Microsoft und verifizierten Diensten bieten, möchten Sie möglicherweise mit Diensten kommunizieren, die nicht als vorgefertigte Konnektoren verfügbar sind. Angepasste Konnektoren adressieren dieses Szenario, indem sie es Ihnen erlauben, einen Konnektor mit eigenen Auslösern und Aktionen zu erstellen (und sogar gemeinsam zu nutzen).

Screenshot, der zeigt, wie benutzerdefinierte Konnektoren die Text Analytics API mit Apps verbinden.

Anmeldung

Screenshot des Lebenszyklus benutzerdefinierter Konnektoren in fünf Phasen.

1. Erstellen Sie Ihre API

Ein benutzerdefinierter Connector ist ein Wrapper für eine REST-API, der es Logic Apps, Power Automate oder Power Apps ermöglicht, mit dieser REST- oder SOAP-API zu kommunizieren. Diese APIs können es sein:

  • Öffentlich (im öffentlichen Internet sichtbar), wie beispielsweise Spotify, Slack, Rackspace oder eine von Ihnen verwaltete API.
  • Privat (nur für Ihr Netzwerk sichtbar).

Logic Apps unterstützt auch SOAP-APIs.

Für öffentliche APIs, die Sie erstellen und verwalten möchten, sollten Sie die Verwendung eines dieser Microsoft Azure-Produkte in Betracht ziehen:

Für private APIs bietet Microsoft lokale Datenkonnektivität über ein lokales Datengateway an.

2. Sichern Sie Ihre API

Verwenden Sie eine dieser Standardauthentifizierungsmethoden für Ihre APIs und Konnektoren (Microsoft Entra ID wird empfohlen):

Sie können eine Microsoft Entra ID-Authentifizierung für Ihre API im Azure-Portal festlegen, sodass Sie keine Implementierung der Authentifizierung vornehmen müssen. Oder Sie können die Authentifizierung im Code Ihrer API verlangen und erzwingen. Weitere Informationen zur Microsoft Entra ID für benutzerdefinierte Konnektoren finden Sie unter Sichern Sie Ihre API und Ihren Konnektor mit der Microsoft Entra ID.

2.1. OAuth 2.0

Neu erstellte benutzerdefinierte Konnektoren, die OAuth 2.0 zur automatischen Authentifizierung verwenden, verfügen über eine Umleitungs-URI pro Konnektor. Vorhandene OAuth 2.0-Konnektoren müssen vor dem 17. Februar 2024 aktualisiert werden, um eine Umleitungs-URI pro Konnektor zu verwenden.

  • Wenn Sie Ihre benutzerdefinierten Konnektoren mit der Weboberfläche erstellt haben, bearbeiten Sie Ihre benutzerdefinierten Konnektoren, gehen Sie zur Registerkarte Sicherheit und aktivieren Sie das Kontrollkästchen Auf eindeutige Umleitungs-URL aktualisieren. Speichern Sie anschließend, um die Umleitungs-URI pro Konnektor zu aktivieren.
  • Wenn Sie Ihre benutzerdefinierten Konnektoren mit Multiauthentifizierung mithilfe des Befehlszeilenschnittstellentools (CLI) erstellt haben, müssen Sie Ihren Konnektor mithilfe des CLI-Tools aktualisieren, um "redirectMode": "GlobalPerConnector" festzulegen.
  • Sobald benutzerdefinierte Konnektoren aktualisiert wurden, um die Umleitungs-URI pro Konnektor entweder über die Einstellung auf der Registerkarte Sicherheit oder über das CLI-Tool zu verwenden, entfernen Sie die globale Umleitungs-URI aus Ihren OAuth 2.0-Apps. Sie sollten die neu generierte eindeutige Umleitungs-URL zu Ihren OAuth 2.0-Apps hinzufügen.
  • Wir werden dieses Update ab dem 17. Februar 2024 für vorhandene OAuth benutzerdefinierte 2.0-Konnektoren erzwingen. Jeder benutzerdefinierte Connector, der nicht für die Verwendung einer Umleitungs-URI pro Connector aktualisiert wurde, funktioniert bei neuen Verbindungen nicht mehr und zeigt dem Benutzer eine Fehlermeldung an.
  • Um herauszufinden, welche benutzerdefinierten Konnektoren ein Update benötigen, um zur Umleitungs-URL pro Konnektor zu migrieren, können Sie einen Flow erstellen, der die Aktion Benutzerdefinierte Konnektoren als Administrator abrufen von Power Apps für den Administrator-Konnektor verwendet und dessen Ergebnis analysiert. Der später in diesem Artikel angehängte Flow ruft alle benutzerdefinierten Konnektoren mit demselben ab. Anschließend wird eine Filterbedingung auf die Eigenschaft des Verbindungsparameters angewendet, um benutzerdefinierte Nicht-OAuth-Konnektoren herauszufiltern, gefolgt von einem weiteren Filter, um nur Konnektoren auszuwählen, die nicht die für jeden Konnektor eindeutige Umleitungs-URL verwenden. Schließlich fügt er die ausgewählten benutzerdefinierten Konnektoren in eine Array-Variable ein, die zu Beginn des Flows initialisiert wurde, und generiert eine HTML-Tabelle mit den Namen und Erstellenden dieser Konnektoren. Sie können diesen Flow in Ihre Umgebung importieren, indem Sie diese Lösung importieren. Sie können den Flow noch erweitern, um die HTML-Tabelle als E-Mail an sich selbst zu senden. Alternativ Sie können ihn erweitern, um E-Mails direkt an die Erstellenden von Connectors zu senden und ihnen die Namen des Connectors mitzuteilen, der aktualisiert werden muss.

3. Beschreiben Sie die API und definieren Sie den benutzerdefinierten Konnektor

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. Die folgenden Ansätze werden unterstützt:

OpenAPI-Definitionen und Postman-Sammlungen verwenden verschiedene Formate, sind jedoch beide sprachunabhängig maschinenlesbare Dokumente, in denen Ihre API beschrieben wird. Sie können diese Dokumente aus verschiedenen Tools generieren, die auf der von Ihrer API verwendeten Sprache und Plattform basieren. Im Hintergrund verwenden Logic Apps, Power Automate und Power Apps OpenAPI, um Konnektoren zu definieren.

4. Verwenden Sie Ihren Konnektor in einer Logic App, Power Automate- oder Power Apps-App

Angepasste Konnektoren werden auf die gleiche Weise wie vorgefertigte Konnektoren verwendet. Sie müssen eine Verbindung zu Ihrer API erstellen, um diese Verbindung zu verwenden, um alle Vorgänge aufzurufen, die Sie in Ihrem angepassten Connector freilegen.

In Power Automate erstellte Konnektoren sind in Power Apps verfügbar, und in Power Apps erstellte Konnektoren sind in Power Automate verfügbar. Diese Verfügbarkeit gilt nicht für in Logic Apps erstellte Konnektoren. Sie können die OpenAPI-Definition oder Postman-Sammlung jedoch wiederverwenden, um den Connector in einem dieser Dienste neu zu erstellen. Weitere Informationen finden Sie im entsprechenden Tutorial:

Trinkgeld

Wenn Sie ein Feld in der API aktualisieren (entfernen, hinzufügen oder ändern), führen Sie diese Schritte aus:

  1. Veröffentlichen Sie den Connector erneut, damit er den aktualisierten Swagger für die API anzeigt.
  2. Entfernen Sie alle Verbindungen/Datenquellen in allen Apps, die diesen Connector verwendet haben.
  3. Fügen Sie die Verbindung/Datenquelle für diesen Connector wieder zu den Apps hinzu.

5. Teilen Sie Ihren Konnektor

Sie können Ihren Konnektor für Benutzer in Ihrer Organisation auf die gleiche Weise freigeben, wie Sie Ressourcen in Logic Apps, Power Automate oder Power Apps freigeben. Die gemeinsame Nutzung ist optional, aber möglicherweise gibt es Szenarien, in denen Sie Ihre Connectors für andere Benutzende freigeben möchten.

Weitere Informationen finden Sie unter Freigeben benutzerdefinierter Konnektoren in Ihrer Organisation.

6. Zertifizieren Sie Ihren Konnektor

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. Microsoft überprüft Ihren Connector, prüft auf technische und inhaltliche Konformität und validiert die Funktionalität.

Weitere Informationen finden Sie unter Senden Sie Ihre Konnektoren zur Microsoft-Zertifizierung.

Unterstützung von Virtual Network

Wenn der Connector in einer Power Platform Umgebung verwendet wird, die mit einem virtuellen Netzwerk verknüpft ist, gelten Einschränkungen:

  • Bei der Verwendung von benutzerdefiniertem Code werden die Einschränkungen unter Code in einem benutzerdefinierten Connector schreiben erläutert.

  • Benutzerdefinierte Konnektoren, die erstellt wurden, bevor die Umgebung einem virtuellen Netzwerk zugeordnet wurde, müssen erneut gespeichert werden.

  • Trigger, die Standortheader zurückgeben, die nicht an den benutzerdefinierten Connector zurückrufen, werden nicht unterstützt.

Feedback senden

Wir freuen uns sehr über Feedback zu Problemen mit unserer Connector-Plattform oder neuen Feature-Ideen. Um Feedback abzugeben, gehen Sie zu Probleme übermitteln oder Hilfe zu Konnektoren erhalten und wählen Sie Ihren Feedbacktyp aus.