Configuring Parameters

To populate the configuration parameters with the correct values, complete the following steps:

  1. Log in to the CloudBlue Connect Distributor Portal.
  2. Go to Products and select the Azure NCE product.
  3. Click Configuration and filter the parameters by scope (marketplace) to see the configuration parameters for the required marketplace.

  4. Assign the proper value to each parameter.

In the following table you can see a description of the parameters and detailed information on where to obtain the required values.

ID:

tenant_id

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID:

client_id

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID: client_secret

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID:

refresh_token

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID:

refresh_token_date

Important: Credentials must now be managed in the Microsoft Management Settings extension. Please refer to the Microsoft Management Settings documentation for additional information.

ID: transtion_mode
Scope: Marketplace
Description: Configure this parameter to indicate the transition mode to be used to make Azure transitions: No transitions (the transition can only be done in the Partner Center) or Only One (this should be selected if the customer owns only one legacy subscription and he chooses to import such subscription. If the customer has more than one legacy subscription and he tries to import one of them, it will not be possible to proceed with this option. In that case, it will be necessary to complete the process from the Partner Center).
ID: usage_exchange_rate_list
Scope: Marketplace
Description:

This parameter allows you to configure your own custom usage exchange rates instead of using the Microsoft Azure API exchange rate. The exchange rates must be specified in json format.

Please bear in mind that calculations will be made by converting the amount specified in the Microsoft invoice into dollars first, and then into the destination currency. Therefore, you will need to specify two currency exchange rates: the original currency, which will be converted into dollars, and the final currency. However, if the Microsoft invoice is in USD, you will only need to specify one currency exchange rate, which will be the final currency that dollars will be converted to.

Furthermore, please bear in mind that currency rates must be configured as "USDPerUnit" to specify the number of US dollars that corresponds to one unit of the other currency.

In the table bellow you can see some examples of the conversions:

Original Currency Destination Currency Example of Exchange Rate Value to be Configured
USD HKD 0.13 {"HKD":0.13}
USD ILS 0.30 {"ILS":0.30}
USD ZAR 0.07 {"ZAR":0.07)
EUR CHF 1.19, 1.09 {"EUR":1.19,"CHF":1.09}
ID: acm_activation
Scope: Marketplace
Description: It allows you to specify if the Azure Cost Management tool should be enabled or not.
ID: sales_model
Scope: Marketplace
Description: Specify the Sales Model contract that this marketplace has with Microsoft: Direct and Indirect Partner or only Direct Partner.
  • Direct and Indirect partner: If the indirect 2-tier direct billed partner is selling to indirect resellers.

  • Direct partner: If the direct 1-tier direct billed partner is selling to customers.

This parameter is used to make partner attestation required for vendors selling both in the indirect and direct sales models with the same credentials.

ID: transition_required_message
Scope: Marketplace
Description: Message that will be displayed when the transition to NCE needs to be done manually on the Partner Center. For Example: "Your Microsoft account has one or more Legacy Azure subscriptions, and an automated transition to NCE cannot be processed. Please contact your service distributor for assistance."
ID: ownership_validation_list
Scope: Marketplace
Description:

This parameter is used to configure the processor to skip the validation of the domain owner in the requests by specifying an external ID, Hub ID and a domain. This will be necessary when the processor is unable to validate the owner of a domain and the distributor will need to complete such validation manually.

Once the distributor has validated the domain ownership manually, it will be necessary to configure this parameter so that the processor can skip the validation of the domain owner in order to proceed with the request. The external id, hub id and domain required to configure this parameter will be provided in the email mentioned above.

The parameter must contain an object with the following format.

Copy
{
    "exclude": [
        {
          "external_id": "1000001",
          "hub_id": "HB-0000-0001",
          "domain": "sample1.onmicrosoft.com"
        },
        {
          "external_id": "1000002",
          "hub_id": "HB-0000-0001",
          "domain": "sample2.onmicrosoft.com"
        }
    ]
}

Once the domain validation has been skipped, the object in this parameter can be removed.

ID: activation_template_existing_customer
Scope: Marketplace
Description: Please configure the activation template for an existing customer with the following ID: TL-149-617-342.
ID: activation_template_new_customer
Scope: Marketplace
Description: Please configure the activation template for a new customer with the following ID: TL-096-007-823.
ID: activation_template_direct_model
Scope: Marketplace
Description: This parameter allows you to specify the ID of the Activation Template that will be displayed for the direct model. Please configure this template with the following ID: TL-723-887-449
ID: activation_template_distribution_model
Scope: Marketplace
Description: This parameter allows you to specify the ID of the Activation Template that will be displayed for the distribution model. Please configure this template with the following ID: TL-580-433-349
ID: processor_approve_list
Scope: Marketplace
Description:

This parameter allows you to configure a list of asset Ids, order IDs or customer IDs for which a subscription cancellation or suspension request will be auto-approved offline. The IDs must be separated by commas as follows:

"AS-1111-1111-1111,PR-1111-1111-1111-001,TA-1111-1111-1111"

ID: seamless_move_enabled
Scope: Marketplace
Description:

If this parameter is set to Enabled, if it is empty for a marketplace or if it does not exist, it will be possible to import Azure subscriptions with Seamless Move. If the parameter exists and it is set to Disabled, it will not be possible to use Seamless Move to import Azure subscriptions with Seamless Move.

CloudBlue, an Ingram Micro business, uses cookies to improve the usability of our site. By continuing to use this site and/or logging in you are accepting the use of these cookies. For more information, visit our Privacy Policy.