Управление Webex для BroadWorks

Обеспечение клиентских организаций

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

Управление пользователями

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

Обеспечение пользователей

Возможные способы обеспечения пользователей:

  • Используйте API для создания учетных записей Webex

  • Назначьте интегрированную службу IM&P (непрерывное обеспечение) с доверенными адресами электронной почты для создания учетных записей Webex

  • Назначьте интегрированную службу IM&P (непрерывное обеспечение) без доверенных адресов электронной почты. Пользователи предоставляют и подтвердят адреса электронной почты для создания учетных записей Webex

  • Разрешить пользователям самостоятельно выполнять активацию (вы отправляете им ссылку, они создают учетные записи Webex).

Открытые API обеспечения

Cisco Webex предоставляет открытые API, чтобы поставщики услуг могли интегрировать службы обеспечения подписчиков Webex для BroadWorks в существующие процессы обеспечения. Спецификации для этих API доступны по адресу developer.webex.com. При необходимости разработки с помощью этих API обратитесь к представителю Cisco для получения Webex для BroadWorks.

Непрерывное обеспечение

В BroadWorks можно обеспечивать пользователей с параметром Включить интегрированную службу IM&P. Это действие приводит к тому, что адаптер обеспечения BroadWorks отправляет API-запрос для обеспечения работы Cisco Webex. Наш АPI обеспечения имеет обратную совместимость с UC-One SaaS API. BroadWorks AS не требует изменения кода, а только изменения конфигурации конечной точки API для адаптера обеспечения.


Обеспечение подписчиков Cisco Webex может занять значительное время (несколько минут для первоначального пользователя предприятия). Webex выполняет подготовку в фоновом режиме. Таким образом, успешное непрерывное обеспечение означает, что обеспечение запущено. Это не означает завершение работы.

Чтобы подтвердить, что пользователи и клиентская организация полностью обеспечиваются Cisco Webex, необходимо войти в Partner Hub и просмотреть список клиентов.

Самостоятельная активация пользователя

Для обеспечения пользователей BroadWorks в Webex без назначения интегрированной службы IM&P:

  1. Войдите в Partner Hub и перейдите на страницу Параметры BroadWorks.

  2. Щелкните Просмотр шаблонов.

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

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

  4. Скопируйте ссылку обеспечения и отправьте ее пользователю.

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

  5. Вы можете следить за состоянием активации пользователя в выбранном шаблоне.

Чтобы получить более подробную информацию, см. Обеспечение пользователей и процессы активации.

Изменение идентификатора или адреса электронной почты пользователя

Изменения идентификатора и адреса электронной почты пользователя

Параметры «Email ID» и «Alternate ID» являются атрибутами пользователя BroadWorks, которые используются в Webex для BroadWorks. Идентификатор пользователя BroadWorks по-прежнему является основным идентификатором пользователя в BroadWorks. В таблице ниже описаны назначения этих различных атрибутов и порядок действий при необходимости их изменения.

Атрибут в BroadWorks Соответствующий атрибут в Webex Цель Примечания
Идентификатор пользователя BroadWorks Нет Основной идентификатор Невозможно изменить этот идентификатор и привязать пользователя к той же учетной записи в Webex. Если он указан неверно, можно удалить пользователя и повторно создать его.
Email ID User ID

Обязательно для непрерывного обеспечения (создание идентификатора пользователя Webex), когда вы утверждаете, что доверяете адресу электронной почты

Не требуется в BroadWorks, если вы не утверждаете, что доверяете адресам электронной почты

Не требуется в BroadWorks, если абоненты могут самостоятельно выполнять активацию

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

  1. Изменение адреса электронной почты пользователя в Control Hub

  2. Изменение атрибута Email ID в BroadWorks

Не изменяйте идентификатор пользователя в BroadWorks. Это не поддерживается.

Alternate ID Нет Включает аутентификацию пользователя, по электронной почте и паролю, на основании идентификатора пользователя BroadWorks Должен быть таким же, как и Email ID. Если вы не можете поместить адрес электронной почты в атрибут Alternate ID, пользователи должны будут ввести свой BroadWorks User ID при аутентификации.

Изменение пакета пользователей в Partner Hub

1

Войдите в Partner Hub и щелкните Клиенты.

