Skip to main content
With the Azure MCA integration, you allow the Vantage service principal to have access at the billing scope level.
When you configure this integration, the Vantage service principal is granted billing account reader permissions. The service principal does not have permissions—nor will it ever attempt—to make any changes to your infrastructure.
You must have a Vantage Organization Owner or Integration Owner role to add or remove this integration. See the Role-Based Access Control documentation for details.
To integrate your Azure MCA account with Vantage, follow the below steps:

Create a new application registration

Generate a client secret

Obtain your billing account ID

Assign the billing account reader role to the service principal

Add app registration credentials to the Vantage console

​
Step 1 - Create a New Application Registration

1
From the main page of the Azure portal, search for and navigate to Microsoft Entra ID.
2
In the left navigation, under Manage, select App registrations.
3
Click + New registration.
Azure portal with App Registration menu option selected
4
The Register an application screen is displayed. For Name, enter vantage.
5
Leave all other settings as their defaults and click Register.
Azure portal the Register an application screen and vantage entered as app name
6
The app details are displayed. Record the Application (client) ID and Directory (tenant) ID to use later.
Azure portal with the client ID and tenant ID displayed and highlighted

​
Step 2 - Generate a Client Secret

1
On the same page, next to the Client credentials field, click Add a certificate or secret. (You can also access the Certificates and secrets screen from the left navigation menu.)
2
Click + New client secret.
3
The Add a client secret pane is displayed. For Description, enter a description, such as vantage-secret.
Azure portal with the Azure client secret window open and a new secreted created called vantage-secret
4
For Expires, select an expiration option for the secret.
If this secret expires, you will need to supply Vantage with a new secret before the expiration date.
5
Click Add.
6
The newly created secret is displayed. Copy the secret’s Value to add to the Vantage console later. This value will be displayed only one time.

​
Step 3 - Obtain Your Billing Account ID

1
Navigate to Cost Management + Billing.
2
On the left menu, click Billing scopes and select your MCA Billing Account from the list.
3
On the left menu, click Settings > Properties.
4
Copy your Billing account id to add to the Vantage console later.
Azure portal with the billing account id highlighted Source: Microsoft

​
Step 4 - Assign the Billing Account Reader Role to the Service Principal

1
From the left menu, select Access Control (IAM).
2
At the top, click Add.
3
On the right Add role assignment pane, select Billing account reader.
Adding the billing account reader role for the service principal
4
Under Users, groups, or apps, search for and select the vantage service principal that was generated when you created the app registration in step 1.
5
Click Add.

​
Step 5 - Add App Registration Credentials to Vantage

1
Navigate to the Integrations page in the Vantage console, and add an Azure integration.
2
On the Azure integration page, click Add Credentials.
3
Add the following credentials:
  • For Azure AD Tenant ID, add the Directory (tenant) ID you obtained in step 1.
  • For Service Principal App ID, add the Application (client) ID you obtained in step 1.
  • For Service Principal Password, add the client secret you obtained in step 2.
  • For Billing Account Id, add the Billing Account Id you obtained in step 3.
4
Click Connect Account.
After completing the connection, you will see the status of your integration change to Importing within the Vantage console. This status indicates that Vantage is actively importing your Azure cost data. See the Integration Status documentation for details on integration statuses.

​
Optional Azure Reservations and Savings Plans

The Azure MCA integration steps on this page are sufficient for importing Azure cost data into Vantage. If you also want Azure Reservations and Azure Savings Plans to appear on the Commitments page, continue to Optional Azure Reservations and Savings Plans and complete the additional permission steps there.

​
Update Your Client Secret

If you need to update your Azure MCA integration’s client secret, see the Update Your Client Secret section in the main Azure connection documentation for detailed instructions.

​
Next Steps - Workspace Access

Once the import is complete and the integration status changes to Stable, you can select which workspaces this integration is associated with. See the Workspaces documentation for information.