Assign Reader and Tag Contributor Roles (multiple subscriptions)
You can use Azure Management Groups to grant the Client Portal access to your Azure subscriptions. This approach has the following benefits:
You can assign access to multiple subscriptions in a single step.
If you create more Azure subscriptions in the future, access will be automatically granted. It means when you add an Azure subscription to your tenant, activating it in the Client Portal is unnecessary.
When you onboard your tenant to the Client Portal, an Enterprise Application called SoftwareOne Cloud Consumption (formerly PyraCloud) is created in your tenant. You must then assign the Tag Contributor and Reader roles to this Enterprise Application.
These roles allow the Client Portal to read a list of all the resources in your Azure subscriptions, and read and write tags on those resources. You can choose whether you want the Client Portal to write tags back to resources in your Azure subscription using Cloud Tenant Setup.
Granting access using Azure CLI
Before granting access using Azure CLI, note the following points:
Ensure that you've installed PowerShell and Azure CLI. For installation instructions, see Install PowerShell and Install Azure CLI.
The script utilizes PowerShell variables, therefore, you must execute this script at a PowerShell prompt instead of a normal command prompt.
Use the following commands to onboard your Azure subscriptions:
The following table explains these commands:
az login
Log in to your Microsoft tenant.
az rest --method post --url "/providers/Microsoft.Authorization/elevateAccess?api-version=2016-07-01"
Elevate your permissions to manage all Azure subscriptions and management groups.
az ad sp create --id 2a4807a4-d9e4-457d-b32f-a455e0d3662a
az ad app permission grant --id 2a4807a4-d9e4-457d-b32f-a455e0d3662a --api 00000003-0000-0000-c000-000000000000 --scope "User.Read"
Create the SoftwareOne Cloud Consumption (PyraCloud Azure) service principal/enterprise application in your tenant.
$root_mg=$(az account management-group list --query "[?displayName == 'Tenant Root Group'] | [0] | id" --output tsv)
Get the ID of your Tenant Root Group.
az role assignment create --assignee "2a4807a4-d9e4-457d-b32f-a455e0d3662a" --role "Reader" --scope "$root_mg"
az role assignment create --assignee "2a4807a4-d9e4-457d-b32f-a455e0d3662a" --role "Tag Contributor" --scope "$root_mg"
In your tenant root group, assign the Reader and Tag Contributor roles to the SoftwareOne Cloud Consumption (PyraCloud Azure) application.
Granting access using the Azure Portal
Before granting access through the Azure Portal, note the following points:
Make sure you have onboarded your tenant.
Make sure you have the correct permissions to manage access to all Azure subscriptions and management groups in your tenant. For instructions, see Elevate access to manage all Azure subscriptions and management groups in Microsoft's documentation.
Follow these steps to grant access through Azure:
Search for Management Groups
Launch the Azure Portal and search for Management groups.
On the Management groups page, select Tenant Root Group. Note that regardless of your organization's configuration, you'll always have a Tenant Root Group. It might have been renamed, but it always appears at the top of the hierarchy.
Assign the Reader role
On the Role tab, select Reader as the role and click Next.
On the Members tab, select User, group, or service principal if it's not selected by default, and click Select members.
In the Select members panel, search for SoftwareOne Cloud Consumption (formerly PyraCloud Azure).
Click Select to add the enterprise application to the Members list. Once the app is added, click Review + assign.
On the Review + assign tab, review the details and click Review + assign to confirm the role assignment.
Assign the Tag Contributor role
To assign the Tag Contributor role, follow all the steps in Step 3: Assign the Reader role, but choose Tag Contributor as your role instead of Reader.
After you've completed the steps, the roles are assigned and displayed on the Role assignments tab.
Last updated
Was this helpful?
