Отстраняване на неизправности в Webex за Cisco BroadWorks

Тази статия е разделена на три основни раздела:

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

Ресурси за отстраняване на неизправности на Webex за Cisco BroadWorks

Полезни лог файлове

Име на лога

Източник

Полезно за отстраняване на проблеми

PSLlog

Сървър на приложения

Поточно осигуряване

котарак access_log

XSP

Вход в приложението Webex

XsiActionsLogXSP

Взаимодействия при влизане в приложението Webex с Webex IDP Proxy, взаимодействия с клиенти за заявка за профили на устройства

Дневник на услугата за удостоверяване

XSP

Вход в приложението Webex (валидиране и издаване на токени)

XSlogXSP?

Мобилни абонаменти за push известия

Сигнализация на повиквания

Дневник за стартиране на приложението Webex

Windows: \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac:/Users/{username}/Library/Logs/SparkMacDesktop/current_log

Мобилен: Използване на лог файлове за изпращане

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

Инициализация на BWC библиотека за свързване с BroadWorks

getUserProfile & Регистриране на извличане на JwT токени

BroadWorks Calling

Дневник на приложението Webex

Клиент

Windows: \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac:/Users/{username}/Library/Logs/SparkMacDesktop/current_log

Мобилен: Използване на лог файлове за изпращане

Целият SIP трафик за регистрация и разговори

Поддържане на трафик към BWKS Backend

Функции по време на разговор, които изискват сигнализиране (Hold/Resume, Трансфер и т.н.)

Дневник на медиите (Webex Media Engine)

Клиент

Windows: \Users\{username}\AppData\Local\CiscoSpark\media\*.log

Mac: /Users/{username}/Library/Logs/SparkMacDesktop/media/

Мобилен: Използване на лог файлове за изпращане

Всички медийни записи

Кодеци, договорени за повикване

Функции по време на разговор

Списък за четене

Известни проблеми и ограничения

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

Serviceability Connector

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

За подробности относно внедряването на Serviceability Connector вижте Ръководство за внедряване на Cisco Webex Serviceability Connector.

Процес на отстраняване на неизправности в Webex за BroadWorks

Ескалиране на проблем

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

Процедура

  1. Съберете колкото е възможно повече информация от системите, свързани с проблема.
  2. Свържете се със съответния екип в Cisco, за да откриете случай.

Каква информация за клиента да се събира

Ако смятате, че трябва да отворите случай или да ескалирате проблем, съберете следната информация, докато отстранявате неизправности с потребителя:

  • Идентификатор на потребителя: CI имейл адрес или UUID на потребителя (това е Webex идентификаторът, но ако получите и BroadWorks идентификатора на потребителя, това ще помогне).
  • Идентификатор на организацията.
  • Приблизителен период от време, през който е възникнал проблемът.
  • Клиентска платформа и версия.
  • Изпращане или събиране на лог файлове от клиента.
  • Запишете идентификационния номер за проследяване, ако е показан на клиента.

Проверете данните на потребителя в Help Desk

Администраторите на партньори, които имат права за роля на администратор на Help Desk (основен или разширен), могат да използват тази процедура, за да проверят данните на потребителите, използвайки изгледа Help Desk.

Процедура

  1. Влезте в отдела за помощ.
  2. Потърсете потребителя и след това щракнете върху него. Това отваря екрана с обобщение на потребителя.
  3. Щракнете върху потребителското име, за да видите подробната конфигурация на потребителя. Полезната информация в този изглед включва UUID на потребителя, клъстер за обща идентичност (CI), клъстер за приложения Webex, поведение при извикване, GUID на акаунт в BroadWorks
  4. Щракнете върху Копиране, ако е необходимо да използвате тази информация в друг инструмент или да я прикачите към случай на Cisco.

Преглед на организацията на клиента в Help Desk

Администраторите на партньори, които имат права за роля на администратор на Help Desk (основен или разширен), могат да използват тази процедура, за да преглеждат подробности за организацията на клиента в изгледа Help Desk.

Процедура

  1. Влезте в отдела за помощ.
  2. Потърсете и след това щракнете върху името на организацията на клиента.
  3. Превъртете надолу, докато видите Изглед на клиентски портал и щракнете върху Преглед на името на клиента, за да видите изглед само за четене на организацията клиент – включително потребители и конфигурация.

Извличане на потребителски лог файлове от Partner Hub

При отстраняване на проблеми с настолни и мобилни клиенти е важно партньорите (и TAC) да могат да преглеждат регистрационните файлове на клиента.

Процедура

  1. Помолете потребителя да изпрати лог файлове. За помощ вижте: Приложение Webex | Съобщете за проблем.
  2. Помолете потребителя да експортира извикващата среда и да ви изпрати файла ced.dat.
  3. Вземете клиентските лог файлове от Partner Hub или Help Desk.

    Опция за партньорски център:

    1. Влезте в Partner Hub и намерете организацията на клиента на потребителя.
    2. Изберете Отстраняване на неизправности.
    3. Изберете Дневници.
    4. Търсене на потребителя (по имейл).
    5. Прегледайте и изтеглете клиентските лог файлове като zip файл.

    Опция за помощно бюро:

    1. Влезте в отдела за помощ.
    2. Търсете организацията.
    3. Щракнете върху организацията (отваря се екранът с обобщение).
    4. Превъртете надолу, за да кликнете върху Преглед на клиента.
    5. Изберете Отстраняване на неизправности.
    6. Изберете Дневници.
    7. Търсене на потребителя (по имейл).
    8. Прегледайте и изтеглете клиентските лог файлове като zip файл.

