M365Con 2027 – konferensi online gratis · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Runbook Azure Automation Mendapat 'Insufficient Privileges' dari Microsoft Graph: Berikan App Role ke Managed Identity

By ·

Runbook yang masuk dengan managed identity-nya gagal pada panggilan Graph dengan Authorization_RequestDenied. Identitas tersebut tidak memiliki izin Graph sampai Anda menetapkan app role dengan PowerShell.

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

Runbook Azure Automation terhubung ke Microsoft Graph dengan managed identity-nya. Koneksi berhasil. Panggilan pertama gagal dengan [Authorization_RequestDenied] : Insufficient privileges to complete the operation.

Poin Penting

  • Managed identity awalnya tidak memiliki izin Microsoft Graph. Runbook tanpa pengawasan memerlukan izin aplikasi (app role), bukan delegated scope.
  • Dilaporkan dalam sumber komunitas: portal tidak dapat memberikan izin ini kepada managed identity. Tetapkan app role dengan Microsoft Graph PowerShell atau REST, menggunakan object ID, bukan application ID.
  • Resource ID adalah object ID dari service principal Microsoft Graph di penyewa Anda sendiri. Jangan menyalin ID dari contoh.
  • Berikan hanya peran yang dibutuhkan skrip. Learn memperingatkan bahwa app role yang ditetapkan dengan cara ini langsung berlaku dan tidak ditinjau.

Dua utas Microsoft Q&A dari September 2025 menggambarkan masalah ini. Dalam satu utas, anggota komunitas mengikuti artikel Tech Community untuk memberikan izin Graph dan mengalami galat pada skrip. Dalam utas lainnya, runbook yang seharusnya mencantumkan pengguna Entra ID yang tidak aktif gagal dengan cara yang sama. Tidak ada utas yang berakhir dengan konfirmasi. Artikel ini menyusun potongan-potongan informasi dari Microsoft Learn dan menandai hal-hal yang hanya dilaporkan dalam utas tersebut. Ini bukan prosedur resmi Microsoft.

Mengapa galat muncul

Managed identity yang ditetapkan sistem adalah service principal di Entra ID. Mengaktifkannya memberi runbook sebuah identitas, tetapi tidak memberi izin Graph. Artikel Microsoft Tech Community dari Oktober 2024 menyebutkan bahwa identitas tersebut tidak memiliki izin Graph secara default dan bahwa tombol Grant admin consent di portal dinonaktifkan untuknya.

Halaman pemecahan masalah Graph PowerShell di Learn menyatakan bahwa sebagian besar galat otorisasi dikembalikan sebagai 403 dan penyebab umumnya adalah izin yang hilang. Untuk akses hanya-aplikasi, halaman tersebut menyarankan untuk mengonfigurasi izin aplikasi terlebih dahulu atau menetapkan app role dengan New-MgServicePrincipalAppRoleAssignment.

Ada dua kesalahan dalam utas tersebut yang mudah terulang:

  • Jenis izin yang salah. Saran pertama dalam utas itu, dari seorang moderator Microsoft, memberikan izin delegated melalui oauth2PermissionGrants. Moderator yang sama kemudian menyatakan bahwa runbook memperoleh token tanpa interaksi pengguna dan memerlukan izin aplikasi.
  • Resource ID yang salah. Contoh moderator menggunakan ID contoh untuk service principal Microsoft Graph. Moderator tersebut kemudian menyatakan bahwa ID ini berbeda di setiap penyewa dan harus dicari di penyewa Anda sendiri. Tutorial Graph PowerShell di Learn menjelaskan ResourceId sebagai object ID dari service principal resource.

Langkah 1: Aktifkan identitas terkelola dan catat object ID-nya

  1. Di Azure portal, buka Automation account.
  2. Di bawah Account Settings, pilih Identity.
  3. Atur System assigned ke On, pilih Save, lalu konfirmasi.

