Стать партнером Azure Event Grid через портал Azure

В этой статье описывается, как сторонние поставщики SaaS, также известные как партнеры , подключены к Сетке событий, чтобы иметь возможность публиковать события из своих служб и как эти события используются конечными пользователями.

Процесс подключения для партнеров

В кратком примере включение событий службы для использования пользователями обычно включает следующий процесс:

1. Сообщите о своем интересе к тому, чтобы стать партнером в команде службы "Сетка событий".

2. Зарегистрируйте поставщика ресурсов Сетки событий в подписке Azure.

3. Создайте регистрацию партнера.

4. Создайте пространство имен.

5. Создайте канал и тему партнера в одном шаге.

   Это важно

   Вы можете создать канал событий (в старой версии), который поддерживает темы партнеров. Канал — это новый тип ресурса маршрутизации и является предпочтительным вариантом, который поддерживает отправку событий с помощью разделов партнеров. Канал событий является устаревшим ресурсом и скоро будет удалён.

6. Проверьте функциональность событий партнёров от начала до конца.

Для шага 5 необходимо решить, какой тип взаимодействия с пользователем требуется предоставить. Вам доступны следующие варианты:

• Предоставьте собственное решение, обычно веб-графический интерфейс пользователя (GUI), размещённое в вашем домене с помощью нашего пакета SDK и/или REST API для создания канала (новейшего и рекомендуемого типа) / канала событий (устаревшего типа) и соответствующей партнерской темы. С помощью этого параметра можно попросить пользователя о подписке и группе ресурсов, в которой вы создадите раздел партнера.
• Используйте портал Azure или CLI для создания канала (рекомендуется)/канала событий (устаревшая версия) и связанного партнерского раздела. Чтобы воспользоваться этой опцией, необходимо каким-то образом получить доступ к подписке Azure пользователя и группе ресурсов, в которой вы создадите раздел партнера.

В этой статье показано, как стать партнером Azure Event Grid с помощью портала Azure.

Сообщите о вашем интересе к тому, чтобы стать партнером

Обратитесь в команду Event Grid по адресу [email protected], чтобы сообщить о вашем интересе в том, чтобы стать партнером. Мы будем иметь беседу с вами, предоставляя подробные сведения об вариантах использования событий партнеров, лицах, процессе подключения, функциональных возможностях, ценах и т. д.

Предпосылки

Чтобы выполнить оставшиеся действия, убедитесь, что у вас есть:

• Подписка Azure. Если у вас его нет, создайте бесплатную учетную запись перед началом.
• Клиент Azure.

Регистрация поставщика ресурсов Сетки событий

Если вы не пользовались сеткой событий раньше, потребуется зарегистрировать поставщика ресурсов сетки событий. Если вы использовали сетку событий раньше, переходите к следующему разделу.

На портале Azure сделайте следующее:

1. В меню слева выберите Подписки.

2. Выберите подписку, которую вы хотите использовать для службы "Сетка событий", из списка подписок.

3. На странице Подписка выберите Поставщики ресурсов в разделе Параметры в меню слева.

4. Найдите Microsoft.EventGrid и убедитесь, что состояние не зарегистрировано.

5. Выберите Microsoft.EventGrid в списке поставщиков.

6. Выберите Зарегистрировать на панели команд.

   

7. Обновите страницу, чтобы убедиться, что состояние Microsoft.EventGrid изменено на Зарегистрировано.

   

Создание регистрации партнера

1. Войдите на портал Azure.

2. Выберите все службы в области навигации слева, а затем введите в строку поиска регистрацию партнеров сетки событий и выберите ее.

3. На странице регистрации партнеров сетки событий нажмите кнопку +Создать на панели команд или создайте ссылку регистрации партнеров сетки событий на странице.

   

4. На странице "Создание регистраций типов тем партнеров - Основы" введите следующие сведения:

   1. В разделе сведений о проекте выполните следующие действия.
      1. Выберите подписку Azure.
      2. Выберите существующую группу ресурсов Azure или создайте новую группу ресурсов.
   2. В разделе сведений о регистрации выполните следующие действия.
      1. В поле "Регистрация" введите имя регистрации.
      2. В поле "Имя организации" введите имя вашей организации.
   3. В разделе "Тип ресурса партнера" введите сведения о типе ресурса, который будет отображаться на странице создания раздела партнера :

      1. В поле "Имя типа ресурса партнера" введите имя типа ресурса.

      2. В поле Отображаемое имя введите понятное отображаемое имя для типа раздела партнера (ресурса).

      3. Введите описание типа ресурса.

      4. Введите описание сценария. Он должен объяснить способы или сценарии, для которых можно использовать темы партнеров для ваших информационных ресурсов.

         

