Az Azure Functions meghívása munkafolyamatokból az Azure Logic Appsben

A következőkre vonatkozik: Azure Logic Apps (Használat + Standard)

A logikai alkalmazás munkafolyamatában egy adott feladatot végrehajtó kód futtatásához nem kell teljes alkalmazást vagy infrastruktúrát létrehoznia. Ehelyett létrehozhat és meghívhat egy Azure-függvényt. Az Azure Functions kiszolgáló nélküli számítástechnikát biztosít a felhőben, és a következő feladatok elvégzésére képes:

• A munkafolyamat viselkedésének kiterjesztése Node.js vagy C# használatával létrehozott függvények futtatásával.
• Számítások végrehajtása a munkafolyamatban.
• Speciális formázási vagy számítási mezők alkalmazása a munkafolyamatban.

Ez az útmutató bemutatja, hogyan hívhat meg egy meglévő Azure-függvényt a Használat vagy a Standard munkafolyamatból. Ha az Azure Functions használata nélkül szeretne kódot futtatni, tekintse meg a következő dokumentációt:

• Kódrészletek futtatása munkafolyamatokban
• .NET-keretrendszer kód létrehozása és futtatása Standard munkafolyamatokból

Korlátozások

• Csak a használati munkafolyamatok támogatják az Azure-függvényhívások hitelesítését felügyelt identitással, Microsoft Entra-hitelesítéssel. A standard munkafolyamatok jelenleg nem támogatottak a függvényhívások hitelesítésének engedélyezéséről szóló szakaszban.

• Az Azure Logic Apps nem támogatja az Azure Functions használatát az üzembehelyezési pontok engedélyezésével. Bár ez a forgatókönyv néha működik, ez a viselkedés kiszámíthatatlan, és engedélyezési problémákat okozhat, amikor a munkafolyamat megpróbálja meghívni az Azure-függvényt.

Előfeltételek

• Azure-fiók és -előfizetés. Ha még nincs előfizetése, regisztráljon egy ingyenes Azure-fiókra.

• Egy Azure-függvényalkalmazás-erőforrás, amely egy vagy több Azure-függvényt tartalmaz.

  • A függvényalkalmazás erőforrásának és a logikai alkalmazás erőforrásának ugyanazt az Azure-előfizetést kell használnia.

  • A függvényalkalmazás-erőforrásnak .NET-t vagy Node.js kell használnia futtatókörnyezeti veremként.

  • Amikor új függvényt ad hozzá a függvényalkalmazáshoz, kiválaszthatja a C# vagy a JavaScript lehetőséget.

• A meghívni kívánt Azure-függvény. Ezt a függvényt a következő eszközökkel hozhatja létre:

  • Azure Portalra

  • Visual Studio

  • Visual Studio Code

  • Azure CLI

  • Azure PowerShell

  • ARM-sablon

  • A függvénynek a HTTP-eseményindító sablont kell használnia .

    A HTTP-eseményindító sablon képes elfogadni a logikai alkalmazás munkafolyamatából származó, típussal rendelkező application/json tartalmat. Amikor függvényt ad hozzá a munkafolyamathoz, a tervező megjeleníti a sablonból az Azure-előfizetésben létrehozott egyéni függvényeket.

  • A függvénykódnak tartalmaznia kell a választ és a hasznos adatokat, amelyeket a függvény befejezése után vissza szeretne adni a munkafolyamatnak. Az context objektum arra az üzenetre hivatkozik, amelyet a munkafolyamat a kérelem törzse nevű Azure Functions-műveletparaméteren keresztül küld az útmutató későbbi részében.

    Ez az útmutató a fabrikamAzureFunction nevű mintafüggvényt használja:

    module.exports = function (context, data) {
    
       var input = data;
    
       // Function processing logic
       // Function response for later use
       context.res = {
          body: {
            content:"Thank you for your feedback: " + input
          }
       };
       context.done();
    }
    

    Ha a függvényen belülről szeretné elérni az context objektum tulajdonságait, használja az alábbi szintaxist:

    context.body.<property-name>

    Ha például az objektum tulajdonságára contentcontext szeretne hivatkozni, használja a következő szintaxist:

    context.body.content

    Ez a kód tartalmaz egy változót input is, amely a paraméterből tárolja az data értéket, hogy a függvény műveleteket hajthat végre ezen az értéken. A JavaScript-függvényekben a data változó parancsikonként is használható context.body.

    Feljegyzés

    Az body itt található tulajdonság az context objektumra vonatkozik, és nem ugyanaz, mint a művelet kimenetében lévő Body token, amelyet a függvénynek is átadhat.

  • A függvény csak akkor használhat egyéni útvonalakat, ha definiált egy OpenAPI-definíciót (Swagger-fájlt).

    Ha rendelkezik OpenAPI-definícióval a függvényhez, a munkafolyamat-tervező gazdagabb élményt nyújt a függvényparaméterek használatakor. Mielőtt a munkafolyamat megkeresheti és elérheti az OpenAPI-definíciókkal rendelkező függvényeket, állítsa be a függvényalkalmazást az alábbi lépések végrehajtásával.

