Omówienie zdarzeń partnerów dla partnerów — Azure Event Grid

Artykuł
10/18/2023

Zdarzenia partnerów usługi Event Grid umożliwiają klientom subskrybowanie zdarzeń pochodzących z zarejestrowanego systemu przy użyciu tego samego mechanizmu, który byłby używany dla dowolnego innego źródła zdarzeń na platformie Azure, takiego jak usługa platformy Azure. Te zarejestrowane systemy integrują się z usługą Event Grid są nazywane "partnerami". Ta funkcja umożliwia również klientom wysyłanie zdarzeń do systemów partnerskich, które obsługują odbieranie i kierowanie zdarzeń do rozwiązań/punktów końcowych klienta na swojej platformie. Zazwyczaj partnerzy są dostawcami oprogramowania jako usługi (SaaS) lub ERP , ale mogą to być platformy firmowe, które chcą udostępnić swoje wydarzenia zespołom wewnętrznym. Celowo integrują się z usługą Event Grid, aby zrealizować kompleksowe przypadki użycia klientów, które kończą się na platformie Azure (klienci subskrybują zdarzenia wysyłane przez partnera) lub kończą się w systemie partnerskim (klienci subskrybują zdarzenia firmy Microsoft wysyłane przez usługę Azure Event Grid). Klienci bankowi w usłudze Azure Event Grid wysyłanie zdarzeń publikowanych przez partnera do obsługiwanych miejsc docelowych, takich jak elementy webhook, Azure Functions, Azure Event Hubs lub Azure Service Bus, aby wymienić kilka. Klienci korzystają również z usługi Azure Event Grid w celu kierowania zdarzeń pochodzących z usługi firmy Microsoft, takich jak Outlook, Teams lub Microsoft Entra ID, dzięki czemu rozwiązania klienta mogą reagować na nie. Dzięki zdarzeniu partnerskim klienci mogą tworzyć rozwiązania oparte na zdarzeniach na różnych platformach i granicach sieci, aby niezawodnie, bezpiecznie i bezpiecznie odbierać zdarzenia lub wysyłać je na dużą skalę.

Uwaga

Jest to artykuł koncepcyjny, który jest wymagany przed podjęciem decyzji o dołączeniu jako partnera do usługi Azure Event Grid. Aby uzyskać instrukcje krok po kroku dotyczące dołączania jako partnera usługi Event Grid przy użyciu witryny Azure Portal, zobacz Jak dołączyć jako partner usługi Event Grid (Azure Portal).

Zdarzenia partnerów: jak to działa

Jako partner utworzysz zasoby usługi Event Grid, które umożliwiają publikowanie zdarzeń w usłudze Azure Event Grid, aby klienci na platformie Azure mogli je subskrybować. W przypadku większości partnerów, na przykład dostawców SaaS, jest to jedyna możliwość integracji, której będą używać.

Możesz również utworzyć zasoby usługi Event Grid w celu odbierania zdarzeń z usługi Azure Event Grid. Ten przypadek użycia dotyczy organizacji, które są właścicielami platformy lub zarządzają nią, co umożliwia klientom odbieranie zdarzeń przez uwidacznianie punktów końcowych. Niektóre z tych organizacji to systemy ERP, które mają również możliwości routingu zdarzeń na swojej platformie, które wysyła przychodzące zdarzenia platformy Azure do aplikacji klienta hostowanej na swojej platformie.

W przypadku zdarzeń publikowania lub odbierania zdarzeń należy utworzyć ten sam rodzaj zasobów usługi Event Grid, wykonując te ogólne kroki.

