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

Обзор

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

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

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

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

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

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

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

Снимок экрана: добавление назначаемого системой удостоверения на портале

Предоставьте управляемой идентичности роль Центры событий Azure Data sender

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

  2. Перейдите к контроль доступа. выберите Добавить назначение ролей. Снимок экрана предоставления доступа к пространству имен Event Hubs

  3. Выберите роль Центры событий Azure Data Sender на вкладке Role. Затем выберите Next. Снимок экрана: выбор роли отправителя данных Azure EventHubs

  4. На вкладке "Члены" выберите назначение доступа к управляемому удостоверению. Нажмите Select members, чтобы выбрать службу Web PubSub. Затем можно просмотреть и назначить вашу роль. Снимок экрана: выбор удостоверения службы Web PubSub

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

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

  2. Затем на приведенной ниже странице редактирования необходимо настроить имя концентратора и выбрать команду "Добавить ", чтобы добавить прослушиватель событий. Снимок экрана: настройка параметров центра

  3. На странице "Настройка прослушивателя событий" сначала настройте конечную точку концентратора событий. Вы можете выбрать Выбрать Центр событий из вашей подписки, чтобы выбрать его, или напрямую ввести полное имя пространства имён и имя концентратора событий. Затем выберите user и system события, которые вы хотите прослушивать. Наконец, нажмите кнопку "Подтвердить" , когда все готово. Снимок экрана: настройка прослушивателя Центров событий

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

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

  2. Используйте это веб-приложение клиент WebSocket, чтобы генерировать клиентские события. Если вы настроили отправку системного события connected в этот концентратор событий, то после успешного подключения к службе Web PubSub в клиенте-получателе Event Hubs вы сможете увидеть выведенное событие connected. Вы также можете создать событие пользователя с помощью приложения. Снимок экрана с событием подключения, выведенным в клиентском приложении-потребителе Event Hubs. Снимок экрана с областью клиентского приложения WebSocket, используемой для создания пользовательского события.

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

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