Sdílet prostřednictvím


Přehled vlastních konektorů

Přestože pro připojení ke službám Microsoftu i ověřeným službám Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps nabízejí více než 1000 konektorů a Microsoft Copilot Studio může používat tyto předpřipravené konektory, 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.

Snímek obrazovky znázorňující, jak vlastní konektory přemosťují rozhraní API pro analýzu textu 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, Power Apps nebo Copilot Studio 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é používají OAuth 2.0 k automatickému ověřování, mají identifikátor URI přesměrování pro jednotlivé konektory. Stávající konektory OAuth 2.0 musí být aktualizovány tak, aby používaly identifikátor URI přesměrování pro jednotlivé konektory před 17. únorem 2024.

  • 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 se vlastní konektory aktualizují tak, aby používaly identifikátor URI přesměrování pro jednotlivé konektory, a to buď prostřednictvím nastavení na kartě Zabezpečení, nebo nástroje rozhraní příkazového řádku, odeberte identifikátor URI globálního přesměrování z aplikací OAuth 2.0. Nově vygenerovanou jedinečnou adresu URL pro přesměrování byste měli přidat do aplikací OAuth 2.0.
  • Tuto aktualizaci budeme vynucovat pro stávající vlastní konektory OAuth 2.0 od 17. února 2024. Jakýkoli vlastní konektor, který není aktualizován tak, aby používal identifikátor URI přesměrování pro jednotlivé konektory, přestane fungovat pro nová připojení a zobrazí uživateli chybovou zprávu.
  • Pokud chcete zjistit, které vlastní konektory potřebují aktualizaci, aby se migrovaly na adresu URL přesměrování jednotlivých konektorů, můžete vytvořit tok, který používá akci Power Apps Získat vlastní konektory jako správce pro konektor pro správu a parsování jeho výsledku. Tok připojený dále v tomto článku načte všechny vlastní konektory pomocí stejné akce. Pak použije podmínku filtru na vlastnost parametru připojení k odfiltrování vlastního konektoru jiného než OAuth následovaného dalším filtrem, který vybere jenom konektory, které nepoužívají jedinečnou adresu URL přesměrování pro jednotlivé konektory. 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 Logic Apps, Power Automate, Power Apps nebo Copilot Studio 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í, Logic Apps, Power Automate, Power Apps a Copilot Studio používají OpenAPI k definování konektorů.

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 a Copilot Studio a konektory vytvořené v Power Apps jsou k dispozici v Power Automate a Copilot Studio. 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, proveďte tyto kroky:

  1. Znovu publikujte konektor, aby se podíval na aktualizovaný Swagger pro rozhraní API.
  2. Odeberte všechna připojení nebo zdroje dat v jakékoli aplikaci, která tento konektor používala.
  3. Znovu přidejte připojení nebo 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 zdroje v Logic Apps, Power Automate, Power Apps nebo Copilot Studio. 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ího konektoru 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, Power Apps a Copilot Studio, musíte svůj konektor 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.

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 vytvořené před přidružením prostředí k Virtual Network je potřeba znovu uložit.

  • Triggery, které vracejí location hlavičku, která nevolá zpět do vlastního konektoru, se nepodporují.

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.