5. Нажмите кнопку Далее: настраиваемая служба в нижней части страницы. На вкладке "Служба клиентов" на странице "Создание регистрации партнеров " введите сведения о том, что пользователи подписчика будут использовать для связи с вами при возникновении проблемы с источником событий:

   1. Введите номер телефона.

   2. Введите расширение для номера телефона.

   3. Введите URL-адрес веб-сайта поддержки.

      

6. Нажмите кнопку "Далее": теги в нижней части страницы.

7. На странице "Теги" настройте следующие значения.

   1. Введите имя и значение тега, который вы хотите добавить. Этот шаг является необязательным.
   2. Выберите "Проверка и создание" в нижней части страницы, чтобы создать регистрацию (тип темы партнера).

8. На странице "Проверка и создание" просмотрите все параметры и нажмите кнопку "Создать ", чтобы создать регистрацию партнера.

Создайте пространство имен партнера

1. На портале Azure выберите Все службы в меню навигации слева, затем введите партнёрские пространства имен Event Grid в строке поиска и выберите его из списка.

2. На странице Event Grid Partner Namespaces нажмите + Создать на панели инструментов.

   

3. На странице "Создание пространства имен партнеров — основы" укажите следующие сведения.

   1. В разделе сведений о проекте сделайте следующее:

      1. Выберите подписку Azure.
      2. Выберите существующую группу ресурсов или создайте группу ресурсов.

   2. В разделе сведений о пространстве имен выполните следующие действия.

      1. Введите имя для пространства имен.

      2. Выберите расположение пространства имен.

      3. В режиме маршрутизации разделов партнеров выберите заголовок имени канала или атрибут Source в событии.

         • Маршрутизация с использованием заголовка канала: При такой маршрутизации события публикуются с помощью HTTP-заголовка, называемого aeg-channel-name, в котором указывается имя канала, к которому должны направляться события. Если выбрать этот параметр, вы создадите каналы в пространстве имен.
         • Исходный атрибут в маршрутизации событий. Этот подход к маршрутизации основан на значении атрибута контекста source в событии. Если выбрать этот параметр, вы создадите каналы событий, которые являются эквивалентом каналов и вскоре будут сняты с использования.

         Это важно

         • Невозможно обновить режим маршрутизации после создания пространства имен.
         • Канал — это новый тип ресурса маршрутизации и является предпочтительным вариантом. Канал событий является устаревшим ресурсом и скоро будет выведен из использования.

   3. В разделе сведений о регистрации выполните следующие действия, чтобы связать пространство имен с регистрацией партнера.

      1. Выберите подписку , в которой существует регистрация партнера.
      2. Выберите группу ресурсов , содержащую регистрацию партнера.
      3. Выберите регистрацию партнера в раскрывающемся списке.

   4. Нажмите кнопку "Далее": теги в нижней части страницы.

      

4. На странице "Теги" добавьте теги (необязательно).

   1. Введите имя и значение тега, который вы хотите добавить. Этот шаг является необязательным.
   2. В нижней части страницы выберите Проверить и создать.

5. На странице "Рецензирование и создание " просмотрите сведения и нажмите кнопку "Создать".

Создание канала

Если вы выбрали заголовок имени канала для режима маршрутизации разделов партнера, создайте канал, выполнив действия, описанные в этом разделе.

1. Перейдите на страницу обзора созданного пространства имен партнера и выберите +Channel на панели команд.

   

