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

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

Az Azure Logic Apps, a Microsoft Power Automate, a Microsoft Power Apps és a Microsoft Copilot Studio több mint 1000 összekötőt kínál a Microsofthoz való csatlakozáshoz és az ellenőrzött szolgáltatásokhoz, de é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).

Képernyőkép, amely bemutatja, hogyan hidalják át az egyéni összekötők a Text Analytics API-t az alkalmazásokkal.

Életciklus

Képernyőkép az egyéni összekötők életciklusáról öt szakaszban.

1. Saját API létrehozása

Az egyéni összekötő egy REST API burkoló, amely lehetővé teszi a Logic Apps, Power Automate, Power Apps, vagy Copilot Studio a REST vagy SOAP API-val való kommunikációt. Ezek az API-k lehetnek:

  • Nyilvános (a nyilvános interneten látható), például a Spotify, a Slack, a Rackspace vagy az Ön által kezelt API.
  • Privát (csak az Ön hálózata számára látható).

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

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:

Privát API-k esetén a Microsoft helyszíni adatkapcsolatot kínál 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 Microsoft Entra egyéni összekötők azonosítójáról: 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 2.0-t használnak OAuth a hitelesítéshez, összekötőnkénti átirányítási URI-val rendelkeznek. A meglévő OAuth 2.0-s összekötőket frissíteni kell, hogy 2024. február 17. előtt összekötőnkénti átirányítási URI-t használjanak.

  • Ha az egyéni összekötőket a webes felülettel 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 lap beállításán vagy a parancssori felületi eszközön keresztül, távolítsa el a globális átirányítási URI-t a OAuth 2.0-s alkalmazásokból. Adja hozzá az újonnan létrehozott egyedi átirányítási URL-t a OAuth 2.0-s alkalmazásokhoz.
  • Ezt a frissítést 2024. február 17-től kényszerítjük ki a meglévő OAuth 2.0-s egyéni összekötőkre. Az összekötőnkénti átirányítási URI-ra nem frissített egyéni összekötők nem működnek az új kapcsolatok esetében, és hibaüzenetet jelenítenek meg a felhasználónak.
  • Ha meg szeretné tudni, hogy mely egyéni összekötőknek van szükségük frissítésre az összekötőnkénti átirányítási URL-címre való áttelepítéshez, létrehozhat egy folyamatot, amely az Egyéni összekötők lekérése rendszergazdaként műveletet használja Power Apps a rendszergazdai összekötőhöz, és elemezze az eredményét. A cikk későbbi részében csatolt folyamat ugyanazzal a használatával kéri le az összes egyéni összekötőt. Ezután egy szűrési feltételt alkalmaz a kapcsolati paraméter tulajdonságára a nem Oauth egyéni összekötő kiszűréséhez, majd egy másik szűrőt alkalmaz, 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. 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örnyezetbe. A folyamatot tovább bővítheti, hogy a HTML-táblázatot e-mailben küldje el magának. Vagy kiterjesztheti úgy, hogy e-maileket küldjön közvetlenül 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 már rendelkezik hitelesített hozzáféréssel rendelkező API-val, a következő lépés az API leírása, hogy a Logic Apps, Power Automate, Power Apps, vagy Copilot Studio 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 a Logic Apps, Power Automate,, és Power Appsaz összekötők definiálásához használható Copilot Studio OpenAPI .

4. Az összekötő Copilot Studio használata a Logic Appsben Power Automate vagy egy alkalmazásban Power Apps

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 létrehozott Power Automate összekötők az és, Power Apps a és a létrehozott Copilot Studioösszekötők pedig a és Power Apps a következőben Power Automate Copilot Studioérhetők el. Ez a rendelkezésre állás nem igaz a Logic Appsben létrehozott összekötőkre. 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:

Tipp.

Ha frissít (eltávolít, hozzáad vagy módosít) egy mezőt az API-ban, hajtsa végre az alábbi lépéseket:

  1. Tegye közzé újra az összekötőt, hogy az az API frissített Swaggerét nézze.
  2. Távolítson el minden kapcsolatot/adatforrást minden olyan alkalmazásból, amely az összekötőt használta.
  3. Adja hozzá újra az összekötő kapcsolatát/adatforrását az alkalmazásokhoz.

5. Az összekötő megosztása

Az összekötőt ugyanúgy megoszthatja a szervezet felhasználóival, mint az erőforrásokat Copilot Studio a Logic Apps, Power Automate, vagy Power Apps. A megosztás nem kötelező, de előfordulhat, hogy meg szeretné osztani az összekötőket más felhasználókkal.

További információ: Egyéni összekötők megosztása a szervezetben.

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

Ha meg szeretné osztani az összekötőt a Logic Apps összes felhasználójával Copilot Studio, el kell Power Automateküldenie az összekötőt Microsoft-minősítésre. Power Apps A Microsoft felülvizsgálja az összekötőt, ellenőrzi a műszaki és tartalmi megfelelőséget, és ellenőrzi a funkciókat.

A Virtual Network támogatása

Ha az összekötőt egy Virtual Network Power Platform összekapcsolt környezetben használja, 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 ismerteti.

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

  • Az egyéni összekötőbe nem hívó helyfejlécet visszaadó eseményindítók nem támogatottak.

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 elküldése vagy az összekötőkkel kapcsolatos segítség kérése elemre, és válassza ki a visszajelzés típusát.

  • Last updated on