Megosztás a következőn keresztül:

Egyéni összekötők áttekintése

  • 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, érdemes lehet olyan szolgáltatásokkal 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 burkoló egy REST API körül, amely lehetővé teszi a Logic Apps, Power Automate, vagy Power Apps az adott REST vagy SOAP API-val való kommunikációt. 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ó).

Logic Apps támogatja a SOAP API-kat is.

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, hogy az összekötőnkénti átirányítási URI-t használják a Biztonság lapon található beállítással vagy a CLI eszközzel, el kell távolítania a globális átirányítási URI-t az OAuth 2.0-alkalmazásokból. 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ők esetében 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, leáll az új kapcsolatoknál, é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 a megoldás importálásával importálhatja a környezetébe. 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 megadja 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 használja OpenAPI az összekötők meghatározásához.

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. Létre kell hoznia egy kapcsolatot az API-val ahhoz, hogy ezzel a kapcsolattal hívja meg az egyéni összekötőben elérhetővé 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 forgatókönyvek, amelyekben 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 áttekinti az összekötőt, ellenőrzi a műszaki és tartalmi megfelelőséget, és ellenőrzi a funkciókat.

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

A Virtual Network támogatása

Ha az összekötőt egy Virtual Networkhöz Power Platform csatolt környezetben használják, korlátozások érvényesek:

  • Egyéni kód használata esetén: A korlátozásokat a Kód írása egyéni összekötőben című témakör ismerteti.

  • A környezet Virtual Networkhöz való társítása előtt létrehozott egyéni összekötőket újra kell menteni.

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.