2. На странице "Создание канала " Основные сведения" выполните следующие действия.

   1. Введите имя канала. Имя канала должно быть уникальным в регионе, в котором создается.

   2. Для типа канала выберите Тема партнера.

      Темы партнеров — это ресурсы для хранения опубликованных событий. Выберите раздел партнера , если вы хотите перенаправить события в партнерский раздел , содержащий события, которые будут обрабатываться обработчиком позже.

   3. Если вы выбрали Тема партнера, введите следующие сведения:

      1. Идентификатор подписки , в которой будет создан раздел партнера.

      2. Группа ресурсов , в которой будет создана тема партнера.

      3. Имя темы партнера.

      4. Укажите исходные сведения для раздела партнера. Источник — это контекстная информация о источнике событий, предоставленном партнером, который может видеть конечный пользователь. Эта информация полезна, если конечный пользователь рассматривает возможность активации партнерского раздела, например.

         

      5. Выберите "Добавить определения типов событий ", чтобы объявить тип событий, отправляемых каналу и связанному с ним разделу партнера. Типы событий отображаются пользователям при создании подписок на события в тематике партнера и используются для выбора конкретных типов событий для отправки в пункт назначения обработчика событий.

         

         

         

   4. Нажмите кнопку "Далее": ссылка "Дополнительные функции " в нижней части страницы.

   5. На странице "Дополнительные функции" выполните следующие действия.

      1. Чтобы задать собственное сообщение активации, которое может помочь пользователю активировать связанный раздел партнера, установите флажок рядом с параметром "Задать собственное сообщение активации" и введите сообщение.
      2. Для времени истечения срока действия установите время после создания этого канала, когда связанные раздел партнера и этот канал будут автоматически удалены, если они не активированы конечным пользователем. 1.Нажмите кнопку "Далее": просмотр и создание.

      

   6. На странице "Просмотр и создание" просмотрите все параметры канала и выберите "Создать " в нижней части страницы.

      Параметр раздела партнера:

Управление каналом

Если вы создали канал, вам может потребоваться обновить конфигурацию после создания ресурса.

1. Перейдите к конфигурации канала. Вы можете обновить сообщение о включении темы партнера, срок его действия, если не активирован, а также определения типов событий.

   

Создание канала событий

Если вы выбрали атрибут Source в событии длярежима маршрутизации разделов партнеров, создайте канал событий, выполнив действия в этом разделе.

1. Перейдите на страницу обзора созданного пространства имен.

   partner-namespace-overview.png

2. Выберите +Канал событий на панели инструментов.

3. На странице "Создание канала событий " Основные сведения" укажите следующие сведения.

   1. В разделе сведений о канале выполните следующие действия.

      1. В поле "Имя канала событий" введите имя канала событий.
      2. Введите источник. См. спецификации Cloud Events 1.0, чтобы составить представление о подходящем значении для источника. Кроме того, см. этот пример схемы облачных событий.

   2. В разделе Сведения о назначении введите данные для целевой партнерской темы, которая будет создана для этого канала событий.

      1. Введите идентификатор подписки , в которой будет создан раздел партнера.
      2. Введите имя группы ресурсов , в которой будет создан ресурс раздела партнера.
      3. Введите имя для раздела партнера.

   3. Нажмите кнопку "Далее": фильтры в нижней части страницы.

      

4. На странице "Фильтры" добавьте фильтры. выполните следующие действия:

   1. Фильтрация по атрибутам каждого события. Доставляются только события, соответствующие всем фильтрам. Можно указать до 25 фильтров. Сравнения являются нечувствительными к регистру. Допустимые ключи, используемые для фильтров, зависят от схемы событий. В следующем примере , eventid, sourceeventtypeи eventtypeversioin может использоваться для ключей. Пользовательские свойства можно также использовать внутри содержимого данных с помощью . оператора вложения. Пример: data, data.key, data.key1.key2.

   2. Нажмите кнопку Далее: Дополнительные функции в нижней части страницы.

      

5. На странице "Дополнительные функции" можно задать время окончания срока действия и описание для раздела партнера.

   1. Срок действия — это время, в течение которого тема и связанный канал событий будут автоматически удалены, если клиент не активируется. По умолчанию используется семь дней, если время не указано. Установите флажок, чтобы указать собственное время окончания срока действия.

   2. Так как этот раздел является ресурсом, который не создан пользователем, описание может помочь пользователю с пониманием характера этого раздела. Универсальное описание будет предоставлено, если никакое описание не задано. Установите флажок, чтобы задать своё описание темы партнера.

   3. Нажмите кнопку "Далее": проверка и создание.

      

6. В разделе "Проверка и создание" просмотрите параметры и нажмите кнопку "Создать ", чтобы создать канал событий.

Активация разделов партнеров

Прежде чем пользователи смогут подписаться на разделы партнеров, создаваемые в подписках Azure, сначала они будут активировать разделы партнеров. Дополнительные сведения см. в разделе "Активация партнерского раздела".

Дальнейшие шаги

Дополнительные сведения о функциях событий партнеров см. в следующих статьях:

• Обзор событий партнеров для клиентов
• Обзор событий партнеров для партнеров
• Подписка на события партнеров
• Подписка на события Auth0