M365Con 2027 – bezpłatna konferencja online · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Runbook Azure Automation zwraca błąd „Insufficient privileges” przy wywołaniach Microsoft Graph: przydziel role aplikacji tożsamości zarządzanej

By ·

Runbook, który loguje się za pomocą tożsamości zarządzanej, kończy się błędem Authorization_RequestDenied przy wywołaniach Graph. Tożsamość nie ma żadnych uprawnień do Graph, dopóki nie przypiszesz ról aplikacji w PowerShell.

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

Runbook Azure Automation łączy się z Microsoft Graph za pomocą swojej tożsamości zarządzanej. Połączenie się udaje. Pierwsze wywołanie kończy się błędem [Authorization_RequestDenied] : Insufficient privileges to complete the operation.

Najważniejsze wnioski

  • Tożsamość zarządzana na starcie nie ma żadnych uprawnień do Microsoft Graph. Runbooki działające bez nadzoru potrzebują uprawnień aplikacji (ról aplikacji), a nie zakresów delegowanych.
  • Według źródeł społecznościowych portal nie może przydzielić tych uprawnień tożsamości zarządzanej. Przypisz rolę aplikacji za pomocą Microsoft Graph PowerShell lub REST, używając identyfikatorów obiektów, a nie identyfikatorów aplikacji.
  • Identyfikator zasobu to identyfikator obiektu jednostki usługi Microsoft Graph w Twojej własnej dzierżawie. Nie kopiuj identyfikatora z przykładu.
  • Przydziel tylko tę rolę, której potrzebuje skrypt. Learn ostrzega, że role aplikacji przypisane w ten sposób działają od razu i nie podlegają przeglądowi.

Dwa wątki Microsoft Q&A z września 2025 roku opisują ten problem. W jednym członek społeczności według artykułu Tech Community nadawał uprawnienia Graph i napotkał błędy w skrypcie. W drugim runbook, który miał wypisywać nieaktywnych użytkowników Entra ID, zakończył się tym samym błędem. Żaden z wątków nie zakończył się potwierdzeniem. Ten artykuł łączy elementy z dokumentacji Microsoft Learn i oznacza to, co wątki tylko zgłaszały. To nie jest oficjalna procedura Microsoft.

Skąd bierze się błąd

Systemowa tożsamość zarządzana to jednostka usługi w Entra ID. Jej włączenie daje runbookowi tożsamość, ale nie daje uprawnień do Graph. Artykuł Microsoft Tech Community z października 2024 roku mówi, że tożsamość domyślnie nie ma uprawnień do Graph, a przycisk „Grant admin consent” w portalu jest dla niej wyłączony.

Strona Learn o rozwiązywaniu problemów z Graph PowerShell podaje, że większość błędów autoryzacji zwracana jest jako 403, a typową przyczyną jest brakujące uprawnienie. Dla dostępu tylko aplikacyjnego zaleca wstępnie skonfigurować uprawnienia aplikacji lub przypisać role aplikacji poleceniem New-MgServicePrincipalAppRoleAssignment.

W wątkach pojawiły się dwa błędy, które łatwo powtórzyć:

  • Zły typ uprawnienia. Pierwsza propozycja w tym wątku, od moderatora Microsoft, przydzielała uprawnienia delegowane przez oauth2PermissionGrants. Ten sam moderator napisał później, że runbook pobiera token bez interakcji użytkownika i potrzebuje uprawnień aplikacji.
  • Zły identyfikator zasobu. Przykład moderatora używał przykładowego identyfikatora jednostki usługi Microsoft Graph. Moderator napisał potem, że ten identyfikator różni się między dzierżawami i trzeba go odszukać we własnej dzierżawie. Samouczek Learn o Graph PowerShell opisuje ResourceId jako identyfikator obiektu jednostki usługi zasobu.

Krok 1: Włącz tożsamość zarządzaną i zanotuj jej identyfikator obiektu

  1. W portalu Azure otwórz konto usługi Automation.
  2. W sekcji Ustawienia konta wybierz Tożsamość.
  3. Ustaw opcję Przypisana przez system na Włączone, wybierz Zapisz i potwierdź.

