Преглед на синхронизирането на директории

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

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

  • Потребители, които се обаждат само за BroadWorks (които не са включени в Webex)

  • Непотребителски обаждащи се обекти (напр. телефон за конферентна зала, факс машина, номер на група за търсене )

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

Следващата таблица обобщава записите за повиквания на BroadWorks и показва как те се добавят към директорията на Webex .

Таблица 1. Directory Sync актуализации на Webex Directory

Записи за разговори на BroadWorks

Описание

Добавено към Webex Directory чрез...

Webex за потребители на Cisco BroadWorks

Потребителите са активирани за Webex за Cisco BroadWorks

Предоставяне на потребители (напр. поточно обезпечаване)

Потребители, които се обаждат само за BroadWorks

Обаждане на потребители, които са не включен в Webex

Синхронизиране на директория

Обекти, които не са потребители

Например телефон за конферентна зала, факс, номер на групата на Хънт

Синхронизиране на директория

Списъци с телефони на BroadWorks

Записи в телефонния списък на BroadWorks:

  • Общи телефонни списъци на предприятието

  • Групови общи телефонни списъци (групи на доставчици на услуги или корпоративни групи)

  • Лични телефонни списъци

Синхронизиране на директория (синхронизиране на телефонен списък)


За повече подробности относно предоставянето на потребители, вижте Ръководство за решение за Webex за Cisco BroadWorks .

Условия за синхронизиране на директория

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

  • По подразбиране първоначалното синхронизиране се извършва една седмица след разрешаването на синхронизирането (времето, избрано за стартиране на синхронизирането, е произволно). Въпреки това, организациите на клиенти могат да използват Синхронизирайте сега опция за заобикаляне на едноседмичния период на изчакване и задействане на незабавно синхронизиране за дадена клиентска организация.

  • По подразбиране синхронизирането на директория се изпълнява ежеседмично за всеки клиент. Всяко синхронизиране се извършва една седмица след последното синхронизиране, независимо дали последното синхронизиране е било планирано или задействано ръчно с Синхронизирайте сега .

  • максимален брой едновременни синхронизации на BroadWorks клъстер е две: едно планирано синхронизиране и едно синхронизиране при поискване (чрез API или GUI на Partner Hub). Въпреки това, администраторите не могат да изпълняват две синхронизации при поискване едновременно от един и същ BroadWorks. Това ограничение съществува независимо дали синхронизирането е инициирано чрез API или чрез Синхронизирайте сега опция в Partner Hub. Освен това Webex няма да планира две планирани синхронизации да се изпълняват едновременно от един и същ BroadWorks.

  • Ако възникне грешка при синхронизиране, Webex прави повторни опити за синхронизиране автоматично на всеки 24 часа до следващото планирано синхронизиране.

  • Синхронизирането игнорира потребители, които нямат телефонен номер.

  • В Partner Hub можете да видите информация за състоянието на синхронизиране за даден клиент. Освен това можете да експортирате подробна информация за последното синхронизиране в CSV запис. CSV записът предоставя повече подробности от дисплея на Control Hub и може да помогне при отстраняване на неизправности, анализи и одит.

  • Webex съхранява потребителските контакти в криптиран формат. Само потребителят, който притежава контакта, има достъп до ключа за декриптиране.

  • За потребители, обаждащи се само за BroadWorks, и за обаждащи се обекти, които не са потребители, тази функция синхронизира следните типове телефонен номер от BroadWorks:

    • Основен телефонен номер

    • Номер на мобилен телефон

    • Вътрешен номер

    Синхронизирането обаче изключва от синхронизирането потребители, обаждащи се само за BroadWorks, и обекти, които не са потребители, ако не присъства нито първичен телефон номер, нито разширение.

Списък с телефони и контакти на BroadWorks

Синхронизирането на директория също така синхронизира записите от телефонния списък на BroadWorks с Webex Contacts. Синхронизираните записи се добавят към един от следните типове контакти:

  • Контакти на организация — Webex съхранява тези контакти срещу организация. Всеки потребител има достъп до контактите на организацията за своята организация. Максимумът е до 30 000 контакта.

  • Потребителски контакти — Webex съхранява тези контакти срещу потребител. Само потребителят, който притежава контакта, има достъп до записа за контакт. Максимумът е до 2000 контакта (1500 синхронизирани контакта + 500 контакта за ръчно въвеждане).


Към контактите на Webex се добавят само записи в телефонния списък. Потребителите, които се обаждат само за BroadWorks, и обаждащите се обекти, които не са потребители, които са включени в синхронизирането на директория, не се добавят към Контакти, освен ако потребител на Webex не ги добави към Контакти ръчно.

