- Начало
- /
- Статия
Synchronize Entra ID users into Control Hub
You can add Webex to Microsoft Entra ID and then synchronize users from the directory in to your organization managed in Control Hub. The synchronization requires no on-premises infrastructure or connectors. This integration keeps your user list in sync whenever a user is created, updated, or removed from the application in Entra ID.
System for Cross-domain Identity Management (SCIM)
The integration between users in the directory and Control Hub uses the System for Cross-domain Identity Management ( SCIM) API. SCIM is an open standard for automating the exchange of user identity information between identity domains or IT systems. SCIM is designed to make it easier to manage user identities in cloud-based applications and services. SCIM uses a standardized API through REST.
Entra ID doesn't synchronize null values. If you set an attribute value to NULL, it is not deleted or patched with a NULL value in Webex. If this limitation affects your users, contact Microsoft for support.
Entra ID (Azure AD) Wizard App
Use the Entra ID (Azure AD) Wizard App in Control Hub to simplify the synchronization of users and groups with Webex. The Wizard App allows you to easily configure which attributes, users, and groups to synchronize, and to decide whether to synchronize user's avatars to Webex. See Set up the Entra ID (Azure AD) Wizard App in Control Hub to learn more about the benefits of using the wizard.
Before configuring Control Hub for automatic user provisioning with Entra ID, you need to add Webex from the Entra ID application gallery to your list of managed applications.
If you already integrated Webex Control Hub with Entra ID for single sign-on (SSO), Cisco Webex is already added to your enterprise applications and you can skip this procedure.
1 |
Sign in to the Azure portal at https://portal.azure.com with your administrator credentials. |
2 |
Go to Entra ID for your organization. |
3 |
Go to Enterprise Applications and then click Add. |
4 |
Click Add an application from the gallery. |
5 |
In the search box, type Cisco Webex. |
6 |
In the results pane, select Cisco Webex, and then click Add to add the application. A message appears that says the application was added successfully. |
7 |
To make sure that the Webex application you've added for synchronization doesn't show up in the user portal, open the new application, go to Properties, and set Visible to users? to No. |
This procedure lets you choose users to synchronize to the Webex cloud.
Entra ID uses a concept called "assignments" to determine which users should receive access to selected apps. In the context of automatic user provisioning, only the users and/or groups of users that are "assigned" to an application in Entra ID are synchronized to Control Hub.
Use the Entra ID (Azure AD) Wizard App in Control Hub to synchronize both users within Entra ID groups and individual group objects. Webex can't synchronize individual groups outside the Entra ID (Azure AD) Wizard App.
If you are configuring your integration for the first time, we recommend you assign one user for testing, and then add other users and groups after a successful test.
1 |
Open the Webex application in the Entra ID portal, then go to Users and groups. |
2 |
Click Add Assignment. |
3 |
Find the users/groups you want to add to the application:
|
4 |
Click Select and then click Assign. Repeat these steps until you have all the groups and users you want to synchronize with Webex. |
Use this procedure to set up provisioning from Entra ID and obtain a bearer token for your organization. The steps cover necessary and recommended administrative settings.
Before you begin
Get your organization ID from the customer view in Control Hub. Click your organization
name on the bottom left and then copy the Organization ID into a text
file. You need this value when you enter the tenant URL. We use this value as an example in
this article: a35bfbc6-ccbd-4a17-a488-72gf46c5420c
1 |
Sign in to the Azure portal and then go to | ||||||
2 |
Choose Cisco Webex from your list of enterprise applications. | ||||||
3 |
Go to Provisioning, and then change the Provisioning Mode to Automatic.
The Webex App includes some default mappings between Entra ID user attributes and Webex user attributes. These attributes are enough to create users, but you can add more as described later in this article. | ||||||
4 |
Enter the Tenant URL. The following table shows the URL for your Webex offer. Replace
For example, your tenant URL might look like this:
| ||||||
5 |
Follow these steps to get the bearer token value for the Secret Token: | ||||||
6 |
Return to the Azure portal and paste the token value into Secret Token. | ||||||
7 |
Click Test Connection to make sure that Entra ID recognizes the organization and token. A successful result states that the credentials are authorized to enable user provisioning. | ||||||
8 |
Enter a Notification Email and check the box to get email when there are provisioning errors. | ||||||
9 |
Click Save. |
What to do next
For info on making changes to the synchronized organization, see the Manage Synchronized Entra ID Users help article.
Follow this procedure to map additional user attributes from Entra ID to Webex, or to change existing user attribute mappings.
Entra ID to Webex mapping does not synchronize every single user detail. Some aspects of user data are not synchronized:
-
Avatars
-
Rooms
-
Attributes not listed in the table below
We recommend that you do not change the default attribute mappings unless absolutely necessary. The value that you map as the username is particularly important. Webex uses the user's email address as their username. By default, we map userPrincipalName (UPN) in Azure AD to email address (username) in Control Hub.
If the userPrincipalName does not map to the email in Control Hub, users are provisioned into Control Hub as new users instead of matching existing users. If you want to use another Azure user attribute that is in email address format instead of UPN, you must change that default mapping in Entra ID from userPrincipalName to the appropriate Entra ID user attribute.
Before you begin
You have added and configured the Cisco Webex app to your Entra ID, and tested the connection.
You can modify the user attribute mappings before or after you start synchronizing users.
1 |
Sign in to the Azure portal and then go to Enterprise applications > All applications. | ||||||||||||||||||||||||||||||||||||
2 |
Open the Cisco Webex application. | ||||||||||||||||||||||||||||||||||||
3 |
Select the Provisioning page, expand the Mappings section, and click Provision Azure Active Directory Users.
| ||||||||||||||||||||||||||||||||||||
4 |
Check the Show advanced options check box and then click Edit attribute list for CiscoWebEx. | ||||||||||||||||||||||||||||||||||||
5 |
Choose the Webex attributes to be populated from Entra ID user attributes. The attributes and mappings are shown later in this procedure. | ||||||||||||||||||||||||||||||||||||
6 |
After selecting the Webex attributes, click Save, and then Yes to confirm. The Attribute Mapping page opens, so you can map Entra ID user attributes to the Webex user attributes you chose. | ||||||||||||||||||||||||||||||||||||
7 |
Near the bottom of the page, click Add new mapping. | ||||||||||||||||||||||||||||||||||||
8 |
Choose Direct mapping. Select the Source attribute (Azure attribute) and the Target attribute (Webex attribute), and then click OK.
| ||||||||||||||||||||||||||||||||||||
9 |
Repeat the previous two steps until you have added or modified all the mappings you need, then click Save and Yes to confirm your new mappings. You can Restore default mappings if you want to start again. |
Your mappings are done and the Webex users will be created or updated on the next synchronization.