Sdílet prostřednictvím

Přehled vlastních konektorů

  • Článek

Přestože pro připojení ke službám Microsoftu i ověřeným službám Azure Logic Apps, Microsoft Power Automate a Microsoft Power Apps nabízejí více než 1 000 konektorů, může se stát, že budete chtít komunikovat se službami, které nejsou k dispozici ve formě připravených konektorů. Tuto situaci řeší vlastní konektory, které umožňují vytvářet (a dokonce i sdílet) konektor s vlastními triggery a akcemi.

Screenshot of custom connectors - overview.

Životní cyklus

Screenshot of custom connectors - lifecycle.

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ř Spotify, Slack, Rackspace nebo rozhraní API, které spravujete.
  • 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 nabízí Microsoft datovou konektivitu prostřednictvím místní datové brány.

2. Zabezpečení API

Doporučuje se použití jedné z těchto standardních metod ověřování pro vaše rozhraní API a konektory 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 tématu 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í protokol OAuth 2.0, mají URI přesměrování podle konektoru. Stávající konektory OAuth 2.0 je třeba před 17. únorem 2024 aktualizovat tak, 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čné adrese URL pro přesměrování a poté uložit, abyste povolili URI přesměrování podle konektoru.
  • Pokud jste vytvořili vlastní konektory s multi-auth pomocí nástroje rozhraní příkazového řádku (CLI), musíte konektor aktualizovat pomocí nástroje CLI "redirectMode": "GlobalPerConnector".
  • Jakmile jsou vlastní konektory aktualizovány, aby používaly URI přesměrování na konektor buď prostřednictvím nastavení na kartě Zabezpečení nebo pomocí nástroje CLI, musíte z aplikací OAuth 2.0 odebrat URI globálního přesměrování. Nově vygenerovanou jedinečnou adresu URL přesměrování musíte přidat do svých aplikací OAuth 2.0.
  • Tuto aktualizaci budeme u stávajících vlastních konektorů OAuth 2.0 vynucovat od 17. února 2024. Jakýkoli vlastní konektor, který nebyl aktualizován, aby používal URI přesměrování na konektor, přestane pro nová připojení fungovat a zobrazí uživateli chybovou zprávu.
  • Chcete-li zjistit, které vlastní konektory potřebují aktualizaci za účelem migrace na adresu URL pro přesměrování podle konektoru, můžete vytvořit jednoduchý tok, který využívá akci Získat vlastní konektory jako správce v konektoru Power Apps for Admin, 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 bez Oauth a následně další filtr, který vybere pouze konektory, které nepoužívají jedinečnou adresu URL pro přesměrování podle konektoru. 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 k dispozici v Power Apps. Podobně pak konektory vytvořené v Power Apps jsou k dispozici v Power Automate. To 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:

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 najdete v tématu Sdílení vlastních konektorů v rámci organizace.

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 najdete v tématu Odeslání konektorů Microsoftu k certifikaci.

Podpora Virtual Network

Když se konektor používá v prostředí Power Platform propojeném s Virtual Network, platí omezení:

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

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

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 do části Odeslat problémy nebo získat pomoc s konektory a vyberte typ zpětné vazby.