Understanding Organizational Contacts

Organizational contacts are identities which are imported or synchronized into Webex and you can search all users and organization contacts in an organization through Webex app and all Webex devices.

Use Control Hub based tool to migrate or synchronize your organizational contacts to Webex. For on-premises deployments, organizational contacts are configured in the LDAP server as contact objects or in the Cisco Unified Communications Manager as end-users. You can configure rules in Control Hub based tool to classify users in the Unified CM database into end users and contacts.

This tool

synchronizes users and contacts from Unified CM or LDAP server to Webex
automatically detects updates in Unified CM based users and contacts and updates the changes into Webex
You can set a schedule for the periodic sync to synchronize users and contacts from LDAP server into Webex
periodic audit could be configured to make sure Unified CM users and contact data doesn't get out of sync with Webex

You can select only one source of users from either the Unified CM or LDAP server. If you configure directory connector, then you cannot synchronize users through the tool.

If you do not have Cisco Cloud connectivity, then use the CSV file through Control Hub to import your org contacts.

The prerequisites, Configure LDAP server search and set your preferences are mandatory sections which will guide you through the initial set up to import and synchronize your organizational contacts into Webex.

Необхідні компоненти

Ознайомтеся з Центром керування.

Webex Control Hub - це інтерфейс управління для платформи Webex. Для отримання додаткової інформації див. розділ Початок роботи з Webex Control Hub.
Центр керування доступом з повними правами адміністратора.

Адміністратор із повними правами може призначити одну або кілька ролей будь-якому користувачеві в організації. Переконайтеся, що призначено користувача з правами адміністратора, щоб ви могли перемістити решту ваших користувацьких контактів Jabber. Для отримання додаткової інформації див. розділ Призначення організаційних ролей облікових записів у Webex Control Hub.
Onboard the Unified CM clusters to Webex Cloud-Connected UC. For more information, see Set Up Webex Cloud-Connected UC for On-Premises Devices.
On the cluster or clusters that you onboarded to Webex Cloud-Connected UC, enable Deployment Insights service. For more information, see Enable or Disable Webex Cloud-Connected UC Services in Control Hub.

Configure LDAP server search. The LDAP credentials are retrieved from the Unified CM LDAP search configuration page for contact synchronization. For more information, see Configure LDAP server search.

If you don't validate the on-premise configurations for LDAP, the LDAP contact synchronization is not initiated.

Configure LDAP server search

Lightweight Directory Access Protocol (LDAP) synchronization helps you to provision and configure end users for your system.

If you wish to use Unified CM configuration, do the following:

Set the LDAP server Directory Type to Microsoft AD or Open LDAP server on the Unified CM.

Provide the LDAP search configuration:

LDAP server Username
LDAP server Password
LDAP server Search Base
LDAP server Search filter
UC Directory Profile tagged as Primary

By default, the entity type is Contacts.

For more information, see Configure LDAP Synchronization

If you wish to customize the configuration in Control Hub, do the following:

1.	Configure the LDAP server search page on Unified CM and provide the following: LDAP server Username LDAP server Password
2.	Add one or more UC Directory profile.
3.	Specify the LDAP server directory type explicitly in Control Hub user interface.
4.	Specify the LDAP server Entity Type as Users or Contacts in the Control Hub user interface.
5.	Specify the UC service profile as one of the directory profiles created in step 2.
6.	Specify the LDAP server search base.
7.	Specify the LDAP server search filter. For more information, see Configure LDAP Synchronization

Встановіть свої налаштування

From the Control Hub dashboard, Go to Updates and Migration.

Select the User/Contact Sync tile and click Go to Settings under Prerequisites.

The Settings page appears.

Configure either the Unified CM or the LDAP server for user synchronization function. Select the details from the following sections:

Unified CM end-user list—Configure rules for Control Hub to identify users in the Unified CM database into end users and contacts

Назва поля

Опис

Правила ідентифікації контактів і користувачів

Check any of the following check boxes to identify Org contacts from Unified CM. This option allows separating contacts from the users as the Unified CM users may contain both users and contacts. You can set rules to distinguish contacts from users:

Synchronize all records as contacts.
Synchronize all records as users.
За вибором клієнта

If the selected option is Custom, the tool provides options to classify the Unified CM end-user record as contact. Rest of the identities are considered as Users.

Select at least one identification rule to proceed.