Следната таблица показва типове контакти на Webex спрямо източника на контакт (синхронизиран от списък с телефони на BroadWorks или добавен ръчно):

Таблица 2. Максимум и източник за синхронизиране на директория

Тип контакт на Webex

Свържете се с източника

Максимално

Синхронизирано от BroadWorks...

API , използван за синхронизиране

Контакти на организацията

Синхронизиране на директория

30 000 контакта

Общи телефонни списъци на предприятието

/directories/enterprisecommon

Групови общи телефонни списъци (за група доставчици на услуги)**

/directories/groupcommon

Потребителски контакти

Синхронизиране на директория

1500 контакта

Лични телефонни списъци

/directories/personal

Добавено ръчно от потребител

500 контакта

Няма

Няма

Групови контакти

Синхронизиране на директория

30 000 контакта на група

Групови общи телефонни списъци (за корпоративна група)**

/directories/groupcommon

** Записите в общите телефонни списъци на групата се синхронизират по различен начин в зависимост от това дали BroadWorks е в режим на предприятието или режим на доставчик на услуги. Стойността на isBroadWorksEnterprise параметър (true или false) определя как се синхронизира списъкът:

  • Вярно – Синхронизиране като групов контакт

  • False—Синхронизиране като контакт от организация

Следните условия се прилагат относно начина, по който Directory Sync обработва максималните стойности на контактите:

  • Ако дадена организация надвиши максимално разрешените контакти за синхронизиране (30 000 контакта на организацията или 30 000 групови общи контакти на група), синхронизирането на директория изключва записи над максималния праг. Няма конкретен ред, приложен към синхронизирани или пропуснати контакти.

  • Ако един от вашите клиенти надвишава максимално позволения брой контакти в която и да е категория, препоръчваме ви да повдигнете дело пред Cisco , за да изключите тази организация от синхронизирането на директорията.

  • Ръчните контакти са контакти, които потребителят добавя ръчно в приложението Webex . Потребител може да добави до 500 ръчни контакта. Ръчните контакти попадат в по-голямата категория потребителски контакти на Webex, но не са включени в синхронизирането.

  • Общото комбинирано ограничение за организационни контакти (30000) и групови контакти (30000 на група) е 200 000.

Актуализации

Следва как директорията Webex обработва актуализации:

  • Ако име на контакт се промени в BroadWorks, съществуващият контакт се изтрива от директорията на Webex и се създава нов контакт.

  • Ако номерът за контакт се промени в BroadWorks, Webex актуализира съществуващия контакт в директорията на Webex с новия номер.

След като администратор актуализира контакт в BroadWorks, следните условия очертават кога актуализацията се показва в приложението Webex на потребителя:

  • Ако актуализацията е към потребител, който се обажда само на BroadWorks, или обект, който не е потребител, актуализацията се показва в приложението Webex на потребителя веднага след последващото синхронизиране на директорията.

  • Ако актуализацията е към запис в телефонния списък на BroadWorks:

    • За потребителски контакти — актуализациите се показват в приложението Webex на потребителя веднага след последващото синхронизиране на директория.

    • За групови контакти - Актуализациите се показват в приложението Webex на потребителите веднага след последващото синхронизиране на директория.

    • За контакти в организацията – директорията Webex се актуализира при следващото синхронизиране на директорията, но потребителите няма да видят промяната в приложението Webex , докато не рестартират приложението Webex или докато изтече локалният 72-часов кеш таймер.


Актуализациите на информация за потребителя на Webex за Cisco BroadWorks се обработват като част от процесите на осигуряване.

Control Hub съдържа опция за добавяне или редактиране на контакти на ниво организация в Control Hub чрез CSV файл. Администраторите на партньори и администраторите на клиенти с достъп до Control Hub имат достъп до тази опция. Въпреки това, актуализирането на контакти чрез Control Hub не се поддържа от Webex за Cisco BroadWorks. Актуализациите за контакти, приложени в Control Hub, не се синхронизират обратно с BroadWorks и не са достъпни за търсене в директории от настолни телефони.

Предпоставки за синхронизиране на директории

Препоръчваме ви да използвате следните настройки:


