Co to są łączniki w usłudze Azure Logic Apps

  • Artykuł

Podczas tworzenia przepływu pracy przy użyciu usługi Azure Logic Apps można użyć łącznika do pracy z danymi, zdarzeniami i zasobami w innych aplikacjach, usługach, systemach i platformach — bez pisania kodu. Łącznik udostępnia co najmniej jedną wstępnie utworzoną operację, która jest używana jako kroki w przepływie pracy.

W łączniku każda operacja jest warunkiem wyzwalacza , który uruchamia przepływ pracy lub kolejną akcję wykonującą określone zadanie wraz z właściwościami, które można skonfigurować. Chociaż wiele łączników ma zarówno wyzwalacze, jak i akcje, niektóre łączniki oferują tylko wyzwalacze, podczas gdy inne udostępniają tylko akcje.

W usłudze Azure Logic Apps łączniki są dostępne w wbudowanej wersji, wersji zarządzanej lub obu tych elementów. Wiele łączników zwykle wymaga, aby najpierw utworzyć i skonfigurować połączenie z podstawową usługą lub systemem, zwykle tak, aby można było uwierzytelnić dostęp do konta użytkownika. Jeśli żaden łącznik nie jest dostępny dla usługi lub systemu, do którego chcesz uzyskać dostęp, możesz wysłać żądanie przy użyciu ogólnej operacji HTTP lub utworzyć łącznik niestandardowy.

To omówienie zawiera ogólne wprowadzenie do łączników i sposobu ich działania. Aby uzyskać więcej informacji o łączniku, zobacz następującą dokumentację:

Wbudowane łączniki a łączniki zarządzane

W usłudze Azure Logic Apps łączniki są wbudowane lub zarządzane. Niektóre łączniki mają obie wersje. Dostępne wersje zależą od tego, czy tworzysz przepływ pracy aplikacji logiki Zużycie, który działa w wielodostępnej usłudze Azure Logic Apps, czy w standardowym przepływie pracy aplikacji logiki uruchamianym w usłudze Azure Logic Apps z jedną dzierżawą. Aby uzyskać więcej informacji na temat typów zasobów aplikacji logiki, zobacz Typy zasobów i różnice środowiska hosta.

  • Wbudowane łączniki są przeznaczone do uruchamiania bezpośrednio i natywnie w usłudze Azure Logic Apps.

  • Zarządzane łączniki są wdrażane, hostowane i zarządzane na platformie Azure przez firmę Microsoft. Łączniki zarządzane w większości udostępniają serwer proxy lub otokę interfejsu API używanego przez usługę lub system do komunikowania się z usługą Azure Logic Apps.

    • W przepływie pracy Zużycie łączniki zarządzane są wyświetlane w projektancie w obszarze etykiety Standardowe lub Enterprise na podstawie ich poziomu cenowego.

    • W przepływie pracy w warstwie Standardowa wszystkie zarządzane łączniki są wyświetlane w projektancie pod etykietą platformy Azure .

Aby uzyskać więcej informacji, zobacz następującą dokumentację:

Wyzwalacze

Wyzwalacz określa warunek, który ma być spełniony przed rozpoczęciem przepływu pracy i jest zawsze pierwszym krokiem w dowolnym przepływie pracy. Każdy wyzwalacz jest również zgodny z określonym wzorcem wyzwalania, który kontroluje sposób, w jaki wyzwalacz monitoruje zdarzenia i reaguje na nie. Zazwyczaj wyzwalacz jest zgodny ze wzorcem sondowania lub wzorcem wypychania . Czasami dostępne są obie wersje wyzwalacza.

  • Wyzwalacze sondowania regularnie sprawdzają określoną usługę lub system zgodnie z określonym harmonogramem, aby sprawdzić dostępność nowych danych lub określonego zdarzenia. Jeśli nowe dane są dostępne lub wystąpi określone zdarzenie, te wyzwalacze tworzą i uruchamiają nowe wystąpienie przepływu pracy. To nowe wystąpienie może następnie używać danych przekazanych jako danych wejściowych.

  • Wyzwalacze wypychania lub elementu webhook nasłuchują nowych danych lub zdarzenia bez sondowania. Gdy nowe dane są dostępne lub gdy wystąpi zdarzenie, te wyzwalacze tworzą i uruchamiają nowe wystąpienie przepływu pracy. To nowe wystąpienie może następnie używać danych przekazanych jako danych wejściowych.

Załóżmy na przykład, że chcesz utworzyć przepływ pracy uruchamiany po przekazaniu pliku na serwer FTP. Pierwszym krokiem przepływu pracy jest dodanie wyzwalacza FTP o nazwie Po dodaniu lub zmodyfikowaniu pliku, który jest zgodny ze wzorcem sondowania. Następnie należy określić harmonogram regularnego sprawdzania pod kątem zdarzeń przekazywania.

