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.

Ważne

Partnerzy mogą publikować zdarzenia w usłudze Azure Event Grid, a także odbierać z niego zdarzenia. Te możliwości są włączane za pomocą funkcji Zdarzenia partnerskie. Jeśli nie znasz zdarzeń partnerskich, zobacz Omówienie zdarzeń partnerskich, aby zapoznać się ze szczegółowym wprowadzeniem kluczowych pojęć, które mają kluczowe znaczenie dla zrozumienia i wykonania kroków opisanych w tym artykule.

Proces dołączania dla 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 utworzyć kanał zdarzeń (starsza wersja), 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 starszy zasób i wkrótce zostanie wycofany.

6. Przetestuj funkcje zdarzeń partnerów na końcu.

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

• Podaj własne rozwiązanie, zazwyczaj graficzne środowisko graficznego interfejsu użytkownika (GUI), hostowane w domenie przy użyciu naszego zestawu SDK i/lub interfejsu API REST w celu utworzenia kanału (najnowsze i zalecane) /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.

Komunikowanie się z zainteresowaniem zostaniem partnerem

Skontaktuj się z zespołem usługi Event Grid, askgrid@microsoft.com komunikując się z twoim zainteresowaniem 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 Azure. Jeśli nie masz subskrypcji, przed rozpoczęciem utwórz bezpłatne konto.
• Dzierżawa 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ę w witrynie 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 swoją 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. Powinien on wyjaśnić sposoby lub scenariusze, w których można używać tematów partneró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 Telefon.

   2. Wprowadź rozszerzenie numeru telefonu.

   3. Wprowadź adres URL witryny internetowej pomocy technicznej.

      

6. Wybierz pozycję Dalej: Tagi w dolnej części 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ę Przejrzyj i utwórz w dolnej części strony, aby utworzyć rejestrację (typ tematu partnera).

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

Tworzenie przestrzeni 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ędzi.

   

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ę dla przestrzeni nazw.

      3. W obszarze Tryb routingu tematu partnera wybierz pozycję Nagłówek nazwy kanału lub Atrybut źródłowy 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ą starsze niż kanały 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ń to starszy zasób 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 pozycję Dalej: Tagi w dolnej części 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 tematu partnera utwórz kanał, wykonując kroki opisane w tej sekcji.

1. Przejdź do strony Przegląd utworzonej przestrzeni nazw partnera i wybierz pozycję + 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 przechowują 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, gdy użytkownik końcowy rozważa aktywowanie tematu partnera, na przykład.

         

      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. W przypadku czasu wygaśnięcia ustaw czas po utworzeniu tego kanału, w którym skojarzony temat partnera i ten kanał zostanie automatycznie usunięty, jeśli użytkownik końcowy nie zostanie aktywowany. 1.Wybierz pozycję Dalej: Przejrzyj 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ń.

   

Ważne

Nie zapomnij zapisać zmian przed opuszczeniem strony konfiguracji.

Tworzenie kanału zdarzeń

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

Ważne

• Kanał jest nowym typem zasobu routingu i jest preferowaną opcją.

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

   partner-namespace-overview.png

2. Wybierz pozycję + 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ę 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 partnera.
      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 są uwzględniane 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 dla eventidkluczy można użyć wartości , source, eventtypei eventtypeversioin . Możesz również użyć właściwości niestandardowych wewnątrz ładunku danych, używając . operatora jako operatora zagnieżdżania. Na przykład: data, , data.key1.key2data.key.

   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 klient nie zostanie aktywowany. 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 tematu partnera.

   3. Wybierz pozycję Dalej: Przeglądanie i tworzenie.

      

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. Aby uzyskać szczegółowe informacje, zobacz Aktywowanie tematu partnera.

Następne kroki

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

• Omówienie zdarzeń partnerów dla klientów
• Omówienie zdarzeń partnerów dla partnerów
• Subskrybowanie zdarzeń partnerów
• Subskrybowanie zdarzeń Uwierzytelniania Auth0