Руководство по устранению неисправностей Webex для BroadWorks

Водяной знак
29 мар. 2021 г. | – просмотры | – пользователи, которые сочли этот материал полезным

Руководство по устранению неисправностей Webex для BroadWorks

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

Устранение неполадок Webex для BroadWorks

Устранение неполадок Webex для BroadWorks

Устранение неполадок Webex для BroadWorks

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

Эта статья разделена на три основных части:

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

История изменений

Дата

Изменение

Раздел

8 декабря 2020 г.

Обновление документа. Переименование Webex Teams в Webex (приложение).

Добавлены коды ошибок конечных пользователей

Конкретные проблемы

3 ноября 2020 г.

Добавлены настройки вызовов Webview

Конкретные проблемы

22 октября 2020 г.

Представлен новый документ

Водяной знак
29 мар. 2021 г.| – просмотры | – пользователи, которые сочли этот материал полезным

Материалы

Webex для ресурсов по устранению неполадок BroadWorks

Контакты


С октября 2020 года мы переносим поддержку клиентов BroadSoft на процессы и инструменты поддержки Cisco CX. Это означает, что партнерам Webex для BroadWorks необходимо перейти от использования Xchange для управление делами к использованию Менеджера поддержки (SCM).

Мы ожидаем, что миграция будет выполниться в течение приблизительно 3 месяцев — до конца 2020 года. После осуществления миграции группа TAC BroadWorks/UCaaS начнет оказывать поддержку в CSOne/Lightning, а не в BroadSoft Jira. В течение периода миграции может потребоваться работать с делами в обеих системах.

Подробные сведения см. в Переход от устаревших Служб поддержки BroadSoft.

Полезные файлы журналов

Название журнала Источник Полезно для устранения неполадок
PSLog Сервер приложений Непрерывное обеспечение
tomcat access_log XSP Вход в приложение Webex
XsiActionsLog XSP Взаимодействия при входе в приложение Webex с прокси-сервером Webex IDP, взаимодействия с клиентом для запроса профилей устройств
authenticationService log XSP Вход в приложение Webex (проверка и выдача токенов)
XSLog XSP?

Подписки на мобильные устройства для push-уведомлений

Сигнализация вызовов

Журнал запуска приложения Webex

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

Mac.

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

Мобильные устройства: Использовать отправку журналов

Запуск (последовательность)

Проверка прав пользователя

Инициализация библиотеки BWC для подключения к BroadWorks

getUserProfile & JwT token fetch logging

Журнал приложения Webex для вызовов BroadWorks

Клиент

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

Mac.

/Users/{username}/Library/Logs/SparkMacDesktop/bwc/current_log

Мобильные устройства: Использовать отправку журналов

Весь трафик SIP для регистрации и вызовов

Поддерживать актуальный трафик для BWKS Backend

Функции во время вызова, которые требуют отправки сигнала (удержание/возобновление, передача и т. д.)

Журнал мультимедиа (Webex Media Engine)

Клиент

Windows.

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

Mac.

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

Мобильные устройства: Использовать отправку журналов

Ведение журналов всех мультимедиа

Согласование кодеков для вызова

Функции во время вызова

Список литературы

Водяной знак
29 мар. 2021 г.| – просмотры | – пользователи, которые сочли этот материал полезным

Процессы

Webex для процессов устранения неполадок BroadWorks

Эскалация проблемы

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

1

Соберите максимально полную информацию из систем, связанных с этой проблемой.

2

Обратитесь к соответствующему отделу Cisco, чтобы создать заявку (см. раздел Контакты)

Информация о клиенте, которую необходимо собрать

Если вы считаете, что вам необходимо создать запрос или выполнить эскалацию проблемы, то во время устранения неполадок с пользователем необходимо собрать следующую информацию:

  • Идентификатор пользователя: Адрес электронной почты CI или UUID пользователя (это идентификатор Webex, но также может оказаться полезным идентификатор BroadWorks)

  • Идентификатор организации

  • Ориентировочное время, в течение которого проявлялась проблема

  • Платформа и версия клиента

  • Отправка и сбор журналов от клиента.

  • Зафиксируйте идентификатор отслеживания, если он отображается на клиенте

Проверка сведений о пользователе в службе технической поддержки

1

Войдите в https://admin.webex.com/helpdesk.

2

Найдите и щелкните пользователя. Откроется экран сводной информации о пользователях.

3

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