Gdy wyzwalacz jest wyzwalany, wyzwalacz zwykle przekazuje dane wyjściowe zdarzeń do kolejnych akcji w celu odwołania się do i użycia. W przykładzie FTP wyzwalacz automatycznie generuje informacje, takie jak nazwa pliku i ścieżka. Możesz również skonfigurować wyzwalacz tak, aby zawierał zawartość pliku. Aby więc przetwarzać te dane, musisz dodać akcje do przepływu pracy.

Akcje

Akcja określa zadanie do wykonania i zawsze pojawia się jako kolejny krok w przepływie pracy. W przepływie pracy można użyć wielu akcji. Na przykład możesz uruchomić przepływ pracy z wyzwalaczem programu SQL Server, który sprawdza nowe dane klienta w bazie danych SQL. Po wyzwoleniu przepływ pracy może mieć akcję programu SQL Server, która pobiera dane klienta. Po wykonaniu tej akcji programu SQL Server przepływ pracy może użyć innej akcji, która przetwarza dane, na przykład akcję Operacje na danych, która tworzy tabelę CSV.

Uprawnienia połączeń

W przepływie pracy aplikacji logiki Zużycie, zanim będzie można tworzyć zasoby aplikacji logiki, przepływy pracy i ich połączenia lub zarządzać nimi, potrzebne są określone uprawnienia. Aby uzyskać więcej informacji na temat tych uprawnień, zobacz Bezpieczne operacje — bezpieczny dostęp i dane w usłudze Azure Logic Apps.

tworzenie, konfigurowanie i uwierzytelnianie Połączenie ion

Aby móc używać operacji łącznika w przepływie pracy, wiele łączników wymaga, aby najpierw utworzyć połączenie z usługą docelową lub systemem. Aby utworzyć połączenie z poziomu projektanta przepływu pracy, musisz uwierzytelnić swoją tożsamość przy użyciu poświadczeń konta, a czasami inne informacje o połączeniu.

Aby na przykład przepływ pracy mógł uzyskiwać dostęp do konta e-mail usługi Office 365 Outlook i pracować z nim, musisz autoryzować połączenie z tym kontem. W przypadku niektórych wbudowanych łączników i łączników zarządzanych można skonfigurować tożsamość zarządzaną i używać jej do uwierzytelniania, a nie podawać poświadczeń.

Mimo że tworzysz połączenia w przepływie pracy, te połączenia są faktycznie oddzielone zasobami platformy Azure własnymi definicjami zasobów. Aby przejrzeć te definicje zasobów połączenia, wykonaj następujące kroki w zależności od tego, czy masz przepływ pracy Zużycie, czy Standardowy:

Zabezpieczenia i szyfrowanie Połączenie ion

szczegóły konfiguracji Połączenie ion, takie jak adres serwera, nazwa użytkownika i hasło, poświadczenia i wpisy tajne są szyfrowane i przechowywane w zabezpieczonym środowisku platformy Azure. Te informacje mogą być używane tylko w zasobach aplikacji logiki i przez klientów, którzy mają uprawnienia do zasobu połączenia, który jest wymuszany przy użyciu połączonych kontroli dostępu. Połączenie ions korzystające z uwierzytelniania Open Authentication (Microsoft Entra ID OAuth), takiego jak Office 365, Salesforce i GitHub, wymagają zalogowania się, ale usługa Azure Logic Apps przechowuje tylko tokeny dostępu i odświeżania jako wpisy tajne, a nie poświadczenia logowania.

Nawiązane połączenia mogą uzyskiwać dostęp do usługi docelowej lub systemu tak długo, jak zezwala na to usługa lub system. W przypadku usług korzystających z połączeń OAuth identyfikatora entra firmy Microsoft, takich jak Office 365 i Dynamics, usługa Azure Logic Apps odświeża tokeny dostępu na czas nieokreślony. Inne usługi mogą mieć limity czasu używania tokenu przez usługę Logic Apps bez odświeżania. Niektóre akcje, takie jak zmiana hasła, unieważniają wszystkie tokeny dostępu.

Uwaga

Jeśli Twoja organizacja nie zezwala na dostęp do określonych zasobów za pośrednictwem łączników w usłudze Azure Logic Apps, możesz zablokować możliwość tworzenia takich połączeń przy użyciu usługi Azure Policy.

Aby uzyskać więcej informacji na temat zabezpieczania przepływów pracy i połączeń aplikacji logiki, zobacz Bezpieczny dostęp i dane w usłudze Azure Logic Apps.

Dostęp do zapory dla połączeń

