Синхронизация каталогов в Webex для Cisco BroadWorks

Синхронизация каталогов гарантирует, что пользователи Webex для Cisco BroadWorks могут использовать каталог Webex из приложения Webex для вызова любого вызывающего объекта с сервера BroadWorks. Эта функция синхронизирует информацию о вызовах BroadWorks, которая не была частью подготовки пользователей, с каталогом Webex.

Подготовка пользователей Webex для Cisco BroadWorks обновляет каталог Webex с сведениями о вызовах для пользователей Webex для Cisco BroadWorks (основной номер телефона, номер мобильного телефона, добавочный номер), но не содержит записей внешних вызовов. Однако, если синхронизация каталога включена, функция также синхронизирует следующие записи вызовов с каталогом Webex.

• Пользователи вызовов только для BroadWorks (которые не подключены к Webex)

• Объекты для вызовов, не являющиеся пользователями (например, телефон конференц-зала, факс, номер сервисной группы)

• Записи списка телефонов BroadWorks

В следующей таблице приведены краткие сведения о записях вызовов BroadWorks и показано, как они добавляются в каталог Webex.

Условия синхронизации каталогов

• Администраторы партнеров должны включить эту функцию на уровне партнеров. Администраторы партнеров могут включить или выключить эту функцию для нескольких клиентских организаций с помощью одной операции.

• По умолчанию начальная синхронизация осуществляется через неделю после включения синхронизации (время для запуска синхронизации выбирается случайным образом). Однако клиентские организации могут использовать параметр Sync Now , чтобы обойти недельный период ожидания и запустить немедленную синхронизацию для определенной клиентской организации.

• По умолчанию синхронизация каталогов запускается еженедельно для каждого клиента. Каждая синхронизация выполняется через неделю после последней синхронизации независимо от того, была ли последняя синхронизация запланирована или запущена вручную с помощью синхронизации сейчас.

• Максимальное количество одновременных синхронизаций в кластере BroadWorks составляет два: одна запланированная синхронизация и одна синхронизация по запросу (с помощью API или графического интерфейса Partner Hub). Однако администраторы не могут одновременно запустить две синхронизации по запросу из одного и того же BroadWorks. Это ограничение существует независимо от того, была ли синхронизация инициирована с помощью API или с помощью параметра Sync Now в 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 или добавленным вручную).

Описанные ниже условия применимы к обработке максимального количества контактов службой синхронизации каталогов.

• Если организация превышает максимально допустимое количество контактов для синхронизации (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. Это действие необходимо выполнить только один раз.

Общедоступные API размещены на веб-сайте developer.webex.com. С их помощью администраторы партнеров могут обновлять настройки синхронизации каталогов для клиентских организаций, которыми они управляют, запускать немедленную синхронизацию или получать информацию о состоянии синхронизации. Методы синхронизации каталогов сгруппированы в разделе BroadWorks Enterprises:

• List BroadWorks Enterprises (Перечисление предприятий BroadWorks). Используйте этот метод API для получения списка предприятий у определенного поставщика услуг, а также отображения для каждого предприятия его id. Необходимо ввести значение spEnterpriseId, назначенное при подготовке.

• Update Directory Sync for a BroadWorks Enterprise (Обновление синхронизации каталогов для предприятия BroadWorks). Введите id предприятия, чтобы обновить состояние синхронизации каталога для этого предприятия, включая или отключая синхронизацию каталогов.

• Trigger Directory Sync for an Enterprise (Запуск синхронизации каталогов для предприятия). Используйте этот метод API, чтобы инициировать немедленную синхронизацию для определенного id. Для syncStatus введите команду SYNC_NOW.

• Get Directory Sync Status for an Enterprise (Получение данных о состоянии синхронизации каталогов для предприятия). Введите id предприятия и запустите для получения сведений о состоянии и значения 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.

К синхронизации каталогов применяются перечисленные ниже коды ошибок.

В следующей таблице подводятся краткие итоги по обновлениям этой статьи.