M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions m365con.net

Блог · Mirko Peters

Graph Data Connect и разрешения Microsoft Graph: настройка, согласие, принцип наименьших привилегий

By ·

Что делает Microsoft Graph Data Connect, чем он отличается от Graph API, шаги настройки и утверждения, а также как работают разрешения Graph (делегированные, на уровне приложения, согласие).

Automatically translated with AI from the original post. Read the English original

Microsoft Graph Data Connect и разрешения Microsoft Graph — две отдельные темы, которые часто ищут вместе. Data Connect — это сервис массового извлечения данных для аналитики Microsoft 365. Разрешения Graph определяют, что приложение может делать через Graph API. Оба опираются на согласие и поощряют одну и ту же привычку: запрашивать минимальный доступ, достаточный для задачи.

Ключевые выводы

  • Graph Data Connect массово извлекает данные Microsoft 365 в хранилище Azure для аналитики. Graph API подходит для небольших объёмов данных от выбранных пользователей и групп.
  • Для настройки нужен глобальный администратор, который включит сервис, регистрация приложения в Entra, учётная запись хранилища Azure и одобрение администратором запроса на доступ к данным.
  • Конвейеры имеют накладные расходы около 45 минут, а первый запуск с учётом согласия может занять более 40 минут.
  • Разрешения Graph бывают двух типов. Делегированные разрешения действуют от имени вошедшего пользователя. Разрешения на уровне приложения действуют без пользователя и требуют согласия администратора.
  • Microsoft рекомендует делегированную модель, если она отвечает потребностям приложения, и выбирать минимальное разрешение, которое работает.
  • Имена разрешений следуют шаблону {resource}.{operation}.{constraint}, например Application.ReadWrite.OwnedBy.

Что такое Graph Data Connect

Microsoft описывает Data Connect как безопасный и масштабируемый доступ к наборам данных Microsoft 365 в Microsoft Fabric, Azure Synapse и Azure Data Factory для корпоративной аналитики. Данные поступают из таких источников, как Microsoft Entra ID, Outlook, Teams, SharePoint, Viva Insights и группы Microsoft.

Наборы данных делятся на три группы: базовые (необработанный контент, созданный клиентом), очищенные (нормализованные или без дубликатов) и подготовленные (созданные для конкретного сценария). Список наборов включает, например, TeamsCallRecords_v1, SharePointPermissions_v1, GroupMembers_v0 и PlannerTasks_v0. Наборы данных Viva Insights требуют лицензии Viva Insights; это единственное замечание о лицензировании на странице набора данных.

Data Connect или Graph API

В FAQ Data Connect это сформулировано так: оба варианта обращаются к одним и тем же данным. Data Connect извлекает большие объёмы данных массово по всей организации. Graph API подходит для небольших объёмов данных от выбранных пользователей и групп. В FAQ предлагается комбинировать их, например использовать Data Connect для первоначального извлечения, а Graph API для последующей работы в реальном времени.

Известные ограничения из FAQ:

  • Накладные расходы конвейеров составляют около 45 минут независимо от объёма данных.
  • Пользователи локального Exchange не поддерживаются, включая гибридные конфигурации.
  • Сообщения и события из ресурсных учётных записей не поддерживаются.
  • Доступ к наборам данных между клиентами недоступен. Ресурсы Azure и Microsoft 365 должны находиться в одном клиенте Entra.

Шаги настройки

Краткое руководство описывает следующие шаги. Названия меню приведены так, как их указывает Microsoft.

  1. Включите Data Connect. Войдите на admin.microsoft.com под учетной записью глобального администратора. Выберите Параметры > Параметры организации, затем на вкладке Службы выберите Microsoft Graph Data Connect. Установите флажок, чтобы включить функцию для всей организации, и сохраните изменения.
  2. Создайте приложение в Microsoft Entra. В центре администрирования Microsoft Entra перейдите в App registrations > New registration. Выберите «Accounts in this organizational directory only». Скопируйте идентификатор приложения (клиента) и идентификатор клиента, создайте секрет клиента и сразу сохраните его значение. Владельцу приложения нужен почтовый ящик и, согласно краткому руководству, рабочая подписка E5.
  3. Создайте Azure Storage. Создайте учетную запись хранения в регионе, соответствующем региону вашего Microsoft 365. В разделе Access control (IAM) назначьте приложению роль Storage Blob Data Contributor и создайте закрытый контейнер.
  4. Зарегистрируйте приложение в Data Connect на портале Azure. Выберите место назначения, приложение, а также наборы данных и столбцы.
  5. Одобрите запрос. Администратор открывает Settings > Org settings > Security & privacy > Microsoft Graph Data Connect applications. Приложение отображается со статусом Pre-consent. Проверьте наборы данных и нажмите Approve. В кратком руководстве предупреждается, что самостоятельно одобрить запрос нельзя.
  6. Запустите конвейер в Synapse, Data Factory или Fabric. Статус последовательно меняется: Initializing, Consent Pending, Extracting Data, Persisting Data и Succeeded. Первый запуск может занять более 40 минут.

