- Главная
- /
- Статья
Интеграция службы каталогов с помощью общих параметров идентификации Webex для выделенного экземпляра
Синхронизируйте пользователей из облачного каталога (Microsoft Azure AD) или локального каталога (MS AD) с кластерами выделенного экземпляра (Unified CM и Cisco Unity Connection) с помощью службы общих удостоверений Webex с помощью интерфейса Control Hub.
обзор
Синхронизируйте пользователей из облачного каталога, например Azure AD, с приложениями выделенного экземпляра, такими как Unified CM и Cisco Unity Connection, с облачной службой каталогов. Во время синхронизации система импортирует список пользователей и связанных данных пользователей из службы Azure Active Directory (или аналогичной облачной службы каталогов), которая синхронизирована в службу удостоверений Webex. Необходимо выбрать кластер Unified CM в Control Hub, который следует синхронизировать, выбрать соответствующее сопоставление полей идентификатора пользователя Unified CM, а затем выбрать необходимое соглашение о синхронизации для выполнения синхронизации.
Предварительные условия
-
Если в качестве облачного каталога используется Azure Active Directory, дополнительную информацию см. в разделе Настройка приложения мастера Azure AD в Control Hu b .
-
Если в качестве каталога используется Microsoft Active Directory, дополнительную информацию см. в разделе Развертывание соединител я каталогов.
-
Если Unified CM уже интегрирован с существующими системами Active Directory, убедитесь, что эти активные каталоги интегрированы с общими параметрами идентификации Webex.
Просмотр сведений о кластере
На странице управления в Control Hub выберите кластер, с которым необходимо синхронизировать данные пользователей.
Во время этого выбора также предоставляются сведения о кластере, такие как имя кластера, состояние синхронизации кластера, последнее синхронизированное состояние и связанный продукт.
Сведения о кластере |
Описание |
---|---|
Имя кластера |
Имя кластера |
Состояние |
Состояние синхронизации |
Последняя синхронизация |
Дата последней синхронизации |
Продукт |
Сведения о продукте |
Синхронизация каталога
В зависимости от требований можно синхронизировать пользователей из локального каталога Active Directory с Control Hub с помощью соединителя каталогов или непосредственно из каталога Azure в Control Hub, а затем синхронизировать их с Unified CM.
Выполните одно из указанных ниже действий.
-
Чтобы непосредственно синхронизировать пользователей из каталога Azure с Control Hub, выполните процедуру синхронизации пользователей из каталога Azur e .
-
Чтобы синхронизировать пользователей из локального Active Directory в Control Hub с помощью соединителя каталогов, выполните процедуру Синхронизация пользователей из локального Active Director y .
Синхронизация пользователей из каталога Azure
Синхронизация службы каталогов выделенного экземпляра позволяет импортировать данные конечных пользователей из каталога Azure в базу данных Unified CM, чтобы они отображались в окне конфигурации конечных пользователей.
Чтобы синхронизировать пользователей с помощью каталога Azure, выполните приведенные ниже действия.
-
Необходимо синхронизировать пользователей Azure Active Directory в Control Hub.
-
Выполните процедуру Настройка синхронизации каталого в для синхронизации пользователей в Control Hub с Cisco Unified CM.
Синхронизация пользователей из локального каталога Active Directory
Пользователей локального каталога Active Directory можно синхронизировать с общими параметрами идентификации (CI) с помощью соединителя каталогов.
Для службы каталогов поддерживается только развертывание SSO. Дополнительную информацию см. в статьях Интеграция системы единого входа в Control Hub и Решение SSO на основе SAML .
Чтобы синхронизировать пользователей с локальным каталогом Active Directory, выполните приведенные ниже действия.
-
Синхронизируйте пользователей Active Directory с общими параметрами идентификации (CI) с помощью соединителя каталогов. Программное обеспечение соединителя можно скачать из Control Hub и установить на локальном компьютере. Дополнительную информацию см. в руководстве по развертыванию соединителя каталогов.
-
Выполните процедуру, описанную в разделе Настройка синхронизации каталого в , синхронизация пользователей в Control Hub с Unified CM.
Настройка синхронизации каталога
Иногда могут возникать дополнительные задержки при подготовке кластера. В таких случаях подготовка будет по-прежнему происходить, однако эта активность предусматривает значительное время.
-
Войдите в Control Hub в https://admin.webex.com/login.
-
Перейдите к меню Службы > Calling >Выделенный экземпляр > Управление.
Выберите приложение UC и щелкните Настройка в разделе Активировать синхронизацию каталогов на панели справа.
-
После запуска подготовки в окне конфигурации сопоставления полей убедитесь, что сопоставление, выбранное для поля "Идентификатор пользователя Unified CM", уникально идентифицирует пользователя в кластере.
Выберите соответствующее сопоставление поля "Идентификатор пользователя Unified CM" для синхронизации пользователя из Webex.
-
Поле "Идентификатор пользователя" в Unified CM привязывается к идентификатору адреса электронной почты пользователя в Webex.
-
Поле "Идентификатор адреса электронной почты" в Unified CM привязывается к идентификатору адреса электронной почты пользователя в Webex.
-
Поле "Идентификатор пользователя" в Unified CM привязывается к идентификатору адреса электронной почты (без домена) пользователя в Webex.
При отсутствии возможности привязать имеющуюся запись пользователя Unified CM будет создана новая учетная запись. Идентификатор адреса электронной почты пользователя будет использован в качестве уникального идентификатора новой учетной записи пользователя. Это примечание применимо к вариантам 1 и 2.
Параметры
Unified CM
Control Hub
Вариант 1
Поле идентификатора пользователя в Unified CM сопоставляется с идентификатором электронной почты пользователя в Webex
Вариант 2
Поле идентификатора почты в Unified CM сопоставляется с идентификатором электронной почты пользователя в Webex
Вариант 3
Поле идентификатора пользователя в Unified CM сопоставляется с идентификатором электронной почты без доменной части пользователя в Webex
-
-
Щелкните Далее.
Выберите соглашение из раскрывающегося списка для создания нового соглашения о синхронизации. После создания нового соглашения о синхронизации все существующие соглашения о синхронизации, ссылающиеся на локальный каталог, будут удалены. Новое соглашение о синхронизации можно изменить после его создания.
Перед началом синхронизации в разделе "Предпросмотр соглашения" проверьте список пользователей и контактные данные (существующие сведения внешнего каталога LDAP, доступные в Unified Communications Manager). Можно просмотреть перечисленные ниже сведения.
-
Информация о группе
По умолчанию все пользователи синхронизируются с пользовательским рангом 5. Это можно проверить в информационном окне группы.
-
Примененный шаблон группы функций с универсальными шаблонами линий и устройств
-
Сведения о линии и маске для синхронизированных номеров телефона добавленных пользователей
-
Недавно подготовленные пользователи и их добавочные номера
-
Раздел "Синхронизируемые стандартные поля пользователей"
-
Имя узла или IP-адрес сервера каталога
Щелкните Дале е, чтобы выбрать фильтр группы.
Раздел "Информация о группе" неприменим к Cisco Unity Connection и, следовательно, не будет отображаться в разделе "Предпросмотр соглашения".
-
В раскрывающемся списке Выбрать группы выберите группы, которые необходимо синхронизировать. Чтобы выбрать все группы пользователей, установите флажок в поле Выбрать все группы.
По умолчанию будут синхронизированы все пользователи. Если не выбрано ни одной группы, все пользователи и связанные данные пользователей будут синхронизированы автоматически.
Для вложенных групп в каталоге пользователи во время подготовки должны выбрать подмножество групп пользователей, поскольку по умолчанию они не включены в родительскую группу. Чтобы убедиться в том, что во время подготовки будут добавлены только необходимые пользователи, следует проверить все повторяющиеся вложения (если они есть).
Любые изменения соглашения о синхронизации, например удаление целевого пользователя или группы, не будут распространяться во время периодической синхронизации. Необходимо сбросить службу каталогов для этого кластера, а затем выполнить повторную подготовку кластера с использованием нового или измененного соглашения о синхронизации. Чтобы сбросить службу каталогов для необходимого кластера, обратитесь в службу поддержки Cisco TAC.
-
Для подготовки процесса синхронизации щелкните Далее.
Включите синхронизацию в окне Включить синхронизацию после успешного копирования системой данных пользователя во временное пространство хранилища в Unified CM и создания нового соглашения о синхронизации (после выполнения шагов 1 и 2, как показано на снимке экрана ниже).
-
Параметр Скачать отчет позволяет частично просматривать результаты. Чтобы получить полные отчеты для кластера Unified CM, выполните следующую команду CLI: file get activelog /cm/trace/CIService/log4j/DryRunResults.csv
Если у вас нет доступа, для скачивания отчета обратитесь в службу поддержки Cisco TAC.
Ниже представлены результаты пробного запуска.
-
Новые пользователи: пользователи, отсутствующие в Unified CM, но присутствующие в службе удостоверений Webex. Пользователи создаются в Unified CM после включения синхронизации.
-
Совпадающие пользователи: пользователи, присутствующие в Unified CM и службе удостоверений Webex. Эти пользователи останутся активными в Unified CM после завершения синхронизации.
-
Несоответствующие пользователи: пользователи, присутствующие в Unified CM и службе удостоверений Webex. Несовпадающие пользователи будут помечены неактивными в Unified CM после завершения синхронизации и будут удалены через 24 часа бездействия.
Можно проверить отчет и решить, следует ли сохранить тот же список пользователей, а также добавить или удалить пользователей. Если необходимо, щелкните Отменить, чтобы остановить процесс и отменить изменения подготовки.
-
После проверки соглашения о синхронизации щелкните Предпросмотр в Unified CM, чтобы войти в свою инфраструктуру и внести изменения в недавно созданное соглашение о синхронизации.
Можете изменить только информацию о группе. Невозможно переименовать соглашение или изменить какие-либо сведения.
-
Щелкните Включить синхронизацию, чтобы продолжить синхронизацию.
Во время синхронизации до ее завершения невозможно выполнять какие-либо действия. По завершении синхронизации для определенного кластера на странице службы каталогов этот кластер будет указан с состоянием "Подготовлено". На этом этапе вы успешно предоставили Azure AD право на подготовку и синхронизацию пользователей Webex в инфраструктуру UC и выполнили шаги для настройки синхронизации.
Необходимо включить синхронизацию в течение 18 часов с момента создания нового соглашения. После 24 часов бездействия синхронизированные пользователи LDAP становятся неактивными и будут удалены. Пользователи не смогут войти в систему и использовать службы Unified CM.
После завершения подготовки Azure AD для определенного кластера невозможно создать новые соглашения о синхронизации и изменить настройки конфигурации для этого же кластера, кроме настроек группы. Чтобы сбросить службу каталогов, обратитесь в службу поддержки Cisco TAC. После этого можно создать новое соглашение для подготовки.
При использовании idP Azure во время аутентификации SSO после успешной подготовки убедитесь, что в idP Azure настроены правильные заявки. Например, если во время подготовки для сопоставления элемента userid выбран параметр 1, убедитесь, что в качестве UID в разделе Дополнительные заявки задан параметр user.userprincipalname.
Периодическая синхронизация
После успешной подготовки кластера периодическая синхронизация будет выполняться ежедневно, что позволит синхронизировать любые изменения данных пользователей из общих параметров идентификации Webex в Unified CM и Cisco Unity Connection. Ваше вмешательство не требуется для периодической синхронизации. Однако можно проверить, выполнялась ли периодическая синхронизация за день, просмотрев столбец Последняя синхронизация в столбце на странице сведений о кластере в Control Hub. Метка времени обновляется, чтобы отразить время периодической синхронизации для кластера.
Unified CM
Подключение Cisco Unity
Каталог LDAP в Unified CM или Cisco Unity Connection
В процессе синхронизации создается каталог LDAP по умолчанию.
Несмотря на однократную синхронизацию настроек, Control Hub синхронизируется с изменениями 24-часового цикла в общих параметрах идентификации на Unified CM или Cisco Unity Connection.
Просмотр состояния синхронизации
Просмотреть состояние синхронизации можно в столбце "Состояние синхронизации каталога". Щелкните приложение UC, чтобы открыть правую панель, на которой будет отображено состояние подготовки, последнее синхронизированное состояние и причина ошибки при ее наличии. Также можно выбрать локальный часовой пояс. По умолчанию выбран часовой пояс браузера.
Состояние подготовки
Состояние подготовки |
Описание |
---|---|
Обработка |
Выполняется подготовка |
Требуется действие |
Если потребуется вмешательство вручную для определенного кластера, выполните необходимые действия.
|
Ошибка |
Если в мастере Включить синхронизацию требуется выполнить какое-либо действие, выполните проверку и при необходимости выполните требуемые действия. |
Активные |
Подготовка кластера завершена. |
Не подготовлено |
Подготовка кластера еще не началась. |
Импорт пользователей для Unity Connection
Можно вручную импортировать пользователей Azure AD из меню "Импорт пользователей" в Cisco Unity Connection после завершения подготовки кластера в Control Hub.
Импорт пользователей можно выполнять двумя описанными ниже способами.
1 |
В разделе администрирования Cisco Unity Connection раскройте меню Пользователи и выберите Импорт пользователей. |
2 |
На странице "Импорт пользователей" импортируйте учетные записи пользователей каталога LDAP, чтобы создать пользователей Unity Connection. |
1 |
В разделе администрирования Cisco Unity Connection раскройте меню Инструменты и выберите Инструмент массового администрирования. |
2 |
Чтобы добавить пользователей Unity Connection, выполните приведенные ниже действия на странице "Инструмент массового администрирования". |
3 |
По завершении импорта проверьте файл, указанный в поле Имя файла объектов с ошибками, чтобы проверить успешность создания всех пользователей. |
Устранение неполадок, связанных с синхронизацией
В этом разделе приводится необходимая информация и решения для устранения некоторых распространенных ошибок, которые могут возникать на различных этапах синхронизации пользователей из Control Hub в базу данных Unified Communications Manager.
Несоответствующие пользователи
Включите синхронизацию в течение 18 часов после создания нового соглашения. Существующие пользователи будут помечены как неактивные и удалены из Unified CM по истечении 24 часов бездействия.
Ошибка: не удалось скопировать данные. Повторите попытку
-
Прервана связь между выделенным экземпляром и облаком Webex, или невозможно получить данные пользователя из облака Webex.
-
Прервана связь между выделенным экземпляром и Unified CM, или невозможно передать данные пользователя в базу данных Unified CM.
-
Данные пользователя не скопированы во временное местоположение хранилища.
Ошибка: не удалось создать соглашение о синхронизации. Повторите попытку
-
Прервана связь между выделенным экземпляром и Unified CM или невозможно передать данные соглашения о синхронизации в базу данных Unified CM.
-
Не удалось создать соглашение о синхронизации.
Невозможно получить сведения соглашения о синхронизации. Повторите попытку через некоторое время.
Прервана связь между выделенным экземпляром и Unified CM.
Известные проблемы и ограничения синхронизации службы каталогов выделенного экземпляра Webex Calling
При возникновении проблем с этой функцией проверьте, не является ли это известной проблемой с доступными рекомендациями по решению.
-
Подготовка службы каталогов выделенного экземпляра Webex Calling не работает с аутентификацией LDAP, поскольку синхронизируются только данные пользователей, а не пароли для сервера Unified CM, поэтому аутентификация LDAP не работает.
Обходное решение. Для входа необходимо использовать систему единого входа (SSO). В этом документе описана только интеграция системы единого входа (SSO).
Настройте систему единого входа (SSO), если необходимо, чтобы пользователи выполняли аутентификацию посредством корпоративного поставщика удостоверений. Дополнительную информацию см. в статьях Интеграция системы единого входа в Control Hub и Решение SSO на основе SAML .
-
Чтобы отключить службу каталогов, обратитесь в службу поддержки Cisco TAC. Подождите несколько минут и снова начните настройку службы каталогов.
-
Если после удаления необходимо снова подключить тот же кластер Unified CM к организации, необходимо сначала отключить службу каталогов, а затем повторно подготовить тот же кластер.
Чтобы отключить службу каталогов, обратитесь в службу поддержки Cisco TAC.
-
На странице соглашения о синхронизации поля Выполнять синхронизацию каждые и Время следующей повторной синхронизации отображаются активными. Однако эти поля будут неактивны на сервере Unified CM, если включен параметр Выполнить синхронизацию только один раз. В настоящее время это является ограничением функции подготовки службы каталогов выделенного экземпляра Webex Calling, которая будет исправлена в предстоящем выпуске.
-
Пользователи, удаленные на портале Azure, становятся неактивными в службе удостоверений Webex, но отображаются как активные в Unified CM.
Обходное решение. Перейдите к меню Управление > Пользователи и удалите пользователя из Control Hub. Пользователь будет помечен как неактивный в Unified CM.
-
При подготовке новых кластеров для крупных организаций (с более чем 80 000 пользователями) в настоящий момент будет наблюдаться время ожидания. Эта проблема скоро будет решена.
-
При нажатии кнопок Прервать, Продолжить и Включить синхронизацию на странице "Включить синхронизацию" состояние кластера в интерфейсе пользователя не изменится немедленно. Это ограничение вводит в заблуждение, поскольку действия выполняются на сервере.
Обходное решение. Не нажимайте кнопки дважды и проверьте состояние кластера через несколько секунд. Состояние кластера изменится с Требуется действие на Обработка. Эта проблема будет решена в ближайшее время.
-
В настоящее время функция Включить синхронизацию прекращает отвечать, если сеть Unified Communications Manager не работает.
Обходное решение. Чтобы отключить службу каталогов, обратитесь в службу поддержки Cisco TAC. Подождите несколько минут и снова начните настройку службы каталогов. Эта проблема будет исправлена в предстоящем выпуске.
-
Во время подготовки список сведений о группе не заполняется из-за проблем синхронизации со службой общих параметров идентификации Webex. Пользователям рекомендуется отказаться от подготовки и повторить попытку через некоторое время.