Overview
This document covers how to manage Microsoft customer tenants by linking CSP tenants to organizations in Cloudmore.
Linking your tenants to organizations gives you visibility of all your customers' CSP services in one place. It lets you handle changes efficiently and lets your customers use the self-service options.
🔖 Cloudmore Organization
An organization is an entity that falls under a broker and consumes the broker's services. Essentially, it is a company or a department within a company.
🔖 Tenant
A tenant is an entity assigned a unique ID (Tenant ID) under the Microsoft Partner platform for entities that buy and consume Microsoft CSP services.
Manage Organizations (5.0) - for the relationship between Cloudmore organizations and tenants.
Managing Tenants
Linking your tenants to organizations is essential for viewing all your customers and their CSP services in Cloudmore. It enables efficient management and allows your customers to use self-service options.
Prerequisites for managing tenants
-
Microsoft tenant authentication (MFA token) must be set up. Microsoft requires a secure authentication model for Partner Center API calls, so complete the steps in Enabling MFA below first.
Manually linking a tenant is required only when the new customer was created in the Microsoft Partner Center first. Tenants created from Cloudmore are linked automatically.
Navigation and permissions
Broker level: Services > Microsoft 365 and open the Link tenants tab
-
Full access: Super Admin, Global Admin, Global Support Admin
-
Read only: Global View Only Admin, Global Billing Admin
Enabling MFA
The MFA token is set up on the Authentication tab of the Microsoft 365 service. The full steps are in Microsoft Tenant Authentication (5.0).
Prerequisites for enabling MFA
-
Complete the process through the eu.cloudmore.com address for EU customers or the us.cloudmore.com address for US customers, not through a branded URL.
-
The Microsoft Partner Center user account must have at least Privileged Role Administrator permissions to authenticate the token correctly, and must have MFA enabled in the Partner Center.
-
The Privileged Role Administrator account should also be assigned the Admin Agent role in the Partner Center.
-
Once the token is activated, do not change the permissions or password of the account used to grant consent, as this invalidates the token's authentication.
Steps to enable MFA
-
Log in to Cloudmore using your broker account.
-
Open the Authentication tab - Navigate to Services > Microsoft 365 and open the Authentication tab.
-
Enter Microsoft ID - Enter your Microsoft ID in the Microsoft authentication card. The ID can be found in the Microsoft Partner Center under Home > My Profile (Account Settings) > Microsoft Entra ID profile > Microsoft ID.
-
Update consent - Click Update consent. You are redirected to the Microsoft Partner Center. Sign in with a Privileged Role Administrator account and grant consent.
-
Automatic token refresh - The token automatically refreshes every night.
Cloudmore might require a manual token update in case of permission changes for accessing the Partner Center data on your behalf. This might happen when Microsoft changes the permission requirements for using the API endpoints or accessing customer data.
-
Test the token - Run a Microsoft Reconciliation Report to test the API connection to the Microsoft Partner Center.
[SCREENSHOT] Services > Microsoft 365, Authentication tab with the Microsoft authentication card.
Steps to Link all Microsoft Tenants
-
Log in to Cloudmore using your broker account.
-
Navigate to Services > Microsoft 365 and open the Link tenants tab.
Cloudmore lists every CSP tenant registered for the broker in the Partner Center together with every organization that has the Microsoft 365 service. Each row shows the Organization name and the Tenant name. When one side of the pair is missing, the row shows Not linked on that side.
[SCREENSHOT] Services > Microsoft 365, Link tenants tab with linked and Not linked rows.
Use the Show filter to narrow the list:
|
Filter |
What it shows |
|---|---|
|
Any |
All rows (default). |
|
Linked |
Organizations that are linked to a Microsoft tenant. |
|
Organization not linked |
Microsoft tenants with no Cloudmore organization attached. |
|
Tenant not linked |
Organizations that have the Microsoft 365 service but no Microsoft tenant. |
Check for tenants marked Organization not linked regularly to make sure all tenants are matched. Unlinked tenants do not appear in billing reports, and Cloudmore does not generate billing data for these customers.
To link all unlinked tenants in one go:
-
Click Bulk link Microsoft 365.
-
Choose Link all unlinked tenants to create organizations for every Microsoft tenant that does not have one, or Link specific tenants and pick the tenants under Unlinked tenants.
-
Click Link selected tenants.
If an organization with the tenant name is not found, the organization is created automatically in Cloudmore using the Microsoft tenant information, and the Microsoft 365 service is added to it. When every tenant is already linked, the dialog says so.
[SCREENSHOT] Bulk link Microsoft 365 dialog with the two options.
A red tag icon next to a tenant name means the same Microsoft tenant is linked to more than one organization. Review these rows, as one tenant should belong to one organization.
Linking individual tenants
Each row has an actions menu (⋮). The options depend on which side of the link is missing.
-
Link a Tenant to an Existing Organization - Select Edit tenant link on the row, or click the Not linked text. Use this when the organization already exists in both Cloudmore and the Partner Center but has not been linked yet.
-
For a Microsoft tenant without an organization, start typing the organization name in Linked organization and select it.
-
For an organization without a tenant, select the tenant from Tenant name.
-
If you sell in more than one currency, select the Service currency.
-
Click Link. The message Tenant linked. confirms the tenant is linked to the organization.
-
Repeat this for each of your existing CSP tenants so they are all linked.
[SCREENSHOT] Edit tenant link dialog with Tenant ID, Tenant name and Linked organization.
-
Create a New Organization from the Tenant - Select Create organization on a row marked Organization not linked. Use this when a tenant was created in the Partner Center after the bulk linking and you want to create its organization individually.
-
The dialog is prefilled from the tenant's Partner Center profile. Check Organization name, Customer number, Country, Notification e-mail and Domain, and the Service currency if you sell in more than one.
-
Click Create organization and link. The organization is created in Cloudmore, linked to the tenant, and the Microsoft 365 service is added to it.
-
[SCREENSHOT] Create organization from tenant dialog.
The actions menu also has:
|
Action |
Shown when |
What it does |
|---|---|---|
|
Request relationship |
Organization not linked |
Prepares the Partner Center broker relationship request for the customer, which you can copy or email. |
|
Unlink tenant |
Linked |
Removes the tenant link. Microsoft 365 stops being managed for this organization. Tenant data in Microsoft is not changed. |
|
Remove service |
Tenant not linked |
Removes Microsoft 365 from the organization. Its subscriptions stop being managed in Cloudmore. Tenant data in Microsoft is not changed. |
|
Reset grants flag |
The row has an organization |
Delegated admin grants are re-checked on the next sync. |
A linked tenant cannot be pointed at a different organization directly. Unlink the tenant first, then link it to the right organization.
-
An alternative way to create a tenant for an organization is to add the Microsoft 365 service from the organization's Services > Available services. This creates a tenant in the Partner Center and links the organization to it. Here you can also choose Create a default Microsoft GDAP relationship and Add default Microsoft security groups for the new tenant.
[SCREENSHOT] Add Microsoft 365 service dialog showing the default GDAP relationship and security group options.
By following the steps in this guide, you can manage and link your CSP tenants to organizations in Cloudmore. Regularly monitoring and linking tenants keeps billing reports accurate and service management seamless.
Steps to Link all Azure Tenants
To link all Azure tenants, use Bulk link Microsoft Azure on the Link tenants tab. It adds the Microsoft Azure service to organizations that are already linked to a Microsoft tenant.
|
Option |
What it does |
|---|---|
|
Link all unlinked tenants |
Adds Azure to all organizations that don't have it yet, regardless of whether they have any Azure subscriptions or billing. |
|
Link unlinked tenants with Azure Billing |
Adds Azure only to the organizations that use a Microsoft Azure subscription and have Azure billing. |
|
Link specific tenants |
Adds Azure only to the organizations behind the tenants you select. |
Follow the Adding the Microsoft Azure Service guide for detailed steps.