Как да намеря версията на клиента

Процедура

  1. Споделете тази връзка с потребителя: https://help.webex.com/njpf8r5
  2. Помолете потребителя да ви изпрати номера на версията.

Проверка на клиента за извикване на услуга

Процедура

  1. Влезте в клиента на Webex.
  2. Проверете дали иконата "Опции за извикване" (слушалка със зъбно колело над нея) присъства в страничната лента. Ако иконата не присъства, потребителят може все още да не е разрешен за услугата за извикване в контролния център.
  3. Отворете менюто Настройки/Предпочитания и отворете секцията Телефонни услуги. Трябва да видите състоянието SSO Сесия, в която сте влезли. (Ако се показва различна телефонна услуга, като например Webex Calling, потребителят не използва Webex за Cisco BroadWorks.)

    Тази проверка означава:

    • Клиентът успешно е преминал през необходимите микроуслуги на Webex.
    • Потребителят успешно е удостоверен.
    • Клиентът получава дълготраен JSON уеб токен от вашата BroadWorks система.
    • Клиентът е извлякла своя профил на устройство и се е регистрирал в BroadWorks.

Получаване на клиентски лог файлове или обратна връзка

  • Вижте раздела „Ресурси“, за да намерите конкретни клиентски регистрационни файлове на настолни клиенти на Webex или да помолите потребителите да изпратят регистрационни файлове. За помощ вижте: Приложение Webex | Съобщете за проблем.
  • Помолете потребителите на мобилни клиенти да изпращат лог файлове, след което можете да ги получите чрез партньорския център или бюрото за помощ.

    Изпращането на лог файлове е безшумно. Ако обаче потребител изпрати обратна връзка, тя отива до екипа на Webex App devops. Не забравяйте да запишете номера на потребителя за обратна връзка, ако искате да се свържете с Cisco. Например:

    номер на делото за подадена молба за подкрепа

Вземете данни за средата на повикванията

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

Процедура

  1. В клиентската програма щракнете върху Помощ > Проверка на състоянието.
  2. Изберете Нулиране на базата данни. Това задейства пълно рестартиране на клиента и зарежда екрана за вход в приложението Webex.

Проверете дали Webex трябва да се регистрира в BroadWorks

Приложението Webex проверява следната информация, за да определи дали да се регистрира в BroadWorks:

  • Потребителско право на broadworks-connector.
  • Поведение при извикване за организация и потребител.

Проверка на поведението на потребителя при повикване и правата за достъп до конектора

  1. Влезте в отдела за помощ с вашите идентификационни данни за администратор на партньор.
  2. Търсете потребителя.
  3. Кликнете върху потребителя и проверете записа „Поведение при повикване“. Трябва да е „Извикване на Webex“.

    проверете поведението на потребителя при обаждания

  4. Щракнете върху потребителското име, за да отворите екрана с подробности за потребителя.
  5. Превъртете надолу, за да намерите секцията entitlements и проверете дали е включена broadworks-connector

    Екран с подробности за потребителя - Broadworks конекторът е активиран

    Потребител на Webex за Cisco BroadWorks НЕ трябва да има право bc-sp-standard, ако възнамерява да използва Webex за Cisco BroadWorks. Това е правото за „Webex Calling (Broadcloud)“, което представлява обаждане от приложение Webex чрез услуга за облачни обаждания, управлявана от Cisco.

Проверете поведението на организацията при обаждания

  1. Влезте в отдела за помощ с вашите идентификационни данни за администратор на партньор.
  2. Търсете организацията.
  3. Кликнете върху организацията и проверете записа Поведение при повикване. Трябва да е „Извикване на Webex“.

Анализирайте PSLog за проблеми с осигуряването на потребители

Използвайте PSLog на сървъра на приложенията, за да видите HTTP POST заявката към моста за осигуряване и отговора от Webex. В коректен работещ случай, отговорът е 200 OK и след няколко минути можете да видите, че потребителят - и новата клиентска организация, ако е първият потребител - са създадени в Webex. Можете да проверите това, като потърсите в Help Desk имейл адреса, който виждате в публикацията.

Преди да започнете

Събиране на PSLog от сървъра на приложенията по време на опит за предоставяне на поток с тестов потребител.

