Přihlášení k odběru a čekání na spouštění pracovních postupů pomocí webhooků HTTP v Azure Logic Apps
Platí pro: Azure Logic Apps (Consumption + Standard)
Místo použití triggeru, který pravidelně kontroluje nebo dotazuje koncový bod služby nebo akci, která tento koncový bod volá, můžete použít trigger webhooku HTTP nebo akci, která se přihlásí k odběru koncového bodu služby, čeká na konkrétní události a spustí v pracovním postupu konkrétní akce.
Tady je několik příkladů pracovních postupů založených na webhoocích:
- Před aktivací spuštění pracovního postupu počkejte, až událost dorazí ze služby Azure Event Hubs .
- Než budete pokračovat v pracovním postupu, počkejte na schválení.
Tento průvodce ukazuje, jak používat trigger webhooku HTTP a akci Webhooku, aby váš pracovní postup mohl přijímat události koncového bodu služby a reagovat na ně.
Jak fungují webhooky?
Trigger webhooku je založený na událostech, který nezávisí na pravidelné kontrole nebo dotazování na nová data nebo události. Po přidání triggeru webhooku do prázdného pracovního postupu a uložení pracovního postupu nebo po opětovném povolení zakázaného prostředku aplikace logiky se trigger webhooku přihlásí k odběru zadaného koncového bodu služby registrací adresy URL zpětného volání do daného koncového bodu. Trigger pak počká, až koncový bod služby zavolá adresu URL, která trigger aktivuje a spustí pracovní postup. Podobně jako trigger požadavku se trigger webhooku aktivuje okamžitě. Trigger webhooku zůstane také přihlášený k odběru koncového bodu služby, pokud ručně nespustíte následující akce:
- Změňte hodnoty parametrů triggeru.
- Odstraňte trigger a pak pracovní postup uložte.
- Zakažte prostředek aplikace logiky.
Podobně jako trigger webhooku funguje akce webhooku také na základě událostí. Po přidání akce webhooku do existujícího pracovního postupu a uložení pracovního postupu nebo po opětovném povolení zakázaného prostředku aplikace logiky se akce webhooku přihlásí k odběru zadaného koncového bodu služby registrací adresy URL zpětného volání u daného koncového bodu. Když se pracovní postup spustí, akce webhooku pracovní postup pozastaví a počká, dokud koncový bod služby nevolá adresu URL, než se pracovní postup obnoví. Akce webhooku se odhlásí od koncového bodu služby, když dojde k následujícím podmínkám:
- Akce webhooku se úspěšně dokončí.
- Spuštění pracovního postupu se zruší při čekání na odpověď.
- Před uplynutím časového limitu pracovního postupu
- Změníte hodnoty parametrů akce webhooku, které se používají jako vstupy triggerem webhooku.
Příkladem akce webhooku, která se řídí tímto vzorem, je například akce konektoru Office 365 Outlooku pro odesílání e-mailů . Tento model můžete rozšířit do libovolné služby pomocí akce webhooku.
Další informace najdete v následující dokumentaci:
Informace o šifrování, zabezpečení a autorizaci příchozích volání do aplikace logiky, jako je tls (Transport Layer Security), dříve označované jako SSL (Secure Sockets Layer) nebo Microsoft Entra ID Open Authentication (Microsoft Entra ID OAuth), najdete v tématu Zabezpečený přístup a data – Přístup pro příchozí volání triggerů založených na požadavcích.
Technické reference ke konektoru
Další informace o parametrech triggeru a akce naleznete v tématu Http Webhook parametry.
Požadavky
Účet a předplatné Azure. Pokud nemáte předplatné Azure, zaregistrujte si bezplatný účet Azure.
Adresa URL již nasazeného koncového bodu nebo rozhraní API, které podporuje odběr webhooku, a vzor odhlášení odběru pro triggery webhooků v pracovních postupech nebo akcích webhooku podle potřeby
Pracovní postup aplikace logiky Standard nebo Consumption, kde chcete čekat na konkrétní události v cílovém koncovém bodu. Pokud chcete začít s triggerem webhooku HTTP, vytvořte aplikaci logiky s prázdným pracovním postupem. Pokud chcete použít akci webhooku HTTP, spusťte pracovní postup libovolným triggerem. V tomto příkladu se jako první krok používá trigger HTTP.
Přidání triggeru webhooku HTTP
Tato integrovaná aktivační událost volá koncový bod odběru cílové služby a zaregistruje adresu URL zpětného volání do cílové služby. Váš pracovní postup pak čeká, až cílová služba odešle HTTP POST požadavek na adresu URL zpětného volání. Když k této události dojde, trigger se aktivuje a předá všechna data v požadavku společně s pracovním postupem.
Na webu Azure Portal otevřete aplikaci logiky Standard a prázdný pracovní postup v návrháři.
Pokud chcete do pracovního postupu přidat trigger s názvem HTTP Webhook, postupujte podle těchto obecných kroků.
Tento příklad přejmenuje trigger http Webhook tak, aby krok má popisnější název. Příklad později také přidá akci webhooku HTTP a oba názvy musí být jedinečné.
Zadejte hodnoty parametrů triggeru webhooku HTTP, které chcete použít pro přihlášení k odběru a odhlášení odběru volání.
Vlastnost Požadováno Popis Předplatné – metoda Ano Metoda, která se má použít při přihlášení k odběru cílového koncového bodu Přihlášení k odběru – identifikátor URI Ano Adresa URL, která se má použít pro přihlášení k odběru cílového koncového bodu Přihlášení k odběru – text No Text zprávy, který se má zahrnout do žádosti o přihlášení k odběru. Tento příklad obsahuje adresu URL zpětného volání, která jednoznačně identifikuje odběratele, což je vaše aplikace logiky, pomocí výrazu @listCallbackUrl()k načtení adresy URL zpětného volání aplikace logiky.Odhlášení odběru – metoda No Metoda, která se má použít při zrušení odběru z cílového koncového bodu Odhlášení odběru – identifikátor URI No Adresa URL, která se má použít k přihlášení k odběru z cílového koncového bodu Odhlášení odběru – text No Volitelný text zprávy, který se má zahrnout do žádosti o odhlášení odběru
Poznámka: Tato vlastnost nepodporuje použitílistCallbackUrl()funkce. Trigger ale automaticky zahrne a odešle hlavičkyx-ms-client-tracking-idax-ms-workflow-operation-name, které může cílová služba použít k jedinečné identifikaci odběratele.Poznámka:
Pro odhlášení odběru – metoda a odhlášení odběru – vlastnosti identifikátoru URI přidejte do akce tak, že otevřete seznam rozšířených parametrů.
Následující trigger například obsahuje metody, identifikátory URI a texty zpráv, které se mají použít při provádění operací odběru a odhlášení odběru.
Pokud potřebujete použít ověřování, můžete přidat vlastnosti ověřování přihlášení k odběru – Ověřování a odhlášení odběru – Ověřování . Další informace o typech ověřování dostupných pro http Webhook naleznete v tématu Přidání ověřování do odchozích volání.
Pokračujte v vytváření pracovního postupu akcemi, které se spustí při aktivaci triggeru.
Po dokončení uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.
Uložení pracovního postupu volá koncový bod odběru cílové služby a zaregistruje adresu URL zpětného volání. Váš pracovní postup pak čeká, až cílová služba odešle HTTP POST požadavek na adresu URL zpětného volání. Když k této události dojde, trigger se aktivuje a předá všechna data v požadavku společně s pracovním postupem. Pokud se tato operace úspěšně dokončí, trigger se z koncového bodu odhlásí a váš pracovní postup pokračuje k další akci.
Přidání akce webhooku HTTP
Tato integrovaná akce volá koncový bod odběru cílové služby a zaregistruje adresu URL zpětného volání do cílové služby. Pracovní postup se pak pozastaví a počká, až cílová služba odešle HTTP POST požadavek na adresu URL zpětného volání. Když k této události dojde, akce předá veškerá data v požadavku spolu s pracovním postupem. Pokud se operace úspěšně dokončí, akce se z koncového bodu odhlásí a pracovní postup pokračuje k další akci.
V tomto příkladu se jako první krok používá trigger webhooku HTTP.
Na webu Azure Portal otevřete aplikaci logiky Standard a pracovní postup v návrháři.
Pomocí těchto obecných kroků přidejte do pracovního postupu akci s názvem HTTP Webhook.
Tento příklad přejmenuje akci na akci HTTP Webhook tak, aby krok má popisnější název.
Zadejte hodnoty parametrů akce HTTP Webhooku, které se podobají parametrům triggeru webhooku HTTP, které chcete použít pro přihlášení k odběru a odhlášení odběru volání.
Vlastnost Požadováno Popis Předplatné – metoda Ano Metoda, která se má použít při přihlášení k odběru cílového koncového bodu Přihlášení k odběru – identifikátor URI Ano Adresa URL, která se má použít pro přihlášení k odběru cílového koncového bodu Přihlášení k odběru – text No Text zprávy, který se má zahrnout do žádosti o přihlášení k odběru. Tento příklad obsahuje adresu URL zpětného volání, která jednoznačně identifikuje odběratele, což je vaše aplikace logiky, pomocí výrazu @listCallbackUrl()k načtení adresy URL zpětného volání aplikace logiky.Odhlášení odběru – metoda No Metoda, která se má použít při zrušení odběru z cílového koncového bodu Odhlášení odběru – identifikátor URI No Adresa URL, která se má použít k přihlášení k odběru z cílového koncového bodu Odhlášení odběru – text No Volitelný text zprávy, který se má zahrnout do žádosti o odhlášení odběru
Poznámka: Tato vlastnost nepodporuje použitílistCallbackUrl()funkce. Akce však automaticky zahrne a odešle hlavičkyx-ms-client-tracking-idax-ms-workflow-operation-name, které cílová služba může použít k jedinečné identifikaci odběratele.Poznámka:
Pro odhlášení odběru – metoda a odhlášení odběru – vlastnosti identifikátoru URI přidejte do akce tak, že otevřete seznam rozšířených parametrů.
Následující akce například obsahuje metody, identifikátory URI a těla zpráv, které se mají použít při provádění operací přihlášení k odběru a odhlášení odběru.
Pokud chcete přidat další vlastnosti akce, otevřete seznam rozšířených parametrů .
Pokud například potřebujete použít ověřování, můžete přidat vlastnosti ověřování přihlášení k odběru – Ověřování a odhlášení odběru – Ověřování . Další informace o typech ověřování dostupných pro http Webhook naleznete v tématu Přidání ověřování do odchozích volání.
Po dokončení uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.
Když se tato akce spustí, váš pracovní postup zavolá koncový bod odběru cílové služby a zaregistruje adresu URL zpětného volání. Pracovní postup se pak pozastaví a počká, až cílová služba odešle HTTP POST požadavek na adresu URL zpětného volání. Když k této události dojde, akce předá veškerá data v požadavku spolu s pracovním postupem. Pokud se operace úspěšně dokončí, akce se z koncového bodu odhlásí a pracovní postup pokračuje k další akci.
Výstupy triggeru a akce
Tady jsou další informace o výstupech triggeru nebo akce webhooku HTTP, která vrací tyto informace:
| Název vlastnosti | Type | Popis |
|---|---|---|
| záhlaví | objekt | Hlavičky z požadavku |
| text | objekt | Objekt s obsahem textu z požadavku |
| stavový kód | int | Stavový kód z požadavku |
| Stavový kód | Popis |
|---|---|
| 200 | OK |
| 202 | Přijato |
| 400 | Chybný požadavek |
| 401 | Neautorizováno |
| 403 | Zakázáno |
| 404 | Nenalezeno |
| 500 | Vnitřní chyba serveru. Došlo k neznámé chybě. |