Mengaktifkan autentikasi service principal untuk API admin

Artikel ini memperlihatkan cara mengaktifkan autentikasi prinsipal layanan untuk Power BI baca-saja API administrator dan Microsoft Fabric update API administrator.

Prinsipal layanan adalah metode autentikasi yang dapat digunakan untuk memungkinkan aplikasi Microsoft Entra mengakses konten Microsoft Fabric dan API.

Saat Anda membuat aplikasi Microsoft Entra, objek utama service dibuat. Objek perwakilan layanan, yang juga dikenal sebagai perwakilan layanan, memungkinkan Microsoft Entra ID untuk mengotentikasi aplikasi Anda. Setelah diautentikasi, aplikasi dapat mengakses sumber daya penyewa Microsoft Entra.

Mengaktifkan autentikasi prinsipal layanan

Untuk mengaktifkan autentikasi perwakilan layanan untuk FABRIC API, ikuti langkah-langkah berikut:

  1. Buat aplikasi Microsoft Entra. Anda dapat melewati langkah ini jika Anda sudah memiliki aplikasi Microsoft Entra yang ingin Anda gunakan. Catat ID aplikasi, yang Anda butuhkan di langkah selanjutnya.

    Penting

    Pastikan aplikasi yang Anda gunakan tidak memiliki izin di Fabric yang memerlukan persetujuan admin ditetapkan di portal Azure. Lihat cara memeriksa apakah aplikasi Anda memiliki izin tersebut.

  2. Buat grup Microsoft Entra Keamanan baru dan pastikan untuk memilih Keamanan sebagai jenis Grup. Anda dapat melewati langkah ini jika Anda sudah memiliki grup keamanan Microsoft Entra yang ingin Anda gunakan.

  3. Tambahkan ID aplikasi Anda sebagai anggota grup keamanan yang Anda buat. Untuk melakukannya:

  4. Navigasi ke portal Azure > Microsoft Entra ID > Groups, dan pilih grup keamanan yang Anda buat di Step 2.

    1. Pilih Tambahkan Anggota.

  5. Aktifkan pengaturan admin Fabric:

    1. Masuk ke portal admin Fabric. Anda harus menjadi admin Fabric untuk melihat halaman pengaturan penyewa.

    2. Di bawah Pengaturan API Admin, pilih sakelar untuk jenis API admin yang ingin Anda aktifkan:

      • Service Principal dapat mengakses API admin yang hanya dapat dibaca (lihat API admin Power BI yang didukung)
      • Perwakilan layanan dapat mengakses API admin yang digunakan untuk pembaruan (lihat API admin Fabric yang didukung)

  6. Atur tombol ke Diaktifkan.

  7. Pilih tombol radio Grup keamanan tertentu . Di bidang teks yang muncul di bawahnya, tambahkan grup keamanan yang Anda buat di Langkah 2.

  8. Pilih Terapkan.

API admin Power BI yang didukung untuk baca-saja

API administrator baca-saja berikut mendukung autentikasi prinsipal layanan. Daftar ini mungkin tidak lengkap; untuk informasi terbaru tentang API yang tidak tercantum di sini, lihat dokumentasi Power BI REST API.

Aplikasi yang menggunakan autentikasi perwakilan layanan yang memanggil API admin read-only tidak boleh memiliki izin yang memerlukan persetujuan admin untuk Power BI yang diatur di portal Azure. Untuk memeriksa izin yang ditetapkan:

  1. Masuk ke portal Azure.

  2. Pilih Microsoft Entra ID, lalu Aplikasi perusahaan.

  3. Pilih aplikasi yang ingin Anda berikan akses ke Power BI.

  4. Pilih Izin. Tidak boleh ada izin yang memerlukan persetujuan admin berjenis Aplikasi yang terdaftar untuk aplikasi.

API admin Fabric yang didukung untuk pembaruan

Perwakilan layanan dapat mengakses API admin yang digunakan untuk pengaturan pembaruan yang berlaku untuk API admin Fabric, seperti API Ruang Kerja - Pulihkan Ruang Kerja.

Untuk mengetahui apakah API admin Fabric tertentu mendukung autentikasi perwakilan layanan, periksa dokumentasi API dalam referensi Fabric REST API. Cari bagian "identitas yang didukung Microsoft Entra", yang menunjukkan apakah autentikasi prinsipal layanan didukung.

Pertimbangan dan keterbatasan

  • Perwakilan layanan dapat melakukan panggilan REST API, tetapi Anda tidak dapat membuka Fabric dengan kredensial perwakilan layanan.

  • Hak admin Fabric diperlukan untuk mengaktifkan prinsipal layanan di pengaturan Admin API di portal admin Fabric.

Konten terkait

  • Last updated on