Strona Tożsamość pokazuje identyfikator obiektu. Dokumentacja Learn pokazuje także, jak odczytać go w PowerShell: (Get-AzAutomationAccount -ResourceGroupName $resourceGroup -Name $automationAccount).Identity zwraca PrincipalId. Zapisz go jako $MI_ID. To jest identyfikator obiektu, a nie identyfikator aplikacji.

Krok 2: Ustal, jakiego uprawnienia wymaga wywołanie

Nie zgaduj i nie wybieraj Directory.ReadWrite.All tylko dlatego, że brzmi bezpiecznie. Strona Learn poświęcona rozwiązywaniu problemów z Graph PowerShell pokazuje, jak sprawdzić uprawnienie dla polecenia cmdlet. Jej przykładowe dane wyjściowe dotyczą dostępu delegowanego, dlatego potwierdź uprawnienie aplikacji w dokumentacji uprawnień Graph:

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

(Przykład w Learn używa New-MgServicePrincipal zamiast Get-MgUser). Dla skryptu odczytującego aktywność logowania dokumentacja Learn dotycząca listy użytkowników podaje, że właściwość signInActivity wymaga licencji Microsoft Entra ID P1 lub P2 oraz uprawnienia AuditLog.Read.All. Strona Learn o nieaktywnych kontach wymienia AuditLog.Read.All i User.Read.All. Ta sama strona wskazuje rolę Czytelnik raportów jako rolę o najmniejszych uprawnieniach do dzienników aktywności.

W wątku o nieaktywnych kontach moderator Microsoft zasugerował dodanie roli Czytelnik raportów lub Czytelnik katalogu do tożsamości oraz uprawnień AuditLog.Read.All i Directory.Read.All, z użyciem karty uprawnień interfejsu API w aplikacji przedsiębiorstwa. Ten sam moderator później napisał, że ta karta nie jest wyświetlana dla tożsamości zarządzanych. Żadna z tych odpowiedzi nie została zaakceptowana, a Learn nie potwierdza, że do ról aplikacji potrzebna jest także rola katalogu. Zacznij od ról aplikacji i dodaj rolę katalogu tylko wtedy, gdy wywołanie nadal kończy się błędem.

Krok 3: Przypisz rolę aplikacji za pomocą Microsoft Graph PowerShell

Potrzebujesz prawa do przypisywania ról. Samouczek Learn dotyczący Graph PowerShell wymienia rolę Administrator ról uprzywilejowanych, a artykuł na Tech Community mówi, że osoba uruchamiająca jego skrypty musi być Administratorem globalnym. Zaloguj się jako administrator na własnym komputerze lub w Cloud Shell, a nie w runbooku.

Strona Learn o tożsamościach zarządzanych dla Exchange pokazuje ten wzorzec, w którym $MI_ID jest przekazywany zarówno jako -ServicePrincipalId, jak i -PrincipalId. Tutaj został dostosowany do Graph. Identyfikator aplikacji Graph 00000003-0000-0000-c000-000000000000 pochodzi ze strony Learn o REST:

