Le runbook Azure Automation renvoie « Insufficient Privileges » lors de l’appel à Microsoft Graph : attribuez des rôles d’application à l’identité managée
Par Mirko Peters ·
Un runbook qui s’authentifie avec son identité managée échoue sur les appels Graph avec Authorization_RequestDenied. Tant que vous n’avez pas attribué de rôles d’application avec PowerShell, cette identité ne dispose d’aucune autorisation Graph.
Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais
Un runbook Azure Automation se connecte à Microsoft Graph avec son identité managée. La connexion réussit. Le premier appel échoue avec [Authorization_RequestDenied] : Insufficient privileges to complete the operation.
Points clés
- Une identité managée démarre sans aucune autorisation Microsoft Graph. Les runbooks non supervisés ont besoin d’autorisations d’application (rôles d’application), et non de permissions déléguées.
- Signalé dans des sources communautaires : le portail ne permet pas d’accorder ces autorisations à une identité managée. Attribuez le rôle d’application avec Microsoft Graph PowerShell ou REST, en utilisant des ID d’objet et non des ID d’application.
- L’ID de ressource est l’ID d’objet de l’entité de service Microsoft Graph dans votre propre locataire. Ne recopiez pas un ID figurant dans un exemple.
- N’accordez que le rôle dont le script a besoin. Learn avertit que les rôles d’application attribués de cette façon prennent effet immédiatement et ne font l’objet d’aucune vérification.
Deux fils Microsoft Q&A de septembre 2025 décrivent ce problème. Dans le premier, un membre de la communauté a suivi un article de la Tech Community pour accorder des autorisations Graph et a rencontré des erreurs dans le script. Dans le second, un runbook censé lister les utilisateurs Entra ID inactifs a échoué de la même manière. Aucun de ces fils ne s’est conclu par une confirmation. Cet article rassemble les éléments issus de Microsoft Learn et signale ce que les fils ne faisaient que rapporter. Il ne s’agit pas d’une procédure officielle de Microsoft.
Pourquoi l’erreur apparaît
Une identité managée attribuée par le système est une entité de service dans Entra ID. Son activation donne une identité au runbook, mais aucune autorisation Graph. Un article de la Tech Community Microsoft d’octobre 2024 indique que l’identité ne dispose d’aucune autorisation Graph par défaut et que le bouton « Accorder le consentement de l'administrateur » du portail est désactivé pour elle.
La page de dépannage PowerShell de Graph sur Learn indique que la plupart des erreurs d’autorisation renvoient un code 403 et que la cause habituelle est une autorisation manquante. Pour un accès sans utilisateur, elle recommande de préconfigurer des autorisations d’application ou d’attribuer des rôles d’application avec New-MgServicePrincipalAppRoleAssignment.
Deux erreurs sont apparues dans ces fils de discussion et sont faciles à reproduire :
- Mauvais type d’autorisation. La première suggestion du fil, émanant d’un modérateur Microsoft, accordait des autorisations déléguées via
oauth2PermissionGrants. Le même modérateur a précisé plus tard qu’un runbook obtient son jeton sans interaction utilisateur et qu’il a donc besoin d’autorisations d’application. - Mauvais ID de ressource. L’exemple du modérateur utilisait un ID fictif pour l’entité de service Microsoft Graph. Le modérateur a ensuite indiqué que cet ID diffère d’un locataire à l’autre et doit être recherché dans votre propre locataire. Le tutoriel PowerShell de Graph sur Learn décrit
ResourceIdcomme l’ID d’objet de l’entité de service de la ressource.
Étape 1 : activer l’identité managée et noter son ID d’objet
- Dans le portail Azure, ouvrez le compte Automation.
- Sous Paramètres du compte, sélectionnez Identité.
- Réglez Affecté par le système sur Activé, sélectionnez Enregistrer, puis confirmez.
La page Identité affiche l’ID d’objet. La documentation Learn montre aussi comment le lire avec PowerShell : (Get-AzAutomationAccount -ResourceGroupName $resourceGroup -Name $automationAccount).Identity renvoie le PrincipalId. Conservez-le dans $MI_ID. Il s’agit de l’ID d’objet, et non de l’ID d’application.
Étape 2 : déterminer l’autorisation dont l’appel a besoin
Ne devinez pas, et ne choisissez pas Directory.ReadWrite.All parce qu’il semble sûr. La page de dépannage de Graph PowerShell sur Learn montre comment rechercher l’autorisation d’une applet de commande. Son exemple de sortie concerne l’accès délégué ; vérifiez donc l’autorisation d’application dans la référence des autorisations Graph :
``powershell Find-MgGraphCommand -Command Get-MgUser | Select -First 1 -ExpandProperty Permissions ``
(L’exemple de Learn utilise New-MgServicePrincipal à la place de Get-MgUser.) Pour un script qui lit l’activité de connexion, la référence de la liste des utilisateurs indique que la propriété signInActivity nécessite une licence Microsoft Entra ID P1 ou P2 ainsi que l’autorisation AuditLog.Read.All. La page sur les comptes inactifs de Learn répertorie AuditLog.Read.All et User.Read.All, et indique que le rôle le moins privilégié pour les journaux d’activité est Lecteur des rapports.
Dans le fil de discussion sur les comptes inactifs, un modérateur Microsoft a suggéré d’ajouter à l’identité le rôle Lecteur des rapports ou Lecteur de l’annuaire, ainsi que les autorisations AuditLog.Read.All et Directory.Read.All, via l’onglet Autorisations d’API de l’application d’entreprise. Le même modérateur a précisé plus tard que cet onglet n’est pas affiché pour les identités managées. Aucune de ces réponses n’a été retenue, et Learn ne confirme pas qu’un rôle d’annuaire soit aussi nécessaire pour les rôles d’application. Commencez par les rôles d’application, et n’ajoutez un rôle que si l’appel échoue toujours.
Étape 3 : attribuer le rôle d’application avec Microsoft Graph PowerShell
Vous devez disposer du droit d’attribuer des rôles. Le tutoriel Graph PowerShell de Learn mentionne Administrateur de rôles privilégiés, et l’article de Tech Community indique que la personne qui exécute ses scripts doit être Administrateur général. Connectez-vous en tant qu’administrateur sur votre propre ordinateur ou dans Cloud Shell, et non dans le runbook.
La page de Learn sur les identités managées pour Exchange montre ce schéma, avec $MI_ID transmis à la fois comme -ServicePrincipalId et -PrincipalId. Il est ici adapté à Graph. L’ID d’application Graph 00000003-0000-0000-c000-000000000000 provient de la page REST de 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 ``
Remarques :
$graph.Idest l’ID d’objet du principal de service Graph dans votre locataire. C’est la valeur à utiliser pourResourceId.- La recherche du rôle suit le schéma du tutoriel de Learn, qui filtre
AppRolesparValue. La vérification supplémentaire surAllowedMemberTypesprovient de l’article de Tech Community, qui ne conserve que les rôles acceptant le type Application. - La page du tutoriel de Learn utilise une seconde forme, avec l’ID d’objet de la ressource comme
ServicePrincipalIdet un paramètre de corps. Choisissez l’une des deux et vérifiez la sortie. - La page REST de Learn précise que seuls les utilisateurs appropriés doivent détenir
AppRoleAssignment.ReadWrite.All, et que les autorisations attribuées de cette façon prennent effet immédiatement, sans revue.
L’erreur du premier fil, « Some App Roles are not found on Graph API service principal », provient du script communautaire. D’après sa logique, elle se déclenche lorsque le nombre de rôles trouvés diffère du nombre de noms demandés. Un nom mal orthographié, ou un nom qui n’est pas un rôle d’application, la provoquerait. Il s’agit d’une déduction issue de la lecture du script ; l’article ne le précise pas.
Pour vérifier, listez les affectations de l'identité ou consultez l'affectation Graph dans Entra. La page REST de Learn présente la liste avec GET .../appRoleAssignedTo sur la ressource.
Étape 4 : utiliser l'identité dans le runbook
La page Learn consacrée à Graph PowerShell présente l'appel suivant :
``powershell Connect-MgGraph -Identity Get-MgContext ``
Pour une identité affectée par l'utilisateur, ajoutez -ClientId avec l'ID client de cette identité. Get-MgContext affiche AuthType, qui indique si la session est déléguée ou uniquement basée sur une application. Importez d'abord dans le compte Automation le module Microsoft.Graph.Authentication, ainsi que les sous-modules que vous appelez. La page Learn consacrée aux modules décrit les méthodes d'importation et le choix de la version du runtime (5.1 ou 7.2), mais elle ne mentionne pas les modules Graph.
Un point supplémentaire issu du fil sur les comptes inactifs : le script utilisait Connect-AzAccount -Identity et Get-AzADUser avec un filtre SignInActivity. Un modérateur Microsoft a suggéré -Property SignInActivity. Les pages Learn utilisées ici ne confirment pas que cela fonctionne. Pour signInActivity, Learn documente la requête Graph GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity, avec une taille de page maximale de 500. Passer directement par Graph reste la solution la plus sûre.
Étape 5 : patientez, puis testez avec une nouvelle tâche
La page Learn consacrée aux identités managées met en garde contre la mise en cache des jetons, qui peut retarder la prise en compte des modifications. Si le runbook échoue encore juste après l'octroi, arrêtez la tâche, patientez, puis lancez-en une nouvelle. Dans le premier fil, l'autorisation apparaissait sur l'application d'entreprise après la correction de l'ID de ressource, mais le runbook échouait toujours. Le fil ne précise pas si la cause était le délai, le mauvais type d'autorisation ou l'autorisation manquante.
Supprimer un octroi erroné
L'auteur du premier fil voulait supprimer les autorisations accordées dans Graph Explorer, sans obtenir de réponse. Pour les rôles d'application, le tutoriel Learn montre Remove-MgServicePrincipalAppRoleAssignedTo, et la page REST présente un DELETE sur appRoleAssignedTo. Le script de nettoyage de l'article Tech Community utilise Remove-MgServicePrincipalAppRoleAssignment. Pour les autorisations déléguées accordées via oauth2PermissionGrants, la page REST de Learn présente un PATCH qui ne conserve que les étendues listées, ou un DELETE qui révoque l'octroi complet.
Limites
- Aucun des deux fils n'a confirmé de correctif. Les étapes décrites ici reposent sur la documentation Learn, et non sur un résultat avéré.
- La page Learn consacrée à Exchange, utilisée pour le modèle de cmdlet, est rédigée pour les autorisations Exchange et non pour Graph. La cmdlet et ses paramètres correspondent au tutoriel Graph PowerShell, mais effectuez votre propre test.
- Limitez les autorisations au strict nécessaire. Utilisez
AuditLog.Read.Allpour les données de connexion, et non un rôle d'écriture à l'échelle de l'annuaire.
Voir aussi
Sources
- Microsoft Learn : Résoudre les erreurs courantes dans Microsoft Graph PowerShell
- Microsoft Learn : Accorder ou révoquer des autorisations d'API par programmation (REST Graph)
- Microsoft Learn : Accorder des rôles d'application avec Microsoft Graph PowerShell
- Microsoft Learn : Affecter un rôle d'application à une identité managée
- Microsoft Learn : Activer une identité managée pour Azure Automation
- Microsoft Learn : Utiliser les identités managées Azure pour se connecter à Exchange Online PowerShell
- Microsoft Learn : Commandes d’authentification de Microsoft Graph PowerShell
- Microsoft Learn : Type de ressource signInActivity
- Microsoft Learn : Lister les utilisateurs
- Microsoft Learn : Gérer les comptes utilisateur inactifs dans Microsoft Entra ID
- Microsoft Learn : Gérer les modules dans Azure Automation
- Microsoft Tech Community : Accorder l’autorisation Graph API à l’identité managée affectée par le système d’Azure Automation (octobre 2024)
- Microsoft Q&A : Impossible d’accorder l’autorisation Graph API à l’application d’entreprise de l’identité managée (septembre 2025)
- Microsoft Q&A : Automatisation de runbook Azure pour identifier et lister les comptes inactifs (septembre 2025)