Vlastní konektory

  • Č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 REST API (Logic Apps také podporuje rozhraní API SOAP), 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íť).

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 budou 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), měli byste odebrat URI globálního přesměrování z aplikací OAuth 2.0 a přidat nově vygenerované jedinečné přesměrování. Adresa URL vašich 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í podle konektoru, 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í jednoduše 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 ho 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.

Kurz

Tento kurz používá Rozhraní API pro analýzu textu Cognitive Services. Microsoft již poskytuje konektor pro toto API. Je to dobrý příklad pro výuku životního cyklu vlastního konektoru a toho, jak mohou vlastní konektory podporovat jedinečné scénáře.

Scénář

Konektor, který vytvoříte, zpřístupní operaci analýzy mínění v textu, která vrací skóre mínění (0,000 až 1,000) pro textový vstup.

Požadavky

  • Jedno z následujících předplatných:

  • Základní znalosti o tom, jak vytvářet Logic Apps, roky Power Automate nebo Power Apps.

  • Klíč rozhraní API pro rozhraní API služeb Cognitive Services pro analýzu textu.

Získání klíče API

Rozhraní API pro textovou analýzu používá Klíč API k ověření uživatelů. Když uživatel vytvoří připojení k API prostřednictvím vlastního konektoru, určí hodnotu tohoto klíče. Získání klíče API:

Spuštění kurzu

Rozšířené návody

Kurzy a video v této části vám poskytnou potřebný přehled, jak využít konektory Power Platform jako součást vašich implementací.

Kurzy

Následující kurzy poskytují podrobnější informace o konkrétních scénářích vlastních konektorů:

Video

Následující 45minutové video vám ukáže, jak fungují konektory Power Platform. Dále ukazuje, jak vytvořit jednoduché a rozšířené vlastní konektory.

Viz také

Seznam všech konektorů

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.