Knowledge Base

Microsoft Entra Sync for Broker Users (5.0)

Overview

Microsoft Entra ID Sync connects your broker's Microsoft Entra ID (formerly Azure AD) tenant to Cloudmore. You map Entra groups to Cloudmore administrator roles, and the members of each mapped group are provisioned as broker administrators with that role on sync.

Prerequisites

  • A Microsoft Entra ID tenant with the users and groups you want to sync.

  • The Directory (tenant) ID of that tenant, and permission to grant admin consent in it.

  • Entra groups that match the Cloudmore roles you intend to assign.

The Microsoft Entra ID Sync page

👥

Broker level: Settings > Microsoft Entra ID Sync

  • Full access: Super Admin

  • Read only: Global Admin, Global View Only Admin

The page has three sections:

  • Connection - turn the sync on or off, and connect your Entra ID tenant.

  • Entra role mapping - map an Entra group to each Cloudmore administrator role.

  • Sync status - the state of the latest sync.

[SCREENSHOT] The broker Microsoft Entra ID Sync page with the Connection and Entra role mapping sections.

Configure the sync

  1. Navigate to Settings > Microsoft Entra ID Sync.

  2. Under Connection, turn on Activate Microsoft Entra ID sync.

  3. Enter the Entra ID (Directory / tenant ID) of the tenant to sync from.

  4. Click Grant admin consent and complete the consent in Microsoft. Then click Test connection to check that Cloudmore can reach the tenant.

  5. Under Entra role mapping, select the Entra group for each Cloudmore role you want to map: Super Admin, Global Admin, Global View Only Admin, Global Support Admin, Global Billing Admin, Key Account Manager, Key Account View Only Manager, Limited Key Account Manager and Sales Agent. Leave a role empty if you don't want to map it.

  6. Click Save changes.

  7. Click Run user sync to start a sync. Members of each mapped group are created as administrators with that role.

While the sync runs, Sync status shows that synchronization is in progress. Refresh the page to see the updated status.

The sync runs only when you click Run user sync. It does not run automatically, so run it again after you add users to a mapped Entra group. To pause syncing, turn off Activate Microsoft Entra ID sync. Your role mappings are kept.

After the Sync

Synced users can log in to Cloudmore with their Microsoft credentials when Microsoft SSO is enabled. Their Cloudmore username is their Microsoft email address. You manage these accounts like any other administrator, under Settings > Administrators. See Broker User Management (5.0) and Microsoft SSO (5.0).