- Главная
- /
- Статья
Руководство по интеграции устройств в Webex для Cisco BroadWorks
Руководство по интеграции устройств предназначено для администраторов уровня партнеров. В документе описывается развертывание устройств и управление ими с помощью этого решения.
Введение
Об этом руководстве
Этот документ предназначен для администраторов-партнеров в организациях поставщиков услуг, которые развертывают Webex для Cisco BroadWorks. В руководстве описана работа с устройствами OS и MPP для Webex для Cisco BroadWorks и их обслуживания. Руководство разделено на две главы:
- Подключение устройств. Описывает перенос устройств ОС Room (серии Room и Room Kit, серии Desk и Board) и устройств MPP в Webex для Cisco BroadWorks.
- Serviceability устройства: описание управления подключенными устройствами в Control Hub.
История изменений документа
В следующей таблице приводится сводная информация об изменениях этого документа.
Дата |
Версия документа |
Описание изменения |
---|---|---|
12 мая 2023 г. |
1.7 | Добавлены усовершенствования Webex для интегрированных устройств Cisco RoomOS Webex для BroadWorks и поиска по каталогу для устройств W4B Integrated RoomOS в разделе Функции конечных пользователей для интегрированных устройств Webex. |
27 февраля 2023 г. |
1.6 | Обновлены этапы настройки служб для ОС Room в разделе "Подключение устройств". |
17 февраля 2023 г. |
1.5 | Добавлен раздел унифицированного журнала вызовов для телефонов MPP с поддержкой Webex в разделе Функции конечных пользователей для интегрированных устройств Webex. |
14 октября 2022 г. |
1.4 |
|
20 июня 2022 г. |
1.3 |
|
03 июня 2022 г. |
1.2 |
|
27 мая 2022 г. |
1.1 |
|
20 мая 2022 г. |
1.0 |
|
Интеграция устройств для Webex для Cisco BroadWorks
Обзор переноса устройств
В этой главе описывается подключение устройств в Webex для Cisco BroadWorks. В этой главе описаны следующие сценарии использования:
-
Добавление новых устройств ОС Webex Room (с помощью кодов активации)
-
Подключение новых устройств MPP
-
Добавление возможностей Webex на существующие устройства MPP
-
Рекомендуется развернуть эту функцию на независимых серверах ADP. Однако XSP также поддерживает эту функцию. Если вы используете XSP, то если в этом документе упоминается "ADP", вы можете заменить "XSP", если только в тексте не указано только ADP.
-
Эта функция поддерживает персональные устройства и устройства рабочего пространства.
Подключение к ОС Room
Webex для Cisco BroadWorks поддерживает подключение с кодом активации для устройств с ОС комнат в совместном доступе и рабочих пространствах.
Подключение устройств с кодами активации
Подключение устройств с кодами активации обеспечивает простой и безопасный способ подключения устройств Room OS. Код активации — это 16-значный одноразовый код доступа, созданный системой, который пользователь должен ввести на устройстве, чтобы подключить устройство. Код активации надежно связан с предполагаемой учетной записью пользователя и гарантирует, что только предполагаемый пользователь подключает устройство, связанное с той же учетной записью. После ввода пользователем правильного кода устройство подключается к Webex и BroadWorks, завершит регистрацию, скачает файл конфигурации и готово к использованию.
Перечисленные ниже устройства ОС Room поддерживают перенос с кодами активации.
-
Серия Webex Board (ОС Room)
-
Серия Webex Desk (ОС Room)
-
Серия Webex Room (Room OS)
Процесс переноса в ОС Room
В следующем процессе показано, что происходит при подключении устройства ОС Room с помощью кодов активации.
-
Администратор партнера осуществляет подготовку основного пользователя и устройства в BroadWorks, а затем создает код активации в BroadWorks.
-
Владельцу устройства отправляется электронное сообщение с кодом активации устройства.
-
Владелец устройства запускает устройство.
-
Устройство предлагает владельцу устройства ввести код активации.
-
Владелец устройства вводит код активации на устройстве.
-
Устройство подключено к BroadWorks и Webex с помощью приведенного ниже подпроцесса.
-
Устройство Room OS отправляет запрос на активацию службам Webex. Код активации проверяется GDS. Если код правильный, устройство подключится к Webex. Webex возвращает устройство маркер машины.
-
Устройство отправляет запрос на активацию в BroadWorks DM вместе с маркировкой машины и MAC-адресом.
-
BroadWorks авторизует и подключает устройство.
-
Устройство отправляет запрос на обновленную конфигурацию в DM BroadWorks. Маркер машины включен для авторизации.
-
BroadWorks авторизует токен, находит обновленный файл конфигурации и возвращает обновленный файл конфигурации.
-
ОС Room попытается найти запись NAPTR для домена, указанного в файле конфигурации, поскольку она ожидает найти запись SRV для _sip._tls.<domain_in_config> если нет записи NAPTR, то RoomOS попытается найти запись SRV и запись A соответственно.
Запись SRV должна быть _sip._tls., поскольку roomOS поддерживает только TLS для транспорта и SRTP для мультимедиа.
-
-
Устройство регистрируется и готово к использованию.
На следующей схеме представлен упрощенный обзор процесса ввода в должность.
Подробную информацию о подключении к ОС Room, включая более подробные схемы, см. в описании функций Усовершенствования Cisco BroadWorks для подключения устройств с поддержкой Webex.
Аутентификация устройства (с помощью токенов носителя OAuth)
Для аутентификации устройств Room OS необходимо включить токены носителя Cisco OAuth в BroadWorks. Во время подключения маркер носителя передается через заголовок активации авторизации и служит для идентификации устройства. IdP проверяет маркер носителя и возвращает идентификатор UUID (идентификатор компьютера для устройств рабочего пространства или идентификатор пользователя для персональных устройств) в качестве субъекта носителя. BroadWorks сохраняет UUID в качестве имени устройства на сетевом сервере.
Предварительные требования ОС Room
Минимальная версия ОС Room
Room OS 10.13 минимум
Требования к исправлениям BroadWorks
Эта функция поддерживается начиная с версии 2021.11 сервера ADP с независимым выпуском (RI) без требований к исправлениям.
Для использования этой функции на серверах без RI необходимо установить следующие исправления (из групп исправлений ap381367, ap381951, ap382198). Установите исправления, применимые к вашему выпуску.
Для R22:
-
AP.as.22.0.1123.ap381367
-
AP.as.22.0.1123.ap382236
-
AP.nfm.22.0.1123.ap381367
-
AP.ns.22.0.1123.ap381367
-
AP.platform.22.0.1123.ap381367
-
AP.platform.22.0.1123.ap382198
-
AP.ps.22.0.1123.ap381367
-
AP.xsp.22.0.1123.ap381367
-
AP.xsp.22.0.1123.ap382198
Для R23:
-
AP.as.23.0.1075.ap381367
-
AP.as.23.0.1075.ap382236
-
AP.ns.23.0.1075.ap381367
-
AP.platform.23.0.1075.ap382198
-
AP.platform.23.0.1075.ap381367
-
AP.xsp.23.0.1075.ap381367
-
AP.xsp.23.0.1075.ap382198
-
AP.ps.23.0.1075.ap381367
Для R24:
-
AP.as.24.0.944.ap381367
-
AP.as.24.0.944.ap381951
-
AP.as.24.0.944.ap382236
Требования к платформе BroadWorks
Эта функция доступна в следующих версиях:
-
R22: доступно только на XSP
-
R23: доступно в XSP или ADP (независимо от выпуска)
-
R24: доступно на ADP (Release Independent)
Требования к конфигурации BroadWorks
-
Чтобы реализовать это решение, необходимо настроить обеспечение Flowthrough таким образом, чтобы позволить Broadworks обеспечивать устройства Webex.
При настройке непрерывной подготовки необязательно использовать непрерывную подготовку для пользователей, т.е. можно продолжать использовать существующие методы обеспечения (API, доверенный/ненадежный адрес электронной почты, сам пользователь и т.д.) для подготовки пользователей. См. раздел "Требования к подготовке" руководства по решению Webex для Cisco BroadWorks.
-
Убедитесь, что интегрированная служба IM+P включена в BroadWorks и указывает на мост подготовки BroadWorks.
URL моста подготовки был назначен, когда шаблон клиента был применен к организации. Это должно было быть выполнено во время начальной настройки Webex для Cisco BroadWorks. Чтобы найти существующий URL-адрес в центре партнера, см. раздел Настройка сервера приложений с URL-адресом службы подготовки в руководстве по решению Webex для Cisco BroadWorks.
-
При наличии нескольких партнерских организаций требуется выделенный экземпляр службы управления устройствами (DMS) для каждого партнера.
Предварительные условия для подключения с кодом активации в ОС Room
Убедитесь, что указанное ниже установлено.
-
Разверните службу активации устройств в BroadWorks. Дополнительные сведения см. в статье Безопасный перенос Cisco BroadWorks с помощью кодов активации.
-
Убедитесь, что для параметра URL DAS для кластера BroadWorks задано значение URL служб управления устройствами (DMS). Чтобы просмотреть текущую настройку URL-адреса DAS в Partner Hub, перейдите в раздел Настройки интерфейса.
и выберите соответствующий кластер. URL-адрес отображается в разделе
Следующие функции BroadWorks должны быть активированы в AS.
-
101377 Усовершенствования для подключения устройств Webex и MPP
-
25088 Телефонные трубки поддержки для устройств DECT
-
24104 Поддержка многофункционального цепочки для устройств DECT
-
20077 Усовершенствования управления устройствами
-
19559 Усовершенствования визуального управления устройствами
-
Усовершенствования настройки типа профиля устройства 02283
Например, запустите следующую команду, чтобы включить 101377. Измените номер функции при активации других функций.
AS_CLI/System/ActivatableFeature> активировать 101377
Если все перечисленные исправления установлены и активируемая функция не указана в вашем конкретном выпуске AS, это происходит потому, что она уже включена в базовый выпуск AS и не требует активации.
Запустите следующую команду CLI на сетевом сервере:
NS_CLI/System/DeviceManagement> asLocationLookupEnabled true
Убедитесь, что ЦС, подписывающий сертификат SBC, указан в списке доверия ОС Room. Список доверия ОС Room можно просмотреть на веб-портале устройства. На портале выберите , чтобы просмотреть список ЦС.
Процесс переноса ОС Room
-
Webex Board Series
-
Серия Webex Desk
-
Серия Webex Room
1 |
Настройте поддержку BroadWorks для устройств ОС Room. |
2 |
Подготовка нового устройства в BroadWorks. |
3 |
В профиле устройства запросите код активации. Код будет автоматически отправлен основному пользователю по электронной почте. |
Настройка служб для ОС Room
1 |
Чтобы подготовить Cisco OAuth для своей учетной записи Cisco Identity Provider Federation, отправьте запрос на обслуживание в своем операторе по подключению или в Cisco TAC. Назовите запрос на обслуживание "ADP AuthService Configuration". Если учетные данные поставщика удостоверений Cisco OAuth уже получены с помощью одного из потоков в этом документе, нет необходимости создавать новый запрос. Однако, если учетные данные Cisco OAuth получены с помощью процесса, которого нет в этом документе, заполните новый запрос на службу для обновления учетных данных. Компания Cisco предоставит вам идентификатор клиента OAuth, секретный код клиента и токен обновления, который будет действителен в течение 60 дней. Если срок действия маркера истекает до его использования с ADP, можно отправить другой запрос.
| ||||||||||||||||||||
2 |
Включите OAuth с помощью этой команды CLI:
| ||||||||||||||||||||
3 |
Убедитесь, что область OAuth включает broadworks-connector-user (область включена по умолчанию). Выполните эту команду, чтобы проверить область действия. ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth/Scopes> получить | ||||||||||||||||||||
4 |
Настройте параметры поставщика удостоверений Cisco с помощью приведенных ниже команд CLI.
| ||||||||||||||||||||
5 |
Настройте поставщиков удостоверений для федерации Cisco с помощью следующих команд: ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>
Маркер обновления теперь находится в контексте CiscoIdentityProvider/Partners, и имя партнера из контекста CiscoIdentityProvider/Federation должно совпадать с партнером, добавленным в контексте CiscoIdentityProvider/Partners. Если вы используете загрузку ADP RI старше 2022.10, R23 XSP без патча AP.xsp.23.0.1075.ap383838 или R22 XSP, выполните указанные ниже действия.
| ||||||||||||||||||||
6 |
Очистите все существующие области в следующих трех контекстах в разделе
Для каждого контекста запустите
|
Подготовка устройств Room OS
1 |
В BroadWorks CommPilot проверьте конфигурацию Identity/Device Profile Type , чтобы узнать, существует ли тип устройства для этого устройства ОС Room. Если тип устройства не существует в BroadWorks, импортируйте тип устройства в BroadWorks с помощью файла DTAF, загруженного с cisco.com. |
2 |
После импорта типа устройства убедитесь, что в конфигурации Identity/Device Profile Type присутствуют следующие параметры:
|
3 |
Убедитесь, что в файле профиля устройства установлены параметры SIP, которые необходимо использовать. В файле типа Identity/Device Profile Type убедитесь, что режим аутентификации является носителем. |
4 |
Создайте профиль устройства с настройками нового устройства. На странице Добавление/изменение профиля устройства Identity/Device оставьте поле MAC-адреса пустым. |
5 |
Настройте основного пользователя. На странице Добавление пользователей установите или снимите флажок isPlace в зависимости от того, является ли устройство персональным или рабочим пространством в совместном доступе.
Устройства рабочего пространства в совместном доступе также требуют назначения основного пользователя. Можно назначить необходимого основного пользователя. |
6 |
Заполните параметр, соответствующий типу устройства и методу настройки, которые необходимо использовать.
|
7 |
Если устройство предназначено для личного использования и необходимо использовать непрерывную подготовку, для основного пользователя назначьте интегрированную службу мгновенных сообщений и состояния доступности . On the page, add the IM+P service: |
Дальнейшие действия
Request Activation Code
1 |
In the Identity/Device Profile page, search for and open the device profile for your new device. |
2 |
Click the Device Activation tab. |
3 |
Click Request activation code. |
Дальнейшие действия
Provide the device to the user. After the user plugs in the device, they are required to enter the activation code that was sent in the email. This will onboard the device to Webex for Cisco BroadWorks.
MPP Onboarding to Webex
This section describes the onboarding of either new or existing MPP devices to Webex for Cisco BroadWorks. Note that 'existing' refers to an MPP device that exists on BroadWorks, but which does not have Webex capability.
MPP Device Onboarding (New Devices)
During onboarding, the administrator updates BroadWorks with support for MPP, upgrades the device firmware and provisions the device on BroadWorks to complete onboarding.
The following diagram provides an overview of the onboarding process after the activation code that the user enters is validated.
MPP Device Onboarding (Existing Devices)
For existing MPP devices, where the device exists already on BroadWorks, but is not onboarded to Webex, update BroadWorks and the device firmware to support MPP to Webex onboarding. After the updates, the device onboards to Webex automatically.
Дополнительные сведения
For more information on MPP device onboarding to Webex, refer to the feature description Cisco BroadWorks DMS Enhancements for Webex Enabling MPP Devices.
MPP Device Prerequisites
Minimum MPP Version
MPP firmware 11.3.7 minimum
BroadWorks Patch Requirements
This feature is supported as of version 2021.11 of the Release Independent (RI) ADP server with no patch requirements.
For non-RI servers, you must have installed the following patches (from patch groups ap381367, ap381951, ap382198) in order to use the feature. Install the patches that apply to your release:
Для R22:
-
AP.as.22.0.1123.ap381367
-
AP.as.22.0.1123.ap382236
-
AP.nfm.22.0.1123.ap381367
-
AP.ns.22.0.1123.ap381367
-
AP.platform.22.0.1123.ap381367
-
AP.platform.22.0.1123.ap382198
-
AP.ps.22.0.1123.ap381367
-
AP.xsp.22.0.1123.ap381367
-
AP.xsp.22.0.1123.ap382198
Для R23:
-
AP.as.23.0.1075.ap381367
-
AP.as.23.0.1075.ap382236
-
AP.ns.23.0.1075.ap381367
-
AP.platform.23.0.1075.ap382198
-
AP.platform.23.0.1075.ap381367
-
AP.xsp.23.0.1075.ap381367
-
AP.xsp.23.0.1075.ap382198
-
AP.ps.23.0.1075.ap381367
Для R24:
-
AP.as.24.0.944.ap381367
-
AP.as.24.0.944.ap381951
-
AP.as.24.0.944.ap382236
BroadWorks Platform Requirements
This feature is available on:
-
R22: available on XSP only
-
R23: available on XSP or ADP (Release Independent)
-
R24: available on ADP (Release Independent)
BroadWorks Configuration Requirements
-
To implement this solution, the Flowthrough provisioning must be configured to allow Broadworks to provision devices to Webex.
While configuring the Flowthrough provisioning, it’s not mandatory to use flowthrough provisioning to provision users i.e., you can continue to use your existing provisioning methods (API, Trusted/Untrusted Email, User self, etc.) to provision users. See "Provisioning Requirements" in the Webex for Cisco BroadWorks Solution Guide.
-
Make sure that the Integrated IM+P service is enabled on BroadWorks and points to the BroadWorks Provisioning Bridge.
The Provisioning Bridge URL was assigned when the Customer Template was applied to the organization. This should have been completed during your initial Webex for Cisco BroadWorks setup. To find the existing URL in Partner Hub, see Configure Application Server with Provisioning Service URL in the Webex for Cisco BroadWorks Solution Guide.
-
If you have multiple partner organizations, you require a dedicated Device Management Service (DMS) instance per partner.
Certificates and Firewalls
Make sure that you have configured the following:
-
Certificate Requirements—MPP devices use mTLS authentication using the device certificate. The device MAC address, which the certificate provides, authenticates the device. Download the required certificates for your MPP device from https://www.cisco.com/security/pki/.
Upload your certificates to establish trust on the ADP or firewall. For example, if you’re uploading to the ADP, use this command:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts/updateTrust> <certificate_filename>
-
Firewall requirements—If ADP is behind a firewall, your firewall must be configured with a rule to extract the MAC address from the device certificate and place it in an Authentication header that is then forwarded to the ADP. For example, the identity pattern
.*([0-9a-fA-F]{12}).*
can be used to extract the MAC address, which can then be placed in a header that uses a descriptive name (for example,macaddress
).If ADP is not behind a firewall, the preceding requirement doesn’t exist.
Feature Activation
Activate the following BroadWorks features on the AS:
-
101377 Enhancements for Webex and MPP device onboarding
-
25088 Support Handsets for DECT Devices
-
23775 Remote Reset for MPP Devices
-
24104 Support Multicell Chaining for DECT devices
-
20077 Device Management Enhancements
-
19559 Visual Device Management Enhancements
-
02283 Device Profile Type Customization Enhancements
For example, run the following command to enable 101377.Change the feature number when activating the other features:
AS_CLI/System/ActivatableFeature> activate 101377
If all the listed patches are installed and an activatable feature is not listed for your particular AS release, it is because it is already included in your AS base release and does not require activation.
Run the following CLI on the Network Server:
NS_CLI/System/DeviceManagement> asLocationLookupEnabled true
Activation Code Requirements
Необязательно. Activation codes are not mandatory for MPP device onboarding. Howver, if you want to use activation codes, see Request Activation Code for MPP for additional requirements that are specific to activation codes with MPP.
MPP Device Onboarding Flow
1 |
(New or existing MPP devices). Configure system support for MPP on Webex for Cisco BroadWorks. |
2 |
(Existing MPP devices). For any existing MPP devices for which you want to add Webex capability, upgrade to the latest device firmware. |
3 |
(New MPP devices only). If the device doesn’t exist on BroadWorks, provision the device and primary user on BroadWorks. |
4 |
Request Activation Code for MPP (Optional). If you want to use activation codes to onboard MPP devices, request an activation code.
|
Configure Services for MPP
Прежде чем начать
If the ADP is behind a firewall, your firewall must be configured with a rule to extract the MAC address from the device certificate and place it in an Authentication header that is then forwarded to the ADP. For example, the identity pattern .*([0-9a-fA-F]{12}).*
can be used to extract the MAC address, which can then be placed in a header that uses a descriptive name (for example, macaddress
).
Refer to your firewall documentation for help with the configurations.
1 |
Raise a Service Request with your onboarding agent or with Cisco TAC to provision Cisco OAuth for your Cisco Identity Provider Federation account. Use "ADP AuthService Configuration" to title your request. Компания Cisco предоставит вам идентификатор клиента OAuth, секретный код клиента и токен обновления, который будет действителен в течение 60 дней. If the token expires before you use it with your ADP, you can raise another request. If you already obtained Cisco OAuth Identity Provider credentials using one of the flows in this document, there’s no need to create a new request. However, if you obtained Cisco OAuth credentials using a flow that is not in this document, complete a new service request to update your credentials. | ||||||||||
2 |
Configure the Cisco Identity Provider parameters by running the following CLI commands.
| ||||||||||
3 |
Set the url of the DM Bridge using the below CLI command. The DM Bridge URL is different for each Teams Cluster (which you pulled in Step 2).
| ||||||||||
4 |
Enable MAC address extraction and authentication using either the Authentication header or Authentication certificate. For security reasons, we recommend that you use one of the options only:
|
Upgrade MPP Device Firmware
Прежде чем начать
Upgrade the device firmware to the latest version to ensure that tha the MPP device supports Webex capability. For more information on firmware upgrades, refer to the Release Notes for your phone model firmware release. |
Дальнейшие действия
-
Existing MPP devices—After the upgrade, the device onboards to Webex automatically. The user can start using Webex services on the device.
-
New MPP devices—Provision the new MPP device on BroadWorks.
Provision MPP Device
1 |
On BroadWorks CommPilot, check the Identity/Device Profile Type configuration to see if the device type exists for this MPP device. If the device type doesn’t exist on BroadWorks, import the device type into BroadWorks using a DTAF file that is downloaded from cisco.com. |
2 |
On BroadWorks CommPilot, open the Identity/Device Profile Type and check the Allow Activation Code Onboarding check box. |
3 |
Create an Identity/Device Profile Type File with the SIP settings that you want to use. |
4 |
Create an Identity/Device Profile with settings for your new device. In the MAC address field, enter the device MAC address. If you are using activation codes to onboard MPP devices, leave the MAC address field empty. |
5 |
Configure the Primary User. On the Users Add page, set the isPlace check box according to whether the device is personal or for a shared workspace:
|
6 |
Complete the option that corresponds to the device type and provisioning method that you want to use:
|
7 |
If the device is for personal use, and you want to use flowthrough provisioning, then for the primary user, assign the Integrated IM+P service. On the page, add the IM+P service: |
Дальнейшие действия
Request Activation Code for MPP
(Optional) Webex for Cisco BroadWorks does not require activation codes to onboard new MPP devices. However, if you do decide to use activation codes, complete the Request Activation Code procedure to request an activation code for a new device.
Prerequisites for Using Activation Codes with MPP Devices
If you are using activation code onboarding for MPP devices, make sure that your system meets the following activation code-specific requirements.
Device Activation Service—Complete the following requirements to enable the Device Activation Service:
-
Deploy the Device Activation Service on BroadWorks. For details, see Cisco BroadWorks Secure Onboarding Using Activation Codes.
-
Point the Device Activation Service (DAS) to Device Management Services (DMS) on BroadWorks AS using the following CLI command:
AS_CLI/Interface/DAS> set url <url_of_DMS>
-
Verify that the DAS URL setting for the BroadWorks cluster is set to the Device Management Services (DMS) URL. To view the current DAS URL setting in Partner Hub, go to Interface settings.
and select the appropriate cluster. The URL appears under
Cisco Global Discovery Services (GDS)—GDS is required in order to provision the activation code. Enable GDS on BroadWorks by completing both of the below steps:
-
Create a service request to provision your GDS account. Cisco provides you with the client ID, client secret, refresh token and GDS domain.
-
After your GDS account is provisioned, enable GDS on the ADP using the following CLI:
ADP_CLI/Applications/BroadworksDms/DeviceActivation/IdentityProviders/Cisco> get set gdsDomain <gds_domain_from service request> e.g. https://activation.webex.com set clientId <id_from_service_request> clientSecret <secret_from_service_request> refreshToken <token_from_service_request>
Request Activation Code
Complete the following steps to request an activation code for a new MPP device.
-
In the Identity/Device Profile page, search for and open the device profile for your new device.
-
Click the Device Activation tab.
-
Click Request activation code.
The system generates the activation code and emails the code to the primary user. The user must enter the code on the device to complete onboarding.
Serviceability устройства
Обзор возможностей обслуживания
Control Hub содержит параметры работоспособности, которые позволяют администраторам просматривать состояние устройства, а также набор параметров технического обслуживания. Возможности администраторов:
-
Просмотр текущего состояния устройства
-
Перезагрузите устройство удаленно
-
Отправка отчета о проблемах для устранения неполадок
-
Удалить устройство
Просмотр состояния устройства
1 |
Войдите в экземпляр Control Hub для клиентской организации. |
2 |
Щелкните Устройства. |
3 |
Щелкните соответствующее устройство. |
Перезагрузка Устройства
1 |
Войдите в экземпляр Control Hub для клиентской организации. |
2 |
Щелкните Устройства. |
3 |
Выберите устройство. |
4 |
В раскрывающемся списке Действия выберите Перезагрузка. |
Сообщить о проблеме
1 |
Войдите в экземпляр Control Hub для клиентской организации. |
2 |
Щелкните Устройства. |
3 |
Щелкните соответствующее устройство. |
4 |
В разделе Действия выберите Сообщить о проблеме. |
5 |
Просмотрите сводку отчета. |
Удалить устройство
1 |
Войдите в экземпляр Control Hub для клиентской организации. |
2 |
Щелкните Устройства. |
3 |
Выберите подходящее устройство. |
4 |
В раскрывающемся списке Действия выберите Удалить. |
Изменение владельца устройства
1 |
Удаление существующей регистрации устройства из Webex. |
2 |
В BroadWorks деактивируйте регистрацию устройства под существующим пользователем. |
3 |
В BroadWorks активируйте устройство с помощью кода активации из другого профиля удостоверения/устройства , используемого другим пользователем. |
Дальнейшие действия
-
Новый владелец устройства вводит код активации на устройстве.
-
Устройство повторно регистрируется в Webex и BroadWorks с помощью новой конфигурации. Новый профиль удостоверения/устройства в BroadWorks автоматически обновляется с помощью MAC-адреса устройства.
Мониторинг производительности
Для этой функции существуют следующие счетчики производительности.
Счетчик |
Описание |
---|---|
Модуль: enterprises.broadsoft.broadworks.deviceActivation.activate | |
bwDASActivateRequests |
Общее количество полученных запросов на активацию. Это включает активацию запросов BroadWorks и запросов Webex. |
bwDASActivateFailures |
Общее количество запросов на активацию, которые не удалось выполнить успешно. Сюда входят запросы на активацию BroadWorks, которые не удалось выполнить, и запросы Webex, которые не удалось выполнить. |
Запросы bwDASActivateBroadWorks |
Количество полученных запросов активировать BroadWorks. |
bwDASActivateBroadWorksFailures |
Количество запросов BroadWorks, которые не были успешно выполнены. Ошибки авторизации и аутентификации не учитываются этим счетчиком. |
bwDASActivateWebexRequests |
Количество полученных запросов активации Webex. |
bwDASActivateWebexFailures |
Количество запросов Webex, которые не были успешно выполнены. |
Модуль: enterprises.broadsoft.broadworks.dms.dmBridge | |
bwDMBridgeRequests |
Количество отправленных запросов DMBridge. |
bwDMBridgeFailures |
Количество запросов DMBridge, которые не были успешно выполнены. |
Функции конечных пользователей для интегрированных устройств Webex
Унифицированный журнал вызовов
Телефоны MPP с поддержкой Webex
Устройства Cisco MPP с поддержкой Webex на платформе Webex для BroadWorks теперь смогут отображать унифицированную историю вызовов для вызовов, совершенных или принятых от клиента Webex пользователя и его устройств. Это позволяет улучшить работу устройств конечных пользователей, поскольку они могут наблюдать и использовать вызовы, совершенные/принятые в приложении Webex с помощью журналов вызовов на устройствах MPP, а также все локальные вызовы, обработанные на устройстве.
Унифицированный журнал вызовов Webex будет источником по умолчанию для просмотра журнала журнал вызовов пользователя. Этот журнал вызовов вызовов содержит вызовы, сделанные со всех телефонов, видеоустройств Webex или приложения Webex .
Затронутые модели IP-телефонов:
-
MPP68xx Серии 6821, 6841, 6851, 6861
-
MPP78xx Серии 7811, 7821, 7841, 7861
-
MPP 88xx серии 8811, 8841, 8845, 8851, 8861, 8865, 8875
Включение функции.
Для включения этой функции необходимо выполнить следующие критерии
-
Интеграция устройств Webex для BroadWorks должна быть реализована и функциональна для устройств MPP. Дополнительные сведения см. в этом руководстве Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.
Требования к исправлениям и DTAF:
Ожидания/последствия/ограничения:
-
Основная линия (только текущий пользователь)
-
Унифицированный журнал вызовов будет поддерживаться, как указано выше.
-
Поддержка Защита конфиденциальности – Защита/скрытие журнала вызовов при задании пароля пользователя.
-
Если телефон не поддерживает облако, будет отображаться только локальная история вызовов на это устройство и с него.
-
-
Другие линии (общие или иные)
-
Поддерживается только локальная история вызовов на устройство и с него.
-
-
Устройства рабочего пространства
-
Унифицированный журнал вызовов в этом экземпляре не будет поддерживаться.
-
Если эта функция включена, вся история локальных вызовов на MPP (полученная из BroadWorks) будет удалена.
Интегрированные устройства RoomOS Webex для BroadWorks
Интегрированные устройства Cisco RoomOS Webex для BroadWorks теперь смогут отображать унифицированный журнал вызовов для вызовов, совершенных или принятых от клиента Webex пользователя и его устройств. Это позволяет улучшить работу устройств конечных пользователей, поскольку они могут наблюдать и использовать вызовы, совершенные/принятые с помощью приложения Webex с помощью журналов вызовов на устройствах RoomOS, а также все локальные вызовы, обработанные на их устройствах.
Унифицированный журнал вызовов Webex будет источником по умолчанию для просмотра журнала журнал вызовов пользователя. Этот журнал вызовов вызовов содержит вызовы, сделанные со всех телефонов, видеоустройств Webex или приложения Webex .
Доступно в приведенных ниже моделях устройств RoomOS.
-
Устройства RoomOS
-
Серия настольных рабочих столов: Desk, Desk Mini, Desk Pro
-
Серия Room
-
Серия RoomKit
-
Webex Board Series
Включение функции.
-
Интеграция устройств Webex для BroadWorks должна быть реализована и функциональна для устройств RoomOS. Дополнительные сведения см. в этом руководстве Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.
Требования к исправлениям и DTAF:
-
Broadworks – эта функция зависит от установки соответствующих исправлений BroadWorks. Подробную информацию можно найти здесь.
Требования к конфигурации:
-
Ниже конфигурации должны быть установлены как указано
-
Конфигурация Bwks: Feature_Toggle_Webex_Call=Да
-
Усовершенствования поиска по каталогу для интегрированных устройств RoomOS Webex для BroadWorks
Пользователи интегрированных устройств Cisco RoomOS Webex для BroadWorks теперь смогут выполнять поиск пользователей, пространств и даже устройств в своей организации Webex непосредственно на устройствах RoomOS с помощью новой усовершенствованной службы каталогов Webex. Эта служба предоставляет расширенные возможности поиска и поиска пользователям Webex для BroadWorks, чтобы они могли находить пользователей и вещи (рабочие пространства, устройства и т.д.) в своей организации Webex.
Доступно в приведенных ниже моделях устройств RoomOS.
-
Устройства RoomOS
-
Серия настольных рабочих столов: Desk, Desk Mini, Desk Pro
-
Серия Room
-
Серия RoomKit
-
Webex Board Series
Включение функции.
-
Интеграция устройств Webex для BroadWorks должна быть реализована и функциональна для устройств MPP. Дополнительные сведения см. в этом руководстве Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.
Требования к конфигурации:
-
На устройстве должен быть включен переключатель службы каталогов xConfiguration Webex DirectoryServiceSupport.
Введение
Об этом руководстве
Этот документ предназначен для администраторов-партнеров в организациях поставщиков услуг, которые развертывают Webex для Cisco BroadWorks. В руководстве описана работа с устройствами OS и MPP для Webex для Cisco BroadWorks и их обслуживания. Руководство разделено на две главы:
История изменений документа
В следующей таблице приводится сводная информация об изменениях этого документа.
Дата |
Версия документа |
Описание изменения |
---|---|---|
12 мая 2023 г. |
1.7 | Добавлены усовершенствования Webex для интегрированных устройств Cisco RoomO S Webex для BroadWorks и поиска по каталогу для устройст в W4B Integrated RoomOS в разделе Функции конечных пользователей для интегрированных устройств Webex. |
27 февраля 2023 г. |
1.6 | Обновлены этапы настройки служб для ОС Roo m в разделе "Подключение устройств". |
17 февраля 2023 г. |
1.5 | Добавлен раздел унифицированного журнала вызовов для телефонов MPP с поддержкой Webe x в разделе Функции конечных пользователей для интегрированных устройств Webex. |
14 октября 2022 г. |
1.4 |
|
20 июня 2022 г. |
1.3 |
|
03 июня 2022 г. |
1.2 |
|
27 мая 2022 г. |
1.1 |
|
20 мая 2022 г. |
1.0 |
|
Интеграция устройств для Webex для Cisco BroadWorks
Обзор переноса устройств
В этой главе описывается подключение устройств в Webex для Cisco BroadWorks. В этой главе описаны следующие сценарии использования:
-
Подключение новых устройств ОС Webex Room (с помощью кодов активации)
-
Подключение новых устройств MPP
-
Добавление возможностей Webex на существующие устройства MPP
-
Рекомендуется развернуть эту функцию на независимых серверах ADP. Однако XSP также поддерживает эту функцию. Если вы используете XSP, то там, где этот документ относится к "ADP", можно заменить "XSP", если только в тексте не указано только "ADP".
-
Эта функция поддерживает персональные устройства и устройства рабочего пространства.
Подключение к ОС Room
Webex для Cisco BroadWorks поддерживает подключение с кодом активации для устройств с ОС комнат в совместном доступе и рабочих пространствах.
Подключение устройств с кодами активации
Подключение устройств с кодами активации обеспечивает простой и безопасный способ подключения устройств Room OS. Код активации — это 16-значный одноразовый код доступа, созданный системой, который пользователь должен ввести на устройстве, чтобы подключить устройство. Код активации надежно связан с предполагаемой учетной записью пользователя и гарантирует, что только предполагаемый пользователь подключает устройство, связанное с той же учетной записью. После ввода пользователем правильного кода устройство подключается к Webex и BroadWorks, завершит регистрацию, скачает файл конфигурации и готово к использованию.
Перечисленные ниже устройства ОС Room поддерживают перенос с кодами активации.
-
Серия Webex Board (ОС Room)
-
Серия Webex Desk (ОС Room)
-
Серия Webex Room (Room OS)
Процесс переноса в ОС Room
В следующем процессе показано, что происходит при подключении устройства ОС Room с помощью кодов активации.
-
Администратор партнера осуществляет подготовку основного пользователя и устройства в BroadWorks, а затем создает код активации в BroadWorks.
-
Владельцу устройства отправляется электронное сообщение с кодом активации устройства.
-
Владелец устройства запускает устройство.
-
Устройство предлагает владельцу устройства ввести код активации.
-
Владелец устройства вводит код активации на устройстве.
-
Устройство подключено к BroadWorks и Webex с помощью приведенного ниже подпроцесса.
-
Устройство Room OS отправляет запрос на активацию службам Webex. Код активации проверяется GDS. Если код правильный, устройство подключится к Webex. Webex возвращает устройство маркер машины.
-
Устройство отправляет запрос на активацию в BroadWorks DM вместе с маркировкой машины и MAC-адресом.
-
BroadWorks авторизует и подключает устройство.
-
Устройство отправляет запрос на обновленную конфигурацию в DM BroadWorks. Маркер машины включен для авторизации.
-
BroadWorks авторизует токен, находит обновленный файл конфигурации и возвращает обновленный файл конфигурации.
-
Room OS попытается найти запись NAPTR для домена, указанного в файле конфигурации, поскольку предполагается найти запись SRV для _sip._tls.<domain_in_config> Если запись NAPTR отсутствует, RoomOS попытается найти запись SRV, за которой следует запись A соответственно.
Запись SRV должна быть _sip_tls.., поскольку roomOS поддерживает только TLS для транспорта и SRTP для мультимедиа.
-
-
Устройство регистрируется и готово к использованию.
На следующей схеме представлен упрощенный обзор процесса ввода в должность.
Подробную информацию о подключении к ОС Room, включая более подробные схемы, см. в описании функций Усовершенствования Cisco BroadWorks для подключения устройств с поддержкой Webex.
Аутентификация устройства (с помощью токенов носителя OAuth)
Для аутентификации устройств Room OS необходимо включить токены носителя Cisco OAuth в BroadWorks. Во время подключения маркер носителя передается через заголовок активации авторизации и служит для идентификации устройства. IdP проверяет маркер носителя и возвращает идентификатор UUID (идентификатор компьютера для устройств рабочего пространства или идентификатор пользователя для персональных устройств) в качестве субъекта носителя. BroadWorks сохраняет UUID в качестве имени устройства на сетевом сервере.
Предварительные требования ОС Room
Минимальная версия ОС Room
Room OS 10.13 минимум
Требования к исправлениям BroadWorks
Эта функция поддерживается начиная с версии 2021.11 сервера ADP с независимым выпуском (RI) без требований к исправлениям.
Для использования этой функции на серверах без RI необходимо установить следующие исправления (из групп исправлений ap381367, ap381951, ap382198). Установите исправления, применимые к вашему выпуску.
Для R22:
-
AP.as.22.0.1123.ap381367
-
AP.as.22.0.1123.ap382236
-
AP.nfm.22.0.1123.ap381367
-
AP.ns.22.0.1123.ap381367
-
AP.platform.22.0.1123.ap381367
-
AP.platform.22.0.1123.ap382198
-
AP.ps.22.0.1123.ap381367
-
AP.xsp.22.0.1123.ap381367
-
AP.xsp.22.0.1123.ap382198
Для R23:
-
AP.as.23.0.1075.ap381367
-
AP.as.23.0.1075.ap382236
-
AP.ns.23.0.1075.ap381367
-
AP.platform.23.0.1075.ap382198
-
AP.platform.23.0.1075.ap381367
-
AP.xsp.23.0.1075.ap381367
-
AP.xsp.23.0.1075.ap382198
-
AP.ps.23.0.1075.ap381367
Для R24:
-
AP.as.24.0.944.ap381367
-
AP.as.24.0.944.ap381951
-
AP.as.24.0.944.ap382236
Требования к платформе BroadWorks
Эта функция доступна в следующих версиях:
-
R22: доступно только на XSP
-
R23: доступно в XSP или ADP (независимо от выпуска)
-
R24: доступно на ADP (Release Independent)
Требования к конфигурации BroadWorks
-
Чтобы реализовать это решение, необходимо настроить обеспечение Flowthrough таким образом, чтобы позволить Broadworks обеспечивать устройства Webex.
При настройке непрерывной подготовки необязательно использовать непрерывную подготовку для пользователей, т.е. можно продолжать использовать существующие методы обеспечения (API, доверенный/ненадежный адрес электронной почты, сам пользователь и т.д.) для подготовки пользователей. См. раздел "Требования к подготовке" руководства по решению Webex для Cisco BroadWorks.
-
Убедитесь, что интегрированная служба IM+ P включена в BroadWorks и указывает на мост подготовки BroadWorks.
URL моста подготовки был назначен, когда шаблон клиента был применен к организации. Это должно было быть выполнено во время начальной настройки Webex для Cisco BroadWorks. Чтобы найти существующий URL-адрес в центре партнера, см. раздел Настройка сервера приложений с URL-адресом службы подготовк и в руководстве по решению Webex для Cisco BroadWorks.
-
Если у вас несколько партнерских организаций, для каждого партнера требуется выделенный экземпляр службы управления устройствами (DMS).
Предварительные условия для подключения с кодом активации в ОС Room
Убедитесь, что указанное ниже установлено.
-
Разверните службу активации устройств в BroadWorks. Дополнительные сведения см. в статье Безопасный перенос Cisco BroadWorks с помощью кодов активации.
-
Убедитесь, что для параметра URL DAS для кластера BroadWorks задан URL служб управления устройствами (DMS). Чтобы просмотреть текущую настройку URL DAS в Partner Hub, перейдите к меню Настройки интерфейса.
и выберите соответствующий кластер. URL-адрес отображается в разделеПри наличии большого количества клиентов (>50) в кластере BroadWorks возможность добавления URL-адреса DAS не поддерживается. В таких случаях рекомендуется обратиться за помощью к инженеру службы поддержки Cisco TAC.
Следующие функции BroadWorks должны быть активированы в AS.
-
101377 Усовершенствования для подключения устройств Webex и MPP
-
25088 Телефонные трубки поддержки для устройств DECT
-
24104 Поддержка многофункционального цепочки для устройств DECT
-
20077 Усовершенствования управления устройствами
-
19559 Усовершенствования визуального управления устройствами
-
Усовершенствования настройки типа профиля устройства 02283
Например, запустите следующую команду, чтобы включить 101377. Измените номер функции при активации других функций.
AS_CLI/System/ActivatableFeature> активировать 101377
Если все перечисленные исправления установлены и активируемая функция не указана в вашем конкретном выпуске AS, это происходит потому, что она уже включена в базовый выпуск AS и не требует активации.
Запустите следующую команду CLI на сетевом сервере:
NS_CLI/System/DeviceManagement> asLocationLookupEnabled true
Убедитесь, что ЦС, подписывающий сертификат SBC, указан в списке доверия ОС Room. Список доверия ОС Room можно просмотреть на веб-портале устройства. На портале выберите , чтобы просмотреть список ЦС.
Процесс переноса ОС Room
-
Webex Board Series
-
Серия Webex Desk
-
Серия Webex Room
1 |
Настройте поддержку BroadWorks для устройств ОС Room. |
2 |
Подготовка нового устройства в BroadWorks. |
3 |
В профиле устройства запросите код активации. Код будет автоматически отправлен основному пользователю по электронной почте. |
Настройка служб для ОС Room
1 |
Чтобы подготовить Cisco OAuth для своей учетной записи Cisco Identity Provider Federation, отправьте запрос на обслуживание у своего оператора по подключению или в Cisco TAC. Назовите запрос на обслуживание "ADP AuthService Configuration". Если учетные данные поставщика удостоверений Cisco OAuth уже получены с помощью одного из потоков в этом документе, нет необходимости создавать новый запрос. Однако, если учетные данные Cisco OAuth получены с помощью процесса, которого нет в этом документе, заполните новый запрос на службу для обновления учетных данных. Компания Cisco предоставит вам идентификатор клиента OAuth, секретный код клиента и токен обновления, который будет действителен в течение 60 дней. Если срок действия маркера истекает до его использования с ADP, можно отправить другой запрос.
| ||||||||||||||||||||
2 |
Включите OAuth с помощью этой команды CLI:
| ||||||||||||||||||||
3 |
Убедитесь, что область OAuth включает broadworks-connector-use r (область включена по умолчанию). Выполните эту команду, чтобы проверить область действия. ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth/Scopes> получить | ||||||||||||||||||||
4 |
Настройте параметры поставщика удостоверений Cisco с помощью приведенных ниже команд CLI.
| ||||||||||||||||||||
5 |
Настройте поставщиков удостоверений для федерации Cisco с помощью следующих команд: ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>
Маркер обновления теперь находится в контексте CiscoIdentityProvider/Partners, и имя партнера из контекста CiscoIdentityProvider/Federation должно совпадать с партнером, добавленным в контексте CiscoIdentityProvider/Partners. Если используется загрузка ADP RI старше 2022.10, R23 XSP без патча AP.xsp.23.0.1075.ap383838 или R22 XSP, выполните указанные ниже действия.
| ||||||||||||||||||||
6 |
Очистите все существующие области в трех следующих контекстах в разделе
Для каждого контекста запустите
|
Подготовка устройств Room OS
1 |
В BroadWorks CommPilot проверьте конфигурацию Identity/Device Profile Typ e , чтобы узнать, существует ли тип устройства для этого устройства ОС Room. Если тип устройства не существует в BroadWorks, импортируйте тип устройства в BroadWorks с помощью файла DTAF, загруженного с cisco.com. |
2 |
После импорта типа устройства убедитесь, что в конфигурации Identity/Device Profile Typ e присутствуют следующие параметры:
|
3 |
Убедитесь, что в файле профиля устройства установлены параметры SIP, которые необходимо использовать. В файле типа Identity/Device Profile Typ e убедитесь, что режим аутентификаци и является носителем. |
4 |
Создайте профиль устройства с настройками нового устройства. На странице Добавление/изменение профиля устройств а Identity/Device оставьте поле MAC-адреса пустым. |
5 |
Настройте основного пользователя. На странице Добавление пользователе й установите или снимите флажок isPlac e в зависимости от того, является ли устройство персональным или рабочим пространством в совместном доступе.
Устройства рабочего пространства в совместном доступе также требуют назначения основного пользователя. Можно назначить необходимого основного пользователя. |
6 |
Заполните параметр, соответствующий типу устройства и методу настройки, который необходимо использовать.
|
7 |
Если устройство предназначено для личного использования и необходимо использовать непрерывную подготовку, для основного пользователя назначьте интегрированную службу мгновенных сообщений и состояния доступност и . На странице добавьте службу обмена мгновенными сообщениями и состоянием доступности. |
Дальнейшие действия
Запрос кода активации
1 |
На странице Identity/Device Profil e найдите и откройте профиль устройства для нового устройства. |
2 |
Щелкните вкладку Активация устройств а . |
3 |
Щелкните Запросить код активации. |
Дальнейшие действия
Предоставьте устройство пользователю. После подключения пользователя к устройству необходимо ввести код активации, отправленный в электронном сообщении. Это приведет к подключению устройства в Webex для Cisco BroadWorks.
Перенос MPP в Webex
В этом разделе описывается перенос новых или существующих устройств MPP в Webex для Cisco BroadWorks. Обратите внимание, что "существующее" относится к устройству MPP, которое существует в BroadWorks, но не имеет возможности Webex.
Подключение устройств MPP (новые устройства)
Во время переноса администратор обновляет BroadWorks с поддержкой MPP, обновляет микропрограммное обеспечение устройства и обеспечивает устройство в BroadWorks для завершения переноса.
На следующей схеме представлен обзор процесса переноса после подтверждения введенного пользователем кода активации.
Подключение устройств MPP (существующие устройства)
Для существующих устройств MPP, в которых устройство уже существует в BroadWorks, но не подключено в Webex, обновите BroadWorks и микропрограммное обеспечение устройства для поддержки подключения MPP к Webex. После обновления устройство автоматически подключается к Webex.
Дополнительная информация
Дополнительную информацию о переносе устройств MPP в Webex см. в описании функции Cisco BroadWorks DMS для включения устройств MPP Webex.
Предварительные требования устройства MPP
Минимальная версия MPP
Микропрограммное обеспечение MPP 11.3.7 минимум
Требования к исправлениям BroadWorks
Эта функция поддерживается начиная с версии 2021.11 сервера ADP с независимым выпуском (RI) без требований к исправлениям.
Для использования этой функции на серверах без RI необходимо установить следующие исправления (из групп исправлений ap381367, ap381951, ap382198). Установите исправления, применимые к вашему выпуску.
Для R22:
-
AP.as.22.0.1123.ap381367
-
AP.as.22.0.1123.ap382236
-
AP.nfm.22.0.1123.ap381367
-
AP.ns.22.0.1123.ap381367
-
AP.platform.22.0.1123.ap381367
-
AP.platform.22.0.1123.ap382198
-
AP.ps.22.0.1123.ap381367
-
AP.xsp.22.0.1123.ap381367
-
AP.xsp.22.0.1123.ap382198
Для R23:
-
AP.as.23.0.1075.ap381367
-
AP.as.23.0.1075.ap382236
-
AP.ns.23.0.1075.ap381367
-
AP.platform.23.0.1075.ap382198
-
AP.platform.23.0.1075.ap381367
-
AP.xsp.23.0.1075.ap381367
-
AP.xsp.23.0.1075.ap382198
-
AP.ps.23.0.1075.ap381367
Для R24:
-
AP.as.24.0.944.ap381367
-
AP.as.24.0.944.ap381951
-
AP.as.24.0.944.ap382236
Требования к платформе BroadWorks
Эта функция доступна в следующих версиях:
-
R22: доступно только на XSP
-
R23: доступно в XSP или ADP (независимо от выпуска)
-
R24: доступно на ADP (Release Independent)
Требования к конфигурации BroadWorks
-
Чтобы реализовать это решение, необходимо настроить обеспечение Flowthrough таким образом, чтобы позволить Broadworks обеспечивать устройства Webex.
При настройке непрерывной подготовки необязательно использовать непрерывную подготовку для пользователей, т.е. можно продолжать использовать существующие методы обеспечения (API, доверенный/ненадежный адрес электронной почты, сам пользователь и т.д.) для подготовки пользователей. См. раздел "Требования к подготовке" руководства по решению Webex для Cisco BroadWorks.
-
Убедитесь, что интегрированная служба IM+ P включена в BroadWorks и указывает на мост подготовки BroadWorks.
URL моста подготовки был назначен, когда шаблон клиента был применен к организации. Это должно было быть выполнено во время начальной настройки Webex для Cisco BroadWorks. Чтобы найти существующий URL-адрес в центре партнера, см. раздел Настройка сервера приложений с URL-адресом службы подготовк и в руководстве по решению Webex для Cisco BroadWorks.
-
Если у вас несколько партнерских организаций, для каждого партнера требуется выделенный экземпляр службы управления устройствами (DMS).
Сертификаты и брандмауэры
Убедитесь, что настроены приведенные ниже параметры.
-
Требования к сертификату. Устройства MPP используют аутентификацию mTLS с помощью сертификата устройства. MAC-адрес устройства, предоставленный сертификатом, аутентифицирует устройство. Скачайте необходимые сертификаты для устройства MPP из https://www.cisco.com/security/pki/.
Загрузите сертификаты, чтобы установить доверие в ADP или брандмауэр. Например, при загрузке в ADP используйте следующую команду:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts/updateTrust> <certificate_filename>
-
Требования к брандмауэру. Если ADP находится за брандмауэром, в брандмауэре необходимо настроить правило извлечения MAC-адреса из сертификата устройства и поместить его в заголовок аутентификации, который затем пересылается на ADP. Например, шаблон удостоверения
.*([0-9a-fA-F]{12}).*
можно использовать для извлечения MAC-адреса, который затем можно поместить в заголовок с описательным именем (например,macaddress
).Если ADP не находится за брандмауэром, предыдущее требование не существует.
Активация функции
Активируйте перечисленные ниже функции BroadWorks в AS.
-
101377 Усовершенствования для подключения устройств Webex и MPP
-
25088 Телефонные трубки поддержки для устройств DECT
-
23775 Удаленный сброс для устройств MPP
-
24104 Поддержка многофункционального цепочки для устройств DECT
-
20077 Усовершенствования управления устройствами
-
19559 Усовершенствования визуального управления устройствами
-
Усовершенствования настройки типа профиля устройства 02283
Например, выполните следующую команду, чтобы включить 101377.Измените номер функции при активации других функций:
AS_CLI/System/ActivatableFeature> активировать 101377
Если все перечисленные исправления установлены и активируемая функция не указана в вашем конкретном выпуске AS, это происходит потому, что она уже включена в базовый выпуск AS и не требует активации.
Запустите следующий CLI на сетевом сервере:
NS_CLI/System/DeviceManagement> asLocationLookupEnabled true
Требования к коду активации
Необязательно. Коды активации не являются обязательными для подключения устройств MPP. Если вы хотите использовать коды активации, см. раздел Запрос кода активации для MP P . Дополнительные требования, характерные для кодов активации с MPP.
Процесс переноса устройств MPP
1 |
(Новые или существующие устройства MPP). Настройка поддержки системы для MPP в Webex для Cisco BroadWorks. |
2 |
Модернизация микропрограммного обеспечения устройства MPP (Существующие устройства MPP). Для всех существующих устройств MPP, для которых необходимо добавить возможности Webex, модернизируйте микропрограммное обеспечение до последней версии. |
3 |
(Только новые устройства MPP). Если устройство не существует в BroadWorks, подготовьте устройство и основного пользователя в BroadWorks. |
4 |
(Необязательно). Чтобы использовать коды активации для подключения устройств MPP, запросите код активации.
|
Настройка служб для MPP
Перед началом работы
Если ADP находится за брандмауэром, в брандмауэре необходимо настроить правило извлечения MAC-адреса из сертификата устройства и поместить его в заголовок аутентификации, который затем пересылается на ADP. Например, шаблон удостоверения .*([0-9a-fA-F]{12}).*
можно использовать для извлечения MAC-адреса, который затем можно поместить в заголовок с описательным именем (например, macaddress
).
Справочную информацию о конфигурациях см. в документации брандмауэра.
1 |
Чтобы подготовить Cisco OAuth для своей учетной записи Cisco Identity Provider Federation, отправьте запрос на обслуживание у своего оператора по подключению или в Cisco TAC. Используйте "ADP AuthService Configuration" (Конфигурация ADP AuthService) для заголовка вашего запроса. Компания Cisco предоставит вам идентификатор клиента OAuth, секретный код клиента и токен обновления, который будет действителен в течение 60 дней. Если срок действия маркера истекает до его использования с ADP, можно отправить другой запрос. Если учетные данные поставщика удостоверений Cisco OAuth уже получены с помощью одного из потоков в этом документе, нет необходимости создавать новый запрос. Однако, если учетные данные Cisco OAuth получены с помощью процесса, которого нет в этом документе, заполните новый запрос на службу для обновления учетных данных. | ||||||||||
2 |
Настройте параметры поставщика удостоверений Cisco, выполнив следующие команды CLI.
| ||||||||||
3 |
Задайте URL моста DM с помощью команды CLI ниже. URL-адрес моста DM отличается для каждого кластера Teams (который был перенесен на этапе 2).
| ||||||||||
4 |
Включите извлечение и аутентификацию MAC-адреса с помощью заголовка Authentication или сертификата Authentication. В целях безопасности рекомендуется использовать только один из следующих вариантов:
|
Модернизация микропрограммного обеспечения устройства MPP
Перед началом работы
Модернизируйте микропрограммное обеспечение устройства до последней версии, чтобы убедиться, что устройство MPP поддерживает возможности Webex. Дополнительную информацию об обновлениях микропрограммного обеспечения см. в примечаниях к выпуску микропрограммного обеспечения модели телефона. |
Дальнейшие действия
-
Существующие устройства MPP. После модернизации устройство автоматически подключается к Webex. Пользователь может начать использовать службы Webex на устройстве.
-
Новые устройства MPP. Подготовка нового устройства MPP в BroadWorks.
Подготовка устройства MPP
1 |
В BroadWorks CommPilot проверьте конфигурацию Identity/Device Profile Typ e , чтобы узнать, существует ли тип устройства для этого устройства MPP. Если тип устройства не существует в BroadWorks, импортируйте тип устройства в BroadWorks с помощью файла DTAF, скачанного с cisco.com. |
2 |
В BroadWorks CommPilot откройте Identity/Device Profile Typ e (Тип профиля устройства) и установите флажок Allow Activation Code Onboardin g (Разрешить подключение с кодом активации). |
3 |
Создайте файл типа профил я устройства с помощью настроек SIP, которые необходимо использовать. |
4 |
Создайте профиль удостоверения/устройств а с настройками для нового устройства. В поле MAC-адре с введите MAC-адрес устройства. Если для подключения устройств MPP используются коды активации, оставьте поле MAC-адреса пустым. |
5 |
Настройте основного пользователя. На странице Добавление пользователе й установите флажок isPlac e в зависимости от того, является ли устройство персональным или для рабочего пространства в совместном доступе.
|
6 |
Заполните параметр, соответствующий типу устройства и методу настройки, который необходимо использовать.
|
7 |
Если устройство предназначено для личного использования и необходимо использовать непрерывную подготовку, для основного пользователя назначьте интегрированную службу мгновенных сообщений и состояния доступност и . На странице добавьте службу обмена мгновенными сообщениями и состоянием доступности. |
Дальнейшие действия
Запрос кода активации для MPP
(Необязательно) Webex для Cisco BroadWorks не требует кодов активации для подключения новых устройств MPP. Однако если вы решите использовать коды активации, выполните процедуру Request Activation Cod e , чтобы запросить код активации для нового устройства.
Предварительные условия для использования кодов активации с устройствами MPP
Если вы используете подключение с кодом активации для устройств MPP, убедитесь, что ваша система соответствует приведенным ниже требованиям, относящимся к коду активации.
Служба активации устройства. Чтобы включить службу активации устройства, выполните следующие требования.
-
Разверните службу активации устройств в BroadWorks. Дополнительные сведения см. в статье Безопасный перенос Cisco BroadWorks с помощью кодов активации.
-
Укажите службу активации устройств (DAS) службам управления устройствами (DMS) в BroadWorks КАК с помощью следующей команды CLI:
AS_CLI/Interface/DAS> задать URL-адрес <url_of_DMS>
-
Убедитесь, что для параметра URL DAS для кластера BroadWorks задан URL служб управления устройствами (DMS). Чтобы просмотреть текущую настройку URL DAS в Partner Hub, перейдите к меню Настройки интерфейса.
и выберите соответствующий кластер. URL-адрес отображается в разделеПри наличии большого количества клиентов (>50) в кластере BroadWorks возможность добавления URL-адреса DAS не поддерживается. В таких случаях рекомендуется обратиться за помощью к инженеру службы поддержки Cisco TAC.
Cisco Global Discovery Services (GDS) — GDS требуется для подготовки кода активации. Включите GDS в BroadWorks, выполнив оба приведенных ниже шага.
-
Создайте запрос на обслуживание для подготовки учетной записи GDS. Cisco предоставляет идентификатор клиента, секретный код клиента, маркер обновления и домен GDS.
-
После подготовки учетной записи GDS включите GDS на ADP с помощью следующего CLI:
ADP_CLI/Applications/BroadworksDms/DeviceActivation/IdentityProviders/Cisco> установите gdsDomain <gds_domain_from service request>, например https://activation.webex.com задайте идентификатор клиента <id_from_service_request> секретный код клиента <secret_from_service_request> токен обновления <token_from_service_request>
Запрос кода активации
Выполните следующие действия, чтобы запросить код активации для нового устройства MPP.
-
На странице Identity/Device Profil e найдите и откройте профиль устройства для нового устройства.
-
Щелкните вкладку Активация устройств а .
-
Щелкните Запросить код активации.
Система создает код активации и отправляет код по электронной почте основному пользователю. Чтобы завершить подключение, пользователь должен ввести код на устройстве.
Serviceability устройства
Обзор возможностей обслуживания
Control Hub содержит параметры работоспособности, которые позволяют администраторам просматривать состояние устройства, а также набор параметров технического обслуживания. Возможности администраторов:
-
Просмотр текущего состояния устройства
-
Перезагрузите устройство удаленно
-
Отправка отчета о проблеме для устранения неполадок
-
Удалить устройство
Просмотр состояния устройства
1 |
Войдите в экземпляр Control Hub для клиентской организации. |
2 |
Щелкните Устройства. |
3 |
Щелкните соответствующее устройство. |
Перезагрузить устройство
1 |
Войдите в экземпляр Control Hub для клиентской организации. |
2 |
Щелкните Устройства. |
3 |
Выберите устройство. |
4 |
В раскрывающемся списке Действи я выберите Перезагрузка. |
Сообщить о проблеме
1 |
Войдите в экземпляр Control Hub для клиентской организации. |
2 |
Щелкните Устройства. |
3 |
Щелкните соответствующее устройство. |
4 |
В разделе Действия выберите Сообщить о проблеме. |
5 |
Просмотрите сводку отчета. |
Удалить устройство
1 |
Войдите в экземпляр Control Hub для клиентской организации. |
2 |
Щелкните Устройства. |
3 |
Выберите подходящее устройство. |
4 |
В раскрывающемся списке Действи я выберите Удалить. |
Изменение владельца устройства
1 |
Удаление существующей регистрации устройства из Webex. |
2 |
В BroadWorks деактивируйте регистрацию устройства под существующим пользователем. |
3 |
В BroadWorks активируйте устройство с помощью кода активации из другого профиля удостоверения/устройств а , используемого другим пользователем. |
Дальнейшие действия
-
Новый владелец устройства вводит код активации на устройстве.
-
Устройство повторно регистрируется в Webex и BroadWorks с помощью новой конфигурации. Новый профиль удостоверения/устройств а в BroadWorks автоматически обновляется с помощью MAC-адреса устройства.
Мониторинг производительности
Для этой функции существуют следующие счетчики производительности.
Счетчик |
Описание |
---|---|
Модуль: enterprises.broadsoft.broadworks.deviceActivation.activate | |
bwDASActivateRequests |
Общее количество полученных запросов на активацию. Это включает активацию запросов BroadWorks и запросов Webex. |
bwDASActivateFailures |
Общее количество запросов на активацию, которые не удалось выполнить успешно. Сюда входят запросы на активацию BroadWorks, которые не удалось выполнить, и запросы Webex, которые не удалось выполнить. |
Запросы bwDASActivateBroadWorks |
Количество полученных запросов активировать BroadWorks. |
bwDASActivateBroadWorksFailures |
Количество запросов BroadWorks, которые не были успешно выполнены. Ошибки авторизации и аутентификации не учитываются этим счетчиком. |
bwDASActivateWebexRequests |
Количество полученных запросов активации Webex. |
bwDASActivateWebexFailures |
Количество запросов Webex, которые не были успешно выполнены. |
Модуль: enterprises.broadsoft.broadworks.dms.dmBridge | |
bwDMBridgeRequests |
Количество отправленных запросов DMBridge. |
bwDMBridgeFailures |
Количество запросов DMBridge, которые не были успешно выполнены. |
Функции конечных пользователей для интегрированных устройств Webex
Унифицированный журнал вызовов
Телефоны MPP с поддержкой Webex
Устройства Cisco MPP с поддержкой Webex на платформе Webex для BroadWorks теперь смогут отображать унифицированную историю вызовов для вызовов, совершенных или принятых от клиента Webex пользователя и его устройств. Это позволяет улучшить работу устройств конечных пользователей, поскольку они могут наблюдать и использовать вызовы, совершенные/принятые в приложении Webex с помощью журналов вызовов на устройствах MPP, а также все локальные вызовы, обработанные на устройстве.
Унифицированный журнал вызовов Webex будет источником по умолчанию для просмотра журнала журнал вызовов пользователя. Этот журнал вызовов вызовов содержит вызовы, сделанные со всех телефонов, видеоустройств Webex или приложения Webex .
Затронутые модели IP-телефонов:
-
MPP68xx Серии 6821, 6841, 6851, 6861
-
MPP78xx Серии 7811, 7821, 7841, 7861
-
MPP 88xx серии 8811, 8841, 8845, 8851, 8861, 8865, 8875
Включение функции.
Чтобы включить эту функцию, необходимо выполнить следующие критерии
-
Интеграция устройств Webex для BroadWorks должна быть реализована и функциональна для устройств MPP. Дополнительные сведения см. в этом руководстве Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.
Требования к исправлениям и DTAF:
Ожидания/последствия/ограничения:
-
Основная линия (только текущий пользователь)
-
Унифицированный журнал вызовов будет поддерживаться, как указано выше.
-
Поддержка защиты конфиденциальности: защита/скрытие журнала вызовов, если задан пароль пользователя.
-
Если телефон не поддерживает связь с облаком, будет отображаться только «локальная история» входящих и исходящих вызовов этого устройства.
-
-
Другие линии (общие или иные)
-
Будет поддерживаться только локальная история входящих и исходящих вызовов на устройстве.
-
-
Устройства рабочего пространства
-
Унифицированный журнал вызовов в этом экземпляре не будет поддерживаться.
-
Если эта функция включена, вся история локальных вызовов на MPP (полученная из BroadWorks) будет удалена.
Интегрированные устройства RoomOS Webex для BroadWorks
Интегрированные устройства Cisco RoomOS Webex для BroadWorks теперь смогут отображать унифицированную историю вызовов для вызовов, совершенных или принятых от клиента Webex пользователя и его устройств. Это позволяет улучшить работу устройств конечных пользователей, поскольку они могут наблюдать и использовать вызовы, совершенные/принятые с помощью приложения Webex с помощью журналов вызовов на устройствах RoomOS, а также все локальные вызовы, обработанные на их устройствах.
Унифицированный журнал вызовов Webex будет источником по умолчанию для просмотра журнала журнал вызовов пользователя. Этот журнал вызовов вызовов содержит вызовы, сделанные со всех телефонов, видеоустройств Webex или приложения Webex .
Доступно в приведенных ниже моделях устройств RoomOS.
-
Устройства RoomOS
-
Серия настольных рабочих столов: Desk, Desk Mini, Desk Pro
-
Серия Room
-
Серия RoomKit
-
Webex Board Series
Включение функции.
-
Интеграция устройств Webex для BroadWorks должна быть реализована и функциональна для устройств RoomOS. Дополнительные сведения см. в этом руководстве Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.
Требования к исправлениям и DTAF:
-
Broadworks – эта функция зависит от установки соответствующих исправлений BroadWorks. Подробную информацию можно найти здесь.
Требования к конфигурации:
-
Ниже конфигурации должны быть установлены как указано
-
Конфигурация Bwks: Feature_oggle_Tebex_WCall=Да
-
Усовершенствования поиска по каталогу для интегрированных устройств RoomOS Webex для BroadWorks
Пользователи интегрированных устройств Cisco RoomOS Webex для BroadWorks теперь смогут выполнять поиск пользователей, пространств и даже устройств в своей организации Webex непосредственно на устройствах RoomOS с помощью новой усовершенствованной службы каталогов Webex. Эта служба предоставляет расширенные возможности поиска и поиска пользователям Webex для BroadWorks, чтобы они могли находить пользователей и вещи (рабочие пространства, устройства и т.д.) в своей организации Webex.
Доступно в приведенных ниже моделях устройств RoomOS.
-
Устройства RoomOS
-
Серия настольных рабочих столов: Desk, Desk Mini, Desk Pro
-
Серия Room
-
Серия RoomKit
-
Webex Board Series
Включение функции.
-
Интеграция устройств Webex для BroadWorks должна быть реализована и функциональна для устройств MPP. Дополнительные сведения см. в этом руководстве Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.
Требования к конфигурации:
-
На устройстве должен быть включен переключатель службы каталогов xConfiguration Webex DirectoryServiceSupport.