Elevate access to manage all Azure subscriptions and management groups
Article
As a Global Administrator in Microsoft Entra ID, you might not have access to all subscriptions and management groups in your directory. This article describes the ways that you can elevate your access to all subscriptions and management groups.
If you are a Global Administrator, there might be times when you want to do the following actions:
Regain access to an Azure subscription or management group when a user has lost access
Grant another user or yourself access to an Azure subscription or management group
See all Azure subscriptions or management groups in an organization
Allow an automation app (such as an invoicing or auditing app) to access all Azure subscriptions or management groups
How does elevated access work?
Microsoft Entra ID and Azure resources are secured independently from one another. That is, Microsoft Entra role assignments do not grant access to Azure resources, and Azure role assignments do not grant access to Microsoft Entra ID. However, if you are a Global Administrator in Microsoft Entra ID, you can assign yourself access to all Azure subscriptions and management groups in your directory. Use this capability if you don't have access to Azure subscription resources, such as virtual machines or storage accounts, and you want to use your Global Administrator privilege to gain access to those resources.
When you elevate your access, you will be assigned the User Access Administrator role in Azure at root scope (/). This allows you to view all resources and assign access in any subscription or management group in the directory. User Access Administrator role assignments can be removed using Azure PowerShell, Azure CLI, or the REST API.
You should remove this elevated access once you have made the changes you need to make at root scope.
Under Access management for Azure resources, set the toggle to Yes.
When you set the toggle to Yes, you are assigned the User Access Administrator role in Azure RBAC at root scope (/). This grants you permission to assign roles in all Azure subscriptions and management groups associated with this Microsoft Entra directory. This toggle is only available to users who are assigned the Global Administrator role in Microsoft Entra ID.
When you set the toggle to No, the User Access Administrator role in Azure RBAC is removed from your user account. You can no longer assign roles in all Azure subscriptions and management groups that are associated with this Microsoft Entra directory. You can view and manage only the Azure subscriptions and management groups to which you have been granted access.
Note
If you're using Privileged Identity Management, deactivating your role assignment does not change the Access management for Azure resources toggle to No. To maintain least privileged access, we recommend that you set this toggle to No before you deactivate your role assignment.
Click Save to save your setting.
This setting is not a global property and applies only to the currently signed in user. You can't elevate access for all members of the Global Administrator role.
Sign out and sign back in to refresh your access.
You should now have access to all subscriptions and management groups in your directory. When you view the Access control (IAM) pane, you'll notice that you have been assigned the User Access Administrator role at root scope.
Make the changes you need to make at elevated access.
Perform the steps in the following section to remove your elevated access.
Step 2: Remove elevated access
To remove the User Access Administrator role assignment at root scope (/), follow these steps.
Sign in as the same user that was used to elevate access.
In the navigation list, click Microsoft Entra ID and then click Properties.
Set the Access management for Azure resources toggle back to No. Since this is a per-user setting, you must be signed in as the same user as was used to elevate access.
If you try to remove the User Access Administrator role assignment on the Access control (IAM) pane, you'll see the following message. To remove the role assignment, you must set the toggle back to No or use Azure PowerShell, Azure CLI, or the REST API.
Sign out as Global Administrator.
If you are using Privileged Identity Management, deactivate your Global Administrator role assignment.
Note
If you're using Privileged Identity Management, deactivating your role assignment does not change the Access management for Azure resources toggle to No. To maintain least privileged access, we recommend that you set this toggle to No before you deactivate your role assignment.
Step 1: Elevate access for a Global Administrator
Use the Azure portal or REST API to elevate access for a Global Administrator.
Step 2: List role assignment at root scope (/)
Once you have elevated access, to list the User Access Administrator role assignment for a user at root scope (/), use the Get-AzRoleAssignment command.
To remove the User Access Administrator role assignment for yourself or another user at root scope (/), follow these steps.
Sign in as a user that can remove elevated access. This can be the same user that was used to elevate access or another Global Administrator with elevated access at root scope.
Use the Remove-AzRoleAssignment command to remove the User Access Administrator role assignment.
Perform the steps in a later section to remove your elevated access.
Step 2: List role assignment at root scope (/)
Once you have elevated access, to list the User Access Administrator role assignment for a user at root scope (/), use the az role assignment list command.
az role assignment list --role "User Access Administrator" --scope "/"
To remove the User Access Administrator role assignment for yourself or another user at root scope (/), follow these steps.
Sign in as a user that can remove elevated access. This can be the same user that was used to elevate access or another Global Administrator with elevated access at root scope.
Perform the steps in a later section to remove your elevated access.
Step 2: List role assignments at root scope (/)
Once you have elevated access, you can list all of the role assignments for a user at root scope (/).
Call Role Assignments - List For Scope where {objectIdOfUser} is the object ID of the user whose role assignments you want to retrieve.
GET https://management.azure.com/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01&$filter=principalId+eq+'{objectIdOfUser}'
Step 3: List deny assignments at root scope (/)
Once you have elevated access, you can list all of the deny assignments for a user at root scope (/).
Call Deny Assignments - List For Scope where {objectIdOfUser} is the object ID of the user whose deny assignments you want to retrieve.
GET https://management.azure.com/providers/Microsoft.Authorization/denyAssignments?api-version=2022-04-01&$filter=gdprExportPrincipalId+eq+'{objectIdOfUser}'
Step 4: Remove elevated access
When you call elevateAccess, you create a role assignment for yourself, so to revoke those privileges you need to remove the User Access Administrator role assignment for yourself at root scope (/).
Call Role Definitions - Get where roleName equals User Access Administrator to determine the name ID of the User Access Administrator role.
GET https://management.azure.com/providers/Microsoft.Authorization/roleDefinitions?api-version=2022-04-01&$filter=roleName+eq+'User Access Administrator'
Save the ID from the name parameter, in this case 18d7d88d-d35e-4fb5-a5c3-7773c20a72d9.
You also need to list the role assignment for the directory administrator at directory scope. List all assignments at directory scope for the principalId of the directory administrator who made the elevate access call. This will list all assignments in the directory for the objectid.
GET https://management.azure.com/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01&$filter=principalId+eq+'{objectid}'
Note
A directory administrator should not have many assignments, if the previous query returns too many assignments, you can also query for all assignments just at directory scope level, then filter the results:
GET https://management.azure.com/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01&$filter=atScope()
The previous calls return a list of role assignments. Find the role assignment where the scope is "/" and the roleDefinitionId ends with the role name ID you found in step 1 and principalId matches the objectId of the directory administrator.
View elevate access log entries in the Directory Activity logs
When access is elevated, an entry is added to the logs. As a Global Administrator in Microsoft Entra ID, you might want to check when access was elevated and who did it. Elevate access log entries do not appear in the standard activity logs, but instead appear in the Directory Activity logs. This section describes different ways that you can view the elevate access log entries.
View elevate access log entries using the Azure portal
Sign in to the Azure portal as a Global Administrator.
Open Monitor > Activity log.
Change the Activity list to Directory Activity.
Search for the following operation, which signifies the elevate access action.
Assigns the caller to User Access Administrator role
View elevate access log entries using Azure CLI
Use the az login command to sign in as Global Administrator.
Use the az rest command to make the following call where you will have to filter by a date as shown with the example timestamp and specify a filename where you want the logs to be stored.
The url calls an API to retrieve the logs in Microsoft.Insights. The output will be saved to your file.
az rest --url "https://management.azure.com/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2021-09-10T20:00:00Z'" > output.txt
In the output file, search for elevateAccess.
The log will resemble the following where you can see the timestamp of when the action occurred and who called it.
Delegate access to a group to view elevate access log entries using Azure CLI
If you want to be able to periodically get the elevate access log entries, you can delegate access to a group and then use Azure CLI.
Open Microsoft Entra ID > Groups.
Create a new security group and note the group object ID.
Use the az login command to sign in as Global Administrator.
Use the az role assignment create command to assign the Reader role to the group who can only read logs at the directory level, which are found at Microsoft/Insights.
az role assignment create --assignee "{groupId}" --role "Reader" --scope "/providers/Microsoft.Insights"
Add a user who will read logs to the previously created group.
A user in the group can now periodically run the az rest command to view elevate access log entries.
az rest --url "https://management.azure.com/providers/Microsoft.Insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2021-09-10T20:00:00Z'" > output.txt