- Главная
- /
- Статья
Руководство по устранению неисправностей Webex для Cisco BroadWorks
Данное руководство необходимо техническим специалистам организаций-поставщиков услуг, которые оказывают поддержку себе и своим клиентам. Вы должны иметь навыки устранения общих неполадок, чтения журналов и работы с обращениями абонентов.
Устранение неполадок Webex для Cisco BroadWorks
Статья состоит из трех основных разделов:
- Материалы — список инструментов, материалов для чтения материалов, журналов и контактов, которые могут понадобиться вам.
- Процессы — описание некоторых действий, которые можно предпринять при устранении проблем клиента.
- Конкретные проблемы — классификация и перечисление известных проблемы, их выявление и варианты устранения.
Ресурсы по устранению неполадок Webex для Cisco BroadWorks
Полезные файлы журналов
Название журнала |
Источник |
Полезно для устранения неполадок |
---|---|---|
PSLog |
Сервер приложений |
Непрерывная подготовка |
кот access_log |
XSP |
Вход в приложение Webex |
XsiActionsLog | XSP |
Взаимодействие входа в приложение Webex с прокси-сервером Webex IDP, взаимодействие клиента для запроса профилей устройств |
authenticationService log |
XSP |
Вход в приложение Webex (проверка и выдача токенов) |
XSLog | XSP? |
Подписки на мобильные устройства для push-уведомлений Сигнализация вызовов |
Журнал запуска приложения Webex |
Windows. Mac. Мобильные устройства: Использовать отправку журналов |
Запуск (последовательность) Проверки прав для пользователя Инициализация библиотеки BWC для подключения к BroadWorks getUserProfile & JwT token fetch logging |
Вызовы BroadWorks Журнал приложения Webex |
Клиент Windows. Mac. Мобильные устройства: Использовать отправку журналов |
Весь трафик SIP для регистрации и вызовов Поддерживать актуальный трафик для BWKS Backend Функции вызова, требующие сигнализации (Hold/Resume, (Передача и т. д.) |
Журнал мультимедиа (Webex Media Engine) |
Клиент Windows. Mac. Мобильные устройства: Использовать отправку журналов |
Ведение журналов всех мультимедиа Согласование кодеков для вызова Функции во время вызова |
Список литературы для чтения
- Webex для портала знаний партнеров Cisco BroadWorks
- Руководство по настройке платформы XSP (R23)
- Руководство по управлению программным обеспечением BroadWorks (R23)
- Руководство по настройке управления устройствами Cisco BroadWorks (R23)
- Руководство по администрированию интерфейса командной строки Broadworks Xsp
- Описание функции маркера долгосрочной аутентификации, выпуск 23.0
- Руководство по интеграции аутентификации SAML, R23
- Руководство по параметрам поддержки Cisco BroadWorks SSL
- Описание функции поддержки Cisco CI
- Сервер push-уведомлений (описание функции)
- Описание поддержки push-уведомлений для функции вызовов, выпуск 22.0
- Метод миграции Connect (Android) в Firebase
- Описание функции хранилища токенов устройств Cisco BroadWorks для push-уведомлений, выпуск 22.0
- Планировщик емкости Cisco BroadWorksSystem (электронная таблица)
- Руководство по выбору размеров платформы Cisco BroadWorks
- Руководство по проектированию систем Cisco Broadworks
- Требования к поддержке аутентификации CI. Версия документа 1.0 MR-7136
Известные проблемы и ограничения
Статья Известные проблемы и ограничения содержит актуальную информацию об известных проблемах, которые мы выявили в решении Webex для BroadWorks.
Соединитель Serviceability
Служба Webex Serviceability увеличивает скорость, с которой специалисты службы технической поддержки Cisco могут диагностировать проблемы с инфраструктурой. Он автоматизирует задачи поиска, извлечения и хранения диагностических журналов и информации в деле SR. Также эта служба выполняет анализ с помощью диагностических подписей, что позволяет центру технической поддержки без труда выявлять и устранять проблемы, связанные с локальным оборудованием.
Подробную информацию о развертывании соединителя Serviceability см. в Руководстве по развертыванию соединителя Serviceability Cisco Webex.
Процесс устранения неполадок Webex для BroadWorks
Эскалация проблемы
После того как вы выполните некоторые рекомендации по устранению неполадок, у вас должно быть достаточное представление о месте возникновения проблемы.
Процедура
- Соберите как можно больше информации из систем, связанных с проблемой.
- Обратитесь в соответствующую службу Cisco, чтобы открыть дело.
Какую информацию о клиенте собирать
Если вы считаете, что вам необходимо создать запрос или выполнить эскалацию проблемы, то во время устранения неполадок с пользователем необходимо собрать следующую информацию:
- Идентификатор пользователя: Адрес электронной почты CI или UUID пользователя (это идентификатор Webex, но если вы также получите идентификатор BroadWorks пользователя, это поможет).
- Идентификатор организации.
- Приблизительный период времени, в течение которого возникла проблема.
- Клиентская платформа и версия.
- Отправлять или собирать логи от клиента.
- Запишите идентификатор отслеживания, если он отображается на клиенте.
Проверьте данные пользователя в службе поддержки
Администраторы партнеров, имеющие права администратора службы поддержки (базовые или расширенные), могут использовать эту процедуру для проверки сведений о пользователях с помощью представления службы поддержки.
Процедура.
- Войдите в Справочную службу.
- Найдите и щелкните пользователя. Откроется экран сводной информации о пользователях.
- Выберите имя пользователя для получения подробной конфигурации пользователя. Полезная информация в этом представлении включает UUID пользователя, кластер общей идентификации (CI), кластер приложений Webex, поведение вызовов, GUID учетной записи BroadWorks.
- Если требуется использовать эту информацию в другом инструменте, нажмите кнопку Копировать, либо приложите ее к заявке Cisco.
Просмотр организации клиента в Help Desk
Администраторы партнеров, имеющие права администратора службы поддержки (базового или расширенного), могут использовать эту процедуру для просмотра сведений об организации клиента в представлении службы поддержки.
Процедура.
- Войдите в Справочную службу.
- Найдите и щелкните название организации клиента.
- Прокрутите страницу вниз, пока не увидите Представление портала клиентов, и нажмите Просмотр CustomerName, чтобы увидеть доступное только для чтения представление организации клиента, включая пользователей и конфигурацию.
Извлечение журналов пользователей из Partner Hub
При устранении неполадок с настольными и мобильными клиентами важно, чтобы партнеры (и TAC) имели возможность просматривать журналы клиентов.
Процедура.
- Попросите пользователя отправить журналы. Подробная информация в статье ниже. Приложение Webex | Сообщить о проблеме.
- Попросите пользователя экспортировать среду вызовов и отправить вам файл ced.dat.
- Получите журналы клиентов из Partner Hub или Help Desk.
Вариант работы через Partner Hub:
- Войдите в Partner Hub и найдите клиентскую организацию пользователя.
- Щелкните Устранение неполадок.
- Выберите Журналы.
- Выполните поиск пользователя (по электронной почте).
- Просмотрите и скачайте журналы клиента в архиве ZIP.
Вариант работы через службу технической поддержки:
- Зайдите в службу технической поддержки.
- Найдите организацию.
- Выберите организацию (откроется экран сводки).
- Прокрутите вниз и нажмите Просмотреть клиента.
- Щелкните Устранение неполадок.
- Выберите Журналы.
- Выполните поиск пользователя (по электронной почте).
- Просмотрите и скачайте журналы клиента в архиве ZIP.
Как найти версию клиента
Процедура.
- Поделитесь этой ссылкой с пользователем: https://help.webex.com/njpf8r5
- Попросите пользователя отправить вам номер версии.
Проверка клиента на предмет вызова службы
Процедура.
- Войдите в клиент Webex.
- Проверьте, присутствует ли на боковой панели пиктограмма параметров вызова (телефонная трубка с шестеренкой над ней). Если пиктограмма не присутствует, возможно, у пользователя еще не включена служба вызовов в Control Hub.
- Откройте меню Настройки/Параметры и перейдите в раздел Услуги телефонии. Вы должны увидеть статус сеанса SSO, в который вы вошли. (Если отображается другая служба телефонной связи, например Webex Calling, пользователь не использует Webex для Cisco BroadWorks.)
Эта проверка означает, что:
- Клиент успешно подключил необходимые микросервисы Webex.
- Пользователь успешно прошел аутентификацию.
- Ваша система BroadWorks выдает клиенту долгосрочный веб-токен JSON.
- Клиент извлек свой профиль устройства и зарегистрировался в BroadWorks.
Получите журналы клиентов или отзывы
- См. раздел «Ресурсы», чтобы найти определенные журналы клиентов в клиентах Webex для настольных компьютеров, либо попросите пользователей отправить журналы. Подробная информация в статье ниже. Приложение Webex | Сообщить о проблеме.
- Попросите пользователей мобильных клиентов отправить журналы, чтобы получить их через Partner Hub или службу поддержки.Отправка журналов происходит в фоном режиме. Однако, если пользователь отправляет обратную связь, она поступает в команду разработчиков приложения Webex. Не забудьте записать номер отзыва пользователя, если вы хотите получить ответ от Cisco. Например:
Получать данные среды вызовов
Журналы клиентов Webex тщательно редактируются для удаления персональных данных. Вы должны экспортировать данные среды вызовов от клиента в том же сеансе, в котором вы выявили проблему.
Процедура.
- На клиенте нажмите Справка > Проверка работоспособности.
- Выберите Сброс базы данных. В результате будет выполнен полный сброс клиента, а также загружен экран входа в приложение Webex.
Убедитесь, что Webex должен зарегистрироваться в BroadWorks
Приложение Webex проверяет следующую информацию, чтобы определить, следует ли регистрироваться в BroadWorks.
- Права пользователя на broadworks-connector.
- Вызов поведения для организации и пользователя.
Проверка поведения пользователя при вызовах и прав на соединитель
- Войдите в Справочную службу, используя учетные данные администратора партнера.
- Выполните поиск пользователя
- Щелкните имя пользователя и проверьте запись «Поведение при вызовах». Должно быть указано «Вызов через Webex».
- Щелкните имя пользователя, чтобы открыть экран «Сведения о пользователе».
- Прокрутите вниз, чтобы найти раздел
entitlements
, и убедитесь, чтоbroadworks-connector
включено.Пользователь Webex для Cisco BroadWorks НЕ ДОЛЖЕН иметь право
bc-sp-standard
, если он намерен использовать Webex для Cisco BroadWorks. Это права для службы вызовов «Webex Calling (BroadCloud)», которая является приложением Webex для вызовов с помощью облачной службы вызовов под управлением Cisco.
Проверьте поведение организации при вызовах
- Войдите в Справочную службу, используя учетные данные администратора партнера.
- Найдите организацию.
- Нажмите на организацию и проверьте запись Поведение при вызове. Должно быть указано «Вызов через Webex».
Анализ PSLog на предмет проблем с инициализацией пользователей
Используйте PSLog сервера приложений, чтобы увидеть POST-запрос HTTP на мост обеспечения и ответ от Webex. В правильной рабочей ситуации передается ответ 200 ОК, и через несколько минут вы сможете увидеть, что в Webex создан пользователь (и новая клиентская организация, если он является первым пользователем). Это можно проверить путем поиска в службе технической поддержки адреса электронной почты, который указа в POST-запросе.
Прежде чем начать
Получите PSLog от сервера приложений во время попытки непрерывного обеспечения тестового пользователя.
Процедура.
- Сначала нужно проверить код ответа HTTP:
- Все ответы, кроме 200 OK, говорят об ошибке обеспечения пользователя.
- 200 OK все еще может указывать на сбой, если что-то в профиле абонента не работает в службах Webex выше моста обеспечения.
- 400 может содержать узел
message
в ответе. Мост обеспечения не смог обработать что-то вsubscriberProfile
. Возможно, что-то не так с сведениями о подписчике или имеется несовместимость с настройкой в шаблоне. - Ответ 401 означает, что учетные данные для обеспечения, введенные в AS, не совпадают с данными, введенными в шаблоне в Partner Hub.
- Ответ 403 может указывать на то, что на сервере приложений что-то было неверно настроено. Проверьте целевую часть запроса — она не должна быть IP-адресом, но должна содержать URL-адрес моста обеспечения, который можно увидеть в шаблоне в Partner Hub.
- 409 указывает на конфликт между предоставленными
subscriberProfile
и существующими данными Webex. Возможно, уже существует пользователь с этим адресом электронной почты. Проверьтеmessage
в ответе.
- Кроме того, можно проверить исходный POST-запрос HTTP на какие-либо подозрительные значения, которые могут привести к сбоям при обеспечении. 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.
Далее объясняется, что можно ожидать от проверки журналов на предмет успешного входа в систему.
Пользователь взаимодействует со клиентом, клиент взаимодействует со службами Webex.
- Пользователь сообщает свой адрес электронной почты в приложение Webex (на схеме 1).
- CI знает о необходимости перенаправить этого пользователя для ввода пароля BroadWorks (посредством UAP) (2 на схеме).
- IDP Proxy передает запрос на получения профиля в интерфейс 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 Web Token (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 (циклическое)
-
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 & П.
Убедитесь в том, что конфигурация интегрированных служб обмена мгновенными сообщениями и состоянием доступности для этого предприятия в точности соответствует шаблону клиента в Partner Hub. Следующие настройки должны совпадать, в противном случае обеспечение невозможно для всех пользователей в организации:
Настройка интегрированных служб обмена мгновенными сообщениями и состоянием доступности BroadWorks Enterprise Integrated | Настройка шаблона клиента Partner Hub |
---|---|
URL сервера сообщений | Идентификатор обеспечения |
Имя пользователя сервера обмена сообщениями | Учетная запись обеспечения |
Пароль сервера обмена сообщениями | Подготовка пароля учетной записи, подтверждение пароля |
Интегрированный IM & Ошибки P для определенных пользователей
Это применимо, если вы используете непрерывное обеспечение и предполагается, что подготовка работает для некоторых или большинства пользователей (таким образом можно исключать проблемы с конфигурацией). Если в BroadWorks отображаются ошибки интегрированных служб обмена мгновенными сообщениями и состоянием доступности, например «[Error 18215] Ошибка обеспечения на сервере обмена сообщениями» и «[Error 18211] Ошибка связи с сервером обмена сообщениями», следует изучить следующие возможные причины:
- Адрес электронной почты пользователя уже существует в CI. Осуществите поиск пользователя в службе технической поддержки, чтобы проверить наличие его адреса электронной почты. Это не обязательно является окончательным решением, поскольку пользователь может существовать в организации, данные которой вы не можете видеть в службе технической поддержки.
- Пользователь независимо зарегистрировался в Webex до назначения интегрированных служб обмена мгновенными сообщениями и состоянием доступности. В этом случае одним из вариантов является удаление пользователем его бесплатной учетной записи, чтобы он мог стать частью организации клиента, которую вы предоставляете. Инструкции находятся на https://help.webex.com/5m4i4y
- Пользователю не назначен основной номер телефона в его профиле (все подписчики Webex для Cisco BroadWorks должны иметь основной идентификатор DID). См. анализ PSLog через AS.
Сбои в предоставлении доступа пользователю в ответ на мост предоставления доступа
Если пользователи не отображаются в Control Hub, в течение нескольких минут после назначения встроенной интегрированной службы обмена мгновенными сообщениями и состоянием доступности, просмотрите коды ответов службы моста обеспечения. Запустите PSLog, чтобы посмотреть коды ответов HTTP.
200 (OK)
Ответ 200 OK не означает, что пользователь успешно инициализирован. Это означает, что служба обеспечения получила запрос и успешно отправила соответствующий запрос на создание пользователя в вышестоящие службы. Транзакция обеспечения реализуется асинхронно. Служба отправляет ответ 200 OK, поскольку процесс создания пользователя может занять несколько минут, а из соображений производительности мы не хотим получать несколько запросов для создания одного и того же пользователя. Однако, если пользователь не появляется в клиентской организации после ответа 200 ОК, это может быть указывать на то, что в вышестоящем потоке службы обеспечения службы Webex могла произойти ошибка создания пользователя. Необходимо эскалация ошибки обеспечения с ответом 200 OK.
400 (Неудачный запрос)
Проверьте ответ HTTP, чтобы получить более подробную информацию о возможных проблемах, которые могут вызвать этот ответ службы обеспечения. Некоторые примеры для узла:
- «Недостоверная электронная почта BroadWorks с устаревшим API обеспечения». Адрес электронной почты, связанный с невыполненным запросом на обеспечение пользователя, не является допустимым, или неправильно введен, однако в шаблоне вы указали, что этим адресам электронной почты можно доверять. Проверьте профили пользователей в BroadWorks, в частности, идентификатор адреса электронной почты.
- Организация клиента не найдена в базе данных, а также флаг создания новой организации не включен». Этот неуспешный запрос на обеспечение должен был создать новую клиентскую организацию в Webex, однако ваш шаблон настроен таким образом, чтобы предотвратить создание новых клиентских организаций. При желании разрешить новые организации для почтовых доменов, не совпадающих с существующими клиентами в Webex, можно перенастроить шаблон в Partner Hub и повторно протестировать запрос на обеспечение. Тем не менее, если для этого пользователя не создается новая организация, вероятно, адрес электронной почты введен неправильно (в частности, часть домена). Проверьте адрес электронной почты пользователя в BroadWorks.
403 (Доступ запрещен)
Запрос на обеспечение не может быть выполнен. В этом случае потребуется изучить запрос и ответ. Например, если в качестве цели запроса на обеспечение указан IP-адрес вместо соответствующего URL-адреса моста обеспечения для вашей организации (см. раздел о настройке брандмауэра в руководстве по решению), это может означать, что в сервере приложений отсутствует требуемое исправление (ap373197).
Убедитесь в том, что к серверу приложений применены все необходимые исправления, а также в том, что выполнена соответствующая конфигурация для успешного непрерывного обеспечения.
409 (Конфликт)
Невозможно обработать запрос на обеспечение, поскольку в Webex имеется существующий пользователь, который соответствует адресу электронной почты в запросе.
Пользователь уже присутствует в CI
Получите электронную почту подписчика из POST-запроса HTTP и найдите его через службу технической поддержки. Вы можете не увидеть пользователя если у вас нет прав, но также вы можете проверить присутствие пользователя в «свободной» организации, например «Consumer» (Потребитель). Вы можете попросить этого пользователя удалить его бесплатную учетную запись, либо для его обеспечения можно использовать другой адрес электронной почты. См. https://help.webex.com/ndta402.
Проблемы со входом пользователя
Портал активации пользователя не загружается
Обычный процесс входа в Webex для Cisco BroadWorks включает портал активации пользователей, на котором пользователи вводят свои пароли. Иногда этот портал не загружается после того, как пользователь указал свой адрес электронной почты на экране регистрации в приложении Webex. Эта проблема может быть вызвана на стороне клиента или службы. На стороне клиента обычно это происходит из-за несовместимости браузера клиента со службой.
Ошибка однократной идентификации.
- В BroadWorks проверьте, назначены ли пользователю типы устройств для приложения Webex (см. Профили устройства в разделе Подготовка среды руководства по решению).
- Проверьте, что пользователь использует правильный пароль. Если шаблон, который вы использовали для предоставления организации клиента пользователя (в Partner Hub), настроен для аутентификации BroadWorks, пользователь должен ввести свой пароль «Web Access» от BroadWorks. Пользователю также может потребоваться ввести свой идентификатор пользователя BroadWorks, если его адрес электронной почты не настроен в качестве альтернативного идентификатора пользователя. Убедитесь, что пользователь правильно ввел заглавные и строчные буквы.
Проблемы с конфигурацией и регистрацией вызовов
После того как пользователь был передан в Webex и успешно выполнил вход в приложение Webex, приложение регистрируется в BroadWorks. Ниже приводится ожидаемая последовательность регистрации и признаки успешной регистрации (как видно из приложения Webex).
Ожидаемая последовательность регистрации
- Клиент обращается к XSI, чтобы получить токен управления устройством и URL-адрес DMS.
- Клиент запрашивает свой профиль устройства в DMS, представляя токен из шага 1.
- Клиент считывает профиль устройства и извлекает учетные данные SIP, адреса и порты.
- Клиент отправляет SIP REGISTER в SBC, используя информацию из шага 3.
- SBC отправляет SIP REGISTER в AS (SBC может выполнить поиск в NS, чтобы найти AS, если SBC еще не знает пользователя SIP).
Ожидаемые признаки успешной регистрации клиента
В интерфейсе Webex появится пиктограмма «Параметры вызова».
На вкладке телефонных услуг приложения Webex (например, Настройки > Телефонные услуги телефонии для Windows, Параметры > Телефонные услуги для Mac) с сообщением «SSO сеанс: Вы выполнили регистрацию» означает, что приложение успешно зарегистрировано (в данном случае на BroadWorks).
У клиента нет значка вызова
В большинстве случаев это означает, что у пользователя нет соответствующих лицензий или прав.
Клиент показывает вкладку «Телефонные службы», но сеанс единого входа отсутствует
Это неуспешная регистрация. Существует несколько причин, по которым клиент приложения Webex может не пройти регистрацию в BroadWorks.
Тестирование нескольких услуг по вызову с одними и теми же клиентами
Эта известная проблема может быть вызвана изменением клиентом разных серверов вызовов. Это, скорее всего, происходит во время пробных испытаний различных служб вызовов, предлагаемых с помощью (одного и того же) клиента приложения Webex. Для устранения этой проблемы можно сбросить базу данных клиента (ссылку).
Неправильная настройка службы аутентификации
Проверьте XSP, размещающие службу аутентификации, на соответствие руководству по решению (см. раздел Настройка служб в XSP Webex для Cisco 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. Обратитесь к Руководству по настройке Webex для Cisco BroadWorks для получения информации о тегах конфигурации. Убедитесь в отсутствии конфликтов или неверных значений. В частности, тег %SBC_ADDRESS_WXT% должен быть SBC для вашего регистратора SIP для клиентов приложения Webex.
Клиент для настольных ПК отключает телефонные службы после успешного подключения SSO
Эта проблема может быть вызвана тем, что один и тот же пользователь вводит несколько клиентов на платформе одного типа. Например, если пользователь успешно войдет в приложение Webex на Windows, а затем войдет в приложение Webex на другом компьютере Windows, активный сеанс единого входа будет только на одном из компьютеров. Это предусмотрено разработкой. Если вам необходимо решить эту проблему, можно настроить 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
Другой признак этой проблемы — отображается кнопка/ссылка, но при ее нажатии открывается внешний браузер.
- Убедитесь, что требуемый шаблон конфигурации клиента развернут и теги CSW установлены правильно. (См. раздел Настройки вызова Веб-просмотр в Руководстве по решению Webex для Cisco BroadWorks).
- Убедитесь в том, что приложение Webex зарегистрировано для вызовов в BroadWorks.
- Убедитесь в том, что версия приложения Webex является актуальной и поддерживает CSWV.
Пустая страница или ошибка после нажатия кнопки «Самообслуживание» button/link
Как правило, такая ситуация в приложении Webex указывает на проблему конфигурации или развертывания в приложении CSWV на BroadWorks XSP. Соберите сведения для дальнейшего анализа, включая журналы CSWV, журналы доступа, репозиторий config-wxt.xml и файл шаблона, а затем создайте заявку.
Проблемы с доменными претензиями
Ошибки, возникающие при регистрации пользователей, могут быть вызваны ошибками заявок на домены. Прежде чем затребовать какие-либо домены, убедитесь, что выполняется следующее условие.
- Поставщики услуг не должны претендовать на домены организаций-клиентов, которыми они управляют. Они могут затребовать только домены пользователей, которые являются частью внутренней организации поставщика услуг. Если будет затребован домен пользователей в отдельной организации (включая организации, которыми управляют поставщики услуг), при регистрации пользователей в клиентской организации будут возникать ошибки, поскольку запросы на аутентификацию пользователя маршрутизируются через поставщика услуг, а не через клиентскую организацию.
- Если две клиентские организации (компания A и компания B) используют один и тот же домен и компания A затребовала его, пользователи компании B могут не пройти регистрацию, поскольку запросы на аутентификацию пользователей маршрутизируются через организацию, которая затребовала домен (компания A).
Если вы затребовали какие-либо домены по ошибке и вам нужно удалить заявку, ознакомьтесь со статьей Управление доменами в Webex.
Коды ошибок конечного пользователя
В таблице ниже описаны коды ошибок конечных пользователей, которые можно увидеть на портале активации пользователей клиента.
Код ошибки |
Сообщение об ошибке |
Рекомендуемое действие |
---|---|---|
100006 |
Ошибка входа: Пользователь ID/Password неверно. |
Проверьте, что пользователь использует правильный пароль. Если шаблон, который вы использовали для предоставления организации клиента пользователя (в Partner Hub), настроен для аутентификации BroadWorks, пользователь должен ввести свой пароль «Web Access» от BroadWorks. Пользователю также может потребоваться ввести свой идентификатор пользователя BroadWorks, если его адрес электронной почты не настроен в качестве альтернативного идентификатора пользователя. Убедитесь, что пользователь правильно ввел заглавные и строчные буквы. |
200010 |
Не удалось проверить учетные данные, так как пользователь BroadWorks не авторизован. |
Пользователь должен указать другую комбинацию имени пользователя и пароля. В противном случае администратору нужно сбросить пароль в BroadWorks. |
200013 |
К сожалению, вы не можете присоединиться к <name of SP offer> через Webex прямо сейчас. Повторите попытку через несколько минут. Если проблема сохраняется, обратитесь к своему <customer organization administrator>. |
Не удалось обновить информацию о пользователе в Common Identity. Пожалуйста, обновите пользователя еще раз, используя API пользователя. |
200014 |
Обратитесь к вашему <Service Provider> администратору. | Убедитесь, что ваша конфигурация верна и что идентификатор предоставления в запросе указан правильно. |
200016 | Не удалось проверить учетные данные, так как сеанс не найден. | Пользователь должен обновить браузер и повторно указать имя пользователя/пароль. |
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 | Не удалось проверить адрес электронной почты, так как идентификатор пользователя уже используется в этом кластере BroadWorks. | Пользователь должен повторить попытку, используя другой адрес электронной почты. В противном случае администратор организации клиента, управляющий существующей учетной записью пользователя, использующей этот адрес электронной почты, должен удалить эту учетную запись пользователя. |
200045 | Не удалось добавить пользователя с помощью самостоятельной активации, поскольку пользователь уже является частью другой организации. | Пользователям следует повторить попытку регистрации, но с другим адресом электронной почты. В противном случае администратор организации клиента, администрирующий другую организацию, должен удалить существующую учетную запись. |
200046 | Не удалось добавить пользователя посредством самостоятельной активации, так как существует несколько ожидающих пользователей с одинаковым broadworksUserId в одном кластере BroadWorks. | Администратор должен удалить ожидающих пользователей из Control Hub. |
200047 | Не удалось добавить пользователя посредством самостоятельной активации, так как userId уже используется в этом кластере BroadWorks. | Пользователь должен повторить попытку, используя другой адрес электронной почты. В противном случае администратор организации клиента, управляющий существующей учетной записью пользователя, должен удалить эту существующую учетную запись пользователя или же удалить другие права. |
200048 | Не удалось добавить пользователя с помощью самостоятельной активации, поскольку адрес электронной почты уже используется для другого идентификатора 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 не найдена. |
600008 | Параметр CustomerConfig не найден в партнерской организации. |
600009 | Синхронизацию пользователей внешнего каталога Broadworks невозможно запустить, так как кластер Broadworks, связанный с CustomerConfig, занят. |
600010 | Синхронизацию пользователей внешнего каталога Broadworks невозможно запустить, так как с CustomerConfig не связан кластер Broadworks. |
600011 | Синхронизация пользователей внешнего каталога Broadworks не включена для CustomerConfig. |
600012 | Не удается запустить синхронизацию пользователей внешнего каталога Broadworks, поскольку синхронизация каталогов гибридного типа уже включена для CustomerConfig. |
600013 | Во время синхронизации пользователей внешнего каталога Broadworks не удалось добавить учетные записи пользователей и компьютеров в хранилище удостоверений. |
600014 | Ошибка синхронизации пользователей внешнего каталога Broadworks при попытке подключения к кластеру Broadworks. Ошибка Broadworks: %s. |
600015 | При синхронизации пользователей внешнего каталога Broadworks не найдены соответствующие пользователи в хранилище удостоверений. |
600017 | При синхронизации списка телефонов BroadWorks не удалось синхронизировать все контакты пользователя и предприятия/организации. |
600018 | Синхронизация списка телефонов BroadWorks не удалась для пользователей в предприятии/организации. |
600019 | При синхронизации списка телефонов BroadWorks не удалось синхронизировать контакты предприятия/организации. |
600020 | Синхронизация пользователей с внешним каталогом BroadWorks не может быть отключена, поскольку в настоящее время идет синхронизация CustomerConfig. |
600022 | Синхронизация пользователей с внешним каталогом BroadWorks не возможна, поскольку в организации нет предусмотренного пользователя. |
600023 | Синхронизация пользователей с внешним каталогом BroadWorks невозможен, поскольку пользователь уже существует в этой организации. |
600024 | Синхронизация с одним пользователем из внешнего каталога BroadWorks не возможна, поскольку в BroadWorks не найдено ни одного совместимго пользователя. |
600025 | Не удалось обновить данные синхронизации пользователей внешнего каталога BroadWorks в учетная запись пользователя CI. |
600026 | Не удалось обновить учетную запись компьютера в CI в BroadWorks External Directory User Sync. |
600027 | Синхронизация пользователей с внешним каталогом BroadWorks не возможна, поскольку в BroadWorks было обнаружено несколько пользователей. |
600028 | Синхронизация отдельного пользователя внешнего каталога BroadWorks невозможна, поскольку должна быть завершена по крайней мере одна синхронизация корпоративного каталога. |
600029 | Не удалось синхронизировать пользователей с внешним каталогом BroadWorks, поскольку в организации не предусмотрен пользователь. |
История изменений
В таблице представлена история изменений данного руководства.
Дата | Изменение |
---|---|
23 апреля 2025 г. | Удалена папка bwc из источника журнала приложения BroadWorks Calling Webex. |
29 июля 2023 г. | Добавлена ссылка на Приложение Webex | Сообщить о проблеме (для создания журналов) в разделах Получение журналов пользователя из Partner Hub и Получение журналов клиента или отзывов . |
27 июня 2022 г. | Обновлен Список чтения с отсутствующей ссылкой на Метод миграции Connect (Android) на Firebase. |
21 июня 2022 г. | Обновлены ссылки ReadingList для указания новых URL-адресов на Cisco.com. Обновлены Проблемы с настройкой и регистрацией вызовов путем добавления ссылки на Руководство по настройке Webex для Cisco BroadWorks для решения проблем с тегами BroadWorks. |
14 апреля 2022 г. | Добавлены контекстные операторы для проверки сведений о пользователе в службе технической поддержки и для просмотра организации клиента в службе технической поддержки с целью уточнения требований к ролям для службы технической поддержки. |
26 марта 2022 г. | Добавлены новые коды ошибок в Коды ошибок синхронизации каталогов. |
15 ноября 2021 г. | Добавлены коды ошибок 200013, 200014, 200025 и 300005 в Коды ошибок конечного пользователя. |
28 сентября 2021 г. | Добавлены коды ошибок для синхронизации каталогов. |
15 июля 2021 г. | Добавлено сообщение об ошибке 100006 в Коды ошибок конечного пользователя. Также обновлено Проблемы со входом пользователей. |
14 июля 2021 г. | Добавлена тема со ссылкой на статью Известные проблемы и ограничения . |
2 июля 2021 г. | Обновлено название продукта вследствие изменения товарно-знаковой политики Webex. |
18 июня 2021 г. | Обновлен логотип Webex в графике. |
8 июня 2021 г. | Добавлен столбец «Рекомендуемые действия» в таблицу Коды ошибок конечного пользователя. |
4 июня 2021 г. | Исправление в таблице Коды ошибок конечного пользователя. |
19 мая 2021 г. | Добавлен раздел Проблемы с претензиями на домены. |
22 апреля 2021 г. | Обновлены Коды ошибок конечного пользователя двумя дополнительными кодами: 200016 и 200054. |
13 апреля 2021 г. | Добавлена информация о подключении к Webex Serviceability. |
8 декабря 2020 г. | Обновление документа. Переименование Webex Teams в Webex (приложение). Добавлены коды ошибок конечного пользователя. |
3 ноября 2020 г. | Добавлен веб-просмотр настроек вызовов. |
22 октября 2020 г. | Представлен новый документ. |