- Начало
- /
- Статия
Синхронизиране на указатели в Webex за Cisco BroadWorks
Тази статия описва как да разположите Directory Sync в 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 Directory чрез... |
---|---|---|
Webex за потребители на Cisco BroadWorks | Потребителите са активирани за Webex за Cisco BroadWorks | Предоставяне на потребители (напр. поточно обезпечаване) |
Потребители, които се обаждат само за BroadWorks | Обаждане на потребители, които са не включен в Webex | Синхронизирана с указател |
Обекти, които не са потребители | Например телефон за конферентна зала, факс, номер на групата на Хънт | Синхронизирана с указател |
Списъци с телефони на BroadWorks | Записи в телефонния списък на 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
Синхронизирането на директория също така синхронизира записите от телефонния списък на BroadWorks с Webex Contacts. Синхронизираните записи се добавят към един от следните типове контакти:
Контакти на организация — Webex съхранява тези контакти срещу организация. Всеки потребител има достъп до контактите на организацията за своята организация. Максимумът е до 30 000 контакта.
Потребителски контакти — Webex съхранява тези контакти срещу потребител. Само потребителят, който притежава контакта, има достъп до записа за контакт. Максимумът е до 2000 контакта (1500 синхронизирани контакта + 500 контакта за ръчно въвеждане).
Следната таблица показва типове контакти на Webex спрямо източника на контакт (синхронизиран от списък с телефони на BroadWorks или добавен ръчно):
Тип контакт на Webex | Свържете се с източника | Максимално | Синхронизирано от BroadWorks... | API , използван за синхронизиране |
---|---|---|---|---|
Контакти на организацията | Синхронизирана с указател | 30 000 контакта | Общи телефонни списъци на предприятието |
|
Групови общи телефонни списъци (за група доставчици на услуги)** |
| |||
Потребителски контакти | Синхронизирана с указател | 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-часов кеш таймер.
Предпоставки за синхронизиране на директории
Препоръчваме ви да използвате следните настройки:
Стойности за ограничаване на скоростта – задайте следните системни свойства на 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, преди да активирате тази функция:
За R22:
AP.as.22.0.1123.ap368517
За R23:
AP.as.23.0.1075.ap368517
За R24: не се изисква кръпка
Активиране на синхронизирането на директории (нов шаблон)
Администраторите на партньори могат да активират синхронизиране на директория за клиентски шаблон, докато създават новия шаблон. Всички нови клиентски организации, които бъдат присвоени на този шаблон, ще имат активирано синхронизиране на директории. За подробности вижте „Конфигуриране на вашите клиентски шаблони“ в Конфигурирайте вашата партньорска организация в Partner Hub в рамките на Ръководство за решение за Webex за Cisco BroadWorks .
Какво да правя След това
Уверете се, че вашите потребители знаят, че трябва да щракнат върху Контакти раздел в приложението Webex поне веднъж, за да включите функцията в приложението Webex . Това трябва да бъде завършено само веднъж.
Активиране на синхронизиране на директории (съществуващ шаблон)
1 | Влезте в Partner Hub и изберете Настройки . |
2 | Превъртете до Обаждане на BroadWorks и щракнете Преглед на шаблони . |
3 | Изберете подходящия клиентски шаблон и превъртете до BroadWorks Directory Sync . |
4 | За да активирате синхронизирането на директории по подразбиране за нови клиентски организации, които използват този шаблон: |
5 | За да активирате синхронизирането на директории за съществуващи клиентски организации, които използват този шаблон: Ако искате да деактивирате синхронизирането на директории, следвайте горната процедура и:
|
Какво да направите след това
Уверете се, че вашите потребители знаят, че трябва да щракнат върху Контакти раздел в приложението Webex поне веднъж, за да включите функцията в приложението Webex . Това трябва да бъде завършено само веднъж.
Задействайте незабавно синхронизиране
1 | Влезте в Partner Hub (http://admin.webex.com ) и изберете Настройки . |
2 | Превъртете до Обаждане на BroadWorks и щракнете Преглед на шаблони . |
3 | Изберете подходящия клиентски шаблон и превъртете до BroadWorks Directory Sync . |
4 | Щракнете върху Показване на списък със състоянието на синхронизиране на клиенти . |
5 | За организацията на клиента, която искате да синхронизирате, щракнете върху трите точки най-вдясно и изберете Синхронизирайте сега . |
6 | Щракнете върху Обнови за да видите резултатите от синхронизирането. |
Експортиране на синхронизирани записи в CSV
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
Синхронизирането на директория ви позволява да синхронизирате само едно предприятие от клъстер на Broadworks в даден момент чрез синхронизиране при поискване. Ако се опитате да синхронизирате повече от едно предприятие, ще получите грешка 429
Времето, необходимо за задействане на синхронизиране за едно предприятие, варира в зависимост от размера на предприятието.
1 | Изпълнете Избройте предприятията на BroadWorks API за генериране на списък с предприятия, които искате да синхронизирате. |
2 | Изпълнете Задействайте синхронизиране на директория за предприятие API на първото предприятие в списъка. |
3 | Изчакайте няколко секунди и след това стартирайте Вземете състояние на синхронизиране на директория API за получаване на състоянието на синхронизиране. |
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 г | Пояснения и корекции на обща информация:
|
09 май 2022 г |
|
07 април 2022 г |
|
28 март 2022 г. |
|
24 март 2022 г. | Добавен списък със синхронизирани типове телефонен номер към Условия за синхронизиране на директория . Синхронизирането вече включва номера на мобилен телефон . |
16 март 2022 г |
|
17 декември 2021 г |
|
16 декември 2021 г |
|
08 декември 2021 г |
|