Přehled vlastních konektorů

Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps a Microsoft Copilot Studio nabízejí více než 1 000 konektorů pro připojení k Microsoftu a ověřeným službám, ale můžete chtít komunikovat se službami, které nejsou k dispozici jako předem př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 znázorňující, jak vlastní konektory propojují rozhraní Analýza textu 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, 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é 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 musí být před 17. únorem 2024 aktualizovány tak, aby používaly identifikátor URI pro přesměrování pro každý 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 vlastní konektory vytvořili pomocí nástroje rozhraní příkazového řádku (CLI) s funkcí multi-auth, musíte svůj konektor aktualizovat pomocí nástroje CLI a nastavit "redirectMode": "GlobalPerConnector".
  • Jakmile budou vlastní konektory aktualizovány tak, aby používaly identifikátor URI přesměrování pro každý konektor, a to buď pomocí nastavení na kartě Zabezpečení, nebo nástroje CLI, odeberte z aplikací OAuth 2.0 globální identifikátor URI přesměrování. 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 vyžadují aktualizaci pro migraci na adresu URL pro přesměrování pro každý konektor, můžete vytvořit tok, který používá akci Získat vlastní konektory jako správce z konektoru Power Apps for Admin a analyzuje její výsledek. 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í, aby odfiltroval vlastní konektory, které nejsou OAuth, a poté použije další filtr, aby vybral pouze konektory, které nepoužívají jedinečnou adresu URL přesměrování pro každý 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 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 Copilot Studio, Logic Apps, aplikaci Power Automate nebo aplikaci 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 Copilot Studio, 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í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 Copilot Studio, Logic Apps, Power Automate a Power Apps, 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.
  • Spouštěče, které vrací hlavičku umístění a nevolají zpět do vlastního konektoru, nejsou podporovány.
  • Požadavky na OAuth a tokeny neprocházejí přes propojenou virtuální síť. Pouze požadavky na koncové body API to dělají.

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.

  • Last updated on