Łączniki niestandardowe

  • Artykuł

Podczas gdy Azure Logic Apps, Microsoft Power Automate i Microsoft Power Apps oferują ponad 1000 łączników do łączenia się z usługami Microsoft i zweryfikowanymi, możesz chcieć komunikować się z usługami, które nie są dostępne jako wstępnie zbudowane łączniki. Łączniki niestandardowe w tym scenariuszu umożliwiają utworzenie (a nawet udostępnienie) łącznika z własnymi wyzwalaczami i akcjami.

Screenshot of custom connectors - overview.

Cykl życia

Screenshot of custom connectors - lifecycle.

1. Utwórz interfejs API

Łącznik niestandardowy to opakowanie wokół interfejsu API REST, które umożliwia aplikacjom Logic Apps, Power Automate lub Power Apps komunikację z tym interfejsem API REST lub SOAP. Te interfejsy API mogą być:

  • Publiczne (widoczne w publicznym Internecie), takie jak Spotify, Slack, Rackspace lub interfejs API zarządzany przez użytkownika.
  • Prywatne (widoczne tylko w sieci użytkownika).

Logic Apps obsługuje również interfejsy API SOAP.

W przypadku publicznych interfejsów API, które mają zostać utworzone i zarządzane, można rozważyć użycie jednego z następujących produktów Microsoft Azure:

W przypadku prywatnych interfejsów API firma Microsoft oferuje lokalną łączność z danymi za pośrednictwem lokalnej bramy danych.

2. Zabezpiecz interfejs API

Użyj jednej z tych standardowych metod uwierzytelniania dla interfejsów API i łączników (zalecana jest tożsamość Microsoft Entra):

W Azure Portal można skonfigurować uwierzytelnianie w usłudze identyfikatora Microsoft Entra dla interfejsu API, aby nie implementować uwierzytelniania. Można też zażądać i wymuszać uwierzytelnianie w kodzie interfejsu API. Aby uzyskać więcej informacji na temat tożsamości Microsoft Entra dla łączników niestandardowych, zobacz Zabezpieczanie interfejsu API i łącznika przy użyciu usługi tożsamości Microsoft Entra.

2.1. OAuth 2.0

Nowo utworzone łączniki niestandardowe, które korzystają z protokołu OAuth 2.0 do automatycznego uwierzytelniania, mają identyfikator URI przekierowania dla każdego łącznika. Istniejące łączniki OAuth 2.0 muszą zostać zaktualizowane, aby mogły używać identyfikatora URI przekierowania dla każdego łącznika przed 17 lutego 2024 r.

  • Jeśli utworzono własne łączniki za pomocą interfejsu internetowego, edytuj te niestandardowe łączniki, przejdź do karty Zabezpieczenia i zaznacz pole, Aktualizuj do unikalnego adresu URL przekierowania, a następnie zapisz, aby włączyć identyfikator URI przekierowania dla każdego łącznika.
  • Jeśli utworzono niestandardowe łączniki z wielokrotnym uwierzytelnianiem przy użyciu narzędzia interfejsu wiersza poleceń CLI, musisz zaktualizować łącznik za pomocą narzędzia CLI, aby ustawić "redirectMode": "GlobalPerConnector".
  • Po zaktualizowaniu łączników niestandardowych w celu korzystania z identyfikatora URI przekierowania dla każdego łącznika za pomocą ustawienia na karcie Zabezpieczenia lub za pomocą narzędzia CLI, należy usunąć globalny identyfikator URI przekierowania z aplikacji OAuth 2.0. Powinieneś dodać nowo wygenerowany unikalny adres URL przekierowania do swoich aplikacji OAuth 2.0.
  • Będziemy egzekwować tę aktualizację w przypadku istniejących niestandardowych łączników OAuth 2.0 od 17 lutego 2024 r. Każdy łącznik niestandardowy, który nie został zaktualizowany w celu korzystania z identyfikatora URI przekierowania łącznika, przestanie działać w przypadku nowych połączeń i wyświetli użytkownikowi komunikat o błędzie.
  • Aby dowiedzieć się, które łączniki niestandardowe wymagają aktualizacji w celu migracji na adres URL przekierowania łącznika, można utworzyć prosty przepływ, który wykorzystuje akcję Pobierz łączniki niestandardowe jako administrator łącznika Power Apps for Admin i analizuje jej wynik. Przepływ załączony w dalszej części tego artykułu pobiera wszystkie niestandardowe łączniki przy użyciu tego samego. Następnie stosuje warunek filtrowania na właściwości parametru połączenia, aby odfiltrować niestandardowy łącznik inny non-Oauth, a następnie kolejny filtr, aby wybrać tylko łączniki, które nie używają unikalnego przekierowania URL na łącznik. Na koniec umieszcza wybrane niestandardowe łączniki w zmiennej tablicowej zainicjalizowanej na początku przepływu i generuje tabelę HTML pokazującą nazwę i twórcę tych łączników. Możesz zaimportować ten przepływ do swojego środowiska, importując to rozwiązanie. Możesz rozszerzyć przepływ dalej, aby wysłać tabelę HTML jako wiadomość e-mail do siebie. lub można rozszerzyć go tak, aby wysyłał wiadomości e-mail bezpośrednio do twórców łączników i przekazywał im nazwy łączników, które wymagają aktualizacji.

