Egyéni összekötők

  • Cikk

Bár Azure Logic Apps Microsoft Power Automate és Microsoft Power Apps több mint 1 000 összekötőt kínál a Microsofthoz és az ellenőrzött szolgáltatásokhoz való csatlakozáshoz, előfordulhat, hogy olyan szolgáltatásokkal szeretne kommunikálni, amelyek nem érhetők el előre összeállított összekötőként. Az egyéni összekötők erre a forgatókönyvre adnak megoldást, lehetővé téve saját eseményindítókkal és műveletekkel rendelkező összekötők létrehozását (és akár megosztását is).

Screenshot of custom connectors - overview.

Életciklus

Screenshot of custom connectors - lifecycle.

1. Saját API létrehozása

Az egyéni összekötő egy REST API körüli burkoló (a Logic Apps támogatja a SOAP API-kat is), amely lehetővé teszi a Logic Apps, Power Automate és Power Apps szolgáltatásoknak, hogy kommunikáljanak a REST vagy SOAP API-kkal.. Ezek az API-k lehetnek:

  • Nyilvánosak (a nyilvános interneten láthatók), például a Spotify, a Slack, a Rackspacevagy egy olyan API, amelyet Ön kezel.
  • Privát (csak az Ön hálózata számára látható).

A létrehozandó és kezelendő nyilvános API-k esetében érdemes megfontolni a következő Microsoft Azure-termékek egyikének használatát:

A privát API-k esetében a Microsoft helyszíni adatösszekapcsolhatóságot biztosít egy helyszíni adatátjárón keresztül.

2. Gondoskodás az API biztonságáról

Használja az alábbi szabványos hitelesítési módszerek egyikét az API-khoz és összekötőkhöz (Microsoft Entra az azonosító ajánlott):

Az API-hoz azonosítóhitelesítést állíthat be Microsoft Entra a Azure Portal, így nem kell hitelesítést megvalósítania. A hitelesítést megkövetelheti és kényszerítheti az API kódjának használatával is. További információ az egyéni összekötők azonosítójáról Microsoft Entra : Az API és az összekötő biztonságossá tétele azonosítóval Microsoft Entra.

2.1. OAuth 2.0

Az újonnan létrehozott egyéni összekötők, amelyek OAuth 2.0-t használnak az automatikus hitelesítéshez, összekötőnkénti átirányítási URI-val rendelkeznek. A meglévő OAuth 2.0-összekötőket frissíteni kell, hogy összekötőnkénti átirányítási URI-t használjanak 2024. február 17. előtt.

  • Ha az egyéni összekötőket a webes felületen hozta létre, szerkessze az egyéni összekötőket, lépjen a Biztonság lapra, és jelölje be a Frissítés egyedi átirányítási URL-címre jelölőnégyzetet, majd mentse az összekötőnkénti átirányítási URI engedélyezéséhez.
  • Ha az egyéni összekötőket többszörös hitelesítéssel hozta létre a parancssori felület (CLI) eszközzel, frissítenie kell az összekötőt a CLI eszközzel a beállításhoz "redirectMode": "GlobalPerConnector".
  • Miután frissítette az egyéni összekötőket az összekötőnkénti átirányítási URI használatára (a Biztonság lapon található beállítással vagy a CLI eszközzel), távolítsa el a globális átirányítási URI-t az OAuth 2.0-alkalmazásokból, és adja hozzá az újonnan létrehozott egyedi átirányítási URL-címet az OAuth 2.0-alkalmazásokhoz.
  • Ezt a frissítést a meglévő OAuth 2.0 egyéni összekötőkre 2024. február 17-től kényszerítjük ki. Minden olyan egyéni összekötő, amely nem lett frissítve összekötőnkénti átirányítási URI használatára, nem fog működni az új kapcsolatokhoz, és hibaüzenetet jelenít meg a felhasználónak.
  • Ha meg szeretné tudni, hogy mely egyéni összekötőket kell frissíteni az összekötőnkénti átirányítási URL-címre való áttelepítéshez, létrehozhat egy egyszerű folyamatot, amely az Egyéni összekötők beolvasása rendszergazdai műveletként használja a Power Apps rendszergazdai összekötőhöz, és elemezheti az eredményét. A cikk későbbi részében csatolt folyamat az összes egyéni összekötőt ugyanazzal a használatával kéri le. Ezután szűrőfeltételt alkalmaz a kapcsolati paraméter tulajdonságára a nem egyéni összekötők kiszűréséhez, majd egy másik szűrőt, amely csak azokat az összekötőket választja ki, amelyek nem használják az összekötőnkénti egyedi átirányítási URL-címet Oauth . Végül a kiválasztott egyéni összekötőket a folyamat elején inicializált tömbváltozóba helyezi, és létrehoz egy HTML-táblázatot, amely megjeleníti az összekötők nevét és létrehozóját. Ezt a folyamatot egyszerűen importálhatja a környezetébe, ha importálja ezt a megoldást. A folyamatot tovább bővítheti, hogy a HTML-táblázatot e-mailben küldje el saját magának. Vagy kiterjesztheti, hogy közvetlenül e-maileket küldjön az összekötő létrehozóinak, és adja meg nekik a frissíteni kívánt összekötő nevét.