Jeśli używasz zapory, która ogranicza ruch, a przepływy pracy aplikacji logiki muszą komunikować się za pośrednictwem tej zapory, musisz skonfigurować zaporę, aby zezwolić na dostęp zarówno dla adresów IP przychodzących , jak i wychodzących używanych przez platformę Azure Logic Apps lub środowisko uruchomieniowe w regionie świadczenia usługi Azure, w którym istnieją przepływy pracy aplikacji logiki.

Jeśli przepływy pracy korzystają również z łączników zarządzanych, takich jak łącznik usługi Office 365 Outlook lub łącznik SQL, lub używają łączników niestandardowych, zapora musi również zezwolić na dostęp dla wszystkich wychodzących adresów IP łącznika zarządzanego w regionie świadczenia usługi Azure zasobu aplikacji logiki. Aby uzyskać więcej informacji, zobacz Konfiguracja zapory.

Łączniki niestandardowe i interfejsy API

W obszarze Przepływy pracy użycia dla wielodostępnej usługi Azure Logic Apps można wywoływać interfejsy API oparte na strukturze Swagger lub oparte na protokole SOAP, które nie są dostępne jako gotowe łączniki. Możesz również uruchomić kod niestandardowy, tworząc niestandardowe aplikacje API Apps. Aby uzyskać więcej informacji, zobacz następującą dokumentację:

W standardowych przepływach pracy dla usługi Azure Logic Apps z jedną dzierżawą można utworzyć natywnie działające niestandardowe łączniki oparte na dostawcy usług, które są dostępne dla dowolnego standardowego przepływu pracy aplikacji logiki. Aby uzyskać więcej informacji, zobacz następującą dokumentację:

ISE i łączniki

W przypadku przepływów pracy wymagających bezpośredniego dostępu do zasobów w sieci wirtualnej platformy Azure można utworzyć dedykowane środowisko usługi integracji (ISE), w którym można tworzyć, wdrażać i uruchamiać przepływy pracy w dedykowanych zasobach. Aby uzyskać więcej informacji na temat tworzenia ises, zobacz Połączenie do sieci wirtualnych platformy Azure z usługi Azure Logic Apps.

Łączniki niestandardowe utworzone w środowisku ISE nie działają z lokalną bramą danych. Jednak te łączniki mogą uzyskiwać bezpośredni dostęp do lokalnych źródeł danych połączonych z siecią wirtualną platformy Azure hostujących środowisko ISE. W związku z tym przepływy pracy aplikacji logiki w środowisku ISE najprawdopodobniej nie potrzebują bramy danych podczas komunikacji z tymi zasobami. Jeśli masz łączniki niestandardowe utworzone poza środowiskiem ISE, które wymagają lokalnej bramy danych, przepływy pracy w środowisku ISE mogą używać tych łączników.

W projektancie przepływu pracy podczas przeglądania wbudowanych łączników lub łączników zarządzanych, które mają być używane dla przepływów pracy w środowisku ISE, etykieta CORE jest wyświetlana na wbudowanych łącznikach, a etykieta ISE jest wyświetlana na zarządzanych łącznikach, które są przeznaczone do pracy z isE .

Example CORE connector

CORE

Wbudowane łączniki z tą etykietą działają w tym samym środowisku ISE co przepływy pracy.

Example ISE connector

ISE

Zarządzane łączniki z tą etykietą są uruchamiane w tym samym środowisku ISE co przepływy pracy.

Jeśli masz system lokalny połączony z siecią wirtualną platformy Azure, środowisko ISE umożliwia przepływom pracy bezpośredni dostęp do tego systemu bez korzystania z lokalnej bramy danych. Zamiast tego można użyć łącznika ISE tego systemu, jeśli jest dostępny, akcji HTTP lub łącznika niestandardowego.

W przypadku systemów lokalnych, które nie mają łączników ISE , użyj lokalnej bramy danych. Aby znaleźć dostępne łączniki ISE, zapoznaj się z artykułem Łączniki ISE.

Example non-ISE connector

Brak etykiety

Wszystkie inne łączniki bez etykiety, które można nadal używać, działają w globalnej, wielodostępnej usłudze Logic Apps.

Znane problemy

Poniższa tabela zawiera znane problemy dotyczące łączników w usłudze Azure Logic Apps:

Komunikat o błędzie opis Rozwiązanie
Error: BadGateway. Client request id: '{GUID}' Ten błąd wynika z aktualizowania tagów w zasobie aplikacji logiki, w którym co najmniej jedno połączenie nie obsługuje uwierzytelniania OAuth identyfikatora Entra firmy Microsoft, takiego jak SFTP ad SQL, przerywanie tych połączeń. Aby zapobiec temu zachowaniu, należy unikać aktualizowania tych tagów.

Następne kroki

Tworzenie przepływu pracy aplikacji logiki zużycie — Azure Portal

Tworzenie standardowego przepływu pracy aplikacji logiki — Azure Portal