Поддерживаемые приемники включают Azure Data Lake Storage Gen2, Azure Storage Blob, Azure SQL DB (только для потоков данных сопоставления) и Microsoft Fabric OneLake. Единственным поддерживаемым механизмом аутентификации является аутентификация субъекта-службы.

Согласие и стоимость

Согласие распространяется на объем извлечения: наборы данных, столбцы, пользователей и приемник. Запуск с тем же объемом не требует нового запроса. Оплата производится через подписки Azure за каждый запуск конвейера, при этом дробные единицы округляются вверх. В примере из FAQ 20 запусков по 500 строк каждый оплачиваются как 20 единиц, а не 10. Прочитанные страницы не содержат тарифов.

Разрешения Graph: основы

Для Graph API Microsoft определяет два типа разрешений.

| | Делегированные | Приложения | |---|---|---| | Действуют | От имени вошедшего пользователя | Без пользователя | | Фактический доступ | Ограничен разрешениями приложения и собственными правами пользователя | Любые данные, которые охватывает разрешение | | Кто может дать согласие | Пользователи или администраторы для всех пользователей | Только администратор | | Другие названия | Scopes | App roles |

Для согласия на разрешения приложений требуется роль Privileged Role Administrator или Global Administrator. Согласие пользователя на делегированные разрешения при этом по-прежнему может ограничиваться политиками согласия приложений в клиенте.

Именование и минимальные привилегии

Разрешения следуют шаблону {resource}.{operation}.{constraint}. В примерах страницы используются операции, такие как Read и ReadWrite, и ограничения, такие как All и OwnedBy. Если ограничение не указано, доступ ограничивается данными, принадлежащими вошедшему пользователю. Например, Application.ReadWrite.OwnedBy позволяет управлять только приложениями, которые создало или которыми владеет приложение, тогда как Application.ReadWrite.All управляет всеми приложениями.

Рекомендация Microsoft: предоставляйте минимально необходимое разрешение. Используйте Directory.AccessAsUser.All, Directory.ReadWrite.All и Directory.Read.All с осторожностью и отдавайте предпочтение более узким разрешениям. Согласие для конкретного ресурса позволяет пользователю предоставить доступ к одному экземпляру ресурса, например к команде, а не ко всему клиенту. Эта возможность поддерживается лишь в части функций.

Распространенные проблемы

  • Регистрация агента коннектора завершается ошибкой. В Learn указано, что делегированные разрешения не поддерживаются для регистрации агента коннектора. Запросите приложению разрешения приложения с минимальными привилегиями и предоставьте согласие администратора на уровне всего клиента.
  • Участники показывают только id и @odata.type. У приложения нет разрешения на чтение этого типа участников.
  • Слишком много разрешений у одного приложения. Приложения, у которых аудитория входа включает личные учетные записи Microsoft, могут запросить не более 30 разрешений; для организационных аудиторий лимит составляет до 400.

Чего не говорит документация

В прочитанных страницах Data Connect не описано, как долго действует одобрение, и не приводятся тарифы. Там также не перечислены требования к лицензиям помимо учебной настройки из краткого руководства.

Связанное

Источники

FAQ

В чём разница между Graph Data Connect и Microsoft Graph API?

В FAQ Data Connect на Microsoft Learn сказано, что оба варианта дают доступ к одним и тем же данным, но разными способами. Data Connect предназначен для массового извлечения больших объёмов данных по всей организации, а Graph API подходит для небольших объёмов данных от выбранных пользователей и групп.

Кто утверждает приложение Graph Data Connect?

В кратком руководстве Microsoft администратор одобряет запрос в центре администрирования Microsoft 365 в разделе Параметры > Параметры организации > Безопасность и конфиденциальность > Microsoft Graph Data Connect applications. В руководстве прямо сказано, что нельзя одобрить собственные приложения самостоятельно.

Нужен ли новый запрос на согласие для каждого запуска конвейера?

Нет. Согласно FAQ Data Connect, пока область действия для наборов данных, столбцов, пользователей и приёмника остаётся прежней, запуск не требует нового запроса на согласие. Запуск той же области для других дат тоже покрывается.

Какие разрешения использовать приложению: делегированные или на уровне приложения?

На Microsoft Learn сказано, что разрешения на уровне приложения обладают широкими полномочиями, и с точки зрения принципа наименьших привилегий рекомендуется делегированная модель, если она отвечает потребностям приложения. Разрешения на уровне приложения всегда требуют согласия администратора.

Entities in this article

Темы этой статьи:

Microsoft Graph Data Connect – Часть Microsoft Graph Microsoft Graph permissions – Подтема в рамках темы «Microsoft Graph» Microsoft Graph – Инструмент разработчика от Microsoft

Related articles

Другие статьи на смежные темы:

RSS