Přehled partnerských událostí pro partnery – Azure Event Grid

Článek
10/18/2023

Partnerské události služby Event Grid umožňují zákazníkům přihlásit se k odběru událostí pocházejících z registrovaného systému pomocí stejného mechanismu, který by používali pro jakýkoli jiný zdroj událostí v Azure, jako je služba Azure. Tyto registrované systémy se integrují se službou Event Grid jako "partneři". Tato funkce také umožňuje zákazníkům odesílat události do partnerských systémů, které podporují příjem a směrování událostí do řešení nebo koncových bodů zákazníka na jejich platformě. Partneři jsou obvykle poskytovatelé softwaru jako služby (SaaS) nebo ERP , ale můžou být firemní platformy, které chtějí zpřístupnit své události interním týmům. Záměrně se integrují se službou Event Grid za účelem realizace kompletních případů použití zákazníků, které končí v Azure (zákazníci se přihlašují k odběru událostí odesílaných partnerem) nebo ukončení partnerského systému (zákazníci se přihlašují k odběru událostí Microsoftu odesílaných službou Azure Event Grid). Zákazníci v Azure Event Gridu můžou odesílat události publikované partnerem do podporovaných cílů, jako jsou webhooky, Azure Functions, Azure Event Hubs nebo Azure Service Bus. Zákazníci také spoléhají na Službu Azure Event Grid ke směrování událostí pocházejících z služby Microsoft, jako je Outlook, Teams nebo Microsoft Entra ID, aby na ně řešení zákazníka mohli reagovat. Díky partnerským událostem můžou zákazníci vytvářet řešení založená na událostech napříč platformami a síťovými hranicemi, aby mohli přijímat nebo odesílat události spolehlivě, bezpečně a ve velkém měřítku.

Poznámka:

Toto je koncepční článek, který je potřeba přečíst předtím, než se rozhodnete připojit jako partnera do Azure Event Gridu. Podrobné pokyny k onboardingu jako partnera Event Gridu pomocí webu Azure Portal najdete v tématu Postup onboardingu jako partnera Event Gridu (Azure Portal).

Partnerské události: Jak to funguje

Jako partner vytvoříte prostředky Event Gridu, které umožňují publikovat události do Azure Event Gridu, aby se zákazníci v Azure mohli přihlásit k jejich odběru. U většiny partnerů, například poskytovatelů SaaS, je to jediná možnost integrace, kterou budou používat.

Můžete také vytvořit prostředky Event Gridu pro příjem událostí z Azure Event Gridu. Tento případ použití je určený pro organizace, které vlastní nebo spravují platformu, která svým zákazníkům umožňuje přijímat události zveřejněním koncových bodů. Některé z těchto organizací jsou systémy ERP, které mají také možnosti směrování událostí v rámci své platformy, které odesílají příchozí události Azure do zákaznické aplikace hostované na své platformě.

Pro publikování událostí nebo přijímání událostí vytvoříte stejný druh prostředků Event Gridu podle těchto obecných kroků.

Obraťte se na tým Event Gridu a askgrid@microsoft.com sdělte svůj zájem o to, aby se stal partnerem. Jakmile nás kontaktujete, provedeme vás procesem onboardingu a pomůžeme vaší službě získat vstupní kartu v galerii Azure Event Gridu, aby se vaše služba našla na webu Azure Portal.
Vytvořte registraci partnera. Jedná se o globální prostředek, který obvykle potřebujete vytvořit jednou.
Vytvořte obor názvů partnera. Tento prostředek zveřejňuje koncový bod, do kterého můžete publikovat události do Azure. Při vytváření oboru názvů partnera zadejte registraci partnera, kterou jste vytvořili.
Zákazník vás autorizuje k vytvoření tématu partnera v předplatném Azure zákazníka.
Zákazník přistupuje k vaší webové stránce nebo provede příkaz, definujete uživatelské prostředí, abyste požadovali tok událostí do Azure nebo možnost přijímat události Microsoftu do vašeho systému. V reakci na tento požadavek nastavíte systém tak, aby to udělal se vstupem od zákazníka. Zákazník může mít například možnost vybrat určité události z vašeho systému, které by se měly předávat do Azure.
Pomocí kanálů vytvořte téma partnera v předplatném Azure a skupině prostředků zákazníka. Kanály jsou prostředky obsažené v oborech názvů partnerů.
Zákazník aktivuje téma partnera, které jste vytvořili ve svém předplatném Azure a skupině prostředků.
Začněte publikovat události do oboru názvů partnera.

Poznámka:

U každého předplatného Azure, ve kterém chcete vytvářet prostředky Event Gridu, musíte zaregistrovat poskytovatele prostředků Azure Event Gridu. Jinak operace pro vytvoření prostředků selžou.