Skontaktuj się z zespołem usługi Event Grid, askgrid@microsoft.com komunikując się z twoim zainteresowaniem zostaniem partnerem. Po skontaktowaniu się z nami przeprowadzimy Cię przez proces dołączania i pomożemy Twojej usłudze uzyskać kartę wprowadzania w galerii usługi Azure Event Grid, aby można było znaleźć twoją usługę w witrynie Azure Portal.
Utwórz rejestrację partnera. Jest to zasób globalny i zwykle trzeba go utworzyć raz.
Utwórz przestrzeń nazw partnera. Ten zasób uwidacznia punkt końcowy, do którego można publikować zdarzenia na platformie Azure. Podczas tworzenia przestrzeni nazw partnera podaj utworzoną rejestrację partnera.
Klient autoryzuje Cię do tworzenia tematu partnera w subskrypcji platformy Azure klienta.
Klient uzyskuje dostęp do strony internetowej lub wykonuje polecenie, definiujesz środowisko użytkownika, aby zażądać przepływu zdarzeń na platformę Azure lub możliwość odbierania zdarzeń firmy Microsoft do systemu. W odpowiedzi na to żądanie skonfigurujesz system, aby to zrobił przy użyciu danych wejściowych od klienta. Na przykład klient może mieć możliwość wybrania niektórych zdarzeń z systemu, które powinny być przekazywane do platformy Azure.
Utwórz temat partnera w subskrypcji i grupie zasobów platformy Azure klienta przy użyciu kanałów. Kanały to zasoby zawarte w przestrzeniach nazw partnerów.
Klient aktywuje temat partnera utworzony w ramach subskrypcji platformy Azure i grupy zasobów.
Rozpocznij publikowanie zdarzeń w przestrzeni nazw partnera.

Uwaga

Musisz zarejestrować dostawcę zasobów usługi Azure Event Grid w każdej subskrypcji platformy Azure, w której chcesz utworzyć zasoby usługi Event Grid. W przeciwnym razie operacje tworzenia zasobów zakończy się niepowodzeniem.

Dlaczego należy używać zdarzeń partnerów?

Jeśli masz co najmniej jedną z następujących wymagań, możesz użyć funkcji Zdarzenia partnerskie.

Dla partnerów jako wydawców zdarzeń

Chcesz, aby mechanizm udostępniał zdarzenia klientom na platformie Azure. Użytkownicy mogą filtrować i kierować te zdarzenia przy użyciu tematów partnerów i subskrypcji zdarzeń, które posiadają i zarządzają. Można użyć innych metod integracji, takich jak tematy i domeny. Jednak te podejścia nie pozwalają na czyste rozdzielenie własności zasobów, zarządzania i rozliczeń między Tobą a klientem. Funkcja Zdarzenia partnerskie udostępnia również bardziej intuicyjne środowisko użytkownika, które ułatwia odnajdywanie usługi.
Potrzebujesz prostego modelu wielodostępnego, w którym można publikować zdarzenia w jednym regionalnym punkcie końcowym, punkcie końcowym przestrzeni nazw, aby kierować zdarzenia do różnych klientów.
Chcesz mieć wgląd w metryki związane z opublikowanymi zdarzeniami.
Chcesz użyć schematu usługi Cloud Events 1.0 dla zdarzeń.

Dla partnerów jako subskrybenta

Chcesz, aby twoja usługa reagowała na zdarzenia klientów pochodzące z platformy Microsoft Azure.
Chcesz, aby klient reagował na zdarzenia usługi platformy Microsoft Azure przy użyciu aplikacji hostowanych przez twoją platformę. Używasz możliwości routingu zdarzeń platformy do dostarczania zdarzeń do odpowiedniego rozwiązania klienta.
Potrzebujesz prostego modelu, w którym klienci po prostu wybierają nazwę usługi jako miejsce docelowe bez konieczności znajomości szczegółów technicznych, takich jak punkty końcowe platformy.
System/platforma obsługuje schemat Cloud Events 1.0 .

Zasoby zarządzane przez partnerów

Jako partner zarządzasz następującymi typami zasobów.

Rejestracja partnera

Rejestracja zawiera ogólne informacje dotyczące partnera. Rejestracja jest wymagana podczas tworzenia przestrzeni nazw partnera. Oznacza to, że musisz mieć rejestrację partnera, aby utworzyć niezbędne zasoby platformy Azure do integracji z usługą Azure Event Grid.

Rejestracje są globalne. Oznacza to, że nie są one skojarzone z określonym regionem świadczenia usługi Azure. Możesz utworzyć rejestrację jednego partnera i użyć jej podczas tworzenia przestrzeni nazw partnera.

