Поделиться через

Управление регистрацией приложений и разрешениями API для уведомлений Microsoft Graph (устарело)

  • Статья

Важно!

API уведомлений Microsoft Graph не рекомендуется использовать, Он прекратил возвращать данные в январе 2022 г. Дополнительные сведения об уведомлениях см. в Центрах уведомлений Microsoft Azure. Дополнительные сведения см. в записи блога Прекращение поддержки API уведомлений Microsoft Graph (бета-версия).

Чтобы интегрировать в службу приложений уведомления Microsoft Graph, необходимо зарегистрировать свое приложение с помощью платформы удостоверений Майкрософт для поддержки учетных записей Майкрософт, рабочих или учебных учетных записей и объявить обязательные разрешение API.

Регистрация приложения для поддержки учетных записей Майкрософт, рабочих или учебных учетных записей

Зарегистрируйте приложение на Центр администрирования Microsoft Entra для поддержки учетных записей Майкрософт, рабочих или учебных учетных записей. Если вы ранее зарегистрировали приложение на портале приложений Майкрософт, существующие приложения будут отображаться на странице регистрации приложений.

Сведения о регистрации приложений см. в статье Регистрация приложения с помощью платформы удостоверений Майкрософт. При регистрации приложения обязательно сохраните идентификатор приложения или идентификатор клиента под рукой. Вам потребуется этот идентификатор позднее при регистрации приложения для использования на разных устройствах в Центре партнеров для клиентов Windows, Android и iOS.

Примечание.

Если у вас еще нет учетной записи Майкрософт и вы хотите ее получить, перейдите на страницу учетной записи Майкрософт. Если вы пишете приложение, которое должно использовать Azure AD версии 1.0 в качестве платформы проверки подлинности и удостоверений для рабочих или учебных учетных записей, см. статью Библиотека проверки подлинности Azure Active Directory (ADAL). Если вы хотите узнать о новой конвергентной платформа удостоверений Майкрософт (версия 2.0), см. статью Что такое платформа удостоверений Майкрософт?.

Сертификаты и секреты приложения

Чтобы позволить приложению идентифицировать себя и проходить проверку подлинности при получении маркеров проверки подлинности, можно либо отправить собственный сертификат, либо создать секрет клиента, перейдя в разделе Сертификаты & секреты на странице регистрации приложений Центр администрирования Microsoft Entra.

Снимок экрана: сертификаты и секреты приложений в Центр администрирования Microsoft Entra

Примечание.

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

Разрешения API

Вам потребуется добавить дополнительные разрешения, чтобы использовать уведомления Microsoft Graph. Нажмите кнопку Добавить разрешение и в разделе интерфейсов API Майкрософт выберите Microsoft Graph, а затем щелкните вариант Делегированные разрешения.

Снимок экрана: страница

Добавьте указанные ниже разрешения.

  • User.Read — разрешает вашему приложению выполнять вход пользователя

  • UserActivity.ReadWrite.CreatedByApp — разрешает подписку приложения на получение уведомлений

Снимок экрана: делегированные разрешения для уведомлений в Центр администрирования Microsoft Entra

Дальнейшие действия

Узнайте больше о разрешениях и согласии или просмотрите справочник по разрешениям Microsoft Graph.

Теперь, когда вы зарегистрировали приложение, перейдите в Центр партнеров , чтобы настроить приложение и нацелиться на соответствующие платформы приложений (Windows, iOS или Android) на уведомления, отправляемые через Microsoft Graph. Дополнительные сведения см. в статье Внедрение использования на разных устройствах.

Примечание.

Если вам нужны только конечные веб-точки, можно пропустить регистрацию в Центре партнеров и перейти к настройке отправки уведомлений в службе приложений.