Полезная информация в этом представлении включает UUID пользователя, кластер Common Identity (CI), кластер приложений Webex, поведение при вызовах, GUID учетной записи BroadWorks.

4

Если требуется использовать эту информацию в другом инструменте, нажмите кнопку Копировать, либо приложите ее к заявке Cisco.

Просмотр клиентской организации в службе технической поддержки

1

Войдите в https://admin.webex.com/helpdesk.

2

Найдите и щелкните название организации клиента.

3

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

Извлечение журналов пользователя из Partner Hub

При устранении неполадок с клиентами для настольных ПК и мобильными устройств важно, чтобы партнеры (и TAC) могли просматривать журналы клиента.

1

Попросите пользователя отправить журналы.

2

Попросите пользователя экспортировать среду вызовов и отправить вам файл ced.dat.

3

Получите журналы клиента из Partner Hub или службы технической поддержки (см. ниже).

Вариант работы через Partner Hub:

  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

Проверьте, присутствует ли на боковой панели пиктограмма параметров вызова (телефонная трубка с шестеренкой над ней).

Если пиктограмма не присутствует, возможно, у пользователя еще не включена служба вызовов в Control Hub.

3

Откройте меню Настройки/Параметры и перейдите в раздел Услуги телефонии. Вы должны увидеть статус сеанса SSO, в который вы вошли.

(Если отображается другой телефонный сервис, например Webex Calling, пользователь не использует Webex для BroadWorks.)

Эта проверка означает, что:

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

Получение журналов клиента или отзывов

  • См. раздел «Ресурсы», чтобы найти определенные журналы клиентов в клиентах Webex для настольных компьютеров, либо попросите пользователей отправить журналы.

  • Попросите пользователей мобильных клиентов отправить журналы, чтобы получить их через Partner Hub или службу поддержки.


Отправка журналов происходит в фоном режиме. Однако, если пользователь отправляет отзыв, она передается команде разработчиков приложения Cisco Webex. Не забудьте записать номер отзыва пользователя, если вы хотите получить ответ от Cisco. Например:

Экспорт данных среды вызовов

Журналы клиентов Webex тщательно редактируются для удаления персональных данных. Вы должны экспортировать данные среды вызовов от клиента в том же сеансе, в котором вы выявили проблему.

1

В клиенте щелкните изображение профиля, затем щелкните Справка > Экспорт данных среды вызовов.

2

Сохраните файл ced.dat для устранения неполадок с вызовами для этого пользователя.

Важно! Выйдите из системы или перезапустите клиент, чтобы очистить внутренний кэш. Если экспортировать файл ced.dat после этого, то данные экспорта не будут соответствовать ни одному из журналов, отправленных до кэша.

Сброс базы данных Webex

1

В клиенте нажмите Справка >средства проверки состояния.

2

Выберите Сброс базы данных.

В результате будет выполнен полный сброс клиента, а также загружен экран входа в приложение Webex.

Проверка того, что Webex должен зарегистрироваться в BroadWorks

Приложение Webex проверяет следующую информацию, чтобы определить, следует ли регистрироваться в BroadWorks.

  • Права пользователя на broadworks-connector

  • Поведение при вызовах для организации и пользователя

