Dołączanie jako partnera usługi Azure Event Grid przy użyciu witryny Azure Portal

W tym artykule opisano sposób, w jaki dostawcy SaaS innych firm, znani również jako partnerzy są dołączani do usługi Event Grid, aby móc publikować zdarzenia z ich usług i jak te zdarzenia są używane przez użytkowników końcowych.

Proces wdrażania partnerów

W skrócie, włączenie zdarzeń usługi do korzystania przez użytkowników zwykle obejmuje następujący proces:

1. Przekaż swoje zainteresowanie zostaniem partnerem zespołu usługi Event Grid.

2. Zarejestruj dostawcę zasobów usługi Event Grid w ramach subskrypcji platformy Azure.

3. Utwórz rejestrację partnera.

4. Utwórz przestrzeń nazw.

5. Utwórz kanał i temat partnera w jednym kroku.

   Ważne

   Możesz być w stanie utworzyć kanał zdarzeń (dziedziczny), który obsługuje tematy partnerskie. Kanał jest nowym typem zasobu routingu i jest preferowaną opcją, która obsługuje wysyłanie zdarzeń za pośrednictwem tematów partnerów. Kanał zdarzeń to zasób przestarzały i wkrótce zostanie wycofany.

6. Przetestuj funkcję zdarzeń partnerskich od początku do końca.

W kroku 5 należy zdecydować, jakiego rodzaju środowisko użytkownika chcesz podać. Dostępne są następujące opcje:

• Zaproponuj własne rozwiązanie, zazwyczaj graficzny interfejs użytkownika (GUI), hostowany w Twojej domenie przy użyciu naszego SDK i/lub REST API w celu utworzenia kanału (najnowszy i zalecany) /kanału zdarzeń (starsza wersja) i odpowiedniego tematu partnera. Za pomocą tej opcji możesz poprosić użytkownika o subskrypcję i grupę zasobów, w ramach której utworzysz temat partnera.
• Użyj witryny Azure Portal lub interfejsu wiersza polecenia, aby utworzyć kanał (zalecany)/kanał zdarzeń (starsza wersja) i skojarzony temat partnera. W przypadku tej opcji musisz w jakiś sposób uzyskać subskrypcję platformy Azure użytkownika i grupę zasobów, w ramach której utworzysz temat partnera.

W tym artykule pokazano, jak dołączyć jako partnera usługi Azure Event Grid przy użyciu witryny Azure Portal.

Wyraź zainteresowanie zostaniem partnerem

Skontaktuj się z zespołem usługi Event Grid, askgrid@microsoft.com informując o swoim zainteresowaniu zostaniem partnerem. Będziemy rozmawiać z Tobą, podając szczegółowe informacje na temat przypadków użycia zdarzeń partnerskich, osób, procesu dołączania, funkcjonalności, cen i innych.

Wymagania wstępne

Aby wykonać pozostałe kroki, upewnij się, że:

• Subskrypcja platformy Azure. Jeśli nie masz subskrypcji, przed rozpoczęciem utwórz bezpłatne konto.
• Dzierżawca platformy Azure.

Rejestrowanie dostawcy zasobów usługi Event Grid

Jeśli usługa Event Grid nie została wcześniej użyta, musisz zarejestrować dostawcę zasobów usługi Event Grid. Jeśli wcześniej użyto usługi Event Grid, przejdź do następnej sekcji.

W witrynie Azure Portal wykonaj następujące czynności:

1. W menu po lewej stronie wybierz pozycję Subskrypcje.

2. Wybierz subskrypcję, której chcesz użyć dla usługi Event Grid z listy subskrypcji.

3. Na stronie Subskrypcja wybierz pozycję Dostawcy zasobów w obszarze Ustawienia w menu po lewej stronie.

4. Wyszukaj ciąg Microsoft.EventGrid i upewnij się, że stan to Niezarejestrowany.

5. Wybierz pozycję Microsoft.EventGrid na liście dostawców.

6. Wybierz pozycję Zarejestruj na pasku poleceń.

   

7. Odśwież, aby upewnić się, że stan microsoft.EventGrid został zmieniony na Zarejestrowany.

   

Tworzenie rejestracji partnera

