Получение маркера Microsoft Entra и его использование для отправки событий в концентратор событий

Общие сведения о получении маркера Microsoft Entra см. в статье Проверка подлинности из приложения.

В этой статье приведен пример получения маркера Microsoft Entra, который можно использовать для отправки событий в пространство имен Центров событий и их получения из нее. Для тестирования используется средство Postman .

Предварительные требования

• Следуйте инструкциям из краткого руководства. Использование портал Azure для создания концентратора событий в Azure для создания пространства имен Центров событий и концентратора событий в пространстве имен.
• Скачайте и установите классическое приложение Postman .

Регистрация приложения с помощью Microsoft Entra ID

Сначала необходимо зарегистрировать приложение в клиенте Microsoft Entra и записать значения идентификатора клиента, идентификатора клиента и секрета клиента. Эти значения используются последними при тестировании REST API с помощью средства Postman.

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

2. В строке поиска найдите Microsoft Entra ID и выберите его из раскрывающегося списка.

3. На странице Microsoft Entra ID выберите ссылку Регистрация приложений в меню слева, а затем выберите + Новая регистрация на панели инструментов.

   

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

   

5. На домашней странице приложения запишите значения Идентификатор приложения (клиента) и Идентификатор каталога (клиента). Эти значения используются для получения маркера из Microsoft Entra ID.

   

6. Теперь выберите Сертификаты & секреты в меню слева и выберите + Новый секрет клиента.

   

7. Введите описание, выберите , когда истечет срок действия секрета, и нажмите кнопку Добавить.

   

8. Нажмите кнопку копирования рядом со значением секрета в списке Секреты клиента , чтобы скопировать значение в буфер обмена. Вставьте его где-нибудь. Позже вы используете его для получения маркера из Microsoft Entra ID.

   

Добавление приложения в роль отправителя данных Центров событий

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

1. На странице Пространство имен Центров событий выберите Управление доступом в меню слева, а затем выберите Добавить на плитке Добавление назначения ролей .

   

2. На странице Добавление назначения ролей выберите Центры событий Azure Data Sender (Отправитель данных) для параметра Роль, а затем выберите приложение (в этом примере ServiceBusRestClientApp) для субъекта-службы.

   

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

Получение маркера Microsoft Entra с помощью Postman

1. Запустите Postman.

2. Для метода выберите GET.

3. В поле URI введите https://login.microsoftonline.com/<TENANT ID>/oauth2/token. Замените <TENANT ID> значением идентификатора клиента, скопированным ранее.

4. На вкладке Заголовки добавьте ключ Content-Type и application/x-www-form-urlencoded для значения .

   

5. Перейдите на вкладку Текст и добавьте следующие ключи и значения.

   1. Выберите form-data.

   2. Добавьте grant_type ключ и введите client_credentials значение .

   3. Добавьте client_id ключ и вставьте значение идентификатора клиента , записанное ранее.

   4. Добавьте client_secret ключ и вставьте значение секрета клиента , которое вы записали ранее.

   5. Добавьте resource ключ и введите https://eventhubs.azure.net значение .

      

6. Выберите Отправить , чтобы отправить запрос на получение маркера. Вы увидите маркер в результате. Сохраните маркер (за исключением двойных кавычек). Вы используете его позже.

   

Отправка события в концентратор событий

1. В Postman откройте новую вкладку.

2. Выберите POST для метода.

3. Введите URI в следующем формате: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Замените <EVENT HUBS NAMESPACE NAME> именем пространства имен Центров событий. Замените <QUEUE NAME> именем очереди.

4. На вкладке Заголовки добавьте следующие два заголовка.

   1. Добавьте Authorization ключ и значение для него в следующем формате: Bearer <TOKEN from Microsoft Entra ID>. При копировании или вставе маркера не копируйте вложенные двойные кавычки.

   2. Добавьте Content-Type ключ и application/atom+xml;type=entry;charset=utf-8 в качестве значения для него.

      

5. На вкладке Текст выберите необработанный для типа данных и введите This is a message или любое сообщение для текста.

   

6. Выберите Отправить , чтобы отправить сообщение в очередь. Вы увидите состояние как Created с кодом 201, как показано на следующем рисунке.

   

7. На странице пространства имен в портал Azure можно увидеть, что сообщения отправляются в очередь.

   

См. также:

См. следующие статьи:

• Аутентификация из приложения
• Поток кода авторизации OAuth 2.0 и платформа удостоверений Майкрософт