Udostępnij przez

Omówienie łączników niestandardowych

Usługi Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps i Microsoft Copilot Studio oferują ponad 1000 łączników w celu nawiązania połączenia z firmą Microsoft i zweryfikowanymi usługami, ale 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 pokazują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 lub Copilot Studio 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. Protokół OAuth 2.0

Nowo utworzone łączniki niestandardowe, które używają OAuth 2.0 do uwierzytelniania, automatycznie mają URI przekierowania dla każdego łącznika. Istniejące łączniki OAuth 2.0 muszą zostać zaktualizowane, aby używać 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 URI przekierowania dla każdego łącznika za pomocą ustawienia w zakładce Bezpieczeństwo lub narzędzia CLI, usuń globalny URI przekierowania z aplikacji OAuth 2.0. Powinieneś dodać nowo wygenerowany unikalny adres URL przekierowania do swoich aplikacji OAuth 2.0.
  • Wymusimy tę aktualizację dla istniejących niestandardowych łączników OAuth 2.0 począwszy od 17 lutego 2024 r. Każdy łącznik niestandardowy, który nie został zaktualizowany w celu używania identyfikatora URI przekierowania dla każdego łącznika, przestaje działać w przypadku nowych połączeń i wyświetla 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ć przepływ, który używa akcji Pobierz łączniki niestandardowe jako administrator łącznika Power Apps dla administratorów 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 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 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, Power Apps lub Copilot Studio 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, Power Apps i Copilot Studio używają OpenAPI do definiowania łączników.

4. Użyj swojego łącznika w Copilot Studio, Logic Apps, Power Automate lub 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 i Copilot Studio, a łączniki utworzone w Power Apps są dostępne w Power Automate i Copilot Studio. Dostępność 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:

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ę zaktualizowanej strukturze 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

Użytkownik może udostępnić swój łącznik użytkownikom z organizacji tak samo, jak udostępnianie zasobów w Copilot Studio, 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, Copilot Studio, Power Automate i Power Apps, musisz przesłać łącznik do firmy Microsoft w celu uzyskania certyfikatu. Microsoft weryfikuje łącznik, sprawdza zgodność techniczną i treść oraz dokonuje weryfikacji funkcjonalności.

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 utworzone przed skojarzeniem środowiska z Virtual Network muszą zostać ponownie zapisane.

  • Wyzwalacze zwracające nagłówek lokalizacji, które nie wywołują 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ź na stronę Przesyłanie problemów lub uzyskiwanie pomocy dotyczącej łączników i wybierz typ opinii.

  • Last updated on