Onboard a Microsoft Azure subscription

This article describes how to onboard a Microsoft Azure subscription or subscriptions on Permissions Management. Onboarding a subscription creates a new authorization system to represent the Azure subscription in Permissions Management.

Note

A global administrator or root user (an admin for all authorization system types) can perform the tasks in this article after the global administrator has initially completed the steps provided in Enable Permissions Management on your Azure Active Directory tenant.

Explanation

The Permissions Management service is built on Azure, and given you're onboarding your Azure subscriptions to be monitored and managed, setup is simple with few moving parts to configure. Below is what is required to configure onboarding:

  • When your tenant is onboarded, an application is created in the tenant.
  • This app requires 'reader' permissions on the subscriptions
  • For controller functionality, the app requires 'User Access Administrator' to create and implement right-size roles

Prerequisites

To add Permissions Management to your Azure AD tenant:

  • You must have an Azure AD user account and an Azure command-line interface (Azure CLI) on your system, or an Azure subscription. If you don't already have one, create a free account.
  • You must have Microsoft.Authorization/roleAssignments/write permission at the subscription or management group scope to perform these tasks. If you don't have this permission, you can ask someone who has this permission to perform these tasks for you.

How to onboard an Azure subscription

  1. If the Data Collectors dashboard isn't displayed when Permissions Management launches:

    • In the Permissions Management home page, select Settings (the gear icon, top right), and then select the Data Collectors subtab.
  2. On the Data Collectors dashboard, select Azure, and then select Create Configuration.

1. Add Azure subscription details

Choose from three options to manage Azure subscriptions.

Option 1: Automatically manage

This option allows subscriptions to be automatically detected and monitored without further work required. A key benefit of automatic management is that any current or future subscriptions found will be onboarded automatically. The steps to detect a list of subscriptions and onboard for collection are as follows:

  • Firstly, grant Reader role to Cloud Infrastructure Entitlement Management application at management group or subscription scope. To do this:
  1. In the EPM portal, left-click the cog on the top right-hand side.

  2. Navigate to data collectors tab

  3. Ensure 'Azure' is selected

  4. Click ‘Create Configuration’

  5. For onboarding mode, select ‘Automatically Manage’

    Note

    The steps listed on the screen outline how to create the role assignment for the Cloud Infrastructure Entitlements Management application. This can be performed manually in the Entra console, or programatically with PowerShell or the Azure CLI.

  • Once complete, Click ‘Verify Now & Save’

To view status of onboarding after saving the configuration:

  1. Collectors will now be listed and change through status types. For each collector listed with a status of “Collected Inventory”, click on that status to view further information.
  2. You can then view subscriptions on the In Progress page

Option 2: Enter authorization systems

You have the ability to specify only certain subscriptions to manage and monitor with MEPM (up to 10 per collector). Follow the steps below to configure these subscriptions to be monitored:

  1. For each subscription you wish to manage, ensure that the ‘Reader’ role has been granted to Cloud Infrastructure Entitlement Management application for the subscription.
  2. In the EPM portal, click the cog on the top right-hand side.
  3. Navigate to data collectors tab
  4. Ensure 'Azure' is selected
  5. Click ‘Create Configuration’
  6. Select ‘Enter Authorization Systems’
  7. Under the Subscription IDs section, enter a desired subscription ID into the input box. Click the “+” up to nine extra times, putting a single subscription ID into each respective input box.
  8. Once you have input all of the desired subscriptions, click next
  9. Click ‘Verify Now & Save’
  10. Once the access to read and collect data is verified, collection will begin.

To view status of onboarding after saving the configuration:

  1. Navigate to data collectors tab.
  2. Click on the status of the data collector.
  3. View subscriptions on the In Progress page

Option 3: Select authorization systems

This option detects all subscriptions that are accessible by the Cloud Infrastructure Entitlement Management application.

  • Firstly, grant Reader role to Cloud Infrastructure Entitlement Management application at management group or subscription scope.
  1. In the EPM portal, click the cog on the top right-hand side.

  2. Navigate to data collectors tab

  3. Ensure 'Azure' is selected

  4. Click ‘Create Configuration’

  5. For onboarding mode, select ‘Automatically Manage’

    Note

    The steps listed on the screen outline how to create the role assignment for the Cloud Infrastructure Entitlements Management application. You can do this manually in the Entra console, or programatically with PowerShell or the Azure CLI.

  • Once complete, Click ‘Verify Now & Save’

To view status of onboarding after saving the configuration:

  1. Navigate to newly create Data Collector row under Azure data collectors.
  2. Click on Status column when the row has “Pending” status
  3. To onboard and start collection, choose specific ones subscriptions from the detected list and consent for collection.

2. Review and save.

  • In Permissions Management Onboarding – Summary page, review the information you've added, and then select Verify Now & Save.

    The following message appears: Successfully Created Configuration.

    On the Data Collectors tab, the Recently Uploaded On column displays Collecting. The Recently Transformed On column displays Processing.

    You have now completed onboarding Azure, and Permissions Management has started collecting and processing your data.

3. View the data.

  • To view the data, select the Authorization Systems tab.

    The Status column in the table displays Collecting Data.

    The data collection process will take some time, depending on the size of the account and how much data is available for collection.

Next steps