Halaman Identity menampilkan object ID. Learn juga menunjukkan cara membacanya dengan PowerShell: (Get-AzAutomationAccount -ResourceGroupName $resourceGroup -Name $automationAccount).Identity mengembalikan PrincipalId. Simpan sebagai $MI_ID. Ini adalah object ID, bukan application ID.

Langkah 2: Cari tahu izin yang dibutuhkan panggilan

Jangan menebak, dan jangan memilih Directory.ReadWrite.All hanya karena namanya terdengar aman. Halaman troubleshooting Graph PowerShell dari Learn menunjukkan cara mencari izin untuk sebuah cmdlet. Contoh outputnya untuk akses delegated, jadi pastikan izin aplikasinya di referensi izin Graph:

``powershell Find-MgGraphCommand -Command Get-MgUser | Select -First 1 -ExpandProperty Permissions ``

(Contoh Learn menggunakan New-MgServicePrincipal sebagai pengganti Get-MgUser.) Untuk skrip yang membaca aktivitas sign-in, referensi daftar pengguna Learn menyebutkan bahwa properti signInActivity memerlukan lisensi Microsoft Entra ID P1 atau P2 dan izin AuditLog.Read.All. Halaman akun tidak aktif dari Learn mencantumkan AuditLog.Read.All dan User.Read.All. Halaman yang sama menyebut Reports Reader sebagai peran dengan hak paling minimal untuk log aktivitas.

Dalam thread akun tidak aktif, seorang moderator Microsoft menyarankan menambahkan peran Reports Reader atau Directory Reader ke identitas, serta izin AuditLog.Read.All dan Directory.Read.All, melalui tab API permissions pada enterprise application. Moderator yang sama kemudian menyatakan bahwa tab ini tidak ditampilkan untuk identitas terkelola. Tidak ada jawaban tersebut yang diterima, dan Learn tidak memastikan bahwa peran direktori juga diperlukan untuk app role. Mulailah dengan app role, dan tambahkan peran hanya jika panggilan masih gagal.

Langkah 3: Tetapkan app role dengan Microsoft Graph PowerShell

Anda memerlukan hak untuk menetapkan peran. Tutorial Graph PowerShell dari Learn mencantumkan Privileged Role Administrator, sedangkan artikel Tech Community menyebutkan bahwa orang yang menjalankan skripnya harus Global Administrator. Masuk sebagai administrator di komputer Anda sendiri atau di Cloud Shell, bukan di runbook.

Halaman managed identity Exchange dari Learn menunjukkan pola ini, dengan $MI_ID diteruskan sebagai -ServicePrincipalId dan -PrincipalId. Di sini pola tersebut disesuaikan untuk Graph. Application ID Graph 00000003-0000-0000-c000-000000000000 berasal dari halaman REST Learn:

