Sdílet prostřednictvím

Přehled vlastních konektorů

  • Článek

Zatímco Azure Logic Apps, Microsoft Power Automate a Microsoft Power Apps nabízejí více než 1000 konektorů pro připojení k Microsoftu a ověřeným službám, možná budete chtít komunikovat se službami, které nejsou dostupné jako předpřipravené konektory. Tuto situaci řeší vlastní konektory, které umožňují vytvářet (a dokonce i sdílet) konektor s vlastními triggery a akcemi.

Snímek obrazovky ukazující, jak vlastní konektory propojují rozhraní Text Analytics API s aplikacemi.

Životní cyklus

Snímek obrazovky životního cyklu vlastních konektorů v pěti fázích.

1. Sestavte své API

Vlastní konektor je obálka kolem rozhraní REST API, která umožňuje Logic Apps, Power Automate, nebo Power Apps komunikovat s tímto rozhraním API REST nebo SOAP. Tato rozhraní API mohou mít následující formy:

  • Veřejné (viditelné na veřejném internetu), například Spotify, Slack, Rackspace nebo vámi spravované API.
  • Soukromé (viditelné pouze pro vaši síť).

Logic Apps také podporuje rozhraní SOAP API.

U veřejných rozhraní API, která chcete vytvořit a spravovat, zvažte použití jednoho z těchto produktů Microsoft Azure:

Pro soukromá rozhraní API společnost Microsoft nabízí místní datové připojení prostřednictvím místní datové brány.

2. Zabezpečení API

Pro svá rozhraní API a konektory použijte jednu z těchto standardních metod ověřování (doporučuje se Microsoft Entra ID ):

Ověřování Microsoft Entra ID můžete nastavit pro vaše rozhraní API na webu Azure Portal, takže nemusíte implementovat ověřování. Nebo můžete vyžadovat a vynutit ověřování v kódu vašeho API. Další informace o Microsoft Entra ID pro vlastní konektory najdete v části Zabezpečení rozhraní API a konektoru pomocí Microsoft Entra ID.

2.1. OAuth 2.0

Nově vytvořené vlastní konektory, které k automatickému ověřování používají OAuth 2.0, mají URI přesměrování na konektor. Stávající konektory OAuth 2.0 je třeba před 17. únorem 2024 aktualizovat, aby používaly URI přesměrování na konektor.

  • Pokud jste vytvořili vlastní konektory pomocí webového rozhraní, upravte své vlastní konektory, přejděte na kartu Zabezpečení a zaškrtněte políčko Aktualizovat na jedinečnou adresu URL přesměrování a poté uložte, abyste povolili URI přesměrování podle konektoru.
  • Pokud jste vytvořili své vlastní konektory s multi-auth pomocí nástroje rozhraní příkazového řádku (CLI), musíte svůj konektor aktualizovat pomocí nástroje CLI na nastavení "redirectMode": "GlobalPerConnector".
  • Jakmile jsou vlastní konektory aktualizovány tak, aby používaly URI přesměrování podle konektoru buď prostřednictvím nastavení na kartě Zabezpečení , nebo pomocí nástroje CLI, odeberte URI globálního přesměrování z aplikací OAuth 2.0. Nově vygenerovanou jedinečnou adresu URL přesměrování byste měli přidat do svých aplikací OAuth 2.0.
  • Od 17. února 2024 budeme tuto aktualizaci vynucovat u stávajících OAuth 2.0 vlastních konektorů. Jakýkoli vlastní konektor, který není aktualizován, aby používal URI přesměrování na konektor, přestane fungovat pro nová připojení a zobrazí uživateli chybovou zprávu.
  • Chcete-li zjistit, které vlastní konektory potřebují aktualizaci k migraci na adresu URL přesměrování konektoru, můžete vytvořit postup, který používá akci Získat vlastní konektory jako správce z Power Apps pro konektor pro správce a analyzovat jeho výsledek. Tok připojený dále v tomto článku načte všechny vlastní konektory pomocí stejné akce. Poté použije podmínku filtru na vlastnost parametru připojení k odfiltrování vlastního konektoru, který není Oauth, následovaný dalším filtrem, který vybere pouze konektory, které nepoužívají jedinečnou adresu URL přesměrování na konektor. Nakonec vloží vybrané vlastní konektory do proměnné pole inicializované na začátku toku a vygeneruje tabulku HTML s názvem a tvůrcem těchto konektorů. Tento tok můžete importovat do svého prostředí importem tohoto řešení. Tok můžete dále rozšířit a odeslat tabulku HTML jako e-mail sobě. Nebo jej můžete rozšířit, aby posílal e-maily přímo tvůrcům konektoru s názvy konektorů, které je třeba aktualizovat.

