Optima uses bill data to provide an accurate view of your costs across accounts and services. This data is consumed by the Optima platform and made available for pre-built and ad-hoc analyses. In order to gather the cost information, certain configuration steps must be performed with specific data and credentials being shared with Optima.

To connect the Azure MCA Cloud Solution Provider to Optima, you need to first obtain data fields from Azure, and then enter those data fields into Optima.

Data Required to Connect Azure MCA to Optima

To successfully connect Azure MCA CSP to Optima, you will need to first register the Azure MCA Partner in Optima, and then register customer(s). To perform these registrations, you must first obtain the following data:

Azure MCA Partner

Required Data Data Field Name
Application ID application_id
Application Directory ID application_directory_id
Application Secret Key application_secret
Billing Account ID billing_account_id
Microsoft Partner Network ID (MPN ID) mpn_id


Required Data Data Field Name
Azure Tenant ID customer_tenant_id

Obtaining Required Data

To obtain the required application data fields from Azure, perform the following steps:

  1. Open the Microsoft Partner Center: https://partner.microsoft.com/en-us/pcv/apiintegration/appmanagement
  2. In the top right corner, click the gear icon then select Azure AD profile.
  3. Under Account Settings, select App management.
  4. Select your desired Web App, and locate and copy the following information:
Data Field Location
Application ID Listed under the new native app in the App ID field.
Application Directory ID Listed in the Account ID field.
Application Secret Key Listed below, as a key.

NOTE: The application secret keys are like passwords with longer expiry. We recommend saving this in a secure location for future use.

Application Data Fields and Assigning Application Permissions

To assign application permissions in Azure, perform the following steps.

  1. Open your Microsoft Azure MCA portal
  1. Click + Add. The Add Permission panel opens.
  2. In the Select box, enter the name of your application from before.
  3. Select the name of your application, and in the Role box select Billing account reader.
  4. Click Save.

Billing Account ID

To obtain the Billing Account ID from Azure, perform the following steps.

  1. Open the following Microsoft Azure URL

  2. In the Cost Management panel, navigate to Go to billing account.

  3. Click Settings > Properties. On this page, the Billing Account ID can be found in the Billing Account Name field. The Billing Account ID is the first part of the Billing Account Name (everything before the first semicolon).


If the full Billing Account Name is 1bc3aca-5016-4db0-a6bc-1111fccdf72b:5efda3d-936b-4534-99cf-46b0d0a1211e_2018-09-30, then the Billing Account ID is 1bc3aca-5016-4db0-a6bc-1111fccdf72b.


To obtain the MPN ID from Azure, perform the following steps.

  1. Open this Microsoft Azure URL

  2. Copy the MPN ID from the right side of the page.

Customer Tenant ID

To obtain the Customer Tenant ID from Azure, perform the following steps.

  1. Open this Microsoft Azure URL
  2. Navigate to the desired customer and then to the Account section for the customer.
  3. Locate and copy the ID in the Customer account info > Microsoft ID field; this is the needed Customer Tenant ID.

Connecting Azure MCA Cloud Solution Provider in Optima

To connect Azure MCA Cloud Solution Provider in Optima, perform the following steps.

  1. Open Optima.
  2. Open the Settings view and click ADD A CLOUD BILL in the upper right corner.
  3. Choose Microsoft Azure.
  4. Choose MCA Partner (under the Microsoft Customer Agreement heading).
  5. On this view, enter the following information, which you obtained in Obtaining the Required Data Fields from Azure:
    • Application ID
    • Directory ID
    • Application Secret Key
    • Billing Account ID
    • Microsoft Partner Network ID
    • Insert Azure Tenant ID(s)
  6. Click CONTINUE to connect.