• Egy használatalapú vagy standard logikai alkalmazás munkafolyamata, amely bármilyen eseményindítóval kezdődik.

  Az ebben az útmutatóban szereplő példák az Office 365 Outlook When a new email arrives (Új e-mailek érkezésekor) nevű Outlook-eseményindítót használják.

• Ha egy másik munkafolyamatot meghívó Azure-függvényt szeretne létrehozni és meghívni, győződjön meg arról, hogy a másodlagos munkafolyamat egy hívható végpontot biztosító eseményindítóval kezdődik.

  Elindíthatja például a munkafolyamatot az általános HTTP- vagy kérelem-eseményindítóval, vagy használhat szolgáltatásalapú eseményindítót, például az Azure Queuest vagy az Event Gridet. A függvényen belül küldjön egy HTTP POST-kérést az eseményindító URL-címére, és adja meg a másodlagos munkafolyamat által feldolgozandó hasznos adatokat. További információ: Hívás, eseményindító vagy beágyazott logikai alkalmazás munkafolyamatai.

Tippek az Azure-függvények kezeléséhez

OpenAPI-definíció vagy Swagger-fájl létrehozása a függvényhez

Ha a munkafolyamat-tervezőben függvényparaméterekkel dolgozik, gazdagabb élmény érdekében hozzon létre egy OpenAPI-definíciót vagy Swagger-fájlt a függvényhez. Ha úgy szeretné beállítani a függvényalkalmazást, hogy a munkafolyamat megkereshesse és használhassa a Swagger-leírásokkal rendelkező függvényeket, kövesse az alábbi lépéseket:

1. Nyissa meg a függvényalkalmazást az Azure Portalon. Győződjön meg arról, hogy a függvényalkalmazás aktívan fut.

2. A függvényalkalmazásban állítsa be a forrásközi erőforrás-megosztást (CORS), hogy az összes forrás engedélyezve legyen az alábbi lépések végrehajtásával:

   1. A függvényalkalmazás menüjében, az API alatt válassza a CORS lehetőséget.

   2. Az Engedélyezett források csoportban adja hozzá a csillag (*) helyettesítő karaktert, de távolítsa el az összes többi forrást a listában, és válassza a Mentés lehetőséget.

      

Tulajdonságértékek elérése HTTP-kérelmekben

A Webhook-alapú függvények bemenetként elfogadhatják a HTTP-kéréseket, és továbbíthatják ezeket a kéréseket más függvényeknek. Például, bár az Azure Logic Apps olyan függvényekkel rendelkezik , amelyek a DateTime-értékeket konvertálják, ez az alapszintű JavaScript-mintafüggvény bemutatja, hogyan férhet hozzá a függvénynek átadott HTTP-kérelemobjektumon belüli tulajdonsághoz, és hogyan hajthat végre műveleteket ezen a tulajdonságértéken. Az objektumokon belüli tulajdonságok eléréséhez ez a példa a pont (.) operátort használja:

function convertToDateString(request, response){
   var data = request.body;
   response = {
      body: data.date.ToDateString();
   }
}

A függvényen belül a következők történnek:

1. A függvény létrehoz egy változót data , majd hozzárendeli az body objektumon belüli request objektumot a változóhoz. A függvény a pont (.) operátorral hivatkozik az bodyrequest objektumon belüli objektumra:

   var data = request.body;
   

2. A függvény mostantól hozzáférhet a date tulajdonsághoz a data változón keresztül, és a függvény meghívásával a DateTime típusból DateString típussá alakíthatja a ToDateString() tulajdonság értékét. A függvény az eredményt a függvény válaszában lévő tulajdonságon keresztül body is visszaadja:

   body: data.date.ToDateString();
   