1. Zaloguj się do witryny Azure Portal.

2. Wybierz pozycję Wszystkie usługi w okienku nawigacji po lewej stronie, a następnie wpisz pozycję Rejestracje partnerów usługi Event Grid na pasku wyszukiwania i wybierz ją.

3. Na stronie Rejestracje partnerów usługi Event Grid wybierz pozycję + Utwórz na pasku poleceń lub link Utwórz rejestracje partnerów usługi Event Grid na stronie.

   

4. Na stronie Tworzenie rejestracji typu tematu partnera — podstawy wprowadź następujące informacje:

   1. W sekcji Szczegóły projektu wykonaj następujące kroki:
      1. Wybierz subskrypcję platformy Azure.
      2. Wybierz istniejącą grupę zasobów platformy Azure lub utwórz nową grupę zasobów.
   2. W sekcji Szczegóły rejestracji wykonaj następujące kroki:
      1. W polu Nazwa rejestracji wprowadź nazwę rejestracji.
      2. W polu Nazwa organizacji wprowadź nazwę organizacji.
   3. W sekcji Typ zasobu partnera wprowadź szczegółowe informacje o typie zasobu, które będą wyświetlane na stronie tworzenia tematu partnera :

      1. W polu Nazwa typu zasobu partnera wprowadź nazwę typu zasobu.

      2. W polu Nazwa wyświetlana wprowadź przyjazną dla użytkownika nazwę wyświetlaną dla typu tematu partnera (zasobu).

      3. Wprowadź opis typu zasobu.

      4. Wprowadź opis scenariusza. Powinno wyjaśniać sposoby lub scenariusze, w których można używać partnerskich tematów dotyczących zasobów.

         

5. Wybierz pozycję Dalej: Usługa niestandardowa w dolnej części strony. Na karcie Obsługa klienta na stronie Tworzenie rejestracji partnera wprowadź informacje, które użytkownicy subskrybentów będą używać do kontaktowania się z Tobą w przypadku wystąpienia problemu ze źródłem zdarzeń:

   1. Wprowadź numer telefonu.

   2. Wprowadź rozszerzenie numeru telefonu.

   3. Wprowadź adres URL witryny internetowej pomocy technicznej.

      

6. Wybierz Następne: Tagi u dołu strony.

7. Na stronie Tagi skonfiguruj następujące wartości.

   1. Wprowadź nazwę i wartość tagu, który chcesz dodać. Ten krok jest opcjonalny.
   2. Wybierz pozycję Sprawdź i utwórz w dolnej części strony, aby utworzyć rejestrację (typ tematu partnerskiego).

8. Na stronie Przeglądanie i tworzenie przejrzyj wszystkie ustawienia, a następnie wybierz pozycję Utwórz , aby utworzyć rejestrację partnera.

Utwórz przestrzeń nazw partnera

1. W witrynie Azure Portal wybierz pozycję Wszystkie usługi z menu nawigacji po lewej stronie, a następnie wpisz Pola nazw partnerów usługi Event Grid na pasku wyszukiwania, a następnie wybierz ją z listy.

2. Na stronie Przestrzenie nazw partnerów usługi Event Grid wybierz pozycję + Utwórz na pasku narzędziowym.

   

