Runbook do Azure Automation recebe 'Insufficient Privileges' do Microsoft Graph: conceda funções de aplicativo à identidade gerenciada
By Mirko Peters ·
Um runbook que se autentica com a identidade gerenciada falha nas chamadas ao Graph com Authorization_RequestDenied. A identidade não tem permissões do Graph até que você atribua funções de aplicativo com PowerShell.
Automatically translated with AI from the original post. Read the English original
Um runbook do Azure Automation se conecta ao Microsoft Graph com sua identidade gerenciada. A conexão é bem-sucedida. A primeira chamada falha com [Authorization_RequestDenied] : Insufficient privileges to complete the operation.
Pontos-chave
- Uma identidade gerenciada começa sem nenhuma permissão do Microsoft Graph. Runbooks não assistidos precisam de permissões de aplicativo (funções de aplicativo), não de escopos delegados.
- Relatado em fontes da comunidade: o portal não consegue conceder essas permissões a uma identidade gerenciada. Atribua a função de aplicativo com o Microsoft Graph PowerShell ou REST, usando IDs de objeto, não IDs de aplicativo.
- O ID do recurso é o ID de objeto da entidade de serviço do Microsoft Graph no seu próprio locatário. Não copie um ID de exemplo.
- Conceda apenas a função que o script precisa. O Learn alerta que as funções de aplicativo atribuídas dessa forma entram em vigor imediatamente e não passam por revisão.
Duas discussões do Microsoft Q&A de setembro de 2025 descrevem esse problema. Em uma delas, um membro da comunidade seguiu um artigo da Tech Community para conceder permissões do Graph e encontrou erros no script. Na outra, um runbook que deveria listar usuários inativos do Entra ID falhou da mesma forma. Nenhuma das discussões terminou com uma confirmação. Este artigo reúne as peças a partir do Microsoft Learn e indica o que as discussões apenas relataram. Não é um procedimento oficial da Microsoft.
Por que o erro aparece
Uma identidade gerenciada atribuída pelo sistema é uma entidade de serviço no Entra ID. Ao habilitá-la, o runbook recebe uma identidade, mas nenhuma permissão do Graph. Um artigo da Microsoft Tech Community de outubro de 2024 diz que a identidade não tem permissões do Graph por padrão e que o botão "Conceder consentimento de administrador" do portal fica desabilitado para ela.
A página de solução de problemas do Graph PowerShell no Learn diz que a maioria dos erros de autorização retorna como 403 e que a causa comum é uma permissão ausente. Para acesso somente de aplicativo, ela recomenda pré-configurar permissões de aplicativo ou atribuir funções de aplicativo com New-MgServicePrincipalAppRoleAssignment.
Duas coisas deram errado nas discussões e são fáceis de repetir:
- Tipo de permissão errado. A primeira sugestão da discussão, de um moderador da Microsoft, concedeu permissões delegadas por meio de
oauth2PermissionGrants. O mesmo moderador disse depois que um runbook obtém seu token sem interação do usuário e precisa de permissões de aplicativo. - ID de recurso errado. O exemplo do moderador usava um ID de exemplo para a entidade de serviço do Microsoft Graph. Depois, ele disse que esse ID varia entre locatários e precisa ser consultado no seu próprio locatário. O tutorial do Graph PowerShell no Learn descreve o
ResourceIdcomo o ID de objeto da entidade de serviço do recurso.
Passo 1: Habilite a identidade gerenciada e anote o ID do objeto
- No portal do Azure, abra a conta de Automation.
- Em Configurações da conta, selecione Identidade.
- Defina Atribuída pelo sistema como Ativado, selecione Salvar e confirme.
A página Identidade mostra o ID do objeto. O Learn também mostra como lê-lo com PowerShell: (Get-AzAutomationAccount -ResourceGroupName $resourceGroup -Name $automationAccount).Identity retorna o PrincipalId. Guarde-o como $MI_ID. Este é o ID do objeto, não o ID do aplicativo.
Passo 2: Descubra qual permissão a chamada precisa
Não chute, e não escolha Directory.ReadWrite.All só porque parece seguro. A página de solução de problemas do Graph PowerShell no Learn mostra como consultar a permissão de um cmdlet. O exemplo de saída dessa página é para acesso delegado, então confirme a permissão de aplicativo na referência de permissões do Graph:
``powershell Find-MgGraphCommand -Command Get-MgUser | Select -First 1 -ExpandProperty Permissions ``
(O exemplo do Learn usa New-MgServicePrincipal no lugar de Get-MgUser.) Para um script que lê a atividade de entrada, a referência de listagem de usuários do Learn diz que a propriedade signInActivity exige uma licença Microsoft Entra ID P1 ou P2 e a permissão AuditLog.Read.All. A página de contas inativas do Learn lista AuditLog.Read.All e User.Read.All. A mesma página indica o Leitor de Relatórios como a função de menor privilégio para os logs de atividade.
Na discussão sobre contas inativas, um moderador da Microsoft sugeriu adicionar a função Leitor de Relatórios ou Leitor de Diretório à identidade, além das permissões AuditLog.Read.All e Directory.Read.All, usando a aba de permissões de API do aplicativo empresarial. O mesmo moderador depois disse que essa aba não aparece para identidades gerenciadas. Nenhuma dessas respostas foi aceita, e o Learn não confirma que uma função de diretório também seja necessária para funções de aplicativo. Comece com as funções de aplicativo e adicione uma função somente se a chamada continuar falhando.
Passo 3: Atribua a função de aplicativo com o Microsoft Graph PowerShell
Você precisa ter o direito de atribuir funções. O tutorial do Graph PowerShell no Learn lista o Administrador de Função Privilegiada, e o artigo da Tech Community diz que a pessoa que executa os scripts precisa ser Administrador Global. Entre como administrador no seu próprio computador ou no Cloud Shell, não no runbook.
A página de identidade gerenciada do Exchange no Learn mostra este padrão, com $MI_ID passado como -ServicePrincipalId e como -PrincipalId. Aqui ele foi adaptado para o Graph. O ID de aplicativo do Graph, 00000003-0000-0000-c000-000000000000, vem da página REST do 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 ``
Observações:
$graph.Idé o ID do objeto da entidade de serviço do Graph no seu locatário. Esse é o valor a usar comoResourceId.- A busca da função segue o padrão do tutorial do Learn, que filtra
AppRolesporValue. A verificação adicional deAllowedMemberTypesvem do artigo da Tech Community, que mantém apenas as funções que permitem o tipo Application. - A página do tutorial do Learn usa uma segunda forma, com o ID do objeto do recurso como
ServicePrincipalIde um parâmetro de corpo. Escolha uma delas e verifique a saída. - A página REST do Learn alerta que apenas usuários apropriados devem ter
AppRoleAssignment.ReadWrite.All, e que as permissões atribuídas dessa forma entram em vigor imediatamente, sem revisão.
O erro da primeira discussão, "Some App Roles are not found on Graph API service principal", vem do script da comunidade. Pela lógica dele, o erro aparece quando o número de funções encontradas é diferente do número de nomes solicitados. Um nome digitado errado, ou um nome que não seja uma função de aplicativo, dispararia o erro. Isso é uma inferência a partir da leitura do script. O artigo não afirma isso.
Para verificar, liste as atribuições na identidade ou consulte a atribuição do Graph no Entra. A página REST da Learn mostra a listagem com GET .../appRoleAssignedTo no recurso.
Etapa 4: use a identidade no runbook
A página do Graph PowerShell da Learn mostra a chamada:
``powershell Connect-MgGraph -Identity Get-MgContext ``
Para uma identidade atribuída pelo usuário, adicione -ClientId com o ID do cliente da identidade. Get-MgContext mostra AuthType, que indica se a sessão é delegada ou somente de aplicativo. Primeiro, importe para a conta de Automation o módulo Microsoft.Graph.Authentication e quaisquer submódulos que você chamar. A página de módulos da Learn descreve os métodos de importação e a escolha da versão de runtime (5.1 ou 7.2), mas não menciona os módulos do Graph.
Mais um ponto da discussão sobre contas inativas. O script usou Connect-AzAccount -Identity e Get-AzADUser com um filtro de SignInActivity. Um moderador da Microsoft sugeriu -Property SignInActivity. As páginas da Learn usadas aqui não confirmam que isso funciona. Para signInActivity, a Learn documenta a requisição do Graph GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity, com tamanho máximo de página de 500. Usar o Graph diretamente é o caminho mais seguro.
Etapa 5: aguarde e teste com um job novo
A página de how-to de identidades gerenciadas da Learn alerta que o cache de tokens pode atrasar as mudanças. Se o runbook ainda falhar logo após a concessão, pare o job, aguarde e inicie um novo. Na primeira discussão, a permissão apareceu no aplicativo empresarial depois que o ID do recurso foi corrigido, mas o runbook continuou falhando. A discussão não diz se o motivo foi o atraso, o tipo de permissão errado ou a permissão ausente.
Como remover uma concessão incorreta
O autor da primeira discussão queria remover permissões concedidas no Graph Explorer e não obteve resposta. Para app roles, o tutorial da Learn mostra Remove-MgServicePrincipalAppRoleAssignedTo, e a página REST mostra um DELETE em appRoleAssignedTo. O script de limpeza do artigo da Tech Community usa Remove-MgServicePrincipalAppRoleAssignment. Para concessões delegadas feitas por meio de oauth2PermissionGrants, a página REST da Learn mostra um PATCH que mantém apenas os escopos listados, ou um DELETE que revoga a concessão inteira.
Limites
- Nenhuma das discussões confirmou uma solução. As etapas aqui seguem a Learn, não um resultado confirmado.
- A página do Exchange da Learn usada para o padrão do cmdlet é escrita para permissões do Exchange, não do Graph. O cmdlet e os parâmetros correspondem ao tutorial do Graph PowerShell, mas faça seu próprio teste.
- Mantenha a permissão restrita. Use
AuditLog.Read.Allpara dados de login, e não uma função de gravação em todo o diretório.
Relacionados
Fontes
- Microsoft Learn: Solucionar erros comuns no Microsoft Graph PowerShell
- Microsoft Learn: Conceder ou revogar permissões de API programaticamente (Graph REST)
- Microsoft Learn: Conceder app roles usando o Microsoft Graph PowerShell
- Microsoft Learn: Atribuir um app role a uma identidade gerenciada
- Microsoft Learn: Habilitar uma identidade gerenciada para o Azure Automation
- Microsoft Learn: Usar identidades gerenciadas do Azure para se conectar ao PowerShell do Exchange Online
- Microsoft Learn: Comandos de autenticação do Microsoft Graph PowerShell
- Microsoft Learn: Tipo de recurso signInActivity
- Microsoft Learn: Listar usuários
- Microsoft Learn: Gerenciar contas de usuário inativas no Microsoft Entra ID
- Microsoft Learn: Gerenciar módulos no Azure Automation
- Microsoft Tech Community: Conceder permissão de API do Graph à identidade gerenciada atribuída pelo sistema do Azure Automation (outubro de 2024)
- Microsoft Q&A: Não é possível conceder permissão de API do Graph ao aplicativo empresarial da identidade gerenciada (setembro de 2025)
- Microsoft Q&A: Automação de runbook do Azure para identificar e listar contas inativas (setembro de 2025)