Integrate Your Microsoft Tenant Manually

This topic describes how to manually integrate your Azure tenant and assign the Reader and Tag Contributor roles to the Client Portal using Azure Management Groups.

Integrating a Microsoft tenant involves the following steps:

1. Granting consent to the Client Portal in your Azure tenant.

2. Assigning the Tag Contributor and Reader access roles to the Client Portal using Azure Management Groups. The Tag Contributor and Reader roles allow the Client Portal to read a list of all the resources in your Azure subscription, and read and write tags on those resources. You can control whether you want the Client Portal to write tags back to resources in your Azure subscription. For more information, see Syncing your tags to Azure.

3. Providing the details to SoftwareOne to complete your onboarding.

Granting consent through your Azure tenant

Follow these steps to grant consent through your Azure tenant:

1. Select one of the following links:

   • Azure

   • Office365

2. On the Permissions Requested page, review the permissions, and select Accept.

3. After granting consent, launch the Azure Portal and navigate to Azure Active Directory > Enterprise applications to make sure that SoftwareOne Cloud Consumption (formerly PyraCloud) is listed in your enterprise applications.

Assigning the Tag Contributor and Reader access roles

Follow these steps to assign the Tag Contributor and Reader access roles:

1. Launch the Azure Portal and search for Management groups.

2. On the Management groups page, select Start using management groups.

3. Provide the Group ID and a display name for your group. Select Submit. The new group is created and displayed under the Tenant Root Group.

4. Select the newly created management group and then from the left sidebar, select Access Control (IAM).

5. Navigate to Role assignments and select Add > Add role assignment from the dropdown.

6. Assign the Reader role to the Client Portal:

   1. Choose Reader from the list of roles and select Next.

   2. On the Members tab, click Select Members.

   3. Search for SoftwareOne Cloud Consumption (formerly PyraCloud Azure for Azure or PyraCloud Office 365 for Office 365) and then select it from the search results. Click Save.

7. Assign the Tag Contributor role to the Client Portal:

   1. Choose Tag Contributor from the list of roles. Select Next.

   2. On the Members tab, click Select Members.

   3. Search for SoftwareOne Cloud Consumption (formerly PyraCloud Azure for Azure or PyraCloud Office 365 for Office 365) and then select it from the search results. Click Save.

8. Select Review + assign and then Review + assign again. The new roles are displayed on the page.

Providing the details to SoftwareOne

After you’ve completed the integration steps, provide the following details so we can complete the onboarding of your tenant:

• Your Microsoft Tenant ID (or domain).

• A friendly name for your tenant to recognize easily across the Client Portal.

• The start and end date of your Enterprise Agreement.

After we have added your tenant, you'll need to provide an access token from the EA Portal. For information on how to provide an access token, see Add an Access Token.