3. Na stronie Tworzenie przestrzeni nazw partnerów — podstawy podaj następujące informacje.

   1. W sekcji Szczegóły projektu wykonaj następujące czynności:

      1. Wybierz subskrypcję platformy Azure.
      2. Wybierz istniejącą grupę zasobów lub utwórz grupę zasobów.

   2. W sekcji Szczegóły przestrzeni nazw wykonaj następujące czynności:

      1. Wprowadź nazwę przestrzeni nazw.

      2. Wybierz lokalizację przestrzeni nazw.

      3. W Trybie routingu tematu partnera wybierz pozycję Nagłówek nazwy kanału lub Źródłowy atrybut w zdarzeniu.

         • Routing nagłówka nazwy kanału: w przypadku tego rodzaju routingu można publikować zdarzenia 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. Jeśli wybierzesz tę opcję, utworzysz kanały w przestrzeni nazw.
         • Atrybut źródłowy w routingu zdarzeń . Ta metoda routingu jest oparta na wartości atrybutu source kontekstu w zdarzeniu. Jeśli wybierzesz tę opcję, utworzysz kanały zdarzeń, które są odpowiednikiem przestarzałych kanałów i wkrótce zostaną wycofane.

         Ważne

         • Nie można zaktualizować trybu routingu po utworzeniu przestrzeni nazw.
         • Kanał jest nowym typem zasobu routingu i jest preferowaną opcją. Kanał zdarzeń jest zasobem starszego typu i wkrótce zostanie wycofany.

   3. W sekcji Szczegóły rejestracji wykonaj następujące kroki, aby skojarzyć przestrzeń nazw z rejestracją partnera.

      1. Wybierz subskrypcję , w której istnieje rejestracja partnera.
      2. Wybierz grupę zasobów zawierającą rejestrację partnera.
      3. Wybierz rejestrację partnera z listy rozwijanej.

   4. Wybierz Następne: Tagi u dołu strony.

      

4. Na stronie Tagi dodaj tagi (opcjonalnie).

   1. Wprowadź nazwę i wartość tagu, który chcesz dodać. Ten krok jest opcjonalny.
   2. Wybierz pozycję Przejrzyj i utwórz w dolnej części strony.

5. Na stronie Przeglądanie + tworzenie przejrzyj szczegóły i wybierz pozycję Utwórz.

Tworzenie kanału

W przypadku wybrania nagłówka nazwy kanału dla trybu routingu tematów partnera, utwórz kanał, postępując zgodnie z krokami opisanymi w tej sekcji.

1. Przejdź do strony Przegląd utworzonej przez Ciebie przestrzeni nazw partnera i wybierz opcję + Kanał na pasku poleceń.

   

2. Na stronie Tworzenie kanału — podstawy wykonaj następujące kroki.

   1. Wprowadź nazwę kanału. Nazwa kanału powinna być unikatowa w całym regionie, w którym jest tworzona.

   2. Dla typu kanału wybierz pozycję Temat partnera.

      Tematy partnerskie to zasoby, które zawierają opublikowane zdarzenia. Wybierz pozycję Temat partnera , jeśli chcesz przekazać zdarzenia do tematu partnera , który przechowuje zdarzenia do przetworzenia przez program obsługi później.

   3. W przypadku wybrania tematu partnera wprowadź następujące szczegóły:

      1. Identyfikator subskrypcji , w której zostanie utworzony temat partnera.

      2. Grupa zasobów , w której zostanie utworzony temat partnera.

      3. Nazwa tematu partnera.

      4. Określ informacje o źródle tematu partnera. Źródło to kontekstowe informacje o źródle zdarzeń udostępnianych przez partnera, który może zobaczyć użytkownik końcowy. Te informacje są przydatne, na przykład gdy użytkownik końcowy rozważa aktywację tematu partnerskiego.

         

      5. Wybierz pozycję Dodaj definicje typów zdarzeń , aby zadeklarować rodzaj zdarzeń wysyłanych do kanału i do skojarzonego 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ń.

         

         

         

   4. Wybierz pozycję Dalej: link Dodatkowe funkcje w dolnej części strony.

   5. Na stronie Dodatkowe funkcje wykonaj następujące kroki:

      1. Aby ustawić własny komunikat aktywacji, który może pomóc użytkownikowi końcowemu aktywować skojarzony temat partnera, zaznacz pole wyboru obok pozycji Ustaw własny komunikat aktywacji i wprowadź komunikat.
      2. Dla czasu wygaśnięcia ustaw moment, po upływie którego, od utworzenia tego kanału, skojarzony temat partnera i ten kanał zostaną automatycznie usunięte, jeśli nie zostaną aktywowane przez użytkownika końcowego. 1. Wybierz Dalej: Recenzja i utwórz.

      

   6. Na stronie Przeglądanie i tworzenie przejrzyj wszystkie ustawienia kanału i wybierz pozycję Utwórz w dolnej części strony.

      Opcja tematu partnera:

Zarządzanie kanałem

Jeśli utworzono kanał, być może chcesz zaktualizować konfigurację po utworzeniu zasobu.

