Graph Data Connect dan Izin Microsoft Graph Dijelaskan: Pengaturan, Persetujuan, Hak Akses Minimum
By Mirko Peters ·
Apa yang dilakukan Microsoft Graph Data Connect, bagaimana perbedaannya dengan Graph API, langkah pengaturan dan persetujuan, serta cara kerja izin Graph (delegated, application, dan persetujuan).
Automatically translated with AI from the original post. Read the English original
Microsoft Graph Data Connect dan izin Microsoft Graph adalah dua topik terpisah yang sering dicari bersamaan. Data Connect adalah layanan ekstraksi data massal untuk analitik Microsoft 365. Izin Graph mengatur apa yang boleh dilakukan aplikasi melalui Graph API. Keduanya bergantung pada persetujuan, dan keduanya mendorong kebiasaan yang sama: mintalah akses paling minimal yang cukup untuk menyelesaikan pekerjaan.
Poin Penting
- Graph Data Connect mengekstrak data Microsoft 365 secara massal ke Azure storage untuk analitik. Graph API cocok untuk data dalam jumlah kecil dari pengguna dan grup tertentu.
- Pengaturan memerlukan Global Administrator untuk mengaktifkannya, pendaftaran aplikasi Entra, akun Azure Storage, dan persetujuan admin atas permintaan akses data.
- Pipeline memiliki beban overhead sekitar 45 menit, dan eksekusi pertama dapat memakan waktu lebih dari 40 menit termasuk persetujuan.
- Izin Graph terdiri dari dua jenis. Izin delegated bertindak atas nama pengguna yang sudah masuk. Izin application bertindak tanpa pengguna dan memerlukan persetujuan admin.
- Microsoft merekomendasikan model delegated jika model tersebut memenuhi kebutuhan aplikasi, dengan izin terkecil yang masih berfungsi.
- Nama izin mengikuti pola {resource}.{operation}.{constraint}, misalnya Application.ReadWrite.OwnedBy.
Apa itu Graph Data Connect
Microsoft menjelaskan Data Connect sebagai akses yang aman dan skalabel ke dataset Microsoft 365 di Microsoft Fabric, Azure Synapse, dan Azure Data Factory, untuk analitik perusahaan. Data berasal dari sumber seperti Microsoft Entra ID, Outlook, Teams, SharePoint, Viva Insights, dan grup Microsoft.
Dataset terbagi menjadi tiga kelompok: basic (konten mentah yang dibuat pelanggan), cleaned (sudah dinormalisasi atau dihapus duplikatnya), dan curated (dibuat untuk skenario tertentu). Daftar dataset mencakup, misalnya, TeamsCallRecords_v1, SharePointPermissions_v1, GroupMembers_v0, dan PlannerTasks_v0. Dataset Viva Insights memerlukan lisensi Viva Insights, dan ini adalah satu-satunya catatan lisensi di halaman dataset.
Data Connect atau Graph API
Pertanyaan Umum Data Connect menjelaskannya begini: keduanya menjangkau data dasar yang sama. Data Connect mengekstrak data dalam jumlah besar secara massal di seluruh organisasi. Graph API cocok untuk data dalam jumlah kecil dari pengguna dan grup tertentu. FAQ tersebut menyarankan untuk mengombinasikannya, misalnya Data Connect untuk ekstraksi awal dan Graph API untuk pekerjaan real-time setelahnya.
Batasan yang diketahui dari FAQ:
- Pipeline memiliki overhead sekitar 45 menit, berapa pun ukuran datanya.
- Pengguna Exchange on-premises tidak didukung, termasuk dalam pengaturan hybrid.
- Pesan dan acara dari resource account tidak didukung.
- Akses dataset lintas penyewa tidak tersedia. Sumber daya Azure dan Microsoft 365 harus berada dalam penyewa Entra yang sama.
Langkah pengaturan
Panduan memulai cepat ini menjelaskan langkah-langkah berikut. Nama menu sesuai dengan yang ditampilkan Microsoft.
- Aktifkan Data Connect. Masuk ke admin.microsoft.com sebagai Global Administrator. Pilih Settings > Org settings, lalu pada tab Services pilih Microsoft Graph Data Connect. Centang opsi untuk mengaktifkannya untuk seluruh organisasi, lalu simpan.
- Buat aplikasi Entra. Di pusat admin Microsoft Entra, buka App registrations > New registration. Pilih "Accounts in this organizational directory only." Salin application (client) ID dan tenant ID, buat client secret, dan simpan nilainya segera. Pemilik aplikasi memerlukan kotak surat dan, sesuai panduan cepat, langganan E5 yang berfungsi.
- Buat Azure Storage. Buat akun penyimpanan di wilayah yang sesuai dengan wilayah Microsoft 365 Anda. Berikan peran Storage Blob Data Contributor kepada aplikasi di bawah Access control (IAM), lalu buat container privat.
- Daftarkan aplikasi ke Data Connect di portal Azure. Pilih tujuan, aplikasi, serta dataset dan kolomnya.
- Setujui permintaan. Administrator membuka Settings > Org settings > Security & privacy > Microsoft Graph Data Connect applications. Aplikasi menampilkan Pre-consent. Tinjau dataset, lalu pilih Approve. Panduan cepat memperingatkan bahwa Anda tidak dapat menyetujui sendiri.
- Jalankan pipeline di Synapse, Data Factory, atau Fabric. Statusnya berpindah melalui Initializing, Consent Pending, Extracting Data, Persisting Data, dan Succeeded. Eksekusi pertama bisa memakan waktu lebih dari 40 menit.
Sink yang didukung meliputi Azure Data Lake Storage Gen2, Azure Storage Blob, Azure SQL DB (hanya mapping data flows), dan Microsoft Fabric OneLake. Autentikasi service principal adalah satu-satunya mekanisme yang didukung.
Persetujuan dan biaya
Persetujuan mencakup cakupan ekstraksi: dataset, kolom, pengguna, dan sink. Eksekusi dengan cakupan yang sama tidak memerlukan permintaan baru. Penagihan dilakukan melalui langganan Azure, per eksekusi pipeline, dengan satuan pecahan dibulatkan ke atas. Contoh dalam FAQ: 20 eksekusi masing-masing 500 baris ditagih sebagai 20 unit, bukan 10. Halaman yang dibaca tidak mencantumkan tarif.
Izin Graph: dasar-dasarnya
Untuk Graph API, Microsoft mendefinisikan dua jenis izin.
| | Delegated | Application | |---|---|---| | Bertindak | Atas nama pengguna yang masuk | Tanpa pengguna | | Akses efektif | Dibatasi oleh izin aplikasi dan izin pengguna itu sendiri | Semua data yang dicakup izin | | Siapa yang dapat menyetujui | Pengguna, atau admin untuk semua pengguna | Hanya admin | | Nama lain | Scopes | App roles |
Persetujuan untuk izin aplikasi memerlukan peran Privileged Role Administrator atau Global Administrator. Persetujuan pengguna untuk izin delegated tetap dapat dibatasi oleh kebijakan persetujuan aplikasi penyewa.
Penamaan dan prinsip hak akses minimum
Izin mengikuti pola {resource}.{operation}.{constraint}. Contoh dalam halaman tersebut menggunakan operasi seperti Read dan ReadWrite serta batasan seperti All dan OwnedBy. Jika tidak ada batasan, akses dibatasi pada data yang dimiliki pengguna yang masuk. Misalnya, Application.ReadWrite.OwnedBy hanya mengelola aplikasi yang dibuat atau dimiliki aplikasi tersebut, sedangkan Application.ReadWrite.All mengelola semuanya.
Panduan Microsoft: berikan izin minimum yang dibutuhkan. Gunakan Directory.AccessAsUser.All, Directory.ReadWrite.All, dan Directory.Read.All dengan hati-hati, dan utamakan izin yang lebih terbatas. Resource-specific consent memungkinkan pengguna memberikan akses ke satu instans resource, misalnya satu tim, alih-alih seluruh penyewa. Fitur ini hanya didukung oleh sebagian fitur.
Masalah umum
- Pendaftaran connector agent gagal. Learn menyatakan bahwa izin delegated tidak didukung untuk pendaftaran connector agent. Ajukan izin application dengan hak akses minimum dan berikan persetujuan admin untuk seluruh penyewa.
- Anggota hanya menampilkan id dan @odata.type. Aplikasi tidak memiliki izin untuk membaca jenis anggota tersebut.
- Terlalu banyak izin pada satu aplikasi. Aplikasi yang audiens sign-in-nya mencakup akun Microsoft pribadi dapat meminta paling banyak 30 izin; audiens organisasi dapat meminta hingga 400.
Yang tidak dijelaskan dalam dokumentasi
Halaman Data Connect yang dibaca tidak menjelaskan berapa lama persetujuan tetap berlaku atau memberikan tarif harga. Halaman tersebut juga tidak mencantumkan persyaratan lisensi di luar konfigurasi tutorial panduan cepat.
Terkait
Sumber
- Ikhtisar Microsoft Graph Data Connect
- Panduan cepat Data Connect
- Pertanyaan Umum Data Connect
- Kumpulan data, wilayah, dan sink
- Ikhtisar izin Microsoft Graph
FAQ
Apa perbedaan antara Graph Data Connect dan Microsoft Graph API?
Pertanyaan Umum Data Connect di Microsoft Learn menyebutkan bahwa keduanya memberikan akses ke data dasar yang sama, tetapi dengan cara yang berbeda. Data Connect dirancang untuk mengekstrak data dalam jumlah besar secara massal untuk seluruh organisasi, sedangkan Graph API lebih cocok untuk data dalam jumlah kecil dari pengguna dan grup tertentu.
Siapa yang menyetujui aplikasi Graph Data Connect?
Dalam panduan memulai cepat Microsoft, administrator menyetujui permintaan di pusat admin Microsoft 365 pada Settings > Org settings > Security & privacy > Microsoft Graph Data Connect applications. Panduan tersebut menyatakan bahwa Anda tidak dapat menyetujui aplikasi Anda sendiri.
Apakah setiap kali menjalankan pipeline perlu permintaan persetujuan baru?
Tidak. Menurut Pertanyaan Umum Data Connect, selama cakupan untuk dataset, kolom, pengguna, dan sink tetap sama, eksekusi tidak memerlukan permintaan persetujuan baru. Menjalankan cakupan yang sama untuk tanggal yang berbeda juga sudah tercakup.
Apakah aplikasi sebaiknya menggunakan izin delegated atau application?
Microsoft Learn menyatakan bahwa izin application memiliki hak istimewa yang tinggi. Dari sudut pandang hak akses minimum, model delegated direkomendasikan selama model tersebut memenuhi kebutuhan aplikasi. Izin application selalu memerlukan persetujuan administrator.