Проверка поведения пользователя при вызовах и прав на соединитель

  1. Войдите в службу поддержки (https://admin.webex.com/helpdesk) с помощью учетных данных администратора-партнера.

  2. Выполните поиск пользователя

  3. Щелкните имя пользователя и проверьте запись «Поведение при вызовах». Должно быть указано «Вызов через Webex».

  4. Щелкните имя пользователя, чтобы открыть экран «Сведения о пользователе».

  5. Прокрутите страницу вниз, чтобы найти раздел права и убедитесь в том, что broadworks-connector включен.


    Пользователи Webex для BroadWorks НЕ должны иметь праваbc-sp-standard, если они планируют использовать Webex для BroadWorks. Это права для службы вызовов «Webex Calling (BroadCloud)», которая является приложением Webex для вызовов с помощью облачной службы вызовов под управлением Cisco.

Проверьте поведение организации при вызовах

  1. Войдите в службу поддержки (https://admin.webex.com/helpdesk) с помощью учетных данных администратора-партнера.

  2. Найдите организацию.

  3. Щелкните организацию и проверьте запись «Поведение при вызовах». Должно быть указано «Вызов через Webex».

Анализ PSLog для проблем обеспечения пользователя

Используйте PSLog сервера приложений, чтобы увидеть POST-запрос HTTP на мост обеспечения и ответ от Webex.

В правильной рабочей ситуации передается ответ 200 ОК, и через несколько минут вы сможете увидеть, что в Webex создан пользователь (и новая клиентская организация, если он является первым пользователем).

Это можно проверить путем поиска в службе технической поддержки адреса электронной почты, который указа в POST-запросе.

Прежде чем начать

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

1

Сначала нужно проверить код ответа HTTP:

  • Все ответы, кроме 200 OK, говорят об ошибке обеспечения пользователя.

  • Ответ 200 OK может также указывать на сбой, если какие-либо данные в профиле подписчика не работают в услуге Webex в вышестоящем оборудовании моста обеспечения.

  • Ответ 400 может содержать узел сообщения. Мост обеспечения не может обработать что-либо в subscriberProfile. Возможно, что-то не так с сведениями о подписчике или имеется несовместимость с настройкой в шаблоне.

  • Ответ 401 означает, что учетные данные для обеспечения, введенные в AS, не совпадают с данными, введенными в шаблоне в Partner Hub.

  • Ответ 403 может указывать на то, что на сервере приложений что-то было неверно настроено. Проверьте целевую часть запроса — она не должна быть IP-адресом, но должна содержать URL-адрес моста обеспечения, который можно увидеть в шаблоне в Partner Hub.

  • Ответ 409 указывает на конфликт между указанным subscriberProfile и существующими данными Webex. Возможно, уже существует пользователь с этим адресом электронной почты. Проверьте сообщение в ответе.

2

Кроме того, можно проверить исходный POST-запрос HTTP на какие-либо подозрительные значения, которые могут привести к сбоям при обеспечении.

POST-запрос содержит XML-структуру subscriberProfile. Внутри него можно проверить следующие узлы:

  • bwuserid: Используйте его для поиска профиля подписчика, если его требуется изменить в BroadWorks.

  • group: Если шаблон находится в режиме «Поставщик услуг», он указывается строчными буквами и становится именем клиентской организации, которое вы видите в partner Hub.

  • serviceProvider: Если шаблон находится в режиме «Предприятие», он указывается строчными буквами и становится именем клиентской организации, которое вы видите в Partner Hub.

  • primaryPhoneNumber: Обязателен. Без него обеспечение невозможно.

  • email: Является идентификатором пользователя в Webex. Должен быть действительным и уникальным для Webex, в противном случае обеспечение невозможно.


 

Игнорирование служб: создается 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.

Далее объясняется, что можно ожидать от проверки журналов на предмет успешного входа в систему.

Рисунок 1. Аутентификация BroadWorks и настройка устройств

Пользователь взаимодействует со клиентом, клиент взаимодействует со службами Webex.

  • Пользователь сообщает свой адрес электронной почты в приложение Webex (на схеме 1).

  • CI знает о необходимости перенаправить этого пользователя для ввода пароля BroadWorks (посредством UAP) (2 на схеме).

  • IDP Proxy передает запрос на получения профиля в интерфейс Xsi в XSP.

В tomcat 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

    Заголовки включают в себя авторизацию: Базовая и пользовательская: broadworksTeamsClient

  • Затем XSP осуществляет аутентификацию OCI-P Basic по BroadWorks (AuthenticationVerifyRequest и AuthenticationVerifyResponse, как и любое другое приложение, которое осуществляет базовую аутентификацию посредством Xsi), а также UserGetRequest и ServiceProviderGetRequest для сбора информации о подписчике.

  • Ответ Xsi на Webex содержит блок XML Profile, содержащий userId (BroadWorks) и другие сведения (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… header.

В XsiActionsLog:

  • Клиент теперь может предоставлять долгосрочные токены в интерфейсе Xsi-Actions для получения профиля устройства (6 на схеме). Например:

    GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device

    С заголовками headers: Bearer token и user-agent: WebexTeams (вариант/версия)

  • Интерфейс Xsi-Actions передает токен authservice в POST-запросе (настроено на циклический интерфейс), например: 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 (циклическое)

  • Код состояния =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 на схеме)

Водяной знак
29 мар. 2021 г.| – просмотры | – пользователи, которые сочли этот материал полезным

Конкретные проблемы

Webex для BroadWorks Устранение конкретных проблем

Проблемы с Partner Hub

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

Администратор партнерской организации в Webex должен иметь роль администратора с полными правами. Эта роль используется для управления партнерской организацией, в том числе назначения административных прав себе и другим. Чтобы управлять клиентской организацией, вам необходимо предоставить себе (или другим людям) роль администратора продаж с полными правами или роль администратора продаж. См. https://help.webex.com/fs78p5.

Проблемы с обеспечением пользователей

Ошибки интегрированных служб обмена мгновенными сообщениями и состоянием доступности для определенных предприятий или клиентов

Если у вас есть несколько предприятий, использующих различные службы для совместной работы в облаке, например UC-One SaaS и Webex для BroadWorks, возможно, необходимо изменить адаптер для обеспечения на уровне предприятия.

Чтобы проверить те средства, которые настроены для интегрированных служб обмена мгновенными сообщениями и состоянием доступности (по умолчанию для предприятий, если не существует более конкретной настройки), выполните команду AS_CLI/Interface/Messaging> get. Для параметров обеспечения определенного предприятия откройте его и перейдите к пункту Службы > Интегрированные службы обмена мгновенными сообщениями и состоянием доступности.

Убедитесь в том, что конфигурация интегрированных служб обмена мгновенными сообщениями и состоянием доступности для этого предприятия в точности соответствует шаблону клиента в Partner Hub. Следующие настройки должны совпадать, в противном случае обеспечение невозможно для всех пользователей в организации:

Настройка интегрированных служб обмена мгновенными сообщениями и состоянием доступности BroadWorks Enterprise Integrated

Настройка шаблона клиента Partner Hub

URL сервера сообщений

Идентификатор обеспечения

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

Учетная запись обеспечения

Пароль сервера обмена сообщениями

Подготовка пароля учетной записи, подтверждение пароля

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

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

Если в BroadWorks отображаются ошибки интегрированных служб обмена мгновенными сообщениями и состоянием доступности, например «[Error 18215] Ошибка обеспечения на сервере обмена сообщениями» и «[Error 18211] Ошибка связи с сервером обмена сообщениями», следует изучить следующие возможные причины:

  • Адрес электронной почты пользователя уже существует в CI. Осуществите поиск пользователя в службе технической поддержки, чтобы проверить наличие его адреса электронной почты. Это не обязательно является окончательным решением, поскольку пользователь может существовать в организации, данные которой вы не можете видеть в службе технической поддержки.

  • Пользователь независимо зарегистрировался в Webex до назначения интегрированных служб обмена мгновенными сообщениями и состоянием доступности. В этом случае одним из вариантов является удаление пользователем бесплатной учетной записи для того, чтобы он мог стать частью клиентской организации, которую вы обеспечиваете. Инструкции: https://help.webex.com/5m4i4y.

  • Пользователю не назначен основной номер телефона в профиле (все подписчики Webex для BroadWorks должны иметь первичный DID). См. анализ PSLog через AS.

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

Если пользователи не отображаются в Control Hub, в течение нескольких минут после назначения встроенной интегрированной службы обмена мгновенными сообщениями и состоянием доступности, просмотрите коды ответов службы моста обеспечения. Запустите PSLog, чтобы посмотреть коды ответов HTTP.

200 (OK)

Ответ 200 OK не означает успешное обеспечение пользователя. Это означает, что служба обеспечения получила запрос и успешно отправила соответствующий запрос на создание пользователя в вышестоящие службы.

Транзакция обеспечения реализуется асинхронно. Служба отправляет ответ 200 OK, поскольку процесс создания пользователя может занять несколько минут, а из соображений производительности мы не хотим получать несколько запросов для создания одного и того же пользователя.

Однако, если пользователь не появляется в клиентской организации после ответа 200 ОК, это может быть указывать на то, что в вышестоящем потоке службы обеспечения службы Webex могла произойти ошибка создания пользователя.

Необходимо эскалация ошибки обеспечения с ответом 200 OK.

400 (Неудачный запрос)

Проверьте ответ HTTP, чтобы получить более подробную информацию о возможных проблемах, которые могут вызвать этот ответ службы обеспечения. Некоторые примеры для узла<message>:

  • «Недостоверная электронная почта BroadWorks с устаревшим API обеспечения».

    Адрес электронной почты, связанный с невыполненным запросом на обеспечение пользователя, не является допустимым, или неправильно введен, однако в шаблоне вы указали, что этим адресам электронной почты можно доверять. Проверьте профили пользователей в BroadWorks, в частности, идентификатор адреса электронной почты.

  • «Клиентская организация не найдена в базе данных, а также не включен флаг создания новой организации».

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

403 (Доступ запрещен)

Запрос на обеспечение не может быть выполнен. В этом случае потребуется изучить запрос и ответ. Например, если в качестве цели запроса на обеспечение указан IP-адрес вместо соответствующего URL-адреса моста обеспечения для вашей организации (см. раздел о настройке брандмауэра в руководстве по решению), это может означать, что в сервере приложений отсутствует требуемое исправление (ap373197).

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

409 (Конфликт)

Невозможно обработать запрос на обеспечение, поскольку в Webex имеется существующий пользователь, который соответствует адресу электронной почты в запросе.

Пользователь уже присутствует в CI

Получите электронную почту подписчика из POST-запроса HTTP и найдите его через службу технической поддержки.

Вы можете не увидеть пользователя если у вас нет прав, но также вы можете проверить присутствие пользователя в «свободной» организации, например «Consumer» (Потребитель).

Вы можете попросить этого пользователя удалить его бесплатную учетную запись, либо для его обеспечения можно использовать другой адрес электронной почты. См. https://help.webex.com/ndta402.

Проблемы со входом пользователей

Портал активации пользователей не загружается

Обычный процесс входа в Webex для BroadWorks включает в себя портал активации пользователей, на котором пользователи вводят свои пароли. Иногда этот портал не загружается после того, как пользователь указал свой адрес электронной почты на экране регистрации в приложении Webex.

Эта проблема может быть вызвана на стороне клиента или службы. На стороне клиента обычно это происходит из-за несовместимости браузера клиента со службой.

Ошибка однократной идентификации.

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

  • Убедитесь в том, что пользователь использует правильный пароль. Если шаблон, который вы использовали для обеспечения клиентской организации пользователя (в Partner Hub), настроен для аутентификации BroadWorks, пользователю следует ввести свой пароль для доступа в WebWorks.

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

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

Ожидаемая последовательность регистрации

  1. Клиент обращается в XSI для получения токена управления устройством и URL-адреса DMS

  2. Клиент запрашивает свой профиль устройства в DMS, представляя токен, полученный на шаге 1.

  3. Клиент считывает профиль устройства и извлекает учетные данные SIP, адреса и порты

  4. Клиент отправляет SIP REGISTER в SBC, используя информацию из шага 3

  5. SBC отправляет SIP REGISTER в AS (SBC может выполнить поиск в NS для поиска AS, если SBC еще не знает пользователя SIP.)

Ожидаемые признаки успешной регистрации клиента

В интерфейсе Webex появится пиктограмма «Параметры вызова».

На вкладке телефонных услуг приложения Webex (например, Настройки > Телефонные услуги телефонии для Windows, Параметры > Телефонные услуги для Mac) с сообщением «SSO сеанс: Вы выполнили регистрацию» означает, что приложение успешно зарегистрировано (в данном случае на BroadWorks).

Клиент не имеет пиктограммы вызова

В большинстве случаев это означает, что у пользователя нет соответствующих лицензий или прав.

Клиент отображает вкладку услуг телефонии, но не сеанс SSO

Это неуспешная регистрация. Существует несколько причин, по которым клиент приложения Webex может не пройти регистрацию в BroadWorks.

Тестирование нескольких служб вызовов с одинаковыми клиентами

Эта известная проблема может быть вызвана изменением клиентом разных серверов вызовов. Это, скорее всего, происходит во время пробных испытаний различных служб вызовов, предлагаемых с помощью (одного и того же) клиента приложения Webex. Для устранения этой проблемы можно сбросить базу данных клиента (ссылку).

Неправильная конфигурация службы аутентификации

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

  • Ключи 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 настроены (см. раздел Теги BroadWorks, необходимые для Webex в руководстве по решению), а также в том, что отсутствуют конфликты или неверные значения.

В частности, тег %SBC_ADDRESS_WXT% должен быть SBC к регистратору SIP для клиентов приложения Webex.

Клиент рабочего стола отключает услуги телефонии после успешного SSO соединения

Эта проблема может быть вызвана тем, что один и тот же пользователь вводит несколько клиентов на платформе одного типа. Например, если пользователь успешно заходит в приложение Webex в Windows, а затем в приложение Webex на другом компьютере Windows, будет активен только один сеанс SSO на одной из машин. Это предусмотрено разработкой.

Если вам необходимо решить эту проблему, можно настроить BroadWorks на несколько экземпляров одного типа устройств, однако они должны иметь уникальные SIP-адреса. Эта конфигурация находится вне сферы применения Webex для BroadWorks.

Настольное устройство не предназначено для пользователя

Эта подпись видна в журнале клиента(\bwc\):

<Error> [0x70000476b000] BroadWorksConfigDownloader.cpp:106 onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload — профиль устройства «Business Communicator — PC» не найден.

Проблемы с настройками вызова Webview

Кнопка/ссылка самостоятельного обслуживания не отображается в приложении Webex

Другой признак этой проблемы — отображается кнопка/ссылка, но при ее нажатии открывается внешний браузер.

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

  • Убедитесь в том, что приложение Webex зарегистрировано для вызовов в BroadWorks.

  • Убедитесь в том, что версия приложения Webex является актуальной и поддерживает CSWV.

Пустая страница или ошибка после нажатия кнопки/ссылки самостоятельного обслуживания

Как правило, такая ситуация в приложении Webex указывает на проблему конфигурации или развертывания в приложении CSWV на BroadWorks XSP.

Соберите сведения для дальнейшего анализа, включая журналы CSWV, журналы доступа, репозиторий config-wxt.xml и файл шаблона, а затем создайте заявку.

Коды ошибок конечных пользователей

В таблице ниже описаны коды ошибок конечных пользователей, которые можно увидеть на портале активации пользователей клиента.


Это не исчерпывающий список кодов ошибок. В таблице перечислены только существующие коды ошибок, для которых в приложении Webex в данный момент не указаны четкие указания для пользователя.
Таблица 1. Коды ошибок конечных пользователей

Код ошибки

Сообщение об ошибке

200010

Не удалось проверить учетные данные, поскольку пользователь Broadworks не авторизован

200018

Не удалось проверить учетные данные, поскольку пользователь заблокирован

200019

Не удалось проверить учетные данные, поскольку не удалось добавить пользователя для самостоятельной активации

200022

Не удалось отправить сообщение электронной почты, поскольку пользователь не аутентифицирован

200026

Не удалось проверить адрес электронной почты вследствие ошибки предварительной проверки или неверного состояния пользователя, ожидающего утверждения, для PartnerOrgUUID: {partnerOrgUUID}, BroadoworksUUID: {broadworksUUID} , ConfigSetUUID: {configSetUUID}

200039

Не удалось проверить адрес электронной почты, поскольку emailId, уже используется в другой организации

200040

Не удалось проверить адрес электронной почты, поскольку configSet не соответствует configSet в customerConfig

200041

Не удалось проверить адрес электронной почты, поскольку пользователь уже использует другую конфликтующую службу, конфликтующие права

200042

Не удалось проверить адрес электронной почты, поскольку адрес электронной почты уже связан с другим broadworks UserId

200043

Не удалось проверить адрес электронной почты, поскольку сопоставление пользовательской конфигурации клиента некорректно.

200044

Не удалось проверить адрес электронной почты, поскольку userId уже используется в этом кластере Broadworks

200045

Не удалось добавить пользователя с помощью самостоятельной активации, поскольку пользователь уже является частью другой организации

200046

Не удалось добавить пользователя с помощью самостоятельной активации, поскольку существует несколько ожидающих пользователей с одинаковым broadworksUserId в одном кластере Broadworks

200047

Не удалось добавить пользователя с помощью функции самостоятельной активации, поскольку userId уже используется в этом кластере Broadworks

200048

Не удалось добавить пользователя с помощью самостоятельной активации, поскольку адрес электронной почты уже обеспечивается другим userId BroadWorks.

200049

Не удалось добавить пользователя с помощью функции самостоятельной активации, поскольку userId уже используется в этом кластере Broadworks

200050

Не удалось добавить пользователя посредством самостоятельной активации, поскольку provisioningID не соответствует ожидаемому provisioningID предприятия абонента

200051

Не удалось добавить пользователя с помощью самостоятельной активации, поскольку spEnterpriseId, указанный в этом запросе, конфликтует с поставщиком услуг или предприятием, уже указанным в этом кластере BroadWorks.

Была ли статья полезной?

Руководство по устранению неисправностей Webex для BroadWorks

Похожие статьи

Недавно просмотренное

×