Подключение в качестве партнера Сетки событий Azure с использованием портала Azure

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

Важно!

Партнеры могут публиковать события в Сетке событий Azure, а также получать события от нее. Эти возможности включены с помощью функции События партнеров. Если вы не знакомы с событиями партнеров, см. раздел Общие сведения о событиях партнеров, который содержит подробное введение в основные понятия, важнейшие для понимания и выполнения действий, описанных в данной статье.

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

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

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

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

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

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

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

   Важно!

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

6. Всесторонне протестируйте функционирование событий партнеров.

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

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

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

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

Обратитесь в группу "Сетка событий" через askgrid@microsoft.com и сообщите о своем желании стать партнером. В ходе обсуждения с вами мы предоставим подробную информацию о вариантах использования Событий партнеров, об их участниках, процессе регистрации, функциональности, ценах и других аспектах.

Необходимые компоненты

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

• Подписка Azure. Если у вас еще нет подписки 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 выберите Все устройства в левом меню навигации, затем наберите Партнерские пространства имен Сетки событий в панели поиска и выберите отобразившийся пункт.

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

   

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

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

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

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

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

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

      3. Для Режима маршрутизации раздела партнера выберите Заголовок имени канала или Атрибут источника в событии.

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

         Важно!

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

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

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

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

      

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

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

5. На странице Просмотр и создание проверьте значения и нажмите Создать.

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

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

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

   

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

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

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

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

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

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

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

      3. Имя партнерского раздела.

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

         

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

         

         

         

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

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

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

      

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

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

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

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

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

   

Важно!

Сохраните изменения перед выходом из страницы конфигурации.

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

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

Важно!

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

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

   partner-namespace-overview.png

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

3. На странице Создание канала событий — основные введите следующую информацию.

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

      1. В поле Имя канала событий введите имя канала событий.
      2. Введите источник. Чтобы составить представление о допустимых значениях поля источника, см. статью Спецификации облачных событий версии 1.0. Также см. этот пример схемы облачных событий.

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

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

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

      

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

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

   2. Выберите Далее: дополнительные параметры в нижней части страницы.

      

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

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

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

   3. По завершении выберите Next: Отзыв и создание.

      

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

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

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

Следующие шаги

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

• Общие сведения о функции "События партнеров" для клиентов
• Общие сведения о функции "События партнеров" для партнеров
• Подписка на события партнеров
• Подписка на события Auth0