```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 ``

Uwagi:

  • $graph.Id to identyfikator obiektu jednostki serwisowej Graph w Twojej dzierżawie. Tę wartość należy użyć jako ResourceId.
  • Wyszukiwanie roli opiera się na wzorcu z samouczka Learn, który filtruje AppRoles według Value. Dodatkowe sprawdzenie AllowedMemberTypes pochodzi z artykułu na Tech Community i zachowuje tylko role, które dopuszczają typ Application.
  • Strona samouczka Learn używa drugiej postaci: identyfikatora obiektu zasobu jako ServicePrincipalId oraz parametru treści. Wybierz jedną z nich i sprawdź wynik.
  • Strona Learn o REST ostrzega, że uprawnienie AppRoleAssignment.ReadWrite.All powinni mieć wyłącznie odpowiedni użytkownicy, a uprawnienia przypisane w ten sposób wchodzą w życie od razu, bez przeglądu.

Błąd z pierwszego wątku, „Some App Roles are not found on Graph API service principal”, pochodzi ze skryptu społecznościowego. Zgodnie z jego logiką pojawia się, gdy liczba dopasowanych ról różni się od liczby żądanych nazw. Błędna pisownia nazwy lub nazwa, która nie jest rolą aplikacji, mogłaby to wywołać. To jest wniosek wyciągnięty z analizy skryptu. Artykuł tego nie stwierdza.

Aby to sprawdzić, wylistuj przypisania dla tożsamości albo wyświetl przypisanie Graph w Entra. Strona REST w Learn pokazuje listowanie za pomocą GET .../appRoleAssignedTo na zasobie.

Krok 4: Użyj tożsamości w runbooku

Strona Learn o Graph PowerShell pokazuje wywołanie:

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

Dla tożsamości przypisanej przez użytkownika dodaj -ClientId z identyfikatorem klienta tej tożsamości. Get-MgContext pokazuje AuthType, czyli informację, czy sesja jest delegowana, czy działa wyłącznie w kontekście aplikacji. Najpierw zaimportuj moduł Microsoft.Graph.Authentication oraz wszystkie podmoduły, których używasz, do konta Automation. Strona Learn o modułach opisuje metody importu i wybór wersji środowiska uruchomieniowego (5.1 lub 7.2), ale nie wymienia modułów Graph.

Jeszcze jedna uwaga z wątku o nieaktywnych kontach. Skrypt używał Connect-AzAccount -Identity oraz Get-AzADUser z filtrem SignInActivity. Moderator Microsoft zasugerował -Property SignInActivity. Strony Learn, na które się powołano, nie potwierdzają, że to działa. Dla signInActivity Learn dokumentuje żądanie Graph GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity z maksymalnym rozmiarem strony wynoszącym 500. Bezpieczniejszą drogą jest bezpośrednie użycie Graph.

Krok 5: Poczekaj, a następnie przetestuj świeżym zadaniem

Strona Learn o jawnie przypisanej tożsamości zarządzanej ostrzega, że buforowanie tokenów może opóźniać zmiany. Jeśli runbook nadal kończy się błędem zaraz po przydzieleniu uprawnienia, zatrzymaj zadanie, poczekaj i uruchom nowe. W pierwszym wątku uprawnienie pojawiło się w aplikacji korporacyjnej po naprawieniu identyfikatora zasobu, ale runbook nadal kończył się błędem. Wątek nie mówi, czy przyczyną było opóźnienie, niewłaściwy typ uprawnienia, czy brakujące uprawnienie.

Usuwanie błędnie nadanego przydziału

Autor pierwszego wątku chciał usunąć uprawnienia nadane w Graph Explorer i nie otrzymał odpowiedzi. Dla ról aplikacji samouczek Learn pokazuje Remove-MgServicePrincipalAppRoleAssignedTo, a strona REST pokazuje DELETE na appRoleAssignedTo. Skrypt czyszczący z artykułu Tech Community używa Remove-MgServicePrincipalAppRoleAssignment. Dla uprawnień delegowanych nadanych przez oauth2PermissionGrants strona REST w Learn pokazuje PATCH, który zachowuje tylko wymienione zakresy, albo DELETE, który cofa całe nadanie.

Ograniczenia

  • Żaden z wątków nie potwierdził rozwiązania. Opisane kroki opierają się na dokumentacji Learn, a nie na potwierdzonym wyniku.
  • Strona Learn o Exchange, na którą powołano się przy wzorcu cmdletu, dotyczy uprawnień Exchange, a nie Graph. Cmdlet i parametry odpowiadają samouczkowi Graph PowerShell, ale uruchom własny test.
  • Ogranicz uprawnienia do minimum. Użyj AuditLog.Read.All do danych logowania, a nie roli zapisu o zasięgu całego katalogu.

Powiązane

Źródła

Entities in this article

Azure Automation Managed identity Microsoft Graph PowerShell Microsoft Graph permissions

Related articles

RSS