Miután létrehozta a függvényt az Azure-ban, kövesse az Azure-függvények munkafolyamathoz való hozzáadásának lépéseit.

Függvény hozzáadása a munkafolyamathoz (Használat + Standard munkafolyamatok)

Ha azure-függvényt szeretne meghívni a munkafolyamatból, hozzáadhatja a függvényeket, mint a tervező bármely más műveletét.

Hitelesítés engedélyezése Azure-függvényhívásokhoz (csak használatalapú munkafolyamatok esetén)

A Használat munkafolyamat felügyelt identitással hitelesíthet egy Azure-függvényhívást, és hozzáférhet a Microsoft Entra ID által védett erőforrásokhoz. A felügyelt identitás anélkül hitelesítheti a hozzáférést, hogy be kellene jelentkeznie, és meg kellene adnia a hitelesítő adatokat vagy titkos kulcsokat. Az Azure kezeli Ön helyett ezt az identitást, és segít biztonságban tartani az Ön hitelesítő adatait, mivel így nincs szükség titkos kulcsok megadására és rendszeres módosítására. Beállíthatja a rendszer által hozzárendelt identitást vagy egy manuálisan létrehozott, felhasználó által hozzárendelt identitást a logikai alkalmazás erőforrásszintjén. A munkafolyamatból hívott Azure-függvény ugyanazt a felügyelt identitást használhatja a hitelesítéshez.

További információkért tekintse meg a következő dokumentációt:

• Hozzáférés hitelesítése felügyelt identitásokkal
• Hitelesítés hozzáadása kimenő hívásokhoz

Ha úgy szeretné beállítani a függvényalkalmazást és a függvényt, hogy azok használni tudják a Használat logikai alkalmazás felügyelt identitását, kövesse az alábbi magas szintű lépéseket:

1. A logikai alkalmazás felügyelt identitásának engedélyezése és beállítása.

2. Állítsa be a függvényt névtelen hitelesítéshez.

3. Keresse meg a Microsoft Entra-hitelesítés beállításához szükséges értékeket.

4. Alkalmazásregisztráció létrehozása a függvényalkalmazáshoz.

A függvény beállítása névtelen hitelesítéshez (csak használatalapú munkafolyamatok esetén)

Ahhoz, hogy a függvény a Consumption logikai alkalmazás felügyelt identitását használja, a függvény hitelesítési szintjét a következőre anonymouskell állítania: . Ellenkező esetben a munkafolyamat BadRequest-hibát jelez.

1. Az Azure Portalon keresse meg és válassza ki a függvényalkalmazást.

   Az alábbi lépések egy FabrikamFunctionApp nevű példafüggvényalkalmazást használnak.

2. A függvényalkalmazás erőforrásmenüjének Fejlesztési eszközök csoportjában válassza a Speciális eszközök>ugrása lehetőséget.

   

3. Miután megnyílik a Kudu Plus oldal, a Kudu webhely címsorában, a Hibakeresési konzol menüben válassza a CMD elemet.

   

4. A következő lap megjelenése után a mappalistában válassza ki a webhely>wwwroot your-function (webhely wwwroot>your-function) elemét.

   Az alábbi lépések egy FabrikamAzureFunction nevű példafüggvényt használnak.

   

5. Nyissa meg a function.json fájlt szerkesztésre.

   

6. A kötések objektumban ellenőrizze, hogy létezik-e az authLevel tulajdonság. Ha a tulajdonság létezik, állítsa a tulajdonság értékét a következőre anonymous: . Ellenkező esetben adja hozzá a tulajdonságot, és állítsa be az értéket.

   

7. Ha végzett, mentse a beállításokat. Folytassa a következő szakaszt.

A Microsoft Entra-hitelesítés beállításához szükséges értékek megkeresése (csak használati munkafolyamatok esetén)

Mielőtt beállíthatja a függvényalkalmazást a felügyelt identitás és a Microsoft Entra-hitelesítés használatára, az alábbi értékeket kell megkeresnie és mentenie az ebben a szakaszban leírt lépések végrehajtásával.

1. Keresse meg a Microsoft Entra-bérlő bérlőazonosítóját.

2. Keresse meg a felügyelt identitás objektumazonosítóját.