1. Przejdź do obszaru Konfiguracja w kanale. Możesz zaktualizować komunikat dotyczący aktywacji tematu partnera, czasu wygaśnięcia, jeśli nie został aktywowany, oraz definicji typów zdarzeń.

   

Tworzenie kanału zdarzeń

W przypadku wybrania atrybutu Źródła w zdarzeniu dla trybu routingu tematyki partnera, utwórz kanał zdarzeń, wykonując kroki opisane w tej sekcji.

1. Przejdź do strony Przegląd utworzonej przestrzeni nazw.

   partner-namespace-overview.png

2. Wybierz + Kanał zdarzeń na pasku narzędzi.

3. Na stronie Tworzenie kanału zdarzeń — podstawy podaj następujące informacje.

   1. W sekcji Szczegóły kanału wykonaj następujące kroki:

      1. W polu Nazwa kanału zdarzeń wprowadź nazwę dla kanału zdarzeń.
      2. Wprowadź źródło. Zobacz Specyfikacje usługi Cloud Events 1.0 , aby uzyskać pomysł na odpowiednią wartość dla źródła. Zobacz również ten przykład schematu zdarzeń w chmurze.

   2. W sekcji Szczegóły miejsca docelowego wprowadź szczegóły dla tematu partnera docelowego, który zostanie utworzony dla tego kanału zdarzeń.

      1. Wprowadź identyfikator subskrypcji, w której zostanie utworzony temat partnerski.
      2. Wprowadź nazwę grupy zasobów , w której zostanie utworzony zasób tematu partnera.
      3. Wprowadź nazwę tematu partnera.

   3. Wybierz pozycję Dalej: filtry w dolnej części strony.

      

4. Na stronie Filtry dodaj filtry. wykonaj poniższe kroki:

   1. Filtruj według atrybutów każdego zdarzenia. Dostarczane są tylko zdarzenia zgodne ze wszystkimi filtrami. Można określić maksymalnie 25 filtrów. Porównania nie rozróżniają wielkości liter. Prawidłowe klucze używane dla filtrów różnią się w zależności od schematu zdarzeń. W poniższym przykładzie eventid, source, eventtype i eventtypeversioin mogą być używane jako klucze. Możesz również użyć właściwości niestandardowych wewnątrz ładunku danych, korzystając z . jako operatora zagnieżdżania. Na przykład: data, , data.keydata.key1.key2.

   2. Wybierz pozycję Dalej: Dodatkowe funkcje w dolnej części strony.

      

5. Na stronie Dodatkowe funkcje można ustawić czas wygaśnięcia i opis tematu partnera.

   1. Czas wygaśnięcia to czas, w którym temat i skojarzony z nim kanał zdarzeń zostaną automatycznie usunięte, jeśli nie zostaną aktywowane przez klienta. Wartość domyślna siedmiu dni jest używana w przypadku, gdy nie podano czasu. Zaznacz pole wyboru, aby określić własny czas wygaśnięcia.

   2. Ponieważ ten temat jest zasobem, który nie jest tworzony przez użytkownika, opis może pomóc użytkownikowi zrozumieć charakter tego tematu. Jeśli żaden z nich nie zostanie ustawiony, zostanie podany ogólny opis. Zaznacz pole wyboru, aby ustawić własny opis tematyki partnera.

   3. Wybierz Dalej: Przejrzyj i utwórz.

      

6. W obszarze Przeglądanie + tworzenie przejrzyj ustawienia i wybierz pozycję Utwórz , aby utworzyć kanał zdarzeń.

Aktywowanie tematów partnerów

Zanim użytkownicy będą mogli subskrybować tematy partnerów utworzone w swoich subskrypcjach platformy Azure, będą najpierw aktywować tematy partnerów. Szczegóły znajdziesz w Aktywowanie tematu partnera.

Dalsze kroki

Zobacz następujące artykuły, aby uzyskać więcej informacji na temat funkcji Zdarzenia partnerskie:

• Omówienie wydarzeń partnerskich dla klientów
• Przegląd wydarzeń partnerskich dla partnerów
• Subskrybuj wydarzenia partnera
• Subskrybuj zdarzenia Auth0