Kanał

Kanał to zagnieżdżony zasób do przestrzeni nazw partnera. Kanał ma dwa główne cele:

Jest to typ zasobu, który umożliwia tworzenie zasobów partnerskich w ramach subskrypcji platformy Azure klienta. Podczas tworzenia kanału typu partner topictemat partnera jest tworzony w ramach subskrypcji platformy Azure klienta. Temat partnera to zasób klienta, do którego są kierowane zdarzenia, gdy system partnerski publikuje zdarzenia.

Kanał ma ten sam cykl życia co skojarzony z nim temat lub miejsce docelowe partnera klienta. Po usunięciu kanału typu partner topic , na przykład skojarzony temat partnera klienta zostanie usunięty. Podobnie, jeśli temat partnera zostanie usunięty przez klienta, skojarzony kanał w subskrypcji platformy Azure zostanie usunięty.
Jest to zasób używany do kierowania zdarzeń. Kanał typu partner topic służy do kierowania zdarzeń do tematu partnera klienta. Obsługuje dwa typy trybów routingu.
- Routing nazw kanałów. W przypadku tego rodzaju routingu zdarzenia są publikowane przy użyciu nagłówka http o nazwie aeg-channel-name , w którym podajesz nazwę kanału, do którego mają być kierowane zdarzenia. Ponieważ kanały są reprezentacją tematów partnerów, zdarzenia kierowane do kanału są wyświetlane w temacie parter klienta. Ten rodzaj routingu to nowa funkcja, której nie ma w event channelssystemie , która obsługuje tylko routing oparty na źródle. Routing nazw kanałów umożliwia korzystanie z większej liczby przypadków użycia niż routing oparty na źródle i jest zalecanym trybem routingu do wyboru. Na przykład z routingiem nazwy kanału klient może zażądać zdarzeń, które pochodzą z różnych źródeł zdarzeń, aby wylądować w jednym temacie partnera.
- Routing oparty na źródle. Ta metoda routingu jest oparta na wartości atrybutu source kontekstu w zdarzeniu. Źródła są mapowane na kanały i gdy zdarzenie pochodzi ze źródłem, powiedzmy, wartości "A", że zdarzenie jest kierowane do tematu partnera skojarzonego z kanałem zawierającym "A" we właściwości źródłowej.
Możesz zadeklarować typy zdarzeń, które są kierowane do kanału i do skojarzonego z nim tematu partnera. Typy zdarzeń są wyświetlane klientom podczas tworzenia subskrypcji zdarzeń w temacie partnera i są używane do wybierania określonych typów zdarzeń do wysłania do miejsca docelowego programu obsługi zdarzeń. Dowiedz się więcej.

Ważne

Typy zdarzeń można zarządzać w kanale, a po zaktualizowaniu wartości zmiany zostaną natychmiast odzwierciedlone w skojarzonym temacie partnera.

Przestrzeń nazw partnera

Przestrzeń nazw partnera to zasób regionalny, który ma punkt końcowy do publikowania zdarzeń w usłudze Azure Event Grid. Przestrzenie nazw partnerów zawierają kanały lub kanały zdarzeń (starszy zasób). Należy utworzyć przestrzenie nazw partnerów w regionach, w których klienci żądają tematów partnerów lub miejsc docelowych, ponieważ kanały i odpowiednie zasoby partnera muszą znajdować się w tym samym regionie. Nie można mieć kanału w danym regionie z powiązanym tematem partnera, na przykład znajdującym się w innym regionie.

Przestrzenie nazw partnerów zawierają kanały lub kanały zdarzeń. Jest on określany przez tryb routingu tematu partnera właściwości w przestrzeni nazw. Jeśli jest ustawiona na nagłówek Nazwa kanału, kanały są jedynym typem zasobu, który można utworzyć w przestrzeni nazw. Jeśli tryb routingu tematu partnera jest ustawiony na Atrybut źródłowy w zdarzeniu, przestrzeń nazw może zawierać tylko kanały zdarzeń. Należy pamiętać, że decyzja o ustawieniu prawa partner topic routing mode nie jest decyzją między wybraniem nazwy kanału lub routingu opartego na źródle. Kanały obsługują oba te kanały. Jest to raczej decyzja między użyciem nowego typu zasobu routingu, kanałów, a użyciem starszego zasobu, kanałów zdarzeń.