Not synced from the LDAP server to Unified CM database.
Відсутній ідентифікатор користувача менеджера.
No device is associated.
Department ID is missing.
Department ID contains a string.
User ID contains a string.

Імпортувати

Choose the toggle to enable or disable synchronization of contacts or users from Unified CM to Webex.

Import Users—This includes all records that are identified as users from the Unified CM end-user list. It's based on the rules set on the card.

When the Directory Connector is enabled, the Import Users toggle is disabled. So, you cannot perform user synchronization.

You can only sync users from one source either Unified CM or LDAP and the selection is final.

Import Contacts—This includes all records that are identified as contacts from the Unified CM end-user list. The contacts include lobby phones, hunt groups, organizational contacts that the administrator configures. It is based on the rules set on the card.

Select the Cluster

Choose a cluster to migrate the contacts or users.

Періодичний аудит

Allows to peridically audit Unified CM end users list and Webex data to make sure it synchronizes every 7 days.

Set time—Use this field to change the default audit interval

Any changes to users and/or contacts on Unified CM, updates to webex within a couple of hours.

LDAP server—Choose these settings to synchronize users and contacts from the LDAP server to Webex. You can Synchronize contacts from both Unified CM and LDAP server, but users could be synchronized from one source - Unified CM or LDAP server. Once this source is selected, it can't be changed for this Org.

You can only sync users from one source either Unified CM or LDAP and the selection is final.

Назва поля

Опис

Періодична синхронізація LDAP

Enable or disable synchronization from the LDAP server.

Періодична синхронізація

Allows to periodically synchronize all users and/or contacts from LDAP server to Webex.

Додати конфігурацію

Choose a cluster filter to synchronize contacts and/or users. Control Hub LDAP server supports multiple configurations for the clusters. Click Add Configuration to configure LDAP server related configurations. The Control Hub LDAP server uses the Unified CM LDAP search credentials connect to LDAP server.

Cluster name—Select the cluster name.

Configuration—Choose from the two modes - Customer Use Unified CM LDAP search. Use Unified CM LDAP search selection allow tool to pick up the Unified CM LDAP search configuration to sync users or contatcs. Custom configuration allows a user to define the synchronization settings.

LDAP system—Choose OpenLDAP or Microsoft AD as Source LDAP server.

Open LDAP when we use metadirectory such as Recos.

Synchronization type—Select the type of sync either user or contact.

If you have already selected users synchronization from Unified CM settings or User sync through Directory connector is configured, then User sync option will not be available here.

Custom Filter—Custom filter for users or contact synchronization.

LDAP Search Base—LDAP server search base for user or contact synchronization.

An admin can add up to three search bases separated by "&&".

UC Directory Service Profile—Select one of the Unified CM configured UC Service of Type Directory.

Click Save and proceed. The Pending for sync section appears.

Importing Organizational Contacts

Synchronizing Org contacts is now an automated process. Webex Cloud-Connected UC can sync contacts from Unified CM or the LDAP server to Webex. This functionality does not require manual upload of CSV file, which was cumbersome and error prone.

You can choose to synchronize data from a single cluster or all clusters. The rules for synchronizing data depend on the configurations set in the Settings page. You can change the rules, if necessary and it applies from the next synchronization task

On synchronize the org contacts data, the following displays:


Ідентифікатори	Опис
Contacts to be synced	Total number of contacts that are ready to be synchronized to Webex.
Contacts already in Webex	Total number of contacts that are already synchronized to Webex.
Users to be synchronized	Total number of users ready to be synchronized to Webex.
User Exists in Webex	Total number of users who are already synchronized to Webex.

When syncing users and/or contacts from Unified CM, you can review the records and use the inline editing option to change the imported data. Click Review Unified CM Records.

Review User and Contact Data Before Synchronization

This option is not available for LDAP synchronization and only available for Unified CM based users and/or contacts synchronization.

Review the user data before you start the synchronization. Use this screen to fix any errors for the identities. У цій таблиці відображаються лише активні користувачі.

The following procedure is not applicable when Directory connector are enabled as user synchronization cannot be done.