3. Keresse meg a felügyelt identitáshoz társított vállalati alkalmazás alkalmazásazonosítóját.

A Microsoft Entra-bérlő bérlőazonosítójának megkeresése

Futtassa a Get-AzureAccount nevű PowerShell-parancsot, vagy az Azure Portalon kövesse az alábbi lépéseket:

1. Nyissa meg a Microsoft Entra-bérlőt az Azure Portalon.

   Ez az útmutató a Fabrikamot használja példabérltetőként.

2. A bérlői menüben válassza az Áttekintés lehetőséget.

3. Másolja és mentse a bérlőazonosítót későbbi használatra, például:

   

A felügyelt identitás objektumazonosítójának megkeresése

Miután engedélyezte a felügyelt identitást a Consumption logikai alkalmazás erőforrásához, keresse meg a felügyelt identitás objektumát. Ezzel az azonosítóval fogja megkeresni a társított Vállalati alkalmazást az Entra-bérlőben.

1. A logikai alkalmazás menüjében, a Gépház alatt válassza az Identitás lehetőséget, majd válassza ki a hozzárendelt rendszer vagy felhasználó lehetőséget.

   • Rendszer hozzárendelve

     Másolja ki az identitás objektum-(egyszerű) azonosítóját:

     

   • Felhasználó hozzárendelve

     1. Válassza ki az identitást:

        

     2. Másolja ki az identitás objektum-(egyszerű) azonosítóját:

        

A felügyelt identitáshoz társított Azure Enterprise-alkalmazás alkalmazásazonosítójának megkeresése

Ha engedélyezi a felügyelt identitást a logikaialkalmazás-erőforráson, az Azure automatikusan létrehoz egy társított Azure Enterprise-alkalmazást , amely ugyanazzal a névvel rendelkezik. Most meg kell keresnie a társított vállalati alkalmazást, és ki kell másolnia annak alkalmazásazonosítóját. Később ezzel az alkalmazásazonosítóval hozzáadhat egy identitásszolgáltatót a függvényalkalmazáshoz egy alkalmazásregisztráció létrehozásával.

1. Az Azure Portalon keresse meg és nyissa meg az Entra-bérlőt.

2. A bérlői menü Kezelés területén válassza a Vállalati alkalmazások lehetőséget.

3. A Minden alkalmazás lap keresőmezőjébe írja be a felügyelt identitás objektumazonosítóját. Az eredményekből keresse meg a megfelelő vállalati alkalmazást, és másolja ki az alkalmazásazonosítót:

   

4. Most használja a másolt alkalmazásazonosítót egy identitásszolgáltató hozzáadásához a függvényalkalmazáshoz.

Identitásszolgáltató hozzáadása a függvényalkalmazáshoz (csak használati munkafolyamatok)

Most, hogy rendelkezik a bérlőazonosítóval és az alkalmazásazonosítóval, beállíthatja a függvényalkalmazást a Microsoft Entra-hitelesítés használatára egy identitásszolgáltató hozzáadásával és egy alkalmazásregisztráció létrehozásával.

1. Nyissa meg a függvényalkalmazást az Azure Portalon.

2. A függvényalkalmazás menüjének Gépház területén válassza a Hitelesítés lehetőséget, majd válassza az Identitásszolgáltató hozzáadása lehetőséget.

   

3. Az Identitásszolgáltató hozzáadása panel Alapszintű beállítások csoportjában válassza a Microsoftot az identitásszolgáltatói listából.