Примерите по-долу предполагат, че използвате XSP сървър. За ADP сървъри заменете (XSP_ CLI) с (ADP_ CLI).
  • Стойности за ограничаване на скоростта – задайте следните системни свойства на OverloadControl (XSP_ CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit—Задава се на нулева стойност.

    • globalDirectoryTransactionLimit—Задава се на нулева стойност.


    Препоръчително е да зададете userDirectoryTransactionLimit и globalDirectoryTransactionLimit на стойност нула. Въпреки това, ако решите да присвоите стойности, всяка трябва да бъде настроена на поне пет пъти стойността на транзакциятаLimitPeriodSeconds (която трябва да бъде 1).
  • Ограничения на транзакциите – Задайте следните стойности (XSP_ CLI/System/CommunicationUtility/DefaultSettings):

    • userTransactionLimit—Задайте най-малко 100.

    • транзакцияLimitPeriodSecs—Задайте на 1.

  • Стойности за пейджинг – задайте свойствата на системата за пейджинг (XSP_ CLI/Applications/Xsi-Actions/Page):

    • defaultPageSize—Задайте на 50

    • availableUserMaxLimit—Настройте на 100

  • CTI интерфейс – Уверете се, че сте качили тези сертификати на Webex CA в хранилището за доверие на интерфейса CTI и активирате удостоверяването на клиента в CTI интерфейса.

Освен това, в зависимост от вашата версия на BroadWorks, препоръчваме да приложите следните системни корекции към разполагането на BroadWorks, преди да активирате тази функция:

Активиране на синхронизирането на директории (нов шаблон)

Администраторите на партньори могат да активират синхронизиране на директория за клиентски шаблон, докато създават новия шаблон. Всички нови клиентски организации, които бъдат присвоени на този шаблон, ще имат активирано синхронизиране на директории. За подробности вижте „Конфигуриране на вашите клиентски шаблони“ в Конфигурирайте вашата партньорска организация в Partner Hub в рамките на Ръководство за решение за Webex за Cisco BroadWorks .

Какво да правя След това

Уверете се, че вашите потребители знаят, че трябва да щракнат върху Контакти раздел в приложението Webex поне веднъж, за да включите функцията в приложението Webex . Това трябва да бъде завършено само веднъж.

Активиране на синхронизиране на директории (съществуващ шаблон)

Администраторите на партньори могат да изпълнят следните стъпки, за да включат синхронизирането на директории в рамките на съществуващ клиентски шаблон, за да активират функцията за организациите на клиенти, които използват шаблона.

1

Влезте в Partner Hub и изберете Настройки .

2

Превъртете до Обаждане на BroadWorks и щракнете Преглед на шаблони .

3

Изберете подходящия клиентски шаблон и превъртете до BroadWorks Directory Sync .

4

За да активирате синхронизирането на директории по подразбиране за нови клиентски организации, които използват този шаблон:

  1. Задайте Активирайте синхронизирането на директория и телефонен списък на BroadWorks за всички нови организации на клиенти превключете към Включено .

  2. Щракнете върху Запиши.

5

За да активирате синхронизирането на директории за съществуващи клиентски организации, които използват този шаблон:

  1. Щракнете върху Показване на списък със състоянието на синхронизиране на клиенти .

  2. Поставете отметка в съседните квадратчета за всяка организация, за която искате да включите функцията.

  3. Щракнете върху Активиране на синхронизирането .


 

Ако искате да деактивирате синхронизирането на директории, следвайте горната процедура и:

  • В стъпка 4а задайте Активирайте синхронизирането на телефонния указател за всички нови клиентски организации превключете към Изключено за да деактивирате синхронизирането на директории по подразбиране за нови клиентски организации, които използват този шаблон.

  • В стъпка 5c щракнете Деактивирайте синхронизирането за да изключите функцията за съществуващи организации.

Какво да направите след това

Уверете се, че вашите потребители знаят, че трябва да щракнат върху Контакти раздел в приложението Webex поне веднъж, за да включите функцията в приложението Webex . Това трябва да бъде завършено само веднъж.

Задействайте незабавно синхронизиране

В Синхронизирайте сега опцията позволява на администратора на партньора да задейства синхронизиране при поискване за дадена клиентска организация. Тази опция може да бъде избрана само за отделни клиентски организации—няма групова опция за Синхронизиране сега.

1

Влезте в Partner Hub (http://admin.webex.com ) и изберете Настройки .

2

Превъртете до Обаждане на BroadWorks и щракнете Преглед на шаблони .

3

Изберете подходящия клиентски шаблон и превъртете до BroadWorks Directory Sync .

4

Щракнете върху Показване на списък със състоянието на синхронизиране на клиенти .

5

За организацията на клиента, която искате да синхронизирате, щракнете върху трите точки най-вдясно и изберете Синхронизирайте сега .

6

Щракнете върху Обнови за да видите резултатите от синхронизирането.

Експортиране на синхронизирани записи в CSV

Администраторите на партньори могат да експортират подробна информация за последното синхронизиране в CSV файл. CSV съдържа по-подробен изглед на синхронизиращия запис от GUI на Control Hub и може да помогне при отстраняване на неизправности и анализи.

1

Влезте в Partner Hub (http://admin.webex.com ) и изберете Настройки .

2

Превъртете до Обаждане на BroadWorks и щракнете Преглед на шаблони .

3

Изберете подходящия клиентски шаблон и превъртете до BroadWorks Directory Sync .

4

Щракнете върху Показване на списък със състоянието на синхронизиране на клиенти .

5

Поставете отметка в съседните квадратчета за всяка организация, която искате да включите в експортирането.

6

Щракнете върху Експортиране на резултати .

Публични API за синхронизиране на директории

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

  • Избройте предприятията на BroadWorks —Използвайте този метод на API , за да получите списък с предприятия при даден доставчик на услуги и всяко предприятие id. Трябва да въведете spEnterpriseId както е назначено в обезпечаването.

  • Актуализиране на синхронизиране на директория за BroadWorks Enterprise — Влезте в предприятието id за да актуализирате състоянието на директория syc за това предприятие, като активирате или деактивирате синхронизирането на директории.

  • Задействайте синхронизиране на директория за предприятие —Използвайте този метод на API , ако искате да задействате незабавно синхронизиране за дадено предприятие id. За syncStatus, въведете SYNC_NOW команда.

  • Вземете състояние на синхронизиране на директория за предприятие — Влезте в предприятието 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 .

Синхронизирайте множество предприятия с API

Завършете тази процедура, за да използвате публичните API за задействане на синхронизиране на директории за множество предприятия.

  • Синхронизирането на директория ви позволява да синхронизирате само едно предприятие от клъстер на Broadworks в даден момент чрез синхронизиране при поискване. Ако се опитате да синхронизирате повече от едно предприятие, ще получите грешка 429

  • Времето, необходимо за задействане на синхронизиране за едно предприятие, варира в зависимост от размера на предприятието.

1

Изпълнете Избройте предприятията на BroadWorks API за генериране на списък с предприятия, които искате да синхронизирате.

  1. Комплект startWith към началния низ на идентификатора на предприятието или доставчик на услуги .

  2. Щракнете върху Бягай .

2

Изпълнете Задействайте синхронизиране на директория за предприятие API на първото предприятие в списъка.

  1. Влезте в предприятието ид .

  2. Комплект syncStatus до SYNC_NOW

  3. Щракнете върху Бягай .

    За предприятието се задейства незабавно синхронизиране. Това синхронизиране се отчита срещу единичното синхронизиране при поискване за лимит на Broadworks.
3

Изчакайте няколко секунди и след това стартирайте Вземете състояние на синхронизиране на директория API за получаване на състоянието на синхронизиране.

  1. Влезте в предприятието ид

  2. Щракнете върху Бягай .

4

След като синхронизирането завърши, изпълнете стъпки от 2 до 4 на следващото предприятие в списъка. Повторете тези стъпки, докато не синхронизирате целия списък.

Кодове за грешки за синхронизиране на директории

Следните кодове за грешки се отнасят за Directory Sync.

Код на грешка

Съобщение за грешка

600 000

Неочаквана грешка при синхронизиране на потребители от външен указател на Broadworks.

600001

Неуспешно синхронизиране на потребители от външен указател на Broadworks.

600002

Синхронизирането на потребители от външен указател на Broadworks трябваше да бъде прекратено, преди да завърши.

600003

Синхронизирането на потребители от външен указател на Broadworks е успешно само частично. Някои организации на клиента не успяха да се синхронизират.

600004

Синхронизирането на потребители от външен указател на Broadworks не е разрешено за ConfigSet.

600005

Извършва се синхронизиране на потребители от външен указател на Broadworks за ConfigSet.

600006

Нишките за синхронизиране на потребители от външен указател на Broadworks са заети или се затварят, следователно няма да приемат повече заявки за синхронизиране – опитайте отново по-късно.

600007

Организацията за самоличност на CustomerConfig не е намерена.

600008

CustomerConfig не е намерено в организацията на партньора.

600009

Broadworks External Directory User Sync не може да се стартира, тъй като широкият клъстер, свързан с CustomerConfig, е зает

600010

Синхронизирането на потребители от външен указател на Broadworks не може да се изпълни, тъй като няма клъстер на Broadworks, свързан с CustomerConfig.

600011

Синхронизирането на потребители от външен указател на Broadworks не е разрешено за CustomerConfig.

600012

Синхронизирането на потребители от външен указател на Broadworks не може да се изпълни, тъй като синхронизирането на хибриден указател вече е разрешено за CustomerConfig.

600013

Синхронизирането на потребители от външен указател на Broadworks не успя да добави потребители и машинни акаунти към хранилището за самоличности.

600014

Синхронизирането на потребители от външен указател на Broadworks не успя, докато се опитваше да се свърже с клъстера на Broadworks. Грешка от Broadworks - %s.

600015

Синхронизирането на потребители от външен указател на Broadworks не откри съвпадащ потребител в хранилището за самоличности.

600017

BroadWorks Phone List Sync не успя да синхронизира всички потребителски и корпоративни/организационни контакти.

600018

Синхронизирането на телефонния списък на BroadWorks не бе успешно за потребители в предприятието/организацията.

600019

BroadWorks Phone List Sync не успя да синхронизира корпоративни/организационни контакти.

600020

Синхронизирането на потребителя с външна директория на BroadWorks не може да бъде деактивирано, тъй като синхронизирането на CustomerConfig е в ход.

600022

Синхронизирането на един потребител с външна директория на BroadWorks не е възможно, тъй като предприятието няма осигурен потребител.

600023

Синхронизирането на един потребител с външна директория на BroadWorks не е възможно, тъй като потребителят вече съществува в тази организация.

600024

Синхронизирането на един потребител с външна директория на BroadWorks не е възможно, тъй като в BroadWorks не е намерен съвпадащ потребител.

600025

BroadWorks External Directory User Sync не успя да актуализира потребителски акаунт в CI.

600026

BroadWorks External Directory User Sync не успя да актуализира акаунта на машината в CI.

600027

Синхронизирането на един потребител с външна директория на BroadWorks не е възможно, тъй като в BroadWorks са открити множество потребители.

600028

Синхронизирането на един потребител на външна директория на BroadWorks не е възможно, защото трябва да е завършено поне едно синхронизиране на корпоративна директория .

600029

Синхронизирането на потребител на външна директория на BroadWorks не бе успешно, тъй като предприятието няма обезпечен потребител.

История на промените

Следващата таблица обобщава актуализациите на тази статия.

Дата

Ревизия

14 февруари 2023 г

Актуализиран Максимум и източник за синхронизиране на директория раздел.

10 декември 2022 г

Актуализира термина Пълна незабавна синхронизация до Задействайте синхронизиране на директория

19 юли 2022 г

Пояснения и корекции на обща информация:

  • Актуализиран Преглед на синхронизирането на директории за да се изяснят различните синхронизации и как директорията на Webex се актуализира за всеки.

  • Актуализиран Списък с телефони и контакти на BroadWorks за да изясним, че само списъците с телефони се синхронизират с Контакти.

  • Корекции на Актуализации за да се изясни колко време е необходимо на приложението Webex да покаже актуализирани записи.

09 май 2022 г

  • В Преглед на синхронизирането на директории , коригирана Забележка под Максимум и източник за синхронизиране на директория маса. Също така актуализирана бележка относно осигуряването на поток.

  • Граматични редакции и корекции

07 април 2022 г

  • Добавена бележка към Актуализации раздел в Преглед на синхронизирането на директории около ограничаването на прилагането на редакции на контакти на ниво организация в Control Hub.

28 март 2022 г.

  • Вмъкнато отново липсващото съдържание под Активиране на синхронизирането на директории (нов шаблон) .

  • Добавена информация за максимумите на синхронизиране. Можете да стартирате едно планирано синхронизиране и едно синхронизиране на API едновременно от един и същ клъстер.

  • Добавена информация за Задействайте синхронизиране на директория за един потребител API.

24 март 2022 г.

Добавен списък със синхронизирани типове телефонен номер към Условия за синхронизиране на директория . Синхронизирането вече включва номера на мобилен телефон .

16 март 2022 г

  • Добавени са нови кодове за грешки.

  • Добавено е въвеждащо описание за по-добра използваемост при търсене в мрежата.

17 декември 2021 г

  • Незначителни структурни редакции за отстраняване на проблем с липсващо TOC.

16 декември 2021 г

  • Актуализирана статия с увеличени максимални стойности за потребителски контакти.

08 декември 2021 г

  • Добавена секция Максимум за синхронизиране на директории и контакти за да се изясни как Directory Sync извлича максимален брой контакти на организация и потребител.

  • Преработено форматиране на таблицата в Кодове за грешки за синхронизиране на директории за по-добра четливост.