Отправка клиентских событий в Центры событий

Примечание.

Функция прослушивателя событий доступна в предварительной версии.

Обзор

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

В этом руководстве показано, как авторизовать службу Web PubSub для подключения к Центрам событий и добавления правила прослушивателя событий в параметры службы.

Служба Web PubSub использует идентификатор Microsoft Entra с управляемым удостоверением для подключения к Центрам событий. Поэтому необходимо включить управляемое удостоверение службы и убедиться, что у него есть соответствующие разрешения для подключения к Центрам событий. Вы можете предоставить встроенную роль отправителя данных Центры событий Azure управляемому удостоверению, чтобы у него было достаточно разрешений.

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

Настройка прослушивателя событий

Добавление управляемого удостоверения в службу Web PubSub

Найдите службу Azure Web PubSub из портал Azure. Перейдите к удостоверению. Чтобы добавить назначаемое системой удостоверение, на вкладке "Назначаемое системой" переключитесь на "Состояние включено". Выберите Сохранить. Дополнительные сведения об управляемых удостоверениях см. в разделе "Управляемые удостоверения" в Azure Web PubSub.

Screenshot of adding a system-assigned identity in the portal

Предоставление управляемого удостоверения Azure Event Hubs Data sender роли

  1. Найдите ресурс Центры событий Azure в портал Azure. Вы можете предоставить роль на уровне пространства имен Центров событий или на уровне сущности. Ниже описано, как выбрать уровень пространства имен.

  2. Перейдите к контроль доступа. Выберите Добавить назначение ролей. Screenshot of granting access to Event Hubs namespace

  3. Выберите роль Центры событий Azure отправителя данных на вкладке "Роль". Затем нажмите кнопку "Далее". Screenshot of selecting Azure EventHubs Data Sender role

  4. На вкладке "Члены" выберите назначение доступа к управляемому удостоверению. Выберите участников , чтобы выбрать службу Web PubSub. Затем можно просмотреть и назначить назначение роли. Screenshot of selecting your Web PubSub service identity

Добавление правила прослушивателя событий в параметры службы

  1. Найдите службу из портал Azure. Выберите Settings (Параметры). Затем нажмите кнопку "Добавить ", чтобы настроить прослушиватель событий. Для существующей конфигурации концентратора выберите ... , на правой стороне перейдите на ту же страницу редактирования. Screenshot of Web PubSub settings

  2. Затем на приведенной ниже странице редактирования необходимо настроить имя концентратора и выбрать команду "Добавить ", чтобы добавить прослушиватель событий. Screenshot of configuring hub settings

  3. На странице "Настройка прослушивателя событий" сначала настройте конечную точку концентратора событий. Вы можете выбрать Центр событий из подписки , чтобы выбрать или напрямую ввести полное пространство имен и имя концентратора событий. Затем выберите user и system события, которые вы хотите прослушивать. Наконец, нажмите кнопку "Подтвердить" , когда все готово. Screenshot of configuring Event Hubs Listener

Тестирование конфигурации с помощью динамической демонстрации

  1. Откройте это веб-приложение клиента-клиента центров событий, введите центры событий строка подключения для подключения к концентратору событий в качестве потребителя. Если вы получаете центры событий строка подключения из ресурса пространства имен Центров событий вместо экземпляра концентратора событий, необходимо указать имя концентратора событий. Этот клиент-потребитель концентратора событий подключен к режиму, который считывает только новые события; События, опубликованные ранее, не видели здесь. Вы можете изменить режим подключения клиента потребителя, чтобы прочитать все доступные события в рабочей среде.

  2. Используйте это веб-приложение клиента WebSocket для создания событий клиента. Если вы настроили отправку системного события в этот концентратор событий, то после успешного подключения к службе Web PubSub вы сможете увидеть печатное connected событие connected в клиенте-получателе Центров событий. Вы также можете создать событие пользователя с помощью приложения. Screenshot of a printed connected event in the Event Hubs consumer client app.Screenshot showing the area of the WebSocket client app to generate a user event.

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

В этой статье вы узнали, как работают прослушиватели событий и как настроить прослушиватель событий с конечной точкой концентратора событий. Чтобы узнать формат данных, отправленный в Центры событий, ознакомьтесь со следующей спецификацией.