Udostępnij za pośrednictwem

Omówienie łączników niestandardowych

  • Artykuł

Chociaż Azure Logic AppsMicrosoft Power Automate i Microsoft Power Apps oferuje ponad 1 000 łączników do nawiązywania połączenia z firmą Microsoft i zweryfikowanymi usługami, możesz chcieć komunikować się z usługami, które nie są dostępne jako wstępnie utworzone łączniki. Łączniki niestandardowe w tym scenariuszu umożliwiają utworzenie (a nawet udostępnienie) łącznika z własnymi wyzwalaczami i akcjami.

Zrzut ekranu przedstawiający, jak łączniki niestandardowe łączą interfejs API analizy tekstu z aplikacjami.

Cykl życia

Zrzut ekranu przedstawiający cykl życia łączników niestandardowych w pięciu etapach.

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, którym zarządzasz.
  • 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ść danych 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 (Microsoft Entra zalecany jest identyfikator ):

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 Microsoft Entra identyfikatora łączników niestandardowych, zobacz Zabezpieczanie interfejsu API i łącznika za pomocą Microsoft Entra identyfikatora.

2.1. OAuth 2.0

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

  • Jeśli utworzyłeś łączniki niestandardowe za pomocą interfejsu internetowego, edytuj łączniki niestandardowe, przejdź do karty Zabezpieczenia i zaznacz pole,Aktualizuj do unikalnego adresu URL przekierowania, a następnie zapisz, aby włączyć identyfikator URI przekierowania dla łącznika.
  • Jeśli łączniki niestandardowe zostały utworzone z uwierzytelnianiem wielostanowiskowym przy użyciu narzędzia interfejsu wiersza polecenia (CLI), należy zaktualizować łącznik przy użyciu narzędzia interfejsu wiersza polecenia, aby ustawić "redirectMode": "GlobalPerConnector".
  • Po zaktualizowaniu łączników niestandardowych w celu korzystania z identyfikatora URI przekierowania dla poszczególnych łączników za pomocą ustawienia na karcie Zabezpieczenia lub narzędzia interfejsu wiersza polecenia usuń globalny identyfikator URI przekierowania z OAuth aplikacji w wersji 2.0. Nowo wygenerowany unikalny adres URL przekierowania należy dodać do aplikacji OAuth w wersji 2.0.
  • Od 17 lutego 2024 r. będziemy egzekwować tę aktualizację dla istniejących OAuth łączników niestandardowych 2.0. Każdy łącznik niestandardowy, który nie został zaktualizowany w celu korzystania z identyfikatora URI przekierowania dla każdego łącznika, przestaje działać dla nowych połączeń i wyświetla użytkownikowi komunikat o błędzie.
  • Aby dowiedzieć się, które łączniki niestandardowe wymagają aktualizacji w celu migracji do adresu URL przekierowania łącznika, możesz utworzyć przepływ, który używa akcji Pobierz łączniki niestandardowe jako administrator łącznika dla administratora Power Apps i przeanalizować jego 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 filtru we właściwości parametru połączenia, aby odfiltrować łącznik niestandardowy inny niż OAuth, a następnie inny filtr, aby wybrać tylko łączniki, które nie używają unikatowego adresu URL przekierowania dla każdego łącznika. 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 ś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 są dostępne w Power Automate Power Apps, a łączniki utworzone w Power Apps są dostępne w Power Automate. Ta dostępność nie dotyczy łączników utworzonych w usłudze 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:

Wskazówka

Jeśli zaktualizujesz (usuniesz, dodasz lub zmienisz) pole w interfejsie API, wykonaj następujące kroki:

  1. Opublikuj ponownie łącznik, aby przyjrzał się zaktualizowanemu pakietowi Swagger dla interfejsu API.
  2. Usuń wszystkie połączenia/źródła danych w dowolnej aplikacji, która korzystała z tego łącznika.
  3. Ponownie dodaj połączenie/źródło danych dla tego łącznika z powrotem do aplikacji.

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.

Dowiedz się więcej w temacie 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ć więcej informacji, zobacz Przesyłanie łączników do certyfikacji firmy Microsoft.

Pomoc techniczna usługi Virtual Network

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

  • Gdy używany jest kod niestandardowy, ograniczenia są wyjaśnione w temacie Pisanie kodu w łączniku niestandardowym.

  • Łączniki niestandardowe utworzone przed skojarzeniem środowiska z Virtual Network muszą zostać ponownie zapisane.

  • Wyzwalacze zwracające nagłówek lokalizacji, które nie są wywoływane z powrotem do łącznika niestandardowego, nie są obsługiwane.

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ź do sekcji Przesyłanie problemów lub uzyskiwanie pomocy dotyczącej łączników i wybierz typ opinii.