Graph Data Connect і дозволи Microsoft Graph: налаштування, згода та принцип найменших привілеїв
By Mirko Peters ·
Що робить 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 Storage і погодження запиту на доступ до даних адміністратором.
- Конвеєри мають накладні витрати близько 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.
- Увімкніть Data Connect. Увійдіть на admin.microsoft.com як Глобальний адміністратор. Виберіть Settings > Org settings, потім на вкладці Services виберіть Microsoft Graph Data Connect. Позначте опцію ввімкнення для всієї організації та збережіть.
- Створіть застосунок Entra. У центрі адміністрування Microsoft Entra перейдіть до App registrations > New registration. Виберіть «Accounts in this organizational directory only.» Скопіюйте ідентифікатор застосунку (клієнта) та ідентифікатор клієнта, створіть секрет клієнта й одразу збережіть його значення. Власнику застосунку потрібна поштова скринька та, згідно з швидким стартом, робоча підписка E5.
- Створіть Azure Storage. Створіть обліковий запис сховища в регіоні, що відповідає вашому регіону Microsoft 365. Надайте застосунку роль Storage Blob Data Contributor у розділі Access control (IAM) і створіть приватний контейнер.
- Зареєструйте застосунок у Data Connect на порталі Azure. Виберіть призначення, застосунок, набори даних і стовпці.
- Схваліть запит. Адміністратор відкриває Settings > Org settings > Security & privacy > Microsoft Graph Data Connect applications. Застосунок показує статус Pre-consent. Перегляньте набори даних і натисніть Approve. У швидкому старті попереджається, що схвалити власний запит неможливо.
- Запустіть конвеєр у 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 за кожен запуск конвеєра, а дробові одиниці округлюються вгору. Приклад із розділу поширених запитань: 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 не описують, як довго чинне схвалення, і не наводять цінових ставок. Вони також не перелічують вимоги до ліцензій, окрім навчального налаштування зі швидкого старту.
Пов’язане
Джерела
- Огляд Microsoft Graph Data Connect
- Швидкий старт Data Connect
- Поширені запитання про Data Connect
- Набори даних, регіони та приймачі
- Огляд дозволів Microsoft Graph
FAQ
Яка різниця між Graph Data Connect і Microsoft Graph API?
У FAQ з Data Connect на Microsoft Learn сказано, що обидва надають доступ до тих самих базових даних, але різними способами. Data Connect призначений для масового вивантаження великих обсягів даних по всій організації, тоді як Graph API підходить для невеликих обсягів даних від окремих вибраних користувачів і груп.
Хто погоджує застосунок Graph Data Connect?
У швидкому старті Microsoft адміністратор погоджує запит у центрі адміністрування Microsoft 365 за шляхом Settings > Org settings > Security & privacy > Microsoft Graph Data Connect applications. У швидкому старті також зазначено, що власні застосунки не можна погодити самостійно.
Чи потрібен новий запит на згоду для кожного запуску конвеєра?
Ні. За FAQ Data Connect, доки область доступу для наборів даних, стовпців, користувачів і приймача залишається незмінною, запуск не потребує нового запиту на згоду. Запуск тієї самої області для різних дат також охоплюється.
Чи повинен застосунок використовувати делеговані дозволи чи дозволи для застосунків?
На Microsoft Learn зазначено, що дозволи для застосунків мають високі привілеї, а з погляду принципу найменших привілеїв рекомендується делегована модель щоразу, коли вона відповідає потребам застосунку. Дозволи для застосунків завжди потребують згоди адміністратора.