- Главная
- /
- Статья
Синхронизация каталогов в Webex для Cisco BroadWorks
В этой статье описано, как развернуть синхронизацию каталогов в Webex для Cisco BroadWorks. Эта статья предназначена для поставщик услуг администраторов партнерских организаций.
Обзор синхронизации каталогов
Синхронизация каталогов гарантирует, что пользователи Webex для Cisco BroadWorks могут использовать каталог Webex из приложения Webex для вызова любого вызываемого объекта с сервера BroadWorks. Эта функция синхронизирует информацию о вызовах BroadWorks, которая не была частью обеспечения пользователя для каталога Webex.
При обеспечении webex для пользователя Cisco BroadWorks каталог Webex обновляется с учетом сведений о вызовах Webex для пользователей Cisco BroadWorks (основной номер телефона, номер мобильного телефона, расширение), но не записывают записи внешних вызовов. Однако, когда синхронизация каталогов в настоящее время находится в сети, она также синхронизирует следующие записи о вызовах с каталогом Webex.
-
Вызовы только BroadWorks (пользователи, не которых нет в Webex)
-
Объекты вызовов не пользователей (например, комната для совещаний, факс, сервисная группа номер)
-
Записи списка телефонов BroadWorks
В таблице ниже фиксируют записи вызовов BroadWorks и показано, как они добавляются в каталог Webex.
Записи вызовов BroadWorks |
Описание |
Добавлено в каталог Webex с помощью... |
---|---|---|
Webex для пользователей Cisco BroadWorks |
Для пользователей включена webex для Cisco BroadWorks |
Обеспечение пользователя (например, поминая подготовка) |
Вызовы пользователей только BroadWorks |
Вызов пользователей, не которых нет в Webex |
Синхронизация каталогов |
Объекты вызовов, не взывающих пользователей |
Например, номер комната для совещаний телефона, факса, номера группы поисков |
Синхронизация каталогов |
Списки телефонов BroadWorks |
Записи списка телефонов BroadWorks:
|
Синхронизация каталогов (синхронизация списка телефонов) |
Условия синхронизации каталогов
-
Администраторы-партнеры должны включить эту функцию на уровне партнера. Администраторы партнеров могут включить или выключить эту функцию для нескольких клиентских организаций с помощью одной операции.
-
По умолчанию начальная синхронизация осуществляется через неделю после включения синхронизации (время для запуска синхронизации выбирается случайным образом). Однако клиентские организации могут использовать параметр Sync Now , чтобы обойти недельный период ожидания и запустить немедленную синхронизацию для определенной клиентской организации.
-
По умолчанию синхронизация каталогов запускается еженедельно для каждого клиента. Каждая синхронизация происходит через неделю после последней синхронизации, независимо от того, была ли запланирована или инициаизирована последняя синхронизация вручную с помощью sync Now.
-
Максимальное количество одновременных синхронизаций для кластера BroadWorks составляет два: одна запланированная синхронизация и одна синхронизация по запросу (посредством API или GUI Partner Hub). Однако администраторы не могут одновременно запускать две синхронизации "по запросу" из одной broadWorks. Это ограничение существует независимо от того, была ли синхронизация инициирована с помощью API или с помощью параметра Синхронизировать сейчас в Partner Hub. Кроме того, Webex не будет планировать две запланированные синхронизации, которые будут запускаться одновременно с одной и той же BroadWorks.
-
В случае сбоя синхронизации Webex будет автоматически переключена каждые 24 часа до следующей запланированной синхронизации.
-
При синхронизации будут проигнорорируются пользователи, у которых нет номера телефона.
-
В центре партнера можно просмотреть информацию о состоянии синхронизации для определенного клиента. Кроме того, можно экспортировать подробную информацию о последней синхронизации, выполнив запись в формате CSV. Запись CSV обеспечивает более подробные данные, чем экран Control Hub, и может помочь в устранении неполадок, аналитиках и аудите.
-
Webex сохраняет контакты пользователей в зашифрованном формате. Доступ к ключу расшифровки есть только у пользователя, который является его владельцем.
-
Для пользователей, которые звонят только в BroadWorks, и устройств, вызывающих не пользователей, эта функция синхронизирует следующие типы номеров телефона с BroadWorks:
-
Основной номер телефона
-
Номер мобильного телефона
-
Расширение
Однако синхронизация исключает из синхронизации пользователей, которые звонят только BroadWorks, и не пользователей, если ни основной номер телефона, ни расширение не присутствуют.
Настройка службы конфиденциальности на уровне пользователя BroadWorks не поддерживается в рамках синхронизации каталогов.
-
Список телефонов BroadWorks и максимальное число контактов
Синхронизация каталогов также синхронизирует записи списка телефонов BroadWorks со списком контактов Webex. Синхронизированные записи добавляются в один из следующих типов контактов:
-
Контакты организации. Webex сохраняет эти контакты в отношении организации. Каждый пользователь имеет доступ к контактам организации. Максимум 30000 контактов.
-
Контакты пользователя. Webex сохраняет эти контакты в отношении пользователя. Доступ к записи контакта может получить только тот пользователь, который является владельцем контакта. Максимум до 2000 контактов (1500 синхронизированных контактов + 500 контактов для ввода вручную).
В таблице ниже сопомечируются типы контактов Webex с источником контактов (синхронизированные со списком телефонов BroadWorks или добавленные вручную).
Тип контакта Webex |
Источник контакта |
Maximum (Максимум) |
Синхронизировано из BroadWorks... |
API синхронизации |
---|---|---|---|---|
Контакты организации |
Синхронизация каталогов |
30 000 контактов |
Общие списки телефонов предприятия |
|
Общие списки телефонов группы (для группы поставщиков услуг) ** |
| |||
Контакты пользователя |
Синхронизация каталогов |
1500 контактов |
Личные списки телефонов | /каталоги/личные |
Добавлено пользователем вручную |
500 контактов |
н/д |
н/д | |
Контакты группы |
Синхронизация каталогов |
30 000 контактов в группе |
Общие списки телефонов группы (для корпоративной группы) ** | /каталоги/группы |
** Общие списки телефонов группы синхронизируются по-разному в зависимости от того, находится ли BroadWorks в корпоративном или поставщик услуг режиме. Значение параметра isBroadWorksEnterprise
(true или false) определяет синхронизацию списка:
-
True: синхронизация как групповой контакт
-
False. Синхронизировать как контакт организации
Описанные ниже условия применимы к обработке максимального количества контактов службой синхронизации каталогов.
-
Если организация превышает максимально допустимое количество контактов для синхронизации (30 000 контактов организации или 30 000 общих контактов группы на группу), синхронизация каталогов исключает записи, превышающие максимальное пороговое значение. К синхронизированным и пропущенным контактам не применяется определенный порядок.
-
Если один из ваших клиентов превышает максимально допустимое количество контактов в любой из категорий, рекомендуется обратиться в службу cisco для исключения этой организации из синхронизации каталогов.
-
Контакты, добавленные вручную, – это контакты, которые пользователь добавляет вручную в приложении Webex. Пользователь может добавить до 500 контактов вручную. Ручные контакты подраздеятся на более крупные категории контактов пользователей в Webex, но не включены в синхронизацию.
-
Общий суммарный лимит контактов организации (30000) и групповых контактов (30000 на группу) составляет 200000.
Обновления
Ниже приведены условия обработки обновлений каталогом Webex.
-
Если имя контакта изменяется в BroadWorks, существующий контакт удаляется из каталога Webex и создается новый контакт.
-
Если номер контакта изменится в BroadWorks, Webex обноит существующий контакт в каталоге Webex новым номером.
После обновления контакта администратором в BroadWorks при отобрачении обновления в приложении Webex пользователя будут отображаться следующие условия.
-
Если обновление действительно для вызываемого пользователя с возможностью только BroadWorks или вызываемого объекта, который не является пользователем, обновление отображается в приложении Webex пользователя сразу после последующей синхронизации каталогов.
-
Если обновление имеет место для записи списка телефонов BroadWorks,
-
Для контактов пользователей. Обновления отображаются в приложении Webex пользователя сразу после последующей синхронизации каталогов.
-
Для групповых контактов: обновления отображаются в приложении Webex для пользователей сразу после последующей синхронизации каталога.
-
Для контактов организации. Каталог Webex обновляется при последующей синхронизации каталогов, однако пользователи не будут видеть изменения в приложении Webex, пока не перезапустят приложение Webex или пока не истечет срок действия локального 72-часового времени с момента истечения времени, задаваемого для кэша.
-
Предварительные требования для синхронизации каталогов
Рекомендуется использовать следующие настройки.
-
Значения ограничения скорости: задайте следующие свойства системы для управления устранением перегрузки (XSP_CLI/Applications/Xsi-Actions/OverloadControl):
-
userDirectoryTransactionLimit — Установите значение «null».
-
globalDirectoryTransactionLimit — Установите значение «null».
Рекомендуется установить userDirectoryTransactionLimit и globalDirectoryTransactionLimit на нулевое значение. Но если вы решите установить значения, каждое из них должно быть как минимум в пять раз больше значения transactionLimitPeriodSecond (которое должно быть равным 1). -
-
Ограничения транзакций – задайте следующие значения (XSP_CLI/System/CommunicationUtility/DefaultSettings):
-
userTransactionLimits – установите значение не менее "100".
-
transactionLimitPeriodSeconds – установите значение "1".
-
-
Значения пейджинга – задайте свойства системы пейджинга (XSP_CLI/Applications/Xsi-Actions/Paging):
-
defaultPageSize – Значение «50»
-
availableUserMaxLimit – Значение «100»
-
-
Интерфейс CTI — Убедитесь в том, что вы загрузили сертификаты Webex CA в trust store интерфейса CTI и в том, что вы включили аутентификацию клиента в интерфейсе CTI.
Кроме того, в зависимости от выпуска BroadWorks, рекомендуется применить указанные далее системные исправления к развертыванию BroadWorks перед тем, как включить эту функцию.
-
Для R22:
AP.as.22.0.1123.ap368517
-
Для R23:
AP.as.23.0.1075.ap368517
-
Для R24: исправление не требуется
Включение синхронизации каталогов (новый шаблон)
Администраторы партнеров могут включить функцию синхронизации каталогов для шаблона клиента при создании нового шаблона. Для всех новых клиентских организаций, которые назначены этому шаблону, будет включена синхронизация каталогов. Подробности см. в разделе "Настройка шаблонов клиентов" раздела Настройка партнерской организации в центре партнера в руководстве по решению Webex для Cisco BroadWorks.
Дальнейшие действия
Не забудьте проинформировать пользователей о том, что для включения этой функции в приложении Webex необходимо хотя бы один раз перейти на вкладку Контакты в приложении Webex. Это действие необходимо выполнить только один раз.
Включение синхронизации каталогов (существующий шаблон)
1 |
Войдите в центр партнера и щелкните Настройки. |
2 |
Прокрутите страницу до раздела Вызовы BroadWorks и щелкните Просмотр шаблонов. |
3 |
Выберите соответствующий шаблон клиента и прокрутите страницу до раздела Синхронизация каталога BroadWorks. |
4 |
Чтобы включить синхронизацию каталогов по умолчанию для новых клиентских организаций, использующих этот шаблон, выполните указанные ниже действия. |
5 |
Чтобы включить синхронизацию каталогов для существующих клиентских организаций, использующих этот шаблон, выполните указанные ниже действия. Чтобы отключить синхронизацию каталогов, выполните описанную выше процедуру с учетом указанного ниже.
|
Дальнейшие действия
Не забудьте проинформировать пользователей о том, что для включения этой функции в приложении Webex необходимо хотя бы один раз перейти на вкладку Контакты в приложении Webex. Это действие необходимо выполнить только один раз.
Запустить немедленную синхронизацию
1 |
Войдите в Partner Hub ( http://admin.webex.com) и выберите Settings. |
2 |
Прокрутите страницу до раздела Вызовы BroadWorks и щелкните Просмотр шаблонов. |
3 |
Выберите соответствующий шаблон клиента и прокрутите страницу до раздела Синхронизация каталога BroadWorks. |
4 |
Щелкните Показать список состояний синхронизации клиентов. |
5 |
Для клиентской организации, которую необходимо синхронизировать, щелкните троеточие справа и выберите Синхронизировать сейчас. |
6 |
Чтобы отобразить результат синхронизации, щелкните Обновить. |
Экспорт записей синхронизации в файл CSV
1 |
Войдите в Partner Hub ( http://admin.webex.com) и выберите Settings. |
2 |
Прокрутите страницу до раздела Вызовы BroadWorks и щелкните Просмотр шаблонов. |
3 |
Выберите соответствующий шаблон клиента и прокрутите страницу до раздела Синхронизация каталога BroadWorks. |
4 |
Щелкните Показать список состояний синхронизации клиентов. |
5 |
Установите флажки для каждой организации, которую необходимо включить в экспорт. |
6 |
Щелкните Результаты экспорта. |
Общедоступные API для синхронизации каталогов
Общедоступные API размещены на веб-сайте developer.webex.com. С их помощью администраторы партнеров могут обновлять настройки синхронизации каталогов для клиентских организаций, которыми они управляют, запускать немедленную синхронизацию или получать информацию о состоянии синхронизации. Методы синхронизации каталогов сгруппируются по предприятиям BroadWorks:
-
Список предприятий BroadWorks— Используйте этот метод API для получения списка предприятий в рамках данного поставщика услуг и каждого предприятия
идентификатор
. Необходимо ввести идентификаторspEnterpriseId
в соответствии с назначением при подготовке. -
Обновить синхронизацию каталога для предприятия BroadWorks — введите
идентификатор
предприятия, чтобы обновить состояние SYC каталога для этого предприятия, включив или отключив синхронизацию каталога. -
Триггер синхронизации каталогов для предприятия. Используйте этот метод API, чтобы запустить немедленную синхронизацию для определенного корпоративного
идентификатора
. Для параметраsyncStatus
введите командуSYNC_NOW
. -
Получить состояние синхронизации каталогов для предприятия. Введите
идентификатор предприятия
и выполните запуск, чтобы получить состояние иtrackingId
последней синхронизации. С помощьюtrackingID
можно запустить дополнительные аналитические данные с помощью таких инструментов, как Kibana и Grafana.
Кроме того, администраторы могут использовать триггерную синхронизацию каталога для API одного пользователя для запуска синхронизации каталогов по запросу для одного пользователя.
Подробную документацию относительно API см. по ссылке https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
Чтобы ознакомиться с спецификацией API, необходимо войти в https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Синхронизация нескольких предприятий с помощью API
-
Синхронизация каталогов позволяет синхронизировать только одно предприятие с кластером Broadworks одновременно посредством синхронизации по запросу. При попытке синхронизировать несколько предприятий вы получите ошибку 429
-
Время, необходимое для запуска синхронизации для одного предприятия, варьируется в зависимости от размера предприятия.
1 |
Запустите API List BroadWorks Enterprises (Перечисление предприятий BroadWorks), чтобы создать список предприятий, которые необходимо синхронизировать. |
2 |
Запустите API Trigger Directory Sync for an Enterprise (Запуск синхронизации каталогов для предприятия) на первом предприятии в списке. |
3 |
Подождите несколько секунд и запустите API Get Directory Sync Status (Получение данных о состоянии синхронизации каталогов для предприятия), чтобы получить сведения о состоянии синхронизации. |
4 |
По завершении синхронизации выполните шаги 2–4 для следующего предприятия в списке. Повторяйте эти шаги, пока не будет синхронизирован весь список. |
Коды ошибок для синхронизации каталогов
К синхронизации каталогов применяются перечисленные ниже коды ошибок.
Код ошибки |
Сообщение об ошибке |
---|---|
600000 |
Непредвиденная ошибка синхронизации пользователей внешнего каталога Broadworks. |
600001 |
Не удалось синхронизировать пользователей внешнего каталога Broadworks. |
600002 |
Синхронизация пользователей внешнего каталога Broadworks прервана до завершения. |
600003 |
Синхронизация пользователей внешнего каталога Broadworks успешно выполнена только частично. Не удалось синхронизировать некоторые клиентские организации. |
600004 |
Синхронизация пользователей внешнего каталога Broadworks не включена для параметра ConfigSet. |
600005 |
Выполняется синхронизация пользователей с внешним каталогом Broadworks для параметра ConfigSet. |
600006 |
Цепочки синхронизации пользователей внешнего каталога Broadworks заняты или закрываются, поэтому запросы о синхронизации больше приниматься не будут. Повторите попытку позже. |
600007 |
Идентифицируемая организация CustomerConfig не найдена. |
600008 |
Параметр CustomerConfig не найден в партнерской организации. |
600009 |
Невозможно запустить синхронизацию пользователей внешнего каталога Broadworks, поскольку кластер Broadworks, связанный с CustomerConfig, занят. |
600010 |
Не удается запустить синхронизацию пользователей внешнего каталога Broadworks, поскольку отсутствует кластер BroadWorks, связанный с CustomerConfig. |
600011 |
Синхронизация пользователей внешнего каталога Broadworks не включена для CustomerConfig. |
600012 |
Не удается запустить синхронизацию пользователей внешнего каталога Broadworks, поскольку синхронизация каталогов гибридного типа уже включена для CustomerConfig. |
600013 |
Во время синхронизации пользователей внешнего каталога Broadworks не удалось добавить учетные записи пользователей и компьютеров в хранилище удостоверений. |
600014 |
Ошибка синхронизации пользователей внешнего каталога Broadworks при попытке подключения к кластеру Broadworks. Ошибка Broadworks: %s. |
600015 |
При синхронизации пользователей внешнего каталога Broadworks не найдены соответствующие пользователи в хранилище удостоверений. |
600017 |
При синхронизации списка телефонов BroadWorks не удалось синхронизировать все контакты пользователя и предприятия/организации. |
600018 |
Синхронизация списка телефонов BroadWorks не удалась для пользователей в предприятии/организации. |
600019 |
При синхронизации списка телефонов BroadWorks не удалось синхронизировать контакты предприятия/организации. |
600020 |
Синхронизация пользователей с внешним каталогом BroadWorks не может быть отключена, поскольку в настоящее время идет синхронизация CustomerConfig. |
600022 |
Синхронизация пользователей с внешним каталогом BroadWorks не возможна, поскольку в организации нет предусмотренного пользователя. |
600023 |
Синхронизация пользователей с внешним каталогом BroadWorks невозможен, поскольку пользователь уже существует в этой организации. |
600024 |
Синхронизация с одним пользователем из внешнего каталога BroadWorks не возможна, поскольку в BroadWorks не найдено ни одного совместимго пользователя. |
600025 |
Не удалось обновить данные синхронизации пользователей внешнего каталога BroadWorks в учетная запись пользователя CI. |
600026 |
Не удалось обновить учетную запись компьютера в CI в BroadWorks External Directory User Sync. |
600027 |
Синхронизация пользователей с внешним каталогом BroadWorks не возможна, поскольку в BroadWorks было обнаружено несколько пользователей. |
600028 |
Синхронизация с одним пользователем в BroadWorks с внешним каталогом невозможен, поскольку должна быть завершена по крайней мере одна синхронизация корпоративного каталога. |
600029 |
Не удалось синхронизировать пользователей с внешним каталогом BroadWorks, поскольку в организации не предусмотрен пользователь. |
История изменений
В следующей таблице подводятся краткие итоги по обновлениям этой статьи.
Дата |
Редакция |
---|---|
14 февраля 2023 г. |
Обновлен раздел Максимумы синхронизации каталогов и источник . |
10 декабря 2022 г. |
Обновленный термин Завершить немедленную синхронизацию до Инициировать синхронизацию каталога |
19 июля 2022 г. |
Разъяснения и исправления обзорной информации.
|
9 мая 2022 г. |
|
7 апреля 2022 г. |
|
28 марта 2022 г. |
|
24 марта 2022 г. |
Добавлен список типов синхронизированных номеров телефона в условия синхронизации каталогов. Теперь синхронизация включает номера мобильных телефонов. |
16 марта 2022 г. |
|
17 декабря 2021 г. |
|
16 декабря 2021 г. |
|
8 декабря 2021 г. |
|