2

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

Страница обзора организации откроется на панели в правой части экрана.

3

Выберите Просмотр данных клиента.

Клиентская организация откроется в Control Hub, на странице «Обзор».
4

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

Панель информации о пользователе откроется в правой части экрана

5

В разделе Службы пользователя щелкните Пакеты Webex для BroadWorks (Подписки).

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

6

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

В Control Hub отобразится сообщение о том, что пользователь обновляется.

7

Можно закрыть сведения о пользователе и вкладку Control Hub.


Пакеты «Стандартный» и «Премиум» используют отдельные веб-сайты совещаний, связанные с каждым пакетом. При переходе абонента с привилегиями администратора из одного из этих двух пакетов в другой пакет он получает два сайта для совещаний в Control Hub. Возможности проведения совещаний и веб-сайт совещаний абонента соответствуют его текущему пакету. Администратор может и дальше пользоваться веб-сайтом для совещаний предыдущего пакета и любым ранее созданным контентом на этом веб-сайте, например записями.

Удаление пользователей

Удалить пользователей можно указанными способами.

  • Используйте API для удаления учетных записей Webex. См. https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber.

  • Удалите назначение интегрированной службы IM&P в BroadWorks, чтобы удалить учетные записи Webex.

  • Можно удалить пользователя из клиентской организации с помощью Partner Hub.

  • Администраторы клиента могут удалять пользователей в Control Hub. См. https://help.webex.com/0qse04/.

Перенастройка системы

Вы можете перенастроить систему следующим образом.

  • Добавление кластера BroadWorks в Partner Hub.

  • Редактирование или удаление кластера BroadWorks в Partner Hub

  • Добавление шаблона клиента в Partner Hub.

  • Редактирование или удаление шаблона клиента в Partner Hub

Редактирование или удаление кластера BroadWorks в Partner Hub

Можно редактировать или удалять кластер BroadWorks в Partner Hub.

1

Войдите в Partner Hub с помощью учетных данных администратора партнера по ссылке https://admin.webex.com.

2

Перейдите в Настройки и найдите раздел Вызовы BroadWorks.

3

Щелкните Просмотр кластеров.

4

Щелкните кластер, который необходимо отредактировать или удалить.

Сведения о кластере отображаются во всплывающем меню справа.
5

Доступны следующие варианты:

  • Измените все данные, которые необходимо изменить, и щелкните Сохранить.
  • Щелкните Удалить, чтобы удалить кластер, затем подтвердите удаление.

     

    Если с кластером связан шаблон, его нельзя удалить. Удалите связанные шаблоны перед удалением кластера. См. Редактирование или удаление шаблона клиента в Partner Hub.

Список кластеров обновляется по мере внесения изменений.

Редактирование или удаление шаблона клиента в Partner Hub

Шаблоны клиентов можно редактировать или удалять в Partner Hub.

1

Войдите в Partner Hub с помощью учетных данных администратора партнера по ссылке https://admin.webex.com.

2

Перейдите в Настройки и найдите раздел Вызовы BroadWorks.

3

Щелкните Просмотр шаблонов.

4

Щелкните по шаблону, который необходимо отредактировать или удалить.

5

Доступны следующие варианты:

  • Отредактируете все данные, которые необходимо изменить, и щелкните Сохранить.
  • Щелкните Удалить, чтобы удалить шаблон, затем подтвердите удаление.

Настройка

Значения

Примечания

Предоставление имени и пароля учетной записи

Строки, предоставляемые пользователем

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

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

Вкл./Выкл.

Для вступления изменений в силу может потребоваться до 7 часов. То есть после включения этой функции пользователи все еще будут должны вводить свои адреса электронной почты на экране входа.

Список кластеров обновляется по мере внесения изменений.

Увеличение емкости

Фермы XSP

Рекомендуется использовать планировщик производительности для определения необходимого количества дополнительных ресурсов XSP в рамках предлагаемого увеличения количества подписчиков. Для выделенных NPS или выделенных служб Webex для ферм BroadWorks доступны следующие параметры масштабируемости.

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

  • Добавить выделенную ферму: Добавить новую выделенную ферму XSP. Необходимо создать новый кластер и новые шаблоны в Partner Hub, чтобы начать добавление новых клиентов в новую ферму и снизить нагрузку на существующую ферму.

  • Добавить специализированную ферму: Если для определенной службы возникли «узкие места», можно создать отдельную ферму XSP с учетом требований к совместному размещению, перечисленных в этом документе. При изменении URL-адреса службы с новой фермой может потребоваться перенастройка кластеров Control Hub и записей DNS.

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

Управление сертификатами HTTP-сервера

Управление этими сертификатами необходимо для веб-приложений с аутентификацией mTLS на XSP.

  • Наша цепочка сертификатов доверия, выдаваемая в облаке Cisco Webex

  • Ваши сертификаты интерфейсов HTTP-сервера XSP

Цепочка доверия

Вы скачиваете цепочку сертификатов доверия из Control Hub и устанавливаете ее на XSP во время начальной настройки. Мы планируем обновить сертификат до истечения срока его действия и уведомить вас о том, как и когда его необходимо изменить.

Интерфейсы HTTP-сервера

Сервер XSP должен представить в Webex публично подписанный сертификат сервера, как описано в разделе Сертификаты заказов. При первом обеспечении безопасности интерфейса для интерфейса создается самозаверяющийся сертификат. Этот сертификат действителен в течение одного года с даты создания. Необходимо заменить самозаверяющийся сертификат публично подписанным сертификатом. Вы несете ответственность за запрос нового сертификата до истечения его срока его действия.

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

Подписаться на страницу состояния Webex

Сначала проверьте https://status.webex.com, если вы столкнулись с неожиданным прерыванием в работе службы. Если вы не изменяли конфигурацию в Control Hub или BroadWorks до сбоя, проверьте страницу состояния. Узнайте больше о подписке на уведомления о состоянии и инцидентах в Справочном центре Webex.

Использование средства анализа Control Hub

Webex отслеживает данные об использовании и качестве услуг для вашей организации и организации клиента. Узнайте больше о средствах анализа Control Hub в Справочном центре Webex.

Проблемы с сетью

Клиенты или пользователи не создаются в Control Hub при непрерывном обеспечении.

  • Может ли сервер приложений получить URL-адрес для обеспечения?

  • Правильно ли указана учетная запись для обеспечения и пароль. Имеется ли эта учетная запись в BroadWorks?

Кластеры постоянно не проходят проверки соединения.


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

  • Общедоступны ли интерфейсы XSP?

  • Используете ли вы правильные порты? Вы можете ввести порт в определение интерфейса в кластере.

Интерфейсы не проходят проверку

Интерфейсы Xsi-Actions и Xsi-Events.

  • Убедитесь в том, что URL-адреса интерфейса правильно введены в кластере в центре партнера, включая/v2.0/в конце URL-адресов.
  • Убедитесь в том, что брандмауэр обеспечивает связь между Webex и этими интерфейсами.

  • Просмотрите рекомендации по настройке интерфейса в этом документе.

Интерфейс службы аутентификации:

  • Убедитесь в том, что URL-адреса интерфейса правильно введены в кластере в центре партнера, включая/v2.0/в конце URL-адресов.
  • Убедитесь в том, что брандмауэр обеспечивает связь между Webex и этими интерфейсами.

  • Просмотрите рекомендации по настройке интерфейса в этом документе, уделив особое внимание следующим аспектам:

    1. Убедитесь в том, что вы передали ключи RSA на все XSP.
    2. Убедитесь в том, что вы предоставили URL-адрес службы AuthService в веб-контейнере на всех XSP.
    3. Если вы отредактировали конфигурацию шифра TLS, убедитесь в том, что используется правильное наименование. XSP требует ввода формата имени IANA для шифров TLS. В более ранней версии этого документа необходимые наборы шифров указаны в соглашении об именах OpenSSL.
    4. Если вы используете mTLS со службой аутентификации, загружены ли сертификаты клиента Webex в trust store XSP/ADP? Настроено ли приложение (или интерфейс) на запрос сертификатов клиента?

    5. Если вы используете проверку токена CI со службой аутентификации, настроено ли приложение (или интерфейс) на отсутствие запроса сертификатов клиента?

Проблемы с клиентом

Убедитесь в том, что клиент подключен к BroadWorks

  1. Войдите в веб-приложение

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

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

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

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

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

  • Клиент успешно завершил переход на необходимые микросервисы Webex.

  • Пользователь успешно прошел аутентификацию.

  • Ваша система BroadWorks выдала клиенту долгосрочный веб-токен JSON.

  • Клиент извлек свой профиль устройства и зарегистрировался в BroadWorks.

Журналы клиента

Все клиенты приложения Webex могут отправлять журналы в Webex. Это лучший вариант для мобильных клиентов. Кроме того, необходимо записать адрес электронной почты пользователя и приблизительное время, когда возникла проблема, если вы обращались за помощью в TAC. Чтобы получить более подробную информацию, см. Где можно получить поддержку в отношении Cisco Webex?

Если вам необходимо вручную получать журналы с ПК под управлением Windows, вы можете найти их по следующему адресу:

ПК под управлением ОС Windows:C:\Users\{username}\AppData\Local\CiscoSpark

Mac./Users/{username}/Library/Logs/SparkMacDesktop

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

Неправильно настроенная аутентификация mTLS

Если это затрагивает всех пользователей, проверьте подключение mTLS от Webex к URL-адресу службы аутентификации.

  • Убедитесь в том, что приложение службы аутентификации или интерфейс, который оно использует, настроены для применения mTLS.

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

  • Убедитесь в том, что сертификат сервера в интерфейсе или приложении действителен и подписан авторитетным ЦС.

Известные ошибки в конфигурации BroadWorks

слишком низкое значение chainDepth

  • Условия: Вы воспользовались процедурой копирования цепочки сертификатов в XSP и использовали ее для создания точки доверия для проверки соединений Cisco Webex клиента. XSP работает под управлением R21 SP1.

  • Симптом: В R21 командаXSP_CLI/Interface/HttpClientAuthentication/Trusts> getне отображает все сертификаты, ожидаемые в цепочке издателя.

  • Причина. В R21 существует параметрchainDepth. Если для него задано слишком низкое значение, он не позволит добавить в якорь доверия всю цепочку издателя сертификата.

  • Решение:/XSP_CLI/Interface/Http?ClientAuthentication> set chainDepth 3


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

Поддержка

Политика поддержки постоянного состояния

Поставщик услуг является первым контактом для предоставления поддержки конечным клиентам (предприятиям). Проблемы, которые поставщик услуг не может решить, следует эскалировать в TAC. Поддержка версии сервера BroadWorks соответствует политике BroadSoft для текущей и двух предыдущих основных версий (N-2). Подробности см. https://xchange.broadsoft.com/php/xchange/support/maintenancesupport/softwaremaintenancepolicies/lifecyclepolicy/broadworksservers.

Политика в отношении эскалации

  • Вы (поставщик услуг/партнер) являетесь первым контактом для предоставления поддержки конечным клиентам (предприятиям).

  • Проблемы, которые поставщик услуг не может решить, эскалируются в TAC.

Версии BroadWorks

Ресурсы для самостоятельной поддержки

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

  • Приложение Webex можно настроить с помощью этого URL-адреса и URL-адреса для отправки отчетов о проблемах.

  • Пользователи приложения Webex могут отправлять обратную связь или журналы непосредственно из клиента. Журналы будут отправляться в облако Webex, где их анализ будет проводиться командой разработки Cisco Webex.

  • В справочном центра также имеется отдельная страница для поддержки на уровне администратора Webex для BroadWorks.

Сбор информации для отправки запроса на обслуживание

Ошибки в Control Hub могут иметь вложенные данные, которые могут помочь TAC в изучении вашей проблемы. Например, если вы видите идентификатор отслеживания для конкретной ошибки или код ошибки, сохраните текст, чтобы отправить его нам.

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

  • Идентификатор организации клиента и идентификатор организации-партнера (каждый идентификатор является строкой из 32 шестнадцатеричных символов, разделенных дефисами)

  • Идентификатор отслеживания (также из 32 шестнадцатеричных символов), если он имеется в интерфейсе или сообщении об ошибке

  • Адрес электронной почты пользователя (если проблемы возникли у определенного пользователя)

  • Версии клиента (если проблема имеет признаки, замеченные клиентом)