3. Az API leírása és az egyéni összekötő megadása

Ha rendelkezik a hitelesített hozzáféréssel rendelkező API-val, a következő lépés az, hogy leírja az API-t, hogy a Logic Apps, a Power Automate vagy a Power Apps kommunikálni tudjon az API-val. A következő megközelítések támogatottak:

OpenAPI A definíciók és a Postman-gyűjtemények különböző formátumokat használnak, de mindkettő nyelvfüggetlen, géppel olvasható dokumentum, amely leírja az API-t. Az API által használt nyelv és platform alapján számos eszköz áll rendelkezésére ezen dokumentumok létrehozásához. A színfalak mögött, Logic Apps Power Automate és Power Apps összekötők definiálására használható OpenAPI .

4. Összekötő használata Logic App, Power Automate vagy Power Apps alkalmazásban

Az egyéni összekötőket ugyanúgy használják, mint az előre összeállított összekötőket. Először kapcsolatot kell létesítenie az API-val, annak érdekében, hogy ezen a kapcsolaton keresztül hívhatja meg az egyéni összekötőben közzétett műveleteket.

A Power Automate szolgáltatásban létrehozott összekötők elérhetők a Power Apps szolgáltatásban. Hasonlóan a Power Apps szolgáltatásban létrehozott összekötők elérhetők a Power Automate szolgáltatásban. Ez a Logic Apps alkalmazásban létrehozott csatlakozók esetében nem igaz. A definíciót vagy a OpenAPI Postman-gyűjteményt azonban újra felhasználhatja az összekötő újbóli létrehozásához ezen szolgáltatások bármelyikében. További tájékoztatást a megfelelő oktatóanyagban talál:

5. Az összekötő megosztása

Megoszthatja az összekötőt a szervezet felhasználóival, ugyanúgy, ahogy megoszthat erőforrásokat a Logic Apps, Power Automate és Power Apps szolgáltatásokban. A megosztás nem kötelező, de előfordulhatnak olyan helyzetek, ahol meg szeretné osztani az összekötőket más felhasználókkal.

További információért lásd az Egyéni összekötők vállalaton belüli megosztását ismertető cikket.

6. Az összekötő tanúsítása

Ha az összes Logic Apps-, Power Automate- vagy Power Apps-felhasználóval meg szeretné osztani az összekötőt, beküldheti az összekötőt hitelesítésre a Microsoftnak. A Microsoft megvizsgálja az összekötőt, ellenőrzi a technikai és tartalmi megfelelőségét, valamint a funkciók kompatibilitását.

További információt Az összekötő Microsoft általi hitelesítésre történő elküldését ismertető cikkben talál.

Oktatóanyag

Az oktatóanyag a Cognitive Services Text Analytics API-t használja. A Microsoft már biztosít egy csatlakozót ehhez az API-hoz. Ez jó példa arra, hogyan használhatók fel az egyéni csatlakozók életciklusai, és hogyan támogatják az egyéni csatlakozók az egyedi forgatókönyveket.

Forgatókönyv

A létrehozandó összekötő közzéteszi a Text Analytics Sentiment műveletet, amely visszaad egy (0,000 és 1,000 pont közötti) értéket az alapján, hogy a bevitt szöveg értelmes-e.

Előfeltételek

  • Az alábbi előfizetések egyike:

  • A Logic Apps alkalmazások, Power Automate folyamatok vagy Power Apps alkalmazások létrehozásával kapcsolatos alapvető ismeretek.

  • API-kulcs a Cognitive Services Text Analytics API-jához.

API-kulcs lekérése

A Text Analytics API egy API-kulcs segítségével hitelesíti a felhasználókat. Amikor a felhasználó egy egyéni összekötőn keresztül hoz létre kapcsolatot az API-val, a felhasználó megadja ennek a kulcsnak az értékét. Az API-kulcs lekérése:

Az oktatóanyag elindítása

Speciális útmutatás

Az ebben a szakaszban található oktatóanyagok és videók biztosítják a szükséges betekintést az összekötők implementációk részeként való kihasználásához Power Platform .

Oktatóanyagok

A következő oktatóanyagok részletesebben ismertetik az egyéni összekötők konkrét eseteit:

Video

Az alábbi 45 perces videó az Power Platform összekötők működését mutatja be. Azt is bemutatja, hogyan hozhat létre egyszerű és speciális egyéni összekötőket.

Kapcsolódó információk

Az összes összekötő listája

Visszajelzés küldése

Nagyra értékeljük az összekötőplatform problémáival kapcsolatos visszajelzéseket és az új funkciókkal kapcsolatos ötleteket. Ha visszajelzést szeretne küldeni, lépjen a Problémák küldése vagy segítség kérése az összekötőkkel kapcsolatban részre, és válassza ki a visszajelzés típusát.