Proč mám používat partnerské události?

Pokud máte minimálně jeden z následujících požadavků, můžete použít funkci Partnerské události.

Pro partnery jako vydavatele událostí

Chcete mechanismus, který vašim zákazníkům v Azure zpřístupní vaše události. Vaši uživatelé můžou tyto události filtrovat a směrovat pomocí témat partnerů a odběrů událostí, které vlastní a spravují. Můžete použít jiné přístupy k integraci, jako jsou témata a domény. Tyto přístupy by ale nepovolily čisté oddělení vlastnictví prostředků, správy a fakturace mezi vámi a zákazníkem. Funkce Partnerské události také poskytuje intuitivnější uživatelské prostředí, které usnadňuje zjišťování vaší služby.
K směrování událostí různým zákazníkům potřebujete jednoduchý model s více tenanty, ve kterém publikujete události do jednoho regionálního koncového bodu, koncového bodu oboru názvů.
Chcete mít přehled o metrikách souvisejících s publikovanými událostmi.
Chcete pro své události použít schéma Cloud Events 1.0 .

Pro partnery jako předplatitele

Chcete, aby vaše služba reagovala na události zákazníků, které pocházejí z Microsoft Azure.
Chcete, aby zákazník reagoval na události služby Microsoft Azure pomocí svých aplikací hostovaných vaší platformou. Pomocí funkcí směrování událostí vaší platformy můžete doručovat události správnému zákaznickému řešení.
Chcete jednoduchý model, ve kterém vaši zákazníci jednoduše vyberou název vaší služby jako cíl, aniž by museli znát technické podrobnosti, jako jsou koncové body vaší platformy.
Váš systém nebo platforma podporuje schéma cloudových událostí 1.0 .

Prostředky spravované partnery

Jako partner spravujete následující typy prostředků.

Registrace partnera

Registrace obsahuje obecné informace týkající se partnera. Při vytváření oboru názvů partnera se vyžaduje registrace. To znamená, že musíte mít registraci partnera, abyste mohli vytvořit potřebné prostředky Azure pro integraci se službou Azure Event Grid.

Registrace jsou globální. To znamená, že nejsou přidružené ke konkrétní oblasti Azure. Můžete vytvořit registraci jednoho partnera a použít ji při vytváření oborů názvů partnerů.

Kanál

Kanál je vnořený prostředek do oboru názvů partnera. Kanál má dva hlavní účely:

Jedná se o typ prostředku, který umožňuje vytvářet partnerské prostředky v předplatném Azure zákazníka. Když vytvoříte kanál typu partner topic, vytvoří se partnerské téma v předplatném Azure zákazníka. Partnerské téma je prostředek zákazníka, do kterého se události směrují, když partnerský systém publikuje události.

Kanál má stejný životní cyklus jako přidružené téma nebo cíl partnera zákazníka. Když se odstraní kanál typu partner topic , například přidružené téma partnera zákazníka se odstraní. Podobně pokud zákazník odstraní téma partnera, odstraní se přidružený kanál ve vašem předplatném Azure.
Jedná se o prostředek, který se používá ke směrování událostí. Kanál typu partner topic slouží ke směrování událostí do tématu partnera zákazníka. Podporuje dva typy režimů směrování.
- Směrování názvu kanálu. S tímto druhem směrování publikujete události pomocí hlavičky HTTP, aeg-channel-name kde zadáte název kanálu, do kterého se mají události směrovat. Vzhledem k tomu, že kanály představují partnerská témata, události směrované do kanálu se zobrazují v tématu partnera zákazníka. Tento druh směrování představuje novou funkci, která event channelsnepodporuje pouze směrování založené na zdroji. Směrování názvu kanálu umožňuje více případů použití, než je směrování založené na zdroji, a je to doporučený režim směrování, který si můžete vybrat. Například se směrováním názvu kanálu může zákazník požádat o události, které pocházejí z různých zdrojů událostí, aby se nasměrovály na jedno téma partnera.
- Směrování na základě zdroje Tento přístup směrování je založen na hodnotě atributu source kontextu v události. Zdroje se mapují na kanály a když událost přichází se zdrojem, například hodnota "A", že událost je směrována do tématu partnera přidruženého k kanálu, který ve zdrojové vlastnosti obsahuje "A".
Můžete chtít deklarovat typy událostí směrované do kanálu a do přidruženého partnerského tématu. Typy událostí se zákazníkům zobrazují při vytváření odběrů událostí v tématu partnera a slouží k výběru konkrétních typů událostí, které se mají odeslat do cíle obslužné rutiny události. Další informace.