Kanał zdarzeń

Kanał zdarzeń to zasób, który został wydany po raz pierwszy ze zdarzeniami partnerskimi w celu kierowania zdarzeń przychodzących do tematów partnerów. Kanały zdarzeń obsługują tylko routing oparty na źródle i zawsze reprezentują temat partnera klienta.

Ważne

Kanały zdarzeń są przestarzałe. W związku z tym zaleca się korzystanie z kanałów.

Zweryfikowani partnerzy

Zweryfikowany partner to organizacja partnerska, której tożsamość została zweryfikowana przez firmę Microsoft. Zdecydowanie zachęcamy do zweryfikowania organizacji. Klienci starają się współpracować z partnerami, którzy zostali zweryfikowani w związku z taką weryfikacją, zapewniają większe gwarancje, że mają do czynienia z legalną organizacją. Po zweryfikowaniu możesz skorzystać z obecności w galerii usługi Event Grid, w której klienci mogą łatwo odnajdywać twoją usługę i mieć środowisko pierwszej firmy podczas subskrybowania zdarzeń, na przykład.

Autoryzacja klienta do tworzenia tematów partnerów

Klienci autoryzują Cię do tworzenia tematów partnerskich w ramach subskrypcji platformy Azure. Autoryzacja jest udzielana dla danej grupy zasobów w subskrypcji platformy Azure klienta i jest powiązana czasowo. Musisz utworzyć kanał przed datą wygaśnięcia ustawioną przez klienta. Należy mieć dokumentację sugerującą klientowi odpowiedni przedział czasu na skonfigurowanie systemu do wysyłania lub odbierania zdarzeń oraz tworzenia kanału przed wygaśnięciem autoryzacji. Jeśli spróbujesz utworzyć kanał bez autoryzacji lub po wygaśnięciu, tworzenie kanału zakończy się niepowodzeniem i nie zostanie utworzony zasób w subskrypcji platformy Azure klienta.

Uwaga

Usługa Event Grid rozpoczęła wymuszanie kontroli autoryzacji w celu utworzenia tematów partnerów około 30 czerwca 2022 r. Dokumentacja powinna poprosić klientów o udzielenie autoryzacji jako wymaganie wstępne przed utworzeniem kanału.

Ważne

Zweryfikowany partner nie jest autoryzowanym partnerem. Nawet jeśli partner został zweryfikowany przez firmę Microsoft, nadal musisz mieć autoryzację, zanim będzie można utworzyć temat partnera w subskrypcji platformy Azure klienta.

Aktywacja tematu partnera

Klient aktywuje dla nich temat lub miejsce docelowe partnera. W tym momencie stan aktywacji kanału zmieni się na Aktywowano. Po aktywowaniu kanału można rozpocząć publikowanie zdarzeń w punkcie końcowym przestrzeni nazw partnera, który zawiera kanał.

Jak zautomatyzować proces, aby wiedzieć, kiedy można rozpocząć publikowanie zdarzeń dla danego tematu partnera?

Dostępne są dwie opcje:

Odczytywanie (sondowania) stanu kanału okresowo w celu sprawdzenia, czy stan aktywacji został przeniesiony z NeverActivated na Aktywowany. Ta operacja może być intensywnie obciążana obliczeniami.
Utwórz subskrypcję zdarzeń dla subskrypcji platformy Azure lub grupy zasobów zawierającej kanały, które chcesz monitorować. Zdarzenia będą odbierane Microsoft.Resources.ResourceWriteSuccess za każdym razem, gdy kanał zostanie zaktualizowany. Następnie należy odczytać stan kanału przy użyciu identyfikatora usługi Azure Resource Manager podanego w zdarzeniu, aby sprawdzić, czy aktualizacja jest powiązana ze zmianą stanu aktywacji na Aktywowano.