3. Popis rozhraní API a definování vlastního konektoru

Až budete mít rozhraní API s ověřeným přístupem, musíte dále popsat své API, aby logické aplikace, Power Automate, nebo Power Apps mohly s vaším rozhraním API komunikovat. Jsou podporovány následující přístupy:

Definice OpenAPI a kolekcí Postman používají různé formáty, ale oba jsou strojově čitelnými dokumenty bez rozlišení jazyka, které popisují operace a parametry vašeho rozhraní API: Tyto dokumenty můžete vygenerovat z různých nástrojů, a to na základě jazyka a platformy, které vaše rozhraní API používá. V zákulisí používají Logic Apps, Power Automate a Power Apps k definování konektorů OpenAPI.

4. Použijte svůj konektor v aplikaci logiky, aplikaci Power Automate, nebo Power Apps

Vlastní konektory se používají stejným způsobem jako předem sestavené konektory. Musíte vytvořit připojení k rozhraní API, abyste mohli provést volání libovolných operací, které jste ve vašem vlastním konektoru zpřístupnili.

Konektory vytvořené v Power Automate jsou dostupné v Power Apps a konektory vytvořené v Power Apps jsou dostupné v Power Automate. Tato dostupnost neplatí pro konektory vytvořené v Logic Apps. Můžete však znovu použít definici OpenAPI nebo kolekce Postman k opětovnému vytvoření konektoru v kterékoli z těchto služeb. Další informace naleznete v příslušném kurzu:

Tip

Pokud aktualizujete (odebíráte, přidáváte nebo měníte) pole v rozhraní API, postupujte takto:

  1. Znovu publikujte konektor, aby se podíval na aktualizovaný Swagger pro API.
  2. Odeberte všechna připojení / zdroj dat v jakékoli aplikaci, která tento konektor používala.
  3. Znovu přidejte připojení / zdroj dat pro tento konektor zpět do aplikací.

5. Sdílejte svůj konektor

Konektor můžete sdílet s uživateli ve vaší organizaci stejným způsobem, jakým sdílíte prostředky v Logic Apps, Power Automate nebo Power Apps. Sdílení je volitelné, ale můžete mít scénáře, ve kterých chcete sdílet své konektory s ostatními uživateli.

Další informace naleznete v části Sdílení vlastních konektorů ve vaší organizaci.

6. Certifikujte svůj konektor

Pokud chcete sdílet konektor se všemi uživateli ve službách Logic Apps, Power Automate a Power Apps, můžete ho odeslat do společnosti Microsoft k certifikaci. Microsoft jej prověří, zkontroluje, jestli dodržuje předpisy ohledně obsahu a technických předpokladů, a ověří jeho funkce.

Další informace naleznete v části Odeslání konektorů k certifikaci společnosti Microsoft.

Podpora Virtual Network

Když je konektor používán v Power Platform prostředí propojeném s virtuální sítí, platí omezení:

  • Při použití vlastního kódu jsou omezení vysvětlena v části Zápis kódu do vlastního konektoru.

  • Vlastní konektory vytvořené před připojením prostředí k virtuální síti je třeba znovu uložit.

  • Spouštěče, které vracejí záhlaví umístění, které nevolá zpět do vlastního konektoru, nejsou podporovány.

Poskytnutí názorů

Velmi si vážíme vašich názorů na problémy s naší platformou konektorů nebo nových nápadů na funkce. Chcete-li poskytnout zpětnou vazbu, přejděte na Odeslat problémy nebo získejte nápovědu ke konektorům a vyberte typ zpětné vazby.