1.	In the Review users before synchronization page, review the details regarding issues and fix them, if any. The list of issues are as follows: Invalid email: This is an error. Invalid email IDs refer to incomplete ID or duplicate ID. You cannot sync users with invalid email IDs. Fix the error in the email ID or you can remove the contact details. You can fix the invalid email IDs from the Summary page. Missing telephone number/extension: This is a warning. You can sync users without phone number or extension and it is not mandatory to fix this error. You cannot add the missing phone number or extension details from Control Hub. User Exists in Webex: You cannot synchronize users who are already in Webex. If the users exist in Webex, the tool updates the user details. Use the search field to search for the identities and sort them based on the filters.
2.	Click Change user/contact rule to change the rules from the Settings page.
3.	Select a user or contact from the list to make any changes to the identity. You can move the user or contact or remove from the contact sync list.
4.	You can export the list to a CSV file to manually edit any information and later import the updated file. Click Actions to perform the following tasks: Export these rows: Choose this option to export all the available records. Import updated file: Choose this option if you want to view the updated file details. Reset user list : Choose this option if you want to clear the existing user list details and update it again on the Summary page.
5.	Клацніть Далі. Displays the Review contacts before synchronization page.
6.	In the Review contacts before synchronization page, you can perform the same set of tasks such as Search, Sort, Edit Settings, and Change user/ Contact Rules. Review the details about issues and fix them, if any. The list of issues are as follows: Invalid display name: This is an error. The display name should not be empty. Contacts with no information: This is a warning. It is not mandatory to fix the records with no contact information to allow synchronization but contacts with no information will not be synced to Webex. Export and edit all the affected contacts and upload them back to fix the warning. Already in Webex: You cannot synchronize contacts who are already in Webex. If Display name AND Email ID AND Telephone number of the synced contact is same as an existing Webex contact, then contact info will be updated in Webex, else new contact will be created in Webex. Use the search field to search for the identities and sort them based on the filters.
7.	Клацніть Далі. The Summary page appears.

Review Summary Data

The Summary page lists the error and warning messages for the selected users and contacts. Він також надає вам необхідні пропозиції та рішення для їх вирішення. Усуньте помилки, перш ніж продовжувати. Однак ви можете проігнорувати попередження.

You can also remove the identities (user or contact) with errors and proceed. The removed identities are added back to the unsynchronized list.
The errors and warnings can be downloaded.

To resolve the user errors, click View Users and select Remove from sync list.

To resolve errors with the contacts, click View Contacts and select Remove from sync list.

When you use the Remove from sync list option to remove users in the Summary page, the User sync count on Control Hub is not updated.

You can view the count of these invalid identities:

Users with Invalid Email IDs.
Contacts with incorrect display name.
User Already exists in Webex and they cannot be synced.
Users with Missing Telephone number/Extension.
Contacts with Missing Telephone number/Extension.

The users and contact details in the review wizard is reverted when the Settings page is updated.

Export updated records- we recommend updating the Unified CM contact list for any changes that are made to the records. Click Export list, to download the updated records and manually update them in Unified CM.

Review Synchronization Logs

The Synchronization tab lists all the synchronization operations that have been done thus far. You can view the following columns:

Стан
Останнє оновлення:
Загальна кількість контактів
Контакти, що містять помилки
Загальна кількість користувачів
Користувачі, що містять помилки
Розпочато
Тип

In the Logs page, review the message in the System failure column and fix the error. The following table lists the different error scenarios and how to fix them.


Error Scenario	Message on the User Interface	Роздільна здатність
Unable to connect to the LDAP server.	LDAP Communication Error	Check if the IP address and port are configured correctly in the Directory Profile on the Unified CM, and reachable from the Publisher.
Unable to establish a TLS connection	LDAP Certificate Error	Check if the LDAP certificate is Certificate Authority (CA) signed.
Unable to connect to LDAP due to wrong credentials.	LDAP Authentication Error	Check if the correct credentials are provided on the Unified CM LDAP configuration page.
Unable to fetch data due to wrong LDAP search base.	LDAP Search Base Error	Check if the correct LDAP search base is provided in Control Hub or the Unified CM configuration page, depending on the mode.
Unable to fetch data due to timeout.	LDAP Timeout Error	Check the timeout configured in the LDAP (DirSync) service parameter on the Unified CM publisher.
Distinguished Names (DNs) are missing in the CSV data.	LDAP Mismatch Error	Check if the customer has configured the correct LDAP type in Control Hub UI.
Any other error.	LDAP Internal Error	Зверніться до служби підтримки Cisco TAC.