3. Opisywanie interfejsu API i definiowanie łącznika niestandardowego

Po uzyskaniu interfejsu API z dostępem uwierzytelnianym następnym zadaniem jest opisywanie interfejsu API, tak aby Logic Apps, Power Automate lub Power Apps mogły się komunikować z interfejsem API. Obsługiwane są następujące podejścia:

Definicje OpenAPI i kolekcje Postman używają różnych formatów, lecz jedne i drugie są niezależnymi od języka dokumentami czytelnymi dla komputera, które opisują interfejs API. Te dokumenty możesz generować za pomocą różnych narzędzi w zależności od języka i platformy używanych przez interfejs API. Za kulisami Logic Apps, Power Automate i Power Apps używają OpenAPI do definiowania łączników.

4. Użyj swojego łącznika w Logic Apps, Power Automate lub aplikacji Power Apps

Łączniki niestandardowe są używane w taki sam sposób, jak łączniki gotowe. Musisz utworzyć połączenie z interfejsem API, aby użyć tego połączenia, aby wywoływać operacje uwidocznione w łączniku niestandardowym.

Łączniki utworzone w Power Automate są dostępne w Power Apps. Podobnie, łączniki utworzone w Power Apps są dostępne w Power Automate. To nie dotyczy łączników utworzonych w aplikacjach usługi Logic Apps. Możesz jednak ponownie wykorzystać definicję OpenAPI lub kolekcję Postman, by odtworzyć łącznik w dowolnej z tych usług. Aby uzyskać więcej informacji, zobacz odpowiedni samouczek:

5. Udostępnij łącznik

Łącznik można udostępniać użytkownikom w organizacji w taki sam sposób, w jaki są udostępnianie zasoby w usługach Logic Apps, Power Automate lub Power Apps. Udostępnianie jest opcjonalne, ale mogą wystąpić scenariusze, w których będziesz chciał udostępnić swoje łączniki innym użytkownikom.

Aby uzyskać więcej informacji, zobacz Udostępnianie łączników niestandardowych w organizacji.

6. Zatwierdź swój łącznik

Aby udostępnić łącznik wszystkim użytkownikom usług Logic Apps, Power Automate i Power Apps, możesz przesłać łącznik do firmy Microsoft w celu uzyskania certyfikatu. Microsoft weryfikuje łącznik, sprawdza zgodność techniczną i treść oraz dokonuje weryfikacji funkcjonalności.

Aby uzyskać dodatkowe informacje, zobacz Przesyłanie łączników w celu certyfikacji przez firmę Microsoft.

Samouczek

Samouczek korzysta z interfejsu API analizy tekstu Cognitive Services. Microsoft już udostępnia łącznik tego interfejsu API. Jest to dobry przykład do nauczania cyklu życia niestandardowego łącznika i tego, jak niestandardowe łączniki mogą obsługiwać unikalne scenariusze.

Scenariusz

Utworzony łącznik udostępnia operację Analiza tekstu — opinia, która zwraca wynik sentymentu (od 0,000 do 1,000) dla wprowadzonego tekstu.

Wymagania wstępne

  • Jedna z następujących subskrypcji:

  • Podstawowe informacje o sposobie tworzenia aplikacji Logic Apps, przepływów usługi Power Automate lub aplikacji Power Apps.

  • Klucz interfejsu API dla interfejsu API analizy tekstu usług Cognitive Services.

Pobierz klucz interfejsu API

Interfejs API analizy tekstu używa w celu uwierzytelniania użytkowników klucza interfejsu API. Kiedy użytkownik tworzy połączenie z interfejsem API za pośrednictwem łącznika niestandardowego, użytkownik określa wartość tego klucza. Aby uzyskać klucz interfejsu API:

Uruchom samouczek

Zaawansowane wskazówki

Samouczki i materiały wideo w tej sekcji zapewniają niezbędny wgląd w wykorzystanie łączników Power Platform w ramach wdrożeń.

Samouczki

Poniższe samouczki dają więcej szczegółowych informacji na temat specjalnych scenariuszy łączników niestandardowych:

Video

W poniższym 45-minutowym filmie wideo pokazano, jak działają łączniki Power Platform. Pokazano też, jak tworzyć proste i zaawansowane łączniki niestandardowe.

Pomoc techniczna usługi Virtual Network

Gdy łącznik jest używany w środowisku Power Platform połączonym z siecią wirtualną, obowiązują ograniczenia:

  • Gdy używany jest kod niestandardowy: Ograniczenia wyjaśniono w Zapisz kod w niestandardowym łączniku.

  • Łączniki niestandardowe, które zostały utworzone przed powiązaniem środowiska z siecią wirtualną, muszą zostać ponownie zapisane.

Przekazywanie opinii

Jesteśmy wdzięczni za opinie na temat problemów z platformą łączników oraz pomysły na nowe funkcje. Aby przekazać opinię, przejdź na stronę Przesyłanie problemów lub uzyskiwanie pomocy dotyczącej łączników i wybierz typ opinii.