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 define your own custom usage exchange rates instead of relying on the Microsoft Azure API exchange rate. The exchange rates must be provided in JSON format.

Please note the following:

  • Conversion Process: All calculations are performed by first converting the amount from the original currency (as specified in the Microsoft invoice) into USD, and then from USD into the destination currency.

  • Required Exchange Rates:

    • If the invoice is not in USD, you must specify two exchange rates:

    • From the original currency to USD.

    • From USD to the final currency

    • If the invoice is already in USD, only the second exchange rate (USD to the final currency) is needed.

  • Format: Exchange rates must be defined using the "USDPerUnit" format, which specifies how many US dollars correspond to one unit of the other currency.

Below is a table with examples of how to define these 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:

When the processor cannot verify a domain automatically, you must manually bypass the validation by updating the ownership_validation_list parameter in the Connect Distributor Portal.

Retrieve Required IDs

Locate the Connect Helpdesk case associated with the request. You will need the following three values for each domain:

  • External ID: The unique identifier for the transaction.

  • Hub ID: The identifier for the specific Hub (e.g., HB-XXXX-XXXX).

  • Domain: The customer's .onmicrosoft.com tenant domain.

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.

ID: permit_user_address_verification
Scope: Marketplace
Description:

When this parameter is enabled, transacting partners will be allowed to confirm if the customer's address is correct in cases when the address

validation with Microsoft fails with a "none" status. If the transacting partner confirms that the address is correct, the address validation will be skipped and the process will continue.

ID: mca_locale
Scope: Marketplace
Description:

Choose the language that will be used to generate the MCA attestation:

  • English (Default)

  • Spanish

  • French

ID: validate_gdap_import
Scope: Marketplace
Description: When set to Yes, GDAP will be validated on import orders in the corresponding marketplace