```powershell Connect-MgGraph -Scopes AppRoleAssignment.ReadWrite.All,Application.Read.All

$graph = Get-MgServicePrincipal -Filter "AppId eq '00000003-0000-0000-c000-000000000000'" $roleId = $graph.AppRoles | Where-Object { $_.Value -eq 'AuditLog.Read.All' -and $_.AllowedMemberTypes -contains 'Application' } | Select-Object -ExpandProperty Id

New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $MI_ID -PrincipalId $MI_ID -ResourceId $graph.Id -AppRoleId $roleId ``

Catatan:

  • $graph.Id adalah object ID service principal Graph di penyewa Anda. Nilai inilah yang digunakan sebagai ResourceId.
  • Pencarian peran mengikuti pola di tutorial Learn, yang memfilter AppRoles berdasarkan Value. Pemeriksaan tambahan untuk AllowedMemberTypes berasal dari artikel Tech Community, yang hanya mempertahankan peran yang mengizinkan tipe Application.
  • Halaman tutorial Learn menggunakan bentuk kedua, dengan object ID resource sebagai ServicePrincipalId dan parameter body. Pilih salah satu dan periksa outputnya.
  • Halaman REST Learn memperingatkan bahwa hanya pengguna yang sesuai yang boleh memiliki AppRoleAssignment.ReadWrite.All, dan izin yang ditetapkan dengan cara ini langsung berlaku tanpa peninjauan.

Galat di thread pertama, "Some App Roles are not found on Graph API service principal", berasal dari skrip komunitas. Berdasarkan logikanya, galat ini muncul ketika jumlah peran yang cocok berbeda dengan jumlah nama yang diminta. Nama yang salah eja, atau nama yang bukan app role, akan memicunya. Ini adalah kesimpulan dari membaca skrip, bukan dari artikel. Artikel tidak menyatakannya.

Untuk memeriksa, daftar penetapan pada identitas tersebut, atau lihat penetapan Graph di Entra. Halaman REST Learn menunjukkan cara mendaftar dengan GET .../appRoleAssignedTo pada resource.

Langkah 4: Gunakan identitas di runbook

Halaman Graph PowerShell di Learn menunjukkan pemanggilan berikut:

``powershell Connect-MgGraph -Identity Get-MgContext ``

Untuk identitas yang ditetapkan pengguna, tambahkan -ClientId dengan ID klien identitas tersebut. Get-MgContext menampilkan AuthType, yang menunjukkan apakah sesi bersifat delegated atau app-only. Impor modul Microsoft.Graph.Authentication, serta submodul apa pun yang Anda panggil, ke akun Automation terlebih dahulu. Halaman modul di Learn menjelaskan metode impor dan pilihan versi runtime (5.1 atau 7.2), tetapi tidak menyebutkan modul Graph.

Satu catatan lagi dari utas akun tidak aktif. Skrip tersebut menggunakan Connect-AzAccount -Identity dan Get-AzADUser dengan filter SignInActivity. Seorang moderator Microsoft menyarankan -Property SignInActivity. Halaman Learn yang digunakan di sini tidak memastikan bahwa cara ini berhasil. Untuk signInActivity, Learn mendokumentasikan permintaan Graph GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity, dengan ukuran halaman maksimum 500. Menggunakan Graph secara langsung adalah pendekatan yang lebih aman.

Langkah 5: Tunggu, lalu uji dengan tugas baru

Panduan cara kerja managed identity di Learn memperingatkan bahwa caching token dapat menunda perubahan. Jika runbook masih gagal tepat setelah pemberian izin, hentikan tugas, tunggu, lalu mulai tugas baru. Pada utas pertama, izin tampil di aplikasi perusahaan setelah ID resource diperbaiki, tetapi runbook tetap gagal. Utas tersebut tidak menyebutkan apakah penyebabnya adalah penundaan, jenis izin yang salah, atau izin yang belum ada.

Menghapus pemberian izin yang keliru

Penanya di utas pertama ingin menghapus izin yang diberikan melalui Graph Explorer, tetapi tidak mendapat jawaban. Untuk app role, tutorial Learn menunjukkan Remove-MgServicePrincipalAppRoleAssignedTo, dan halaman REST menunjukkan DELETE pada appRoleAssignedTo. Skrip pembersihan pada artikel Tech Community menggunakan Remove-MgServicePrincipalAppRoleAssignment. Untuk pemberian delegated melalui oauth2PermissionGrants, halaman REST Learn menunjukkan PATCH yang hanya mempertahankan cakupan yang Anda cantumkan, atau DELETE yang mencabut seluruh pemberian.

Batasan

  • Tidak ada dari kedua utas tersebut yang memastikan solusinya. Langkah-langkah di sini mengikuti Learn, bukan hasil yang sudah terbukti.
  • Halaman Learn Exchange yang digunakan sebagai pola cmdlet ditulis untuk izin Exchange, bukan Graph. Cmdlet dan parameternya sesuai dengan tutorial Graph PowerShell, tetapi lakukan pengujian Anda sendiri.
  • Jaga izin tetap minimal. Gunakan AuditLog.Read.All untuk data sign-in, bukan peran tulis tingkat direktori.

Terkait

Sumber

Entities in this article

Azure Automation Managed identity Microsoft Graph PowerShell Microsoft Graph permissions

Related articles

RSS