Důležité

Typy událostí je možné spravovat v kanálu a po aktualizaci hodnot se změny projeví okamžitě v přidruženém tématu partnera.

Obor názvů partnera

Obor názvů partnera je regionální prostředek, který má koncový bod pro publikování událostí do služby Azure Event Grid. Obory názvů partnerů obsahují kanály nebo kanály událostí (starší verze prostředku). V oblastech, kde zákazníci požadují témata nebo cíle partnera, musíte vytvořit obory názvů partnerů, protože kanály a jejich odpovídající partnerské prostředky se musí nacházet ve stejné oblasti. V dané oblasti nemůžete mít kanál se souvisejícím tématem partnera, například v jiné oblasti.

Partnerské obory názvů obsahují kanály nebo kanály událostí. Určuje režim směrování tématu partnera pro vlastnost v oboru názvů. Pokud je záhlaví názvu kanálu nastavené, jsou kanály jediným typem prostředku, který lze vytvořit v rámci oboru názvů. Pokud je režim směrování témat partnera nastavený na atribut Zdroj v události, může obor názvů obsahovat pouze kanály událostí. Mějte na paměti, že rozhodnutí o nastavení práva partner topic routing mode není rozhodnutí mezi výběrem názvu kanálu nebo směrováním na základě zdroje. Oba kanály podporují. Je to spíše rozhodnutí mezi použitím nového typu prostředku směrování, kanálů a použití staršího prostředku, kanálů událostí.

Kanál události

Kanál událostí je prostředek, který byl poprvé vydán s partnerskými událostmi pro směrování příchozích událostí do témat partnera. Kanály událostí podporují pouze směrování založené na zdroji a vždy představují téma partnera zákazníka.

Důležité

Kanály událostí jsou zastaralé. Proto se doporučuje používat kanály.

Ověření partneři

Ověřený partner je partnerová organizace, jejíž identita byla ověřena Microsoftem. Důrazně doporučujeme, aby se vaše organizace ověřila. Zákazníci se snaží spojit s partnery, kteří byli ověřeni, jako je takové ověření, poskytuje větší záruky, že pracují s legitimní organizací. Po ověření získáte výhodu přítomnosti v galerii Event Gridu, kde zákazníci můžou vaši službu snadno objevit a mít prostředí první strany při přihlášení k odběru událostí, například.

Autorizace zákazníka k vytváření témat partnerů

Zákazníci vás opravňují k vytváření témat partnerů ve svém předplatném Azure. Autorizace se uděluje pro danou skupinu prostředků v předplatném Azure zákazníka a je vázaná na čas. Kanál musíte vytvořit před datem vypršení platnosti nastaveným zákazníkem. Měli byste mít dokumentaci s návrhem odpovídajícího časového intervalu pro konfiguraci systému pro odesílání nebo přijímání událostí a vytvoření kanálu před vypršením platnosti autorizace. Pokud se pokusíte vytvořit kanál bez autorizace nebo po vypršení jeho platnosti, vytvoření kanálu selže a v předplatném Azure zákazníka se nevytvoří žádný prostředek.

Poznámka:

Služba Event Grid začala vynucovat kontroly autorizace a vytvářet partnerovi témata kolem 30. června 2022. Než vytvoříte kanál, měli byste zákazníky požádat, aby vám udělili autorizaci jako předpoklad.

Důležité

Ověřený partner není autorizovaným partnerem. I když společnost Microsoft ověřila partnera, musíte být ještě před vytvořením partnerského tématu v předplatném Azure zákazníka autorizovaná.

Aktivace tématu partnera

Zákazník aktivuje téma partnera nebo cíl, který jste pro ně vytvořili. V tomto okamžiku se stav aktivace kanálu změní na Aktivované. Po aktivaci kanálu můžete začít publikovat události do koncového bodu oboru názvů partnera, který kanál obsahuje.

Jak proces automatizujete, abyste věděli, kdy můžete zahájit publikování událostí pro dané téma partnera?

K dispozici jsou dvě možnosti:

Přečtěte si (dotaz) stav kanálu pravidelně, abyste zkontrolovali, jestli se stav aktivace přešel z funkce NeverActivated na Aktivované. Tato operace může být výpočetně náročná.
Vytvořte odběr události pro předplatné Azure nebo skupinu prostředků, která obsahuje kanály, které chcete monitorovat. Události obdržíte Microsoft.Resources.ResourceWriteSuccess při každé aktualizaci kanálu. Pak budete muset přečíst stav kanálu pomocí ID Azure Resource Manageru zadaného v události, abyste zjistili, že aktualizace souvisí se změnou stavu aktivace na Aktivované.

Sdílet prostřednictvím