4. Az Alkalmazásregisztráció csoportban az alkalmazásregisztráció típusához válassza a Meglévő alkalmazásregisztráció adatainak megadása lehetőséget, és adja meg a korábban mentett értékeket.

   Tulajdonság	Kötelező	Érték	Leírás
   Alkalmazás (ügyfél) azonosítója	Igen	<alkalmazásazonosító>	Az alkalmazásregisztrációhoz használandó egyedi azonosító. Ebben a példában használja a felügyelt identitáshoz társított vállalati alkalmazáshoz másolt alkalmazásazonosítót.
   Titkos ügyfélkód	Nem kötelező, de ajánlott	<titkos ügyfélkód>	Az a titkos érték, amelyet az alkalmazás használ a személyazonosságának igazolására egy jogkivonat kérésekor. Az ügyfél titkos kódját az alkalmazás konfigurációjában hozza létre és tárolja egy MICROSOFT_PROVIDER_AUTHENTICATION_Standard kiadás CRET nevű, pont ragadós alkalmazásbeállításként. Ha inkább az Azure Key Vaultban szeretné kezelni a titkos kulcsokat, később frissítheti ezt a beállítást a Key Vault-hivatkozások használatához. – Ha titkos ügyfélkulcs-értéket ad meg, a bejelentkezési műveletek a hibrid folyamatot használják, és a hozzáférési és frissítési jogkivonatokat is visszaadják. - Ha nem ad meg ügyfélkulcsot, a bejelentkezési műveletek az OAuth 2.0 implicit engedélyezési folyamatot használják, amely csak egy azonosító jogkivonatot ad vissza. Ezeket a jogkivonatokat a szolgáltató küldi el, és az EasyAuth tokentárolóban tárolja.
   Kiállító URL-címe	Nem	<authentication-endpoint-URL>/<Entra-tenant-ID>/v2.0	Ez az URL átirányítja a felhasználókat a megfelelő Microsoft Entra-bérlőre, és letölti a megfelelő metaadatokat a megfelelő jogkivonat-aláíró kulcsok és a jogkivonat-kiállító jogcímértékének meghatározásához. Az Azure AD v1-et használó alkalmazások esetében hagyja ki a /v2.0-t az URL-címből. Ebben a forgatókönyvben használja a következő URL-címet: https://sts.windows.net/<Entra-tenant-ID>
   Engedélyezett jogkivonat-célközönségek	Nem	<application-ID-URI>	A függvényalkalmazás alkalmazásazonosítója URI (erőforrás-azonosító). Olyan felhő- vagy kiszolgálóalkalmazások esetében, ahol engedélyezni szeretné a webalkalmazásból származó hitelesítési jogkivonatokat, adja hozzá a webalkalmazás alkalmazásazonosítójának URI-ját. A konfigurált ügyfélazonosítót mindig implicit módon tekintjük engedélyezett célközönségnek. Ebben a forgatókönyvben az érték a következő https://management.azure.com: . Később ugyanezt az URI-t használhatja a Audience tulajdonságban, amikor beállítja a függvényműveletet a munkafolyamatban a felügyelt identitás használatára. Fontos: Az alkalmazásazonosító URI-jának (erőforrás-azonosítójának) pontosan meg kell egyeznie a Microsoft Entra ID által várt értékkel, beleértve a szükséges záró perjeleket is.

   Ezen a ponton a verzió az alábbi példához hasonlóan néz ki:

   

   Ha először állítja be a függvényalkalmazást identitásszolgáltatóval, megjelenik az App Service hitelesítési beállítások szakasza is. Ezek a beállítások határozzák meg, hogy a függvényalkalmazás hogyan reagál a nem hitelesített kérelmekre. Az alapértelmezett kijelölés átirányítja az összes kérést az új identitásszolgáltatónál való bejelentkezéshez. Ezt a viselkedést most testre szabhatja, vagy később módosíthatja ezeket a beállításokat a fő hitelesítési lapon a Hitelesítés beállításai melletti Szerkesztés gombra kattintva. Ha többet szeretne megtudni ezekről a lehetőségekről, tekintse át a hitelesítési folyamatot – Hitelesítés és engedélyezés a Azure-alkalmazás Szolgáltatásban és az Azure Functionsben.

   Ellenkező esetben folytathatja a következő lépést.

5. Az alkalmazásregisztráció létrehozásának befejezéséhez válassza a Hozzáadás lehetőséget.

   Ha végzett, a Hitelesítés lap most már felsorolja az identitásszolgáltatót és az alkalmazásregisztrációs alkalmazás (ügyfél) azonosítóját. A függvényalkalmazás mostantól használhatja ezt az alkalmazásregisztrációt hitelesítésre.

6. Másolja ki az alkalmazásregisztráció alkalmazás-(ügyfél-) azonosítóját , hogy később használhassa az Azure Functions-művelet Audience tulajdonságában a munkafolyamathoz.

   

7. Térjen vissza a tervezőhöz, és kövesse a lépéseket a felügyelt identitással való hozzáférés hitelesítéséhez a beépített Azure Functions-művelettel.

Következő lépések

• Azure-erőforrásokhoz való hitelesítés felügyelt identitásokkal az Azure Logic Appsben