Процедура

  1. Първото нещо, което трябва да проверите, е HTTP кодът за отговор:
    • Всичко различно от 200 OK е неуспешно осигуряване на потребителя.
    • 200 OK все още може да показва неуспех, ако нещо в профила на абоната не работи в услугите на Webex нагоре по веригата от моста за осигуряване.
    • 400 може да съдържа възел message в отговора. Мостът за осигуряване не можа да обработи нещо в subscriberProfile. Възможно е да има нещо нередно с данните на абоната или несъвместимост с настройка в шаблона.
    • 401 означава, че въведените в автономната система идентификационни данни за осигуряване не съвпадат с въведените в шаблона в Partner Hub.
    • 403 може да показва нещо неправилно конфигурирано на Application Server. Проверете адреса на заявката. Не трябва да е IP адрес, а URL адресът на моста за осигуряване, който можете да видите в шаблона си в Partner Hub.
    • 409 показва конфликт между предоставените subscriberProfile и съществуващите данни от Webex. Възможно е да има съществуващ потребител с този имейл адрес. Проверете message в отговора.
  2. Можете също да проверите оригиналния HTTP POST за подозрителни стойности, които биха могли да доведат до неуспех на осигуряването. POST съдържа XML структура subscriberProfile. Вътре в това, полезни възли за проверка са:
    • bwuserid: Използвайте това, за да намерите профила на абоната, ако трябва да го редактирате в BroadWorks.
    • group: Ако шаблонът е в „Режим на доставчик на услуги“, това се изписва с малки букви и става името на организацията клиент, която виждате в Partner Hub.
    • serviceProvider: Ако шаблонът е в „корпоративен режим“, това се изписва с малки букви и става името на организацията клиент, която виждате в Partner Hub.
    • primaryPhoneNumber: Трябва да съществува. Осигуряването е неуспешно без него.
    • email: Става потребителски идентификатор в Webex. Трябва да е валидно и уникално за Webex, в противен случай осигуряването ще бъде неуспешно.

      Игнорирайте строфата services : Създаден е от AS и е приет, но не се използва от Webex.

Анализирайте XSP лог файловете за отстраняване на проблеми с влизането на абонати

Този поток описва режима на удостоверяване на BroadWorks. Можете да видите режима на удостоверяване в шаблона BroadWorks в Partner Hub. Вижте Конфигуриране на шаблоните на клиентите в https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726.

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

Следващото обяснение обяснява какво можете да очаквате да видите, когато проверявате лог файловете за успешно влизане. Анализирайте XSP лог файловете за отстраняване на проблеми с влизането на абонати -flow

Потребителят взаимодейства с клиента, клиентът взаимодейства с услугите на Webex:

  • Потребителят предоставя имейл адреса си на приложението Webex (1 на диаграмата).
  • CI знае, че трябва да пренасочи този потребител, за да въведе паролата си за BroadWorks (чрез UAP) (2 на диаграмата).
  • IDP проксито изпраща заявка за получаване на профил към Xsi интерфейса на XSP.

В котарака access_log:

  • Потърсете GET заявката за профила на абоната от Webex към интерфейса Xsi-Actions (2.1 на диаграмата). Той съдържа потребителския идентификатор на Webex. Например:

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

В XsiActionsLog:

  • Потърсете заявката за GET на профила от Webex (2.1 на диаграмата). Той съдържа потребителския идентификатор на Webex. Например:

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile Заглавките включват authorization: Basic и user-agent: broadworksTeamsClient

  • След това XSP извършва OCI-P Basic удостоверяване срещу BroadWorks (AuthenticationVerifyRequest и AuthenticationVerifyResponse, както всяко друго приложение, извършващо основно удостоверяване чрез Xsi), а също и UserGetRequest и ServiceProviderGetRequest, за да събере информация за абоната.
  • Отговорът на Xsi към Webex съдържа XML Profile блок, съдържащ (BroadWorks) userId и други подробности (2.2 на диаграмата).

Взаимодействие между клиента и услугите на Webex:

  • IDP прокси сървърът съпоставя потребителския профил, получен от BroadWorks, и издава SAML твърдение на клиента (2.3 на диаграмата).
  • Клиентът обменя SAML твърдение за CI токен (3 на диаграмата).
  • Клиентът проверява дали влезлият потребител има правата за broadworks-connector (4 на диаграмата). Можете да проверите правата на потребителите в отдела за помощ.
  • Клиентът използва CI токен, за да поиска JSON уеб токен (JWT) от IDP прокси (5 на диаграмата).
  • IDP проксито валидира CI токена в CI.
  • IDP прокси изисква JWT от услугата за удостоверяване.

В дневника на услугата за удостоверяване:

  • Потърсете заявката за токен от Webex (5.2 на диаграмата), например: GET /authService/token, който има http_bw_userid заглавка и други.
  • XSP извършва OCI-P UserGetLoginInfoRequest, за да провери дали предоставеният потребителски идентификатор съответства на потребител на BroadWorks (5.3 на диаграмата). AuthService е установил доверие с Webex чрез mTLS връзката, така че може да издава LLT.
  • Потърсете отговора (5.4 на диаграмата) от LongLivedTokenManager - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks … и StatusCode=200, който можете да свържете с оригиналната заявка, използвайки заглавката trackingid: CLIENT… .

В XsiActionsLog:

  • Клиентът може да представи дълготрайния токен в интерфейса Xsi-Actions, за да получи профила на устройството си (6 на диаграмата). Например: GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device Със заглавките authorization: Bearer token и user-agent: WebexTeams (variant/version)
  • Интерфейсът Xsi-Actions изпраща токена към услугата за удостоверяване (конфигурирана да бъде на интерфейса за обратна връзка). Например: 127.0.0.1:80 POST http://127.0.0.1:80/authService/token, което можете да съпоставите със заглавката trackingid: CLIENT… в GET и заглавката X-BROADSOFT-CORRELATION-ID : CLIENT… в POST.

В дневника на услугата за удостоверяване:

  • Получаването на POST от Xsi (loopback)

  • A StatusCode=200 обратно към Xsi

  • И отговор за валидиране на токен, с JSON блок "token" в тялото.

  • Корелирано с помощта на trackingid: CLIENT…

В XsiActionsLog:

  • След като е получило 200 OK от authservice, което е валидирало токена на клиента, приложението Xsi-Actions вече изпраща OCI-P заявка за UserPrimaryAndSCADeviceGetListRequest
  • Получава OCI-P UserPrimaryAndSCADeviceGetListResponse, съдържащ XML структурата accessDeviceTable.
  • Отговорът на OCI-P е кодиран като Xsi отговор до клиента, включващ XML структурата AccessDevices, която има deviceTypes. Например: Business Communicator – PC и URL адресите, откъдето клиентът може да извлече конфигурационните файлове на устройството.

Клиентът продължава както обикновено:

  • Избира запис за устройство и взаимодейства с DMS, за да получи профил на устройството (6 на диаграмата).
  • Регистрите към BroadWorks чрез SBC, извлечени в конфигурацията от DMS (7 на диаграмата).

Отстраняване на специфични проблеми с Webex за BroadWorks

Проблеми с центъра за партньори

Администраторът не може да вижда организациите на клиентите

Като администратор за вашата партньорска организация в Webex, трябва да имате пълна администраторска роля. Тази роля се използва за управление на вашата партньорска организация, включително за предоставяне на администраторски права на вас и други. За да управлявате организации на клиенти, трябва да предоставите на себе си (или на други хора) ролята Пълен администратор на продажбите или Администратор на продажбите . За подробности вижте Присвояване на роли на организационни акаунти в Control Hub.

Проблеми с осигуряването на потребители

Интегриран IM & P-грешки за конкретни предприятия / клиенти

Ако имате комбинация от предприятия, използващи различни услуги за сътрудничество в облака, например UC-One SaaS и Webex за Cisco BroadWorks, може да сте избрали да модифицирате адаптера за осигуряване за всяко отделно предприятие.

За да проверите какво е конфигурирано за интегрирани IM & P (по подразбиране за предприятия, освен ако не съществува по-специфична настройка), изпълнете AS_CLI/Interface/Messaging> get. За параметрите за осигуряване на конкретно предприятие, отворете предприятието и отидете на Услуги > Интегриран IM & П.

Проверете дали интегрираният IM & P конфигурацията за това предприятие съвпада точно с показаното в шаблона на клиента в Partner Hub. Следните настройки трябва да съвпадат, в противен случай осигуряването ще бъде неуспешно за всички потребители в предприятието:

Интегрирани IM решения на BroadWorks Enterprise & P-настройка Настройка на шаблон за клиент в центъра за партньори
URL адрес на сървъра за съобщения URL адрес за осигуряване
Потребителско име на сървъра за съобщенияИме на акаунт за осигуряване
Парола за сървъра за съобщенияПарола за осигуряване на акаунт, Потвърждаване на паролата

Интегриран IM & P грешки за конкретни потребители

Това важи, ако използвате flow-through provisioning и приемате, че provisioning работи за some/most потребители (така че можете да изключите проблем с конфигурацията). Ако виждате интегрирани IM-та & P грешки в BroadWorks, например, “[Error 18215] Грешка при осигуряване със сървъра за съобщения“ и “[Error 18211] „Грешка в комуникацията със сървъра за съобщения“, трябва да проучите следните потенциални причини:

  • Възможно е имейл адресът на потребителя вече да съществува в CI. Потърсете потребителя в отдела за помощ, за да проверите дали имейл адресът му вече е там. Това не е непременно окончателно, тъй като потребителят може да съществува в организация, чиито данни нямате право да виждате в отдела за помощ.
  • Потребителят се е регистрирал самостоятелно в Webex, преди да му бъде назначен интегрираният IM. & П услуга. В този случай една от опциите е потребителят да изтрие безплатните си акаунти, за да може да стане част от клиентската организация, която осигурявате. Инструкциите са на https://help.webex.com/5m4i4y
  • Потребителят няма зададен основен телефонен номер към профила си (всички абонати на Webex за Cisco BroadWorks трябва да имат основен DID). Вижте темата за анализ на PSLog от AS.

Неуспехи при осигуряването на потребители в отговор от моста за осигуряване

Ако потребителите не се показват в Control Hub, в рамките на няколко минути след задаване на интегрирани IM & П, виж кодовете за отговор от услугата за осигуряване на мост. Пуснете PSLog, за да видите HTTP кодовете за отговор.

200 ОК

Отговор 200 OK не означава, че потребителят е успешно осигурен. Това означава, че услугата за осигуряване е получила заявката и успешно е изпратила съответната заявка за създаване на потребител към услугите нагоре по веригата. Транзакцията за осигуряване е асинхронна по дизайн. Услугата отговаря с 200 OK, защото процесът на създаване на потребител може да отнеме няколко минути и от съображения за производителност не искаме да получаваме множество заявки за създаване на един и същ потребител. Ако обаче потребителят не се появи в организацията на клиента след отговор 200 OK, това може да означава, че създаването на потребителя е било неуспешно в услугите на Webex, разположени нагоре по веригата от услугата за осигуряване. Трябва да ескалирате неуспех при осигуряване, който има отговор 200 OK.

400 Невалидна заявка

Проверете HTTP отговора, който би трябвало да съдържа повече подробности за потенциалните проблеми, които биха могли да причинят този отговор от услугата за осигуряване. Някои примери за възела:

  • „Не мога да се доверя на имейла на BroadWorks със стар API за осигуряване.“ Имейл адресът, свързан с неуспешната заявка за осигуряване на потребител, не е валиден или е въведен неправилно, но вие сте посочили в шаблона, че на имейл адресите може да се има доверие. Проверете профилите на потребителите в BroadWorks, по-специално имейл адресите.
  • Организацията на клиента не е намерена в базата данни, а също така флагът за създаване на нова организация не е активиран. Тази неуспешна заявка за осигуряване би трябвало да създава нова клиентска организация в Webex, но вашият шаблон е конфигуриран да предотвратява създаването на нови клиентски организации. Ако искате да разрешите нови организации за имейл домейни, които не съответстват на съществуващите клиенти в Webex, можете да преконфигурирате шаблона си в Partner Hub и да тествате отново заявката за осигуряване. Ако обаче не очаквате да бъде създадена нова организация за този потребител, е възможно имейл адресът да е въведен неправилно (по-специално частта, свързана с домейна). Проверете имейл адреса на потребителя в BroadWorks.

403 Забранено

Заявката за осигуряване няма шанс за успех. В този случай ще трябва да проучите заявката и отговора. Например, ако видите IP адрес като цел на заявката за осигуряване – вместо подходящия URL адрес на моста за осигуряване за вашата организация (вижте темите за конфигуриране на защитната стена в Ръководството за решения) – това може да означава, че на вашия сървър на приложения липсва задължителен пач (ap373197).

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

409 Конфликт

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

Потребителят вече е в CI

Извлечете имейл адреса на абоната от HTTP POST заявката и го потърсете в Help Desk. Може да не видите потребителя, ако нямате разрешение, но може също така да видите, че потребителят е в „свободна“ организация, например „Потребител“. Можете да помолите този потребител да изтрие безплатния си акаунт или да използвате друг имейл адрес, за да го осигурите. Вижте https://help.webex.com/ndta402.

Проблеми с влизането на потребителите

Порталът за активиране на потребители не се зарежда

Нормалният процес на влизане в Webex за Cisco BroadWorks включва портал за активиране на потребители, където потребителите въвеждат своите пароли. Понякога този портал не се зарежда, след като потребителят е въвел имейл адреса си на екрана за вход в приложението Webex. Този проблем може да бъде причинен от страна на клиента или от страна на услугата. От страна на клиента, това обикновено се дължи на несъвместимост на браузъра на клиента с услугата.

Единичното влизане не беше успешно

  • В BroadWorks проверете дали на потребителя са зададени типовете устройства за приложението Webex (вижте раздела „Профили на устройства “ в раздела „Подготовка на вашата среда “ от „Ръководство за решения“).
  • Проверете дали потребителят използва правилната парола. Ако шаблонът, който сте използвали за осигуряване на клиентската организация на потребителя (в Partner Hub), е конфигуриран за удостоверяване с BroadWorks, потребителят трябва да въвежда своята парола за „Уеб достъп“ за BroadWorks. Потребителят може също да се наложи да въведе своя потребителски идентификатор на BroadWorks, ако имейл адресът му не е конфигуриран като алтернативен потребителски идентификатор. Уверете се, че потребителят е въвел правилно главните и малките букви.

Проблеми с конфигурацията и регистрацията на извикванията

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

Очаквана последователност на регистрация

  1. Клиентът се обажда на XSI, за да получи маркер за управление на устройството и URL адреса към DMS.
  2. Клиентът иска своя профил на устройството от DMS, като представи маркера от стъпка 1.
  3. Клиентът чете профила на устройството и извлича SIP идентификационни данни, адреси и портове.
  4. Клиентът изпраща SIP регистър на SBC с помощта на информацията от стъпка 3.
  5. SBC изпраща SIP регистъра до AS (SBC може да извърши търсене в NS, за да локализира AS, ако SBC все още не познава SIP потребителя).

Очаквани признаци за успешна регистрация на клиент

Иконата „Опции за повикване“ се появява в интерфейса на Webex.

В раздела „Телефонни услуги“ в приложението Webex (напр. „Настройки > Телефонни услуги на Windows, Предпочитания > Телефонни услуги на Mac), съобщението „SSO сесия: „Влезли сте“ означава, че приложението е регистрирано успешно (в този случай в BroadWorks).

Клиентът няма икона за обаждане

В повечето случаи това означава, че потребителят няма правилния лиценз / права.

Клиентът показва раздела „Телефонни услуги“, но няма SSO сесия

Клиентът на Webex показва раздела за телефонни услуги, но няма SSO сесия

Това е неуспешна регистрация. Има няколко причини, поради които клиент на приложение Webex не може да се регистрира в BroadWorks:

Тестват се множество услуги за обаждания с едни и същи клиенти

Този известен проблем може да бъде причинен от това, че клиентът преминава между различни извикващи устройства. Най-вероятно е това да се случи по време на пробни версии на различни услуги за обаждания, предлагани чрез (едни и същи) клиенти на приложението Webex. Можете да нулирате клиентската база данни (линк), за да отстраните този проблем.

Неправилна конфигурация на услугата за удостоверяване

Проверете XSP, хостващи услугата за удостоверяване, спрямо Ръководството за решения (вижте Конфигуриране на услуги на вашия Webex за Cisco BroadWorks XSP). По-конкретно:

  • RSA ключовете (които генерирате на един XSP) се копират на всички XSP.
  • URL адресът на услугата за удостоверяване е предоставен на уеб контейнера на всички XSP и е въведен правилно в клъстера в Partner Hub.
  • Външното удостоверяване чрез сертификати е конфигурирано:

    XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get

    allowUserApp = false

    allowClientApp = true

  • Когато използвате MTLS, трябва да качите клиентския сертификат на Webex в XSP (можете да получите сертификата от Partner Hub, на страницата с настройки на BroadWorks).

Неправилна конфигурация на таговете на BroadWorks

Проверете дали сте конфигурирали необходимите BroadWorks тагове за приложението Webex. Вижте Ръководството за конфигуриране на Webex за Cisco BroadWorks за информация относно конфигурационни тагове. Уверете се, че няма конфликти или неправилни стойности. По-конкретно, тагът %SBC_ADDRESS_WXT% трябва да бъде SBC към вашия SIP регистратор за клиенти на приложението Webex.

Настолният клиент прекъсва телефонните услуги след успешно SSO свързване

Този проблем може да бъде причинен от един и същ потребител, който влиза в множество клиенти на един и същ тип платформа. Например, ако потребител влезе успешно в приложението Webex на Windows и след това влезе в приложението Webex на друга машина с Windows, има активна SSO сесия само на едната от машините. Това е по проект. Ако абсолютно е необходимо да заобиколите този проблем, можете да конфигурирате BroadWorks да има множество екземпляри от един и същи тип устройство, но те трябва да имат уникални SIP адреси. Тази конфигурация е извън обхвата на Webex за Cisco BroadWorks.

Настолното устройство не е осигурено за потребителя

Този подпис се вижда в лога на клиента:

[0x70000476b000] BroadWorksConfigDownloader.cpp:106

onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - the device profile 'Business Communicator - PC' is not found.

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

Грижа за себе си button/link не се показва в приложението Webex

Друг симптом на този проблем е, когато button/link се показва, но щракването върху него отваря външен браузър.

  • Проверете дали необходимият шаблон за конфигурация на клиента е разположен и дали CSW таговете са правилно зададени. (Вижте раздела Настройки на повикванията Webview в Ръководството за решение Webex за Cisco BroadWorks).
  • Проверете дали приложението Webex е регистрирано за обаждания в BroadWorks.
  • Проверете дали приложението Webex е с скорошна версия, която поддържа CSWV.

Празна страница или грешка след щракване върху „Самообслужване“ button/link

Обикновено това поведение в приложението Webex показва проблем с конфигурацията или внедряването на приложението CSWV на BroadWorks XSP. Съберете подробности за по-нататъшно разследване, включително лог файлове на CSWV, лог файлове за достъп, хранилище config-wxt.xml и файл с шаблон, след което повдигнете случай.

Проблеми с претенции за домейн

Грешки при регистрация на потребители могат да възникнат в резултат на грешки, допуснати при заявяване на домейни. Преди да заявите някакви домейни, уверете се, че разбирате следното:

  • Доставчиците на услуги не трябва да претендират за домейни на клиентски организации, които управляват. Те трябва да претендират само за домейните на тези потребители, които са във вътрешната организация на Доставчика на услуги. Заявяването на домейна на потребителите в отделна организация (дори такава, която доставчикът на услуги управлява) може да доведе до грешки при регистрацията за потребителите в организацията на клиентите, тъй като заявките за удостоверяване на потребителите се насочват по-скоро през Доставчика на услуги, отколкото чрез организацията на клиентите.
  • Ако две клиентски организации (Компания А и Компания Б) споделят един и същ домейн и компания А е заявила домейна, регистрацията за потребители на company B може да е неуспешна поради факта, че заявките за удостоверяване на потребителя се маршрутизират чрез организацията, която има заявения домейн (компания А).

    Ако погрешно заявите домейн и трябва да премахнете заявка, вижте статията Управление на вашите домейни в Webex.

Кодове за грешки на крайния потребител

Следната таблица описва кодовете за грешки за крайни потребители, които могат да се видят в портала за активиране на клиентски потребители.

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

Таблица 1. Маса 1: Кодове за грешки на крайния потребител

Код на грешка

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

Предлагано действие

100006

Влизането не бе успешно: Потребител ID/Password е неправилно.

Проверете дали потребителят използва правилната парола. Ако шаблонът, който сте използвали за осигуряване на клиентската организация на потребителя (в Partner Hub), е конфигуриран за удостоверяване с BroadWorks, потребителят трябва да въвежда своята парола за „Уеб достъп“ за BroadWorks. Потребителят може също да се наложи да въведе своя потребителски идентификатор на BroadWorks, ако имейл адресът му не е конфигуриран като алтернативен потребителски идентификатор.

Уверете се, че потребителят е въвел правилно главните и малките букви.

200010

Неуспешно валидиране на идентификационните данни, тъй като потребител на BroadWorks е неупълномощен.

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

В противен случай администраторът трябва да нулира паролата в BroadWorks.

200013

Съжалявам, че в момента не можете да се присъедините към <name of SP offer> с Webex. Опитайте отново след няколко минути. Ако проблемът продължава, моля, свържете се с вашия <customer organization administrator>.

Неуспешно актуализиране на потребителската информация в Common Identity. Моля, актуализирайте потребителя отново, използвайки потребителския API.

200014

Моля, свържете се с вашия <Service Provider> администратор.

Проверете дали конфигурацията ви е точна и дали идентификаторът за осигуряване е правилен в заявката.
200016Неуспешно валидиране на идентификационните данни, тъй като сесията не е намерена.Потребителят трябва да обнови браузъра и да опита отново username/password.
200018Неуспешно валидиране на идентификационните данни, тъй като потребителят е заключен.Потребителят трябва да изчака 10 минути и след това да опита отново.
200019Неуспешно валидиране на идентификационните данни, тъй като добавянето на потребител не е успешно за самоактивиране.Администраторът трябва да провери настройките за самоактивиране в Control Hub.
200022Изпращането на имейл не бе успешно, тъй като потребителят не е удостоверен.Потребителят трябва да опита отново да се регистрира и да въведе идентификационни данни.
200025За съжаление не можете да се присъедините към самоактивиране в момента. Моля, опитайте отново след няколко минути. Ако проблемът продължава, свържете се със системния си администратор.Нека потребителят опита отново след няколко минути. Ако това не помогне, проверете с поддръжката на Cisco.
200026Неуспешно валидиране на имейла поради неуспешна предварителна проверка или неправилно състояние на чакащ потребител за PartnerOrgUUID : {partnerOrgUUID} , BroadoworksUUID : {broadworksUUID} , ConfigSetUUID : {configSetUUID}Администраторът трябва да информира потребителя, че е въвел грешен имейл адрес, тъй като имейл адресът е свързан с друга организация.
200039Неуспешно валидиране на имейл адреса, тъй като emailId вече се използва в друга организация.Потребителят трябва да опита да се регистрира отново през същата връзка за потвърждение, но с различен потребителски идентификатор на BroadWorks.

В противен случай администраторът на организацията на клиента от различната организация трябва да изтрие съществуващия потребителски акаунт.

200040Неуспешно валидиране на имейла, тъй като configSet не съвпада с configSet в customerConfig.Администраторът трябва да сравни връзката за потвърждение, използвана от потребителя, с връзката, конфигурирана в Control Hub. Двете връзки и configSets трябва да съвпадат.
200041Неуспешно валидиране на имейла, тъй като потребителят вече има право на друга конфликтна услуга, конфликт на права.Потребителят трябва да опита да се регистрира отново през същата връзка за потвърждение, използвайки различен потребителски идентификатор на BroadWorks.

В противен случай администраторът на организацията на клиента, който управлява конфликтната услуга, трябва да изтрие конфликтната услуга или права.

200042Неуспешно валидиране на имейл адреса, тъй като той вече е свързан с друг потребителски идентификатор на BroadWorks.Потребителят трябва да опита отново с различен имейл адрес.

В противен случай администраторът трябва да изтрие другия потребител, който използва този имейл адрес.

200043Неуспешно валидиране на имейла, тъй като съпоставянето на конфигурацията на потребителя с клиента е неправилно.Потребителят трябва да опита отново с различен имейл адрес. В противен случай администраторът трябва да изтрие другия потребител, който използва този имейл адрес.
200044Неуспешно валидиране на имейла, тъй като потребителският идентификатор (userId) вече се използва в този клъстер BroadWorks.Потребителят трябва да опита отново с различен имейл адрес. В противен случай администраторът на организацията на клиента, който управлява съществуващия потребителски акаунт, използващ този имейл адрес, трябва да изтрие този потребителски акаунт.
200045Неуспешно добавяне на потребител чрез самостоятелно активиране, тъй като потребителят вече е част от друга организация.Потребителят трябва да опита да се регистрира отново, но с различен имейл адрес. В противен случай администраторът на организацията на клиента, който администрира различната организация, трябва да изтрие съществуващия акаунт.
200046Неуспешно добавяне на потребител чрез самоактивиране, тъй като съществуват множество чакащи потребители със същия broadworksUserId в един и същ BroadWorks клъстер.Администраторът трябва да изтрие чакащите потребители от Control Hub.
200047Добавянето на потребител чрез самоактивиране не бе успешно, тъй като потребителският идентификатор (userId) вече се използва в този клъстер BroadWorks.Потребителят трябва да опита отново с различен имейл адрес. В противен случай администраторът на организацията на клиента, който управлява съществуващия потребителски акаунт, трябва да изтрие този съществуващ потребителски акаунт или да премахне други права.
200048Неуспешно добавяне на потребител чрез самостоятелно активиране, тъй като имейл адресът вече е осигурен с друг UserId за BroadWorks.Потребителят трябва да опита отново с различен имейл адрес.
200049Добавянето на потребител чрез самоактивиране не бе успешно, тъй като потребителският идентификатор (userId) вече се използва в този клъстер BroadWorks.Потребителят трябва да опита отново с различен имейл адрес. В противен случай администраторът на организацията на клиента, който управлява съществуващия потребителски акаунт, трябва да изтрие този съществуващ потребителски акаунт или да премахне други права.
200050Неуспешно добавяне на потребител чрез самоактивиране, тъй като provisioningID не съвпада с очаквания provisioningID на предприятието на абоната.Администраторът трябва да сравни връзката за потвърждение, използвана от потребителя, с връзката, конфигурирана в Control Hub. Двете връзки и configSets трябва да съвпадат.
200051Неуспешно добавяне на потребител чрез самоактивиране, тъй като посоченото в тази заявка spEnterpriseId противоречи на доставчик на услуги или предприятие, което вече е осигурено от този клъстер BroadWorks.Администраторът трябва да провери съществуващите организации в Control Hub и да се увери, че не създава организация с име, което вече съществува.
200054Неуспешно валидиране на имейл адреса като несъответствие между региона на организацията на клиента и организацията на партньора.Администраторът трябва да провери настройките на партньорската организация и клиентската организация в Control Hub и да се увери, че регионите съвпадат.
300005Предварителната проверка е неуспешна, тъй като потребителят вече е в опашката и е в процес на осигуряване.Осигуряването на потребителите все още е в ход. Моля, изчакайте няколко минути и проверете отново.

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

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

Код на грешка

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

600000

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

600001

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

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

600003

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

600004Синхронизирането на потребители от външен указател на Broadworks не е разрешено за ConfigSet.
600005Извършва се синхронизиране на потребители от външен указател на Broadworks за ConfigSet.
600006Нишките за синхронизиране на потребители от външен указател на Broadworks са заети или се затварят, следователно няма да приемат повече заявки за синхронизиране – опитайте отново по-късно.
600007Организацията за самоличност на CustomerConfig не е намерена.
600008CustomerConfig не е намерено в организацията на партньора.
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 е в ход.
600022BroadWorks външна директория единичен потребителски синхронизиране не е възможно, тъй като предприятието няма осигурява потребител.
600023BroadWorks външна директория единичен потребителски синхронизиране не е възможно, защото потребителят вече съществува в тази организация.
600024BroadWorks външна директория единичен потребителски синхронизиране не е възможно, защото не съвпадение потребител е намерен в BroadWorks.
600025BroadWorks външна директория потребителско синхронизиране не успя да актуализира потребителския акаунт в CI.
600026BroadWorks външна директория потребителско синхронизиране не успя да актуализира акаунта на машината в CI.
600027BroadWorks външна директория единичен потребителски синхронизиране не е възможно, защото няколко потребители са намерени в BroadWorks.
600028Синхронизирането на един потребител на BroadWorks External Directory не е възможно, защото поне едно синхронизиране на корпоративни директории трябва да е завършено.
600029BroadWorks външна директория потребителско синхронизиране е неуспешно, тъй като предприятието няма осигурен потребител.

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

Таблицата съдържа историята на промените за това ръководство.

ДатаСмяна
23 април 2025 г.Папката bwc е премахната от източника на лог на приложението BroadWorks Calling Webex.
29 юли 2023 г.Добавена е препратка към Webex App | Съобщаване за проблем (за генериране на регистрационни файлове) в раздела Извличане на потребителски регистрационни файлове от Partner Hub и Получаване на клиентски регистрационни файлове или обратна връзка .
27 юни 2022 г.Актуализиран списък за четене с липсваща връзка в метода на процедурата за мигриране на Connect (Android) към Firebase.
21 юни 2022 г.Актуализирани са връзките към ReadingList, за да сочат към нови URL адреси в Cisco.com. Актуализирани са проблеми с конфигурацията и регистрацията на извиквания чрез добавяне на връзка към ръководството за конфигуриране на Webex за Cisco BroadWorks за проблеми с таговете на BroadWorks.
април 14, 2022Добавени са контекстни оператори към Проверка на потребителски данни в Help Desk и Преглед на организацията на клиентите в Help Desk, за да се изяснят изискванията за ролята за Help Desk.
26 март 2022 г.Добавени са нови кодове за грешки към Кодове за грешки за синхронизиране на директории.
15 ноември 2021 г.Добавени са кодове за грешки 200013, 200014, 200025 и 300005 към Кодове за грешки на крайния потребител.
28 септември 2021 г.Добавени са кодове за грешки за синхронизиране на директории.
юли 15, 2021Добавено е съобщение за грешка 100006 към Кодове за грешки на крайния потребител. Също така актуализирано Проблеми с влизането на потребителите.
Юли 14, 2021Добавена е тема с линк към статията Известни проблеми и ограничения .
Юли 02, 2021Актуализирано име на продукта за ребрандиране на Webex.
18 юни 2021 г.Актуализирано лого на Webex в графиката.
08 юни 2021 г.Добавена е колона „Предложено действие“ към таблицата „Кодове за грешки на крайния потребител “ .
юни 4, 2021Корекция на таблицата Кодове за грешки на крайния потребител.
19 май 2021 г.Добавен е раздел Проблеми с претенции за домейн.
22 април 2021 г.Актуализирани кодове за грешки на крайния потребител с два допълнителни кода: 200016 и 200054.
13 април 2021 гДобавена е информация за връзката за обслужване на Webex.
8 декември 2020 г.Актуализиран документ. Ребрандиране на Webex Екипи към Webex (приложение). Добавени са кодове за грешки за крайния потребител.
3 ноември 2020 г.Добавен е уеб преглед на настройките за обаждания.
22 октомври 2020 г.Въведен е нов документ.