Ръководство за интегриране на устройства за Webex за Cisco BroadWorks

Въведение

Относно това ръководство

Този документ е предназначен за партньорски администратори в организации на доставчици на услуги, които внедряват Webex за Cisco BroadWorks. Ръководството описва как да включите и обслужвате Room OS и MPP устройства за Webex за Cisco BroadWorks. Ръководството е разделено на две глави:

Включване на устройството —Описва как да включите устройства Room OS (серия Room and Room Kit, серия Desk и серия Board) и MPP устройства към Webex за Cisco BroadWorks.
Възможност за обслужване на устройството —Описва как да управлявате вградените устройства в Control Hub.

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

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

Дата	Версия на документа	Описание на промяната
12 май 2023 г	1.7	Добавено Webex за BroadWorks интегрирани устройства Cisco RoomOS и Подобрения за търсене в директории за W4B интегрирани RoomOS устройства под Функции за крайни потребители за раздел Webex интегрирани устройства .
27 февруари 2023 г	1.6	Актуализиран Конфигуриране на услуги за Room OS стъпки под Включване на устройството .
17 февруари 2023 г	1.5	Добавено Обединена история на обажданията за MPP телефони, Webex раздел под Функции за крайния потребител за интегрирани устройства Webex .
октомври 14, 2022	1.4	Актуализиран процес на включване за Room OS под Внедряване на операционната система в стаята раздел за включване на SRV записи. Актуализиран Изисквания за конфигурация на BroadWorks под Предпоставки за ОС стая раздел с указател към Ръководство за решение за изисквания за осигуряване на поток.
20 юни 2022 г.	1.3	Актуализиран Предпоставки за ОС стая и Предпоставки за MPP устройство с указател към Ръководство за решение за изисквания за осигуряване на поток. Актуализиран Устройства с операционна система в стаята за предоставяне и Предоставяне на MPP устройство за да включите информация за различни методи за осигуряване.
03 юни 2022 г	1.2	Коригиран профил на устройството Тип номер за активиране на функцията (02283) в Предпоставки за ОС стая и Предпоставки за MPP устройство
май 27, 2022	1.1	Коригирано изискване за специален DMS екземпляр за партньорска организация. Добавено Предговор глава. Актуализирано заглавието като „Ръководство за интегриране на устройство“.
май 20, 2022	1.0	Първоначално публикуване

Интегриране на устройства за Webex за Cisco BroadWorks

Преглед на включването на устройството

Тази глава описва как да включите устройства към Webex за Cisco BroadWorks. Тази глава обхваща следните случаи на употреба:

Вградени нови устройства с операционна система Webex Room (използвайки кодове за активиране)
Вградени нови MPP устройства
Добавете възможност за Webex към съществуващи MPP устройства

Препоръчваме ви да разположите тази функция на независими от версията ADP сървъри. Въпреки това, XSP също поддържа тази функция. Ако използвате XSP, тогава когато този документ се отнася до "ADP", можете да замените "XSP", освен ако текстът не посочва само ADP.
Тази функция поддържа както лични, така и работни устройства.

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

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

Включване на устройство с кодове за активиране

Включването на устройството с кодове за активиране осигурява прост и сигурен начин за включване на устройства с Room OS. Кодът за активиране е 16-цифрена еднократна генерирана от системата парола, която потребителят трябва да въведе на устройството, за да се включи в устройството. Кодът за активиране е надеждно свързан с предвидения потребителски акаунт и гарантира, че само съответният потребител се включва в устройство, свързано със същия акаунт. След като потребителят въведе правилния код, устройството се свързва както с Webex , така и с BroadWorks, завършва регистрацията, изтегля своя конфигурационен файл и е готово за използване.

Следните устройства с Room OS поддържат включване с кодове за активиране:

Webex Board Series (Room OS)
Серия Webex Desk (Room OS)
Webex Room Series (Room OS)

Процес на внедряване за Room OS

Следният процес показва какво се случва, когато устройство с Room OS се включи, използвайки кодове за активиране:

Администраторът на партньора осигурява основния потребител и устройство в BroadWorks и след това генерира кода за активиране в BroadWorks.
До собственика на устройството се изпраща имейл, който съдържа кода за активиране на устройството.
Собственикът на устройството стартира устройството.
Устройството подканва собственика на устройството да въведе кода за активиране.
Собственикът на устройството въвежда кода за активиране на устройството.
Устройството се включва в BroadWorks и Webex , използвайки следния подпроцес:
- Устройството Room OS изпраща заявка за активиране до услугите на Webex . Кодът за активиране се потвърждава от GDS и ако кодът е правилен, устройството се включва към Webex. Webex връща машинен токен на устройството.
- Устройството изпраща заявка за активиране до DM на BroadWorks заедно с токена на машината и MAC адрес.
- BroadWorks оторизира и включва устройството.
- Устройството изпраща заявка до BroadWorks DM за актуализирана конфигурация. Машинният токен е включен за оторизация.
- BroadWorks оторизира маркера, намира актуализирания конфигурационен файл и връща актуализиран конфигурационен файл.
- Room OS ще се опита да намери NAPTR запис за домейна, посочен в конфигурационен файл , тъй като очаква да намери SRV запис за_sip ._tls .<domain_in_config > ако няма запис NAPTR, тогава RoomOS ще се опита да потърси SRV запис, последван от съответно A запис.
  
  SRV записът трябва да бъде_sip ._tls . тъй като roomOS ще поддържа само TLS за транспорт и SRTP за медии.
Устройството се регистрира и е готово за използване.

Следващата диаграма предоставя опростен преглед на процеса на въвеждане.

За подробна информация относно включването на Room OS, включително по-подробни диаграми на потока, вижте описанието на функцията Подобрения на Cisco BroadWorks за включване на устройства, работещи с Webex .

Удостоверяване на устройството (чрез токени на носител на OAuth)

Удостоверяването на устройство за устройства с Room OS изисква да активирате Cisco OAuth Bearer Tokens на BroadWorks. По време на включване, маркерът на носител се предава през заглавката за активиране на разрешение и служи за идентифициране на устройството. IdP валидира маркера на носител и връща UUID (UUID на машината за устройства на работното пространство или потребителски UUID за лични устройства) като обект на носител. BroadWorks запазва UUID като име на устройството в мрежовия сървър.

Предпоставки за ОС стая

Минимална версия на ОС за стая

Room OS 10.13 минимум

Изисквания за корекция на BroadWorks

Тази функция се поддържа от версия 2021.11 на Release Independent (RI) ADP сървър без изисквания за корекция.

За сървъри, които не са 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 (независимо от версията)

Изисквания за конфигурация на BroadWorks

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

Докато конфигурирате предоставянето на Flowthrough, не е задължително да използвате поточно осигуряване за обезпечавам потребители , т.е. можете да продължите да използвате съществуващите си методи за обезпечаване (API, Доверен/Недоверен Имейл, Потребителски самостоятелно и т.н.) за обезпечавам потребители. Вижте "Изисквания за осигуряване" в Ръководство за решение за Webex за Cisco BroadWorks .
Уверете се, че Интегриран IM+P услугата е активирана на BroadWorks и насочва към моста за осигуряване на BroadWorks.

URL на Provisioning Bridge е назначен, когато клиентският шаблон е приложен към организацията. Това трябва да е завършено по време на първоначалната ви настройка на Webex за Cisco BroadWorks. За да намерите съществуващия URL в Partner Hub, вж Конфигурирайте сървъра на приложения с URL на услугата за предоставяне в Ръководство за решение за Webex за Cisco BroadWorks .
Ако имате няколко партньорски организации, се нуждаете от специална услуга за управление на устройства (DMS) за всеки партньор.

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

Уверете се, че е зададено следното:

Внедрете услугата за активиране на устройство на BroadWorks. За подробности вж Сигурно въвеждане на Cisco BroadWorks с кодове за активиране .
Уверете се, че настройката на DAS URL за клъстера BroadWorks е зададена на URL на услугите за управление на устройства (DMS). За да видите текущата настройка за URL на DAS в Partner Hub, отидете на Настройки > Обаждане на BroadWorks > Преглед на клъстери и изберете подходящия клъстер. URL се показва под Настройки на интерфейса .

Следните функции на BroadWorks трябва да бъдат активирани на AS:

101377 Подобрения за включване на Webex и MPP устройства
25088 Поддръжка на слушалки за DECT устройства
24104 Поддръжка на многоклетъчна верига за DECT устройства
20077 Подобрения в управлението на устройства
19559 Подобрения за управление на визуални устройства
02283 Подобрения за персонализиране на типа профил на устройството

Например, изпълнете следната команда, за да активирате 101377. Променете номера на функцията, когато активирате другите функции: AS_CLI/System/ActivatableFeature> активирайте 101377

Ако всички изброени пачове са инсталирани и активираща се функция не е посочена за вашата конкретна версия на AS, това е защото вече е включена във вашата базова версия на AS и не изисква активиране.

Изпълнете следната команда от командния ред на мрежовия сървър:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Уверете се, че CA, който подписва вашия SBC сертификат, е посочен в списъка за доверие на Room OS. Можете да видите надежден списък на Room OS от интернет портал за устройства . В портала изберете Сигурност > Collaboration Edge за да видите списъка с CA.

Поток за въвеждане на ОС на стаята

Изпълнете следните задачи, за да конфигурирате вашата система да поддържа включването на устройство с кодове за активиране за следните устройства с Webex Room OS:

Серия платки Webex
Серия бюро Webex
Серия стаи Webex

1	Конфигуриране на услуги за Room OS Конфигурирайте поддръжката на BroadWorks за устройства с Room OS.
2	Устройства с операционна система в стаята за предоставяне Осигурете новото устройство на BroadWorks.
3	Заявете код за активиране В профила на устройството поискайте код за активиране. Кодът ще бъде изпратен автоматично до основния потребител.

Конфигуриране на услуги за Room OS

Преди да можете да включите нови устройства на Room OS, задайте следните параметри на системно ниво, за да включите OAuth удостоверяване.

1

Подайте заявка за услуга с вашия агент за включване или с Cisco TAC , за да осигурите Cisco OAuth за вашия акаунт на федерация на доставчика на Cisco Identity Provider. Заглавете заявка за услуга "Конфигурация на ADP AuthService".

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

Cisco ви дава OAuth клиент ID, клиент тайна и опресняване маркер, който е валиден за 60 дни. Ако токенът изтече, преди да го използвате с вашия ADP, можете да повдигнете друга заявка.

2

Активирайте OAuth, като използвате тази команда от командния ред:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth> задайте активиране на истина

3

Уверете се, че обхватът на OAuth включва broadworks-connector-user (обхватът е активирано по подразбиране). Изпълнете тази команда, за да проверите вашите обхвати:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth/Scopes> получи

4

Конфигурирайте параметрите на Cisco Identity Provider, като използвате командите на CLI по-долу.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> задайте разрешено false

задайте clientId —вижте отговор на заявка за услуга за ИД.
задайте clientSecret — вижте отговор на заявка за услуга за тайна.
задайте име на издателя — вижте следната таблица за URL.
задайте URL адрес на издателя — вижте следната таблица за URL.
задайте tokenInfoUrl <IdPProxy_ — вижте следните таблици за URL.
задайте ciResponseBodyMaxSizeInBytes 65536

1. Таблица 1. Задайте име на издателя и URL адрес на издателя
Ако CI клъстер е...	Задайте име на издателя и URL адрес на издаване на...
US-A	https://idbroker.webex.com/idb
ЕС	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ако не познавате своя CI клъстер , можете да получите информацията от подробностите за клиента в изгледа Help Desk на Control Hub.

Таблица 2. Задайте tokenInfoURL
Ако "Отбори Клъстър" е...	Задайте tokenInfoURL на...( URL на прокси за IdP)
ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
АФРА	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Ако не познавате своя Екипен клъстер , можете да получите информацията от подробностите за клиента в изгледа Help Desk на Control Hub. За тестване можете да проверите дали tokenInfoURL е валиден, като замените " `idp/удостоверяване` " част от URL с " `пинг` ".

5

Конфигурирайте доставчици на идентичност за Cisco Federation, като използвате следните команди:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> добавете FederationPartner refreshToken

Нова парола:

Въведете отново нова парола:

...Готово

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> получи

Токен за опресняване на името на партньор

==================================

FederationPartner ********

Намерен е 1 запис.

ADP_ CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

задайте flsUrl https://cifls.webex.com/federation
задайте refreshPeriodInMinutes 60
задайте partnerName FederationPartner

Токенът за опресняване вече е в контекста на CiscoIdentityProvider/Partners и PartnerName от контекста на CiscoIdentityProvider/Federation трябва да съответства на партньора, добавен в контекста на CiscoIdentityProvider/Partners.

Ако използвате ADP RI натоварване, по-старо от 2022.10, R23 XSP без корекция AP.xsp.23.0.1075.ap383838 или R22 XSP, тогава:

Не е необходимо да задавате партньор под „System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>“
Маркерът за опресняване трябва да бъде зададен под: System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

6

Изчистете всички съществуващи обхвати в следните три контекста под ADP_ CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

Обхвати
Администратор/Разрешени роли
Администратор/Обхвати Разрешени

За всеки контекст изпълнете a получи за да получите съществуващите обхвати и след това да ги изтриете. Например:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Scopes> получи изтриване <name_of_scope_ 1> изтриване <name_of_scope_ 2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/RolesAllowed> получи изтриване <name_of_scope_ 1> изтриване <name_of_scope_ 2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/ScopesAllowed> получи изтриване <name_of_scope_ 1> изтриване <name_of_scope_ 2>

Устройства с операционна система в стаята за предоставяне

На BroadWorks осигурете устройството Room OS (серия Webex Board, серия Webex Desk или серия Webex Room).

1	На BroadWorks CommPilot проверете Тип профил на самоличност/устройство конфигурация, за да видите дали тип устройство съществува за това устройство с Room OS. Ако тип устройство не съществува в BroadWorks, импортирайте тип устройство в BroadWorks, като използвате DTAF файл, който изтегляте от cisco.com.
2	След като импортирате тип устройство, уверете се, че следните настройки съществуват в Тип профил на самоличност/устройство конфигурация: Проверете Разрешете въвеждането на код за активиране поле за отметка Проверете Изпратете заявка за код за активиране чрез сървър за съобщения поле за отметка. Комплект Режим на удостоверяване до Носител .
3	Проверете дали файлът с профила на устройството има SIP настройките, които искате да използвате. В Файл с типа на самоличността/профила на устройството уверете се, че Режим на удостоверяване е Носител .
4	Създайте профил на устройство с настройките за вашето ново устройство. В Добавяне/промяна на самоличност/профил на устройство страница, оставете полето за MAC адрес празно.
5	Конфигурирайте основния потребител. На Потребители Добавяне страница, поставете или премахнете отметката от isPlace според това дали възнамерявате устройството да бъде лично или за споделено работно пространство. Отметнато – устройство за работно пространство Не отметнато – лично устройство Устройствата за споделено работно пространство също изискват да зададете основен потребител. Можете да зададете основния потребител, който искате.
6	Попълнете опцията, която съответства на тип устройство и метода на осигуряване, който искате да използвате: Устройството е за споделено работно пространство—Използвайте Предоставяне на работно пространство на BroadWorks API за завършване на обезпечаването за устройството на работното пространство. Устройството е лично; които искате да предоставите с помощта на публични API-използвайте Предоставяне на API за абонати на BroadWorks за да завършите обезпечаването за основния потребител. Устройството е лично; искате потребителите да използват самоактивиране—Препратете URL на портала за активиране на потребителя на потребителя. Потребителят трябва да потвърди своя имейл адрес , за да завърши обезпечаването. Устройството е лично; искате да използвате поточно предоставяне — отидете на стъпка 7.
7	Ако устройството е за лична употреба и искате да използвате осигуряване на поток, тогава за основния потребител задайте Интегриран IM+P услуга. На потребител > Профил страница, добавете услугата IM+P: От Профил страница, щракнете Възлагане на услуги . В списъка на Налични услуги , изберете Интегриран IM&P и използвайте стрелката, за да преместите елемента на Потребителски услуги кутия. Щракнете върху OK. Щракнете върху Профил . Само доверен имейл поток. Добавете потребителя имейл адрес. Тази настройка служи като имейл за IM&P за поточно предоставяне към Webex за Cisco BroadWorks. Това не се изисква, ако използвате ненадеждния имейл поток. Шаблонът на клиента на Webex трябва да бъде конфигуриран с настройки за осигуряване на поток чрез доверени имейли или ненадеждни имейли. За подробности вижте Ръководство за решение за Webex за Cisco BroadWorks .

Какво да направите след това

Заявете код за активиране за устройството Room OS.

Заявете код за активиране

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

1	В Профил на самоличност/устройство страница, потърсете и отворете профил на устройство за новото си устройство.
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 подобрения за Webex , позволяващи MPP устройства .

Предпоставки за MPP устройство

Минимална MPP версия

MPP фърмуер 11.3.7 минимум

Изисквания за корекция на BroadWorks

Тази функция се поддържа от версия 2021.11 на Release Independent (RI) ADP сървър без изисквания за корекция.

За сървъри, които не са 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 (независимо от версията)

Изисквания за конфигурация на BroadWorks

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

Докато конфигурирате предоставянето на Flowthrough, не е задължително да използвате поточно осигуряване за обезпечавам потребители , т.е. можете да продължите да използвате съществуващите си методи за обезпечаване (API, Доверен/Недоверен Имейл, Потребителски самостоятелно и т.н.) за обезпечавам потребители. Вижте "Изисквания за осигуряване" в Ръководство за решение за Webex за Cisco BroadWorks .
Уверете се, че Интегриран IM+P услугата е активирана на BroadWorks и насочва към моста за осигуряване на BroadWorks.

URL на Provisioning Bridge е назначен, когато клиентският шаблон е приложен към организацията. Това трябва да е завършено по време на първоначалната ви настройка на Webex за Cisco BroadWorks. За да намерите съществуващия URL в Partner Hub, вж Конфигурирайте сървъра на приложения с 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 адрес, който след това може да бъде поставен в заглавка, която използва описателно име (например, macdress ).

Ако 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 устройство. Въпреки това, ако искате да използвате кодове за активиране, вж Заявете код за активиране за MPP за допълнителни изисквания, които са специфични за кодовете за активиране с MPP.

Поток за въвеждане на MPP устройство

Изпълнете следните задачи, за да конфигурирате вашата система да поддържа включване на MPP устройство към Webex за Cisco BroadWorks.

Ако добавяте възможност за Webex към MPP устройство, което вече съществува на BroadWorks, изпълнете само стъпки 1 и 2.

1	Конфигуриране на услуги за MPP (Нови или съществуващи MPP устройства). Конфигурирайте системна поддръжка за MPP на Webex за Cisco BroadWorks.
2	Надстройте фърмуера на MPP устройство (Съществуващи MPP устройства). За всички съществуващи MPP устройства, за които искате да добавите възможност за Webex , надстройте до най-новия фърмуер на устройството.
3	Предоставяне на MPP устройство (Само нови MPP устройства). Ако устройството не съществува в BroadWorks, осигурете устройството и основния потребител на BroadWorks.
4	Заявете код за активиране за MPP (По избор). Ако искате да използвате кодове за активиране за вградени MPP устройства, поискайте код за активиране.

Конфигуриране на услуги за MPP

Актуализирайте настройки на системата на BroadWorks, за да поддържате MPP устройства (нови или съществуващи) на Webex за Cisco BroadWorks. Завършете тази стъпка само веднъж. Не е необходимо да повтаряте тази процедура за всяко MPP устройство.

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

Ако ADP е зад защитна стена, вашата защитна стена трябва да бъде конфигурирана с правило за извличане на MAC адрес от сертификата на устройството и поставянето му в заглавка за удостоверяване, която след това се препраща към ADP. Например моделът на идентичност .*([0-9a-fA-F]{12} ).* може да се използва за извличане на MAC адрес, който след това може да бъде поставен в заглавка, която използва описателно име (например, macdress ).

Обърнете се към документацията на защитната стена за помощ при конфигурациите.

1

Подайте заявка за услуга с вашия агент за включване или с Cisco TAC , за да осигурите Cisco OAuth за вашия акаунт на федерация на доставчика на Cisco Identity Provider. Използвайте „ADP AuthService Configuration“, за да озаглавите заявката си.

Cisco ви дава OAuth клиент ID, клиент тайна и опресняване маркер, който е валиден за 60 дни. Ако токенът изтече, преди да го използвате с вашия ADP, можете да повдигнете друга заявка.

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

2

Конфигурирайте параметрите на Cisco Identity Provider, като изпълните следните CLI команди.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> задайте разрешено false

задайте clientId —вижте отговор на заявка за услуга за ИД.
задайте clientSecret — вижте отговор на заявка за услуга за тайна.
задайте име на издателя — вижте следната таблица за URL.
задайте URL адрес на издателя — вижте следната таблица за URL.
задайте ciResponseBodyMaxSizeInBytes 65536

Таблица 3. Задайте име на издателя и URL адрес на издателя
Ако CI клъстер е...	Задайте име на издателя и URL адрес на издаване на...
US-A	https://idbroker.webex.com/idb
ЕС	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ако не познавате своя CI клъстер , можете да получите информацията от подробностите за клиента в изгледа Help Desk на Control Hub.

3

Задайте URL адреса на DM Bridge, като използвате команда от командния ред по-долу. URL на DM Bridge е различен за всеки клъстер на Teams (който изтеглихте в стъпка 2).

ADP_CLI/Applications/BroadworksDms/DeviceActivation/DMBridge> задайте URL = <url_of_ DM_ Bridge> обхват = dm-bridge:device_auth

Таблица 4. DM_ URL на мост
Ако "Отбори Клъстър" е...	Задайте DM_ Прехвърляне на URL към...
ACHM	dm-bridge-a.wbx2.com
AORE	dm-bridge-r.wbx2.com
АФРА	dm-bridge-k.wbx2.com

4

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

Заглавка за удостоверяване – ако ADP е зад защитна стена, използвайте CLI на ADP, за да активирате извличането на MAC адрес за заглавката за удостоверяване. Тази конфигурация дава на ADP възможността да разпознава MAC адрес от заглавката за удостоверяване. Например:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> задайте активиране на истина

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> задайте identityPattern "macaddress:.*([0-9a-fA-F]{12} ).*"

В този пример, macdress е присвоено име с .*([0-9a-fA-F]{12} ).* представляваща шаблона, който се присвоява на заглавката. Ако извикате заглавката нещо различно от macdress , коригирайте съответно вашия CLI.
Сертификат за удостоверяване – ако ADP не е зад защитна стена, удостоверяването се извършва директно между устройството и ADP. Използвайте следните CLI команди, за да активирате извличането на MAC адрес в сертификата на устройството за удостоверяване:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> задайте активиране на истина

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> задайте identityPattern ".*([0-9a-fA-F]{12} ).*"

Надстройте фърмуера на MPP устройство

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

Уверете се, че BroadWorks е актуализиран с поддръжка на услуги за MPP.

Надстройте фърмуера на устройството до най-новата версия, за да сте сигурни, че MPP устройството поддържа възможностите на Webex .

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

Какво да направите след това

Съществуващи MPP устройства — след надстройката устройството автоматично се включва към Webex . Потребителят може да започне да използва услугите на Webex на устройството.
Нови MPP устройства — Осигурете новото MPP устройство на BroadWorks.

Предоставяне на MPP устройство

Ако новото MPP устройство не съществува в BroadWorks, осигурете устройството на BroadWorks.

1	На BroadWorks CommPilot проверете Тип профил на самоличност/устройство конфигурация, за да видите дали тип устройство съществува за това MPP устройство. Ако тип устройство не съществува в BroadWorks, импортирайте тип устройство в BroadWorks с помощта на DTAF файл, който се изтегля от cisco.com.
2	На BroadWorks CommPilot отворете Тип профил на самоличност/устройство и проверете Разрешете въвеждането на код за активиране поле за отметка.
3	Създайте Тип профил на самоличност/устройство Файл със SIP настройките, които искате да използвате.
4	Създайте Профил на самоличност/устройство с настройки за новото ви устройство. В MAC адрес поле, въведете MAC адрес на устройството. Ако използвате кодове за активиране за вградени MPP устройства, оставете MAC адрес полето празно.
5	Конфигурирайте основния потребител. На Потребители Добавяне страница, задайте isPlace поле за отметка според това дали устройството е лично или за споделено работно пространство: Отметнато – устройство за работно пространство Не отметнато – лично устройство
6	Попълнете опцията, която съответства на тип устройство и метода на осигуряване, който искате да използвате: Устройството е за споделено работно пространство—Използвайте Предоставяне на работно пространство на BroadWorks API за завършване на обезпечаването за устройството на работното пространство. Устройството е лично; които искате да предоставите с помощта на публични API-използвайте Предоставяне на API за абонати на BroadWorks за да завършите обезпечаването за основния потребител. Устройството е лично; искате потребителите да използват самоактивиране—Препратете URL на портала за активиране на потребителя на потребителя. Потребителят трябва да потвърди своя имейл адрес , за да завърши обезпечаването. Устройството е лично; искате да използвате поточно предоставяне — отидете на стъпка 7.
7	Ако устройството е за лична употреба и искате да използвате осигуряване на поток, тогава за основния потребител задайте Интегриран IM+P услуга. На потребител > Профил страница, добавете услугата IM+P: От Профил страница, щракнете Възлагане на услуги . В списъка на Налични услуги , изберете Интегриран IM&P и използвайте стрелката, за да преместите елемента на Потребителски услуги кутия. Щракнете върху OK. Щракнете върху Профил . Само доверен имейл поток. Добавете потребителя имейл адрес. Тази настройка служи като имейл за IM&P за поточно предоставяне към Webex за Cisco BroadWorks. Това не се изисква, ако използвате ненадеждния имейл поток. Шаблонът на клиента на Webex трябва да бъде конфигуриран с настройки за осигуряване на поток чрез доверени имейли или ненадеждни имейли. За подробности вижте Ръководство за решение за Webex за Cisco BroadWorks .

Какво да направите след това

По желание Ако искате да използвате кодове за активиране за вградени MPP устройства, поискайте кода за активиране на BroadWorks.

Заявете код за активиране за MPP

(По избор) Webex за Cisco BroadWorks не изисква кодове за активиране за вграждане на нови MPP устройства. Въпреки това, ако решите да използвате кодове за активиране, попълнете Заявете код за активиране процедура за заявка на код за активиране за ново устройство.

Предпоставки за използване на кодове за активиране с MPP устройства

Ако използвате включване на код за активиране за MPP устройства, уверете се, че вашата система отговаря на следните специфични изисквания за код за активиране.

Услуга за активиране на устройство — Изпълнете следните изисквания, за да активирате услугата за активиране на устройство:

Внедрете услугата за активиране на устройство на BroadWorks. За подробности вж Сигурно въвеждане на Cisco BroadWorks с кодове за активиране .
Насочете услугата за активиране на устройства (DAS) към услуги за управление на устройства (DMS) на BroadWorks AS, като използвате следната команда от командния ред:

AS_CLI/Interface/DAS> задайте url <url_of_ DMS>
Уверете се, че настройката на DAS URL за клъстера BroadWorks е зададена на URL на услугите за управление на устройства (DMS). За да видите текущата настройка за URL на DAS в Partner Hub, отидете на Настройки > Обаждане на BroadWorks > Преглед на клъстери и изберете подходящия клъстер. URL се показва под Настройки на интерфейса .

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 заявка за услуга> напр https://activation.webex.com задайте clientId <id_from_service_request > clientSecret <secret_from_service_request > refreshToken <token_from_service_request >

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

Заявете код за активиране

Изпълнете следните стъпки, за да поискате код за активиране за ново MPP устройство.

В Профил на самоличност/устройство страница, потърсете и отворете профил на устройство за новото си устройство.
Щракнете върху Активиране на устройството раздел.
Щракнете върху Заявете код за активиране .

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

Възможност за обслужване на устройството

Преглед на обслужването

Control Hub съдържа опции за обслужване, които позволяват на администраторите да преглеждат състоянието на устройството, заедно с набор от опции за поддръжка. Администраторите могат:

Преглед на текущото състояние на устройството
Рестартирайте устройството дистанционно
Изпратете доклад за проблем за отстраняване на неизправности
Изтрийте устройството

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

Използвайте тази процедура, за да видите отчет за състоянието на устройството от Control Hub. Състоянието включва подробности като статус на регистрация, MAC адрес, SIP адрес, IP адрес и сериен номер.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Щракнете върху подходящото устройство.

Рестартирайте устройството

Използвайте тази процедура, за да рестартирате устройство от интерфейса на Control Hub.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Изберете устройство.
4	От Действия падащо меню, изберете Рестартирайте .

Съобщаване за проблем

Ако срещнете проблеми с устройство, използвайте тази процедура, за да изпратите отчет за проблема до Cisco TAC за отстраняване на неизправности.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Щракнете върху съответното устройство.
4	От Действия , изберете Докладвайте за проблем .
5	Прегледайте обобщение на отчет.

Изтриване на устройството

Използвайте тази процедура, за да изтриете устройство от Control Hub.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Изберете приложимото устройство.
4	От Действия падащо меню, изберете Изтрийте .

Промяна на собственика на устройството

Използвайте тази процедура, за да преместите съществуващо устройство, което е било включено чрез кодове за активиране, към нов собственик на устройство.

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

1

Изтрийте съществуващата регистрация на устройство от Webex:

В Webex Control Hub отворете организацията на клиента, към която принадлежи текущият собственик на устройството.
Под Управление , щракнете Устройства .
Поставете поле за отметка , което е в съседство с устройството, което искате да преместите.
Щракнете върху Изтрий.

Регистрацията на устройството се изтрива от Webex.

2

В BroadWorks деактивирайте регистрацията на устройството под съществуващия потребител:

На BroadWorks CommPilot отворете Профил на самоличност/устройство които устройството използва.
Щракнете върху Активиране на устройството раздел.
Щракнете върху Деактивирайте устройството .

Устройството се деактивира и дерегистрира от BroadWorks. MAC адрес се изтрива от стария Профил на самоличност/устройство конфигурация.

3

В BroadWorks активирайте устройството, като използвате кода за активиране от друг Профил на самоличност/устройство използван от друг потребител:

На BroadWorks CommPilot отворете различен Профил на самоличност/устройство конфигурация за различен потребител.
Уверете се, че Разрешете въвеждането на код за активиране се проверява за Тип профил на самоличност/устройство който се използва.
В Профил на самоличност/устройство прозорец, щракнете върху Активиране на устройството раздел.
Щракнете върху Заявете код за активиране .

Показва се новият код за активиране. Новият потребител трябва да въведе този код, за да се включи в устройството.

Какво да направите след това

Новият собственик на устройството въвежда кода за активиране на устройството.
Устройството се регистрира повторно както в Webex , така и в BroadWorks, използвайки новата конфигурация. Новото Профил на самоличност/устройство на BroadWorks се актуализира автоматично с MAC адрес на устройството.

Мониторинг на производителността

За тази функция съществуват следните броячи на производителност.

Брояч	Описание
модул: enterprises.broadsoft.broadworks.deviceActivation.activate
bwDASActivateRequests	Броят на общия брой получени заявки за активиране. Това включва активиране на заявки на BroadWorks и активиране на заявки на Webex .
bwDASActivateFailures	Общият брой заявки за активиране, които не са успели да завършат успешно. Това включва неуспешни заявки за активиране на BroadWorks и неуспешни заявки за активиране на Webex .
bwDASActivateBroadWorksRequests	Броят на получените заявки за активиране на BroadWorks.
bwDASActivateBroadWorksFailures	Броят на заявките за активиране на BroadWorks, които не успяха да завършат успешно. Неуспехите при упълномощаване и удостоверяване не се разглеждат от този брояч.
bwDASActivateWebexRequests	Броят на получени заявки за активиране на Webex .
bwDASActivateWebexFailures	Броят заявки за активиране на Webex , които не успяха да завършат успешно.
модул: enterprises.broadsoft.broadworks.dms.dmBridge
bwDMBridgeRequests	Броят на изпратените заявки за DMBridge.
bwDMBridgeFailures	Броят на заявките на DMBridge, които не са успели да завършат успешно.

Функции за крайния потребител за интегрирани устройства Webex

Унифицирана хронология на обажданията

MPP телефони, Webex

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

Обединената история на обажданията на Webex ще бъде източникът по подразбиране за преглед на историята на обажданията на потребителя. Тази история на обажданията съдържа обаждания, направени от всички телефони, Webex Video Devices или Webex App.

Засегнати модели IP телефони:

MPP68xx Серии 6821, 6841, 6851, 6861
MPP78xx Серии 7811, 7821, 7841, 7861
MPP88xx Серии 8811, 8841, 8845, 8851, 8861, 8865, 8875

Активиране на функции:

За да активирате функцията, трябва да бъдат изпълнени следните критерии

Интеграцията на устройства Webex за BroadWorks трябва да бъде внедрена и функционална за MPP устройства. Повече подробности можете да намерите в това ръководство Ръководство за интеграция на устройства за Webex за Cisco BroadWorks .

Изисквания за корекция и DTAF:

Broadworks – Тази функция зависи от инсталираните съответните корекции на BroadWorks. Подробности могат да бъдат намерени тук .
Устройство – За да се приложат най-новите MPP конфигурации. Необходимите CPE комплекти могат да бъдат намерени тук (влезте с CCO ИД).

Очаквания/Въздействие/Ограничения:

Основна линия (само за текущия потребител)
- Обединената история на обажданията ще се поддържа, както е споменато.
- Поддръжка Защита на поверителността - Защита/скриване на историята на обажданията, когато е зададена потребителска парола .
- Ако телефонът не е Cloud Aware, ще се показва само „локалната история“ на обажданията към и от това устройство.
Други линии (споделени или по друг начин)
- Ще се поддържа само локална история на повиквания към и от устройство.
Устройства за работно пространство
- Обединената история на обажданията няма да се поддържа в този случай.

Когато функцията е включена, цялата история на местните повиквания на MPP (извлечена от BroadWorks) ще бъде изтрита.

Webex за BroadWorks интегрирани RoomOS устройства

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

Обединената история на обажданията на Webex ще бъде източникът по подразбиране за преглед на историята на обажданията на потребителя. Тази история на обажданията съдържа обаждания, направени от всички телефони, Webex Video Devices или Webex App.

Предлага се на следните модели устройства RoomOS:

RoomOS устройства
Серия бюро: Бюро, Desk Mini, Desk Pro
Серия Room
Серия RoomKit
Уебекс борд серия

Активиране на функции:

Интеграцията на устройства Webex за BroadWorks трябва да бъде внедрена и функционална за устройства с RoomOS. Повече подробности можете да намерите в това ръководство Ръководство за интеграция на устройства за Webex за Cisco BroadWorks .

Изисквания за корекция и DTAF:

Broadworks – Тази функция зависи от инсталираните съответните корекции на BroadWorks. Подробности могат да бъдат намерени тук .

Изисквания за конфигурация:

Конфигурациите по-долу трябва да бъдат зададени, както е посочено
- Bwks конфигурация: Фeature_ Тoggle_ Уebex_ Обаждане=Да

Подобрения в търсенето в директория за Webex за интегрирани RoomOS устройства на BroadWorks

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

Предлага се на следните модели устройства RoomOS:

RoomOS устройства
Серия бюро: Бюро, Desk Mini, Desk Pro
Серия Room
Серия RoomKit
Уебекс борд серия

Активиране на функции:

Интеграцията на устройства Webex за BroadWorks трябва да бъде внедрена и функционална за MPP устройства. Повече подробности можете да намерите в това ръководство Ръководство за интеграция на устройства за Webex за Cisco BroadWorks .

Изисквания за конфигурация:

Превключвателят на услугата на директория „xConfiguration Webex DirectoryServiceSupport“ трябва да бъде активиран на Устройството.

Въведение

Относно това ръководство

Този документ е предназначен за администратори на партньори в организации на доставчици на услуги, които разгръщат Webex за Cisco BroadWorks. Ръководството описва как да включите и обслужвате Room OS и MPP устройства за Webex за Cisco BroadWorks. Ръководството е разделено на две глави:

Включване на устройства— Описва как да се включат устройства Room OS (серия Room и Room Kit, серия Desk и серия Board) и MPP устройства към Webex за Cisco BroadWorks.
Изправност на устройството – описва как да управлявате вградени устройства в Control Hub.

Хронология на промените на документи

Следващата таблица обобщава хронологията на промените за този документ.

Дата	Версия на документа	Описание на промяната
12 май 2023 г.	1.7	Добавено е Webex за интегрирани устройства Cisco RoomOS на BroadWorks и подобрения в търсенето на указатели за W4B Integrated RoomOS устройства в раздела Функции на крайния потребител за интегрирани устройства на Webex.
27 февруари 2023 г.	1.6	Актуализирани са стъпките Конфигуриране на услуги за Room OS под Включване на устройство.
17 февруари 2023 г.	1.5	Добавена е секцията Унифицирана хронология на повикванията за MPP телефони, които са наясно с Webex под Функции на крайния потребител за интегрирани устройства с Webex.
октомври 14, 2022	1.4	Актуализиран процес на включване за Room OS в раздела Room OS Onboarding , за да включва SRV записи. Актуализирани са изискванията за конфигуриране на BroadWorks в раздела Изисквания за операционна система Room с показалец към ръководството за решение за изискванията за поточно осигуряване.
20 юни 2022 г.	1.3	Актуализирани са предпоставките за Room OS и предпоставките за MPP устройство с показалец към ръководството за решение за изискванията за поточно осигуряване. Актуализирани са Осигуряване на устройства за операционна система Room и Осигуряване на MPP устройство , за да включват информация за различни методи на осигуряване.
03 юни 2022 г.	1.2	Коригиран номер за активиране на функцията за тип профил на устройството (02283) в предпоставки за Room OS и предпоставки за MPP устройство
май 27, 2022	1.1	Коригирано изискване за специализиран DMS екземпляр на партньорска организация. Добавена е глава Предговор . Актуализирано заглавие като „Ръководство за интеграция на устройства“.
май 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 за работна област.

Включване на устройство с кодове за активиране

Включването на устройства с кодове за активиране осигурява прост и защитен начин за включване на устройства с Room OS. Кодът за активиране представлява 16-цифрена еднократна генерирана от системата парола, която потребителят трябва да въведе на устройство, за да се включи в устройството. Кодът за активиране е сигурно свързан със съответния потребителски акаунт и гарантира, че само предвиденият потребител включва устройство, свързано със същия акаунт. След като потребителят въведе правилния код, устройството се свързва както с Webex, така и с BroadWorks, завършва регистрацията, изтегля своя конфигурационен файл и е готово за използване.

Следните устройства с операционна система Room поддържат включване с кодове за активиране:

Серия Webex Board (Room OS)
Серия Webex Desk (Room OS)
Серия стаи на Webex (Room OS)

Процес на включване за Room OS

Следният процес показва какво се случва, когато устройство с Room OS се включи с помощта на кодове за активиране:

Администраторът на партньора осигурява основния потребител и устройство в BroadWorks и след това генерира кода за активиране в BroadWorks.
Имейл, който съдържа кода за активиране на устройството, се изпраща на собственика на устройството.
Собственикът на устройството стартира устройството.
Устройството подканва собственика на устройството да въведе кода за активиране.
Собственикът на устройството въвежда кода за активиране на устройството.
Устройството се включва в BroadWorks и Webex с помощта на следния подпроцес:
- Устройството Room OS изпраща заявка за активиране на услугите на Webex. Кодът за активиране се проверява от GDS и ако кодът е правилен, устройството се включва в Webex. Webex връща маркер на машината на устройството.
- Устройството изпраща заявка за активиране до DM на BroadWorks заедно с маркера на машината и MAC адреса.
- BroadWorks упълномощава и включва устройството.
- Устройството изпраща искане до BroadWorks DM за актуализирана конфигурация. Маркерът на машината е включен за упълномощаване.
- BroadWorks упълномощава маркера, намира актуализирания конфигурационен файл и връща актуализирания конфигурационен файл.
- Room OS ще се опита да намери NAPTR запис за домейна, посочен в конфигурационния файл, тъй като очаква да намери SRV запис за _sip._tls.<domain_in_config> Ако няма NAPTR запис, RoomOS ще опита и ще потърси SRV запис, последван съответно от A запис.
  
  SRV записът трябва да е _sip._tls. тъй като roomOS ще поддържа само TLS за транспорт и SRTP за мултимедия.
Устройството се регистрира и е готово за използване.

Следващата схема предоставя опростен общ преглед на процеса на включване.

За подробна информация за включването на операционна система Room, включително по-подробни диаграми на потоци, вижте описанието на функцията Подобрения в Cisco BroadWorks за включване на устройство с Webex-Aware.

Удостоверяване на устройство (чрез маркери за OAuth носител)

Удостоверяването на устройства за устройства за Room OS изисква да активирате Cisco OAuth Bearer Tokens в BroadWorks. По време на включването маркерът за носител се предава чрез заглавката за активиране на упълномощаване и служи за идентифициране на устройството. IdP валидира маркера на носител и връща UUID (машинен UUID за устройства в работната област или потребителски UUID за лични устройства) като тема носител. BroadWorks записва UUID като име на устройство в мрежовия сървър.

Изисквания за Room OS

Минимална версия на операционна система за стая

Стая 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 (независимо от версията)

Изисквания за конфигуриране на BroadWorks

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

При конфигуриране на поточно осигуряване не е задължително да се използва поточно осигуряване за осигуряване на потребителите, т.е. можете да продължите да използвате съществуващите си методи за осигуряване (API, доверен/ненадежден имейл, личност на потребителя и т.н.) за осигуряване на потребители. Вижте „Изисквания за осигуряване“ в ръководството за решение Webex за Cisco BroadWorks.
Уверете се, че интегрираната IM+P услуга е разрешена в BroadWorks и насочва към моста за обезпечаване на BroadWorks.

URL адресът на моста за обезпечаване е зададен, когато към организацията е приложен шаблонът за клиент. Това трябваше да е завършено по време на първоначалната ви настройка на Webex за Cisco BroadWorks. За да намерите съществуващия URL адрес в Partner Hub, вижте Конфигуриране на сървър за приложения с URL адрес на услугата за обезпечаване в ръководството за решение Webex за Cisco BroadWorks.
Ако имате няколко партньорски организации, изисквате специализиран екземпляр на услугата за управление на устройства (DMS) за всеки партньор.

Изисквания за код за активиране при включване с Room OS

Уверете се, че е зададено следното:

Разположете услугата за активиране на устройства в BroadWorks. За подробности вижте Защитено включване в Cisco BroadWorks с помощта на кодове за активиране.
Проверете дали настройката за DAS URL адрес за клъстера на BroadWorks е зададена на URL адреса на услугите за управление на устройства (DMS). За да видите текущата настройка за DAS URL адрес в Partner Hub, отидете на Настройки > BroadWorks Calling > Преглед на клъстери и изберете подходящия клъстер. URL адресът се показва под Настройки на интерфейса.

Ако в клъстера на BroadWorks има много клиенти (>50), възможността за добавяне на 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 OS. Можете да прегледате надеждния списък на операционната система Room от уеб портала за устройства. В портала изберете Защита > Край на сътрудничеството , за да видите списъка на СО.

Поток за включване на операционна система Room

Изпълнете следните задачи, за да конфигурирате системата си да поддържа включване на устройства с кодове за активиране за следните устройства Webex Room OS:

Серия платки Webex
Серия бюро Webex
Серия стаи Webex

1	Конфигуриране на услуги за Room OS Конфигурирайте поддръжка на BroadWorks за устройства с Room OS.
2	Осигуряване на устройства с операционна система Room Осигурете новото устройство в BroadWorks.
3	Заявка за код за активиране В профила на устройството заявете код за активиране. Кодът ще бъде изпратен автоматично по имейл на основния потребител.

Конфигуриране на услуги за Room OS

Преди да можете да включите нови устройства за операционна система Room, задайте следните параметри на системно ниво, за да включите удостоверяването с OAuth.

1

Подайте заявка за услуга с агента за включване или със Cisco TAC, за да осигурите Cisco OAuth за вашия акаунт за федериране на Cisco Identity Provider. Дайте име на заявката си за услуга „ADP AuthService Configuration“.

Ако вече сте получили идентификационни данни за Cisco OAuth Identity Provider, използвайки един от потоците в този документ, няма нужда да създавате ново искане. Ако обаче сте получили идентификационни данни за Cisco OAuth с използване на поток, който не е в този документ, попълнете нова заявка за услуга, за да актуализирате идентификационните си данни.

Cisco ви дава OAuth клиент ID, клиент тайна и опресняване маркер, който е валиден за 60 дни. Ако маркерът изтече, преди да го използвате с вашия ADP, можете да изпратите друга заявка.

2

Активирайте OAuth, като използвате командата CLI:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth> задаване на разрешаване на „вярно“

3

Уверете се, че обхватът на OAuth включва Broadworks-connector-user (обхватът е активиран по подразбиране). Изпълнете тази команда, за да проверите скобите си:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth/Scopes> вземане

4

Конфигурирайте параметрите на доставчика на самоличност на Cisco с помощта на командите на CLI по-долу.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> зададе активирано невярно

задайте clientId – вижте отговора на заявката за услуга за ИД.
задаване на clientSecret – вижте отговора на заявката за услуга за тайна.
set issuerName – вижте таблицата по-долу за URL адрес.
задаване на issuerUrl – вижте таблицата по-долу за URL адрес.
задайте tokenInfoUrl <IdPProxy_URL> – вижте таблиците по-долу за URL.
задаване на ciResponseBodyMaxSizeInBytes 65536

Таблица 1. Задаване на issuerName и issuerURL
Ако CI клъстер е...	Задаване на issuerName и issuerURL на...
US-A	https://idbroker.webex.com/idb
ЕС	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ако не знаете своя CI клъстер, можете да получите информацията от подробностите за клиента в изгледа „Помощен център“ на Control Hub.

Таблица 2. Задаване на маркерInfoURL
Ако "Отбори Клъстър" е...	Задаване на маркерInfoURL на...(IdP прокси URL)
ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
АФРА	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Ако не знаете своя клъстер на Teams, можете да получите информацията от подробностите за клиента в изгледа „Помощен център“ на Control Hub. За тестване можете да потвърдите, че tokenInfoURL е валиден, като замените частта „`idp/authenticate`“ от URL адреса с „`ping`“.

5

Конфигурирайте доставчиците на самоличност за Cisco Federation с помощта на следните команди:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> добавяне на маркер за обновяване на FederationPartner

Нова парола:

Въведете отново новата парола:

...Готово

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> вземане

Маркер за обновяване на името на партньор

==================================

Партньор на федерацията *******

Намерен е 1 запис.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

задаване на flsUrl https://cifls.webex.com/federation
задаване на refreshPeriodInMinutes 60
задаване на партньорИме на федериранеПартньор

Маркерът за обновяване вече е в контекста на CiscoIdentityProvider/Partners и partnerName от контекста на CiscoIdentityProvider/Federation трябва да съответства на партньора, добавен в контекста на CiscoIdentityProvider/Partners.

Ако изпълнявате ADP RI зареждане, по-старо от 2022.10, R23 XSP без корекция AP.xsp.23.0.1075.ap383838 или R22 XSP, тогава:

Не е необходимо да задавате партньор в „System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>“
Маркерът за обновяване трябва да бъде зададен в: System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Федериране>

6

Изчистете всички съществуващи скоби в следните три контекста под ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

Обхвати
Позволени администраторски/роли
Позволен от администратор/скопи

За всеки контекст изпълнете get , за да получите съществуващите скоби и след това ги изтрийте. Например:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Scopes> получите изтриване на <name_of_scope_1> изтриване на <name_of_scope_2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/RolesAllowed> получите изтриване на <name_of_scope_1> изтриване на <name_of_scope_2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/ScopesAllowed> получите изтриване на <name_of_scope_1> изтриване на <name_of_scope_2>

Осигуряване на устройства с операционна система Room

В BroadWorks осигурете устройството Room OS (серия Webex Board, серия Webex Desk или серия Webex Room).

1	В BroadWorks CommPilot проверете конфигурацията на Самоличност/Тип профил на устройство , за да видите дали съществува типът устройство за това устройство с Room OS. Ако типът устройство не съществува в BroadWorks, импортирайте типа устройство в BroadWorks, като използвате DTAF файл, който можете да изтеглите от cisco.com.
2	След като импортирате типа устройство, се уверете, че в конфигурацията за Самоличност/Тип на профила на устройството съществуват следните настройки: Поставете отметка в квадратчето Разрешаване на код за активиране Поставете отметка в квадратчето Изпращане на заявка за код за активиране през сървъра за съобщения . Задайте режим на удостоверяване на носител.
3	Потвърдете, че файлът с профила на устройството има настройките за SIP, които искате да използвате. Във файла с тип профил на самоличност/устройство се уверете, че режимът на удостоверяване е носител.
4	Създайте профил на устройството с настройките за новото си устройство. На страницата Добавяне/промяна на профил на устройство оставете полето за MAC адрес празно.
5	Конфигуриране на основния потребител. На страницата Добавяне на потребители отметнете или премахнете отметката от isPlace в зависимост от това дали възнамерявате устройството да е лично, или за споделена работна област. Отметнато – устройство в работната област Неотметнато – Лично устройство Споделените устройства за работна област също изискват да зададете основен потребител. Можете да зададете желания основен потребител.
6	Попълнете опцията, която съответства на типа устройство и метода на обезпечаване, който искате да използвате: Устройството е за споделена работна област – използвайте Осигуряване на API за работна област на BroadWorks , за да завършите осигуряването за устройството на работната област. Устройството е лично; искате да осигурите чрез публични API – използвайте Осигуряване на API за абонати на BroadWorks , за да завършите осигуряването за основния потребител. Устройството е лично; искате потребителите да използват самостоятелно активиране – пренасочете URL адреса на портала за активиране на потребители към потребителя. Потребителят трябва да потвърди имейл адреса си, за да завърши осигуряването. Устройството е лично; искате да използвате поточно осигуряване – отидете на стъпка 7.
7	Ако устройството е за лична употреба и искате да използвате поточно обезпечаване, тогава за основния потребител задайте интегрираната IM+P услуга. На страницата Потребител > Профил добавете услугата IM+P: От страницата Профил щракнете върху Задаване на услуги. В списъка с Налични услуги изберете Интегриран IM&P и използвайте стрелката, за да преместите елемента в полето Потребителски услуги . Щракнете върху OK. Щракнете върху Профил. Само поток на надеждни имейли. Добавете имейл адреса на потребителя. Тази настройка служи като имейл за IM&P за поточно осигуряване на Webex за Cisco BroadWorks. Това не е задължително, ако използвате ненадежден имейл поток. Шаблонът на клиент в Webex трябва да се конфигурира с настройки за поточно осигуряване с надеждни имейли или ненадеждни имейли. За подробности вижте Напътствия за решението Webex за Cisco BroadWorks.

Какво да направите след това

Поискайте код за активиране за устройството Room OS.

Заявка за код за активиране

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

1	На страницата Самоличност/Профил на устройство потърсете и отворете профила на устройството за новото си устройство.
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 вижте описанието на функцията Подобрения в DMS на Cisco BroadWorks за активиране на 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 (независимо от версията)

Изисквания за конфигуриране на BroadWorks

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

При конфигуриране на поточно осигуряване не е задължително да се използва поточно осигуряване за осигуряване на потребителите, т.е. можете да продължите да използвате съществуващите си методи за осигуряване (API, доверен/ненадежден имейл, личност на потребителя и т.н.) за осигуряване на потребители. Вижте „Изисквания за осигуряване“ в ръководството за решение Webex за Cisco BroadWorks.
Уверете се, че интегрираната IM+P услуга е разрешена в BroadWorks и насочва към моста за обезпечаване на BroadWorks.

URL адресът на моста за обезпечаване е зададен, когато към организацията е приложен шаблонът за клиент. Това трябваше да е завършено по време на първоначалната ви настройка на Webex за Cisco BroadWorks. За да намерите съществуващия URL адрес в Partner Hub, вижте Конфигуриране на сървър за приложения с 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 устройство. Посочете, ако искате да използвате кодове за активиране, вижте Заявка за код за активиране за MPP за допълнителни изисквания, които са специфични за кодовете за активиране с MPP.

Поток за включване на MPP устройство

Изпълнете следните задачи, за да конфигурирате системата си да поддържа включване на MPP устройство в Webex за Cisco BroadWorks.

Ако добавяте възможности за Webex към MPP устройство, което вече съществува в BroadWorks, изпълнете само стъпки 1 и 2.

1	Конфигуриране на услуги за MPP (Нови или съществуващи MPP устройства). Конфигурирайте системна поддръжка за MPP в Webex за Cisco BroadWorks.
2	Надстройване на фърмуера на MPP устройството (Съществуващи MPP устройства). За всички съществуващи MPP устройства, за които искате да добавите възможност за Webex, надстройте до най-новия фърмуер на устройството.
3	Осигуряване на MPP устройство (Само за нови MPP устройства). Ако устройството не съществува в BroadWorks, осигурете устройството и основния потребител в BroadWorks.
4	Заявка за код за активиране за MPP (По избор). Ако искате да използвате кодове за активиране за включване на MPP устройства, поискайте код за активиране.

Конфигуриране на услуги за MPP

Актуализирайте системните си настройки на BroadWorks, за да поддържате MPP устройства (нови или съществуващи) в Webex за Cisco BroadWorks. Изпълнете тази стъпка само веднъж. Не е необходимо да повтаряте тази процедура за всяко MPP устройство.

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

Ако ADP е зад защитна стена, защитната стена трябва да бъде конфигурирана с правило за извличане на MAC адреса от сертификата на устройството и за поставяне в заглавка за удостоверяване, която след това се препраща към ADP. Например моделът на самоличност .*([0-9a-fA-F]{12}).* може да се използва за извличане на MAC адреса, който след това може да бъде поставен в заглавка, която използва описателно име (например macaddress).

Вижте документацията на защитната стена за помощ с конфигурациите.

1

Подайте заявка за услуга с агента за включване или със Cisco TAC, за да осигурите Cisco OAuth за вашия акаунт за федериране на Cisco Identity Provider. Използвайте \„ADP AuthService Configuration\“, за да заглавието на заявката си.

Cisco ви дава OAuth клиент ID, клиент тайна и опресняване маркер, който е валиден за 60 дни. Ако маркерът изтече, преди да го използвате с вашия ADP, можете да изпратите друга заявка.

Ако вече сте получили идентификационни данни за Cisco OAuth Identity Provider, използвайки един от потоците в този документ, няма нужда да създавате ново искане. Ако обаче сте получили идентификационни данни за Cisco OAuth с използване на поток, който не е в този документ, попълнете нова заявка за услуга, за да актуализирате идентификационните си данни.

2

Конфигурирайте параметрите на доставчика на самоличност на Cisco чрез изпълнение на следните CLI команди.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> зададе активирано невярно

задайте clientId – вижте отговора на заявката за услуга за ИД.
задаване на clientSecret – вижте отговора на заявката за услуга за тайна.
set issuerName – вижте таблицата по-долу за URL адрес.
задаване на issuerUrl – вижте таблицата по-долу за URL адрес.
задаване на ciResponseBodyMaxSizeInBytes 65536

Таблица 3. Задаване на issuerName и issuerURL
Ако CI клъстер е...	Задаване на issuerName и issuerURL на...
US-A	https://idbroker.webex.com/idb
ЕС	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ако не знаете своя CI клъстер, можете да получите информацията от подробностите за клиента в изгледа „Помощен център“ на Control Hub.

3

Задайте URL адреса на DM моста, като използвате командата CLI по-долу. URL адресът на DM Bridge е различен за всеки клъстер на Teams (който сте изтеглили в стъпка 2).

ADP_CLI/Applications/BroadworksDms/DeviceActivation/DMBridge> задайте url адрес = <url_of_DM_Bridge> обхват = dm-bridge:device_auth

Таблица 4. URL адрес на _DM мост
Ако "Отбори Клъстър" е...	Задаване на URL адрес на_DM мост на...
ACHM	dm-bridge-a.wbx2.com
AORE	dm-bridge-r.wbx2.com
АФРА	dm-bridge-k.wbx2.com

4

Активирайте извличането и удостоверяването на MAC адреси чрез заглавката за удостоверяване или сертификата за удостоверяване. Поради съображения за защита препоръчваме да използвате само една от опциите:

Заглавка за удостоверяване – ако ADP е зад защитна стена, използвайте CLI на ADP, за да активирате извличането на MAC адрес за заглавката за удостоверяване. Тази конфигурация дава на ADP възможност да разпознае MAC адреса от заглавката за удостоверяване. Например:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> задаване на разрешаване на „вярно“

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> задайте identityPattern \„macaddress:.*([0-9a-fA-F]{12}).*"

В този пример macaddress е зададено име с .*([0-9a-fA-F]{12}).* представлява модела, който се присвоява на заглавката. Ако наричате заглавката нещо различно от macaddress, коригирайте съответно CLI.
Сертификат за удостоверяване – ако ADP не е зад защитна стена, удостоверяване възниква директно между устройството и ADP. Използвайте командите на CLI по-долу, за да разрешите извличането на MAC адрес на сертификата на устройството за удостоверяване:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> задаване на разрешаване на „вярно“

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> задайте identityPattern ".*([0-9a-fA-F]{12}).*"

Надстройване на фърмуера на MPP устройството

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

Уверете се, че BroadWorks е актуализиран с поддръжка на услуги за MPP.

Надстройте фърмуера на устройството до най-новата версия, за да сте сигурни, че MPP устройството поддържа възможностите на Webex.

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

Какво да направите след това

Съществуващи MPP устройства – след надстройването устройството се включва автоматично в Webex. Потребителят може да започне да използва услугите на Webex на устройството.
Нови MPP устройства—Осигуряване на новото MPP устройство в BroadWorks.

Осигуряване на MPP устройство

Ако новото MPP устройство не съществува в BroadWorks, осигурете устройството в BroadWorks.

1	В BroadWorks CommPilot проверете конфигурацията на Самоличност/Тип профил на устройство , за да видите дали съществува типът устройство за това MPP устройство. Ако типът устройство не съществува в BroadWorks, импортирайте типа устройство в BroadWorks, като използвате DTAF файл, изтеглен от cisco.com.
2	В BroadWorks CommPilot отворете Самоличност/Тип профил на устройство и поставете отметка в квадратчето Разрешаване на код за активиране .
3	Създайте файл за самоличност/тип на профила на устройството с настройките за SIP, които искате да използвате.
4	Създайте профил на самоличност/устройство с настройки за новото си устройство. В полето MAC адрес въведете MAC адреса на устройството. Ако използвате кодове за активиране за включване на MPP устройства, оставете полето MAC адрес празно.
5	Конфигуриране на основния потребител. На страницата Добавяне на потребители поставете отметка в квадратчето isPlace в зависимост от това дали устройството е лично, или за споделена работна област: Отметнато – устройство в работната област Неотметнато – Лично устройство
6	Попълнете опцията, която съответства на типа устройство и метода на обезпечаване, който искате да използвате: Устройството е за споделена работна област – използвайте Осигуряване на API за работна област на BroadWorks , за да завършите осигуряването за устройството на работната област. Устройството е лично; искате да осигурите чрез публични API – използвайте Осигуряване на API за абонати на BroadWorks , за да завършите осигуряването за основния потребител. Устройството е лично; искате потребителите да използват самостоятелно активиране – пренасочете URL адреса на портала за активиране на потребители към потребителя. Потребителят трябва да потвърди имейл адреса си, за да завърши осигуряването. Устройството е лично; искате да използвате поточно осигуряване – отидете на стъпка 7.
7	Ако устройството е за лична употреба и искате да използвате поточно обезпечаване, тогава за основния потребител задайте интегрираната IM+P услуга. На страницата Потребител > Профил добавете услугата IM+P: От страницата Профил щракнете върху Задаване на услуги. В списъка с Налични услуги изберете Интегриран IM&P и използвайте стрелката, за да преместите елемента в полето Потребителски услуги . Щракнете върху OK. Щракнете върху Профил. Само поток на надеждни имейли. Добавете имейл адреса на потребителя. Тази настройка служи като имейл за IM&P за поточно осигуряване на Webex за Cisco BroadWorks. Това не е задължително, ако използвате ненадежден имейл поток. Шаблонът на клиент в Webex трябва да се конфигурира с настройки за поточно осигуряване с надеждни имейли или ненадеждни имейли. За подробности вижте Напътствия за решението Webex за Cisco BroadWorks.

Какво да направите след това

По желание Ако искате да използвате кодове за активиране за включване на MPP устройства, поискайте кода за активиране в BroadWorks.

Заявка за код за активиране за MPP

(По избор) Webex за Cisco BroadWorks не изисква кодове за активиране за включването на нови MPP устройства. Ако обаче решите да използвате кодове за активиране, изпълнете процедурата Искане на код за активиране , за да поискате код за активиране за ново устройство.

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

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

Услуга за активиране на устройство— Изпълнете следните изисквания, за да разрешите услугата за активиране на устройство:

Разположете услугата за активиране на устройства в BroadWorks. За подробности вижте Защитено включване в Cisco BroadWorks с помощта на кодове за активиране.
Насочете услугата за активиране на устройства (DAS) към услугите за управление на устройства (DMS) в BroadWorks КАТО използвате следната команда CLI:

AS_CLI/Interface/DAS> задаване на URL адрес <url_of_DMS>
Проверете дали настройката за DAS URL адрес за клъстера на BroadWorks е зададена на URL адреса на услугите за управление на устройства (DMS). За да видите текущата настройка за DAS URL адрес в Partner Hub, отидете на Настройки > BroadWorks Calling > Преглед на клъстери и изберете подходящия клъстер. URL адресът се показва под Настройки на интерфейса.

Ако в клъстера на BroadWorks има много клиенти (>50), възможността за добавяне на 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 заявка за услуга>, напр. https://activation.webex.com задайте ид на клиент <id_from_service_request> clientSecret <secret_from_service_request> refhToken <token_from_service_request>

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

Заявка за код за активиране

Изпълнете следните стъпки, за да поискате код за активиране на ново MPP устройство.

На страницата Самоличност/Профил на устройство потърсете и отворете профила на устройството за новото си устройство.
Щракнете върху раздела Активиране на устройство .
Щракнете върху Искане на код за активиране.

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

Изправност на устройството

Общ преглед на изправността

Control Hub съдържа опции за изправност, които позволяват на администраторите да виждат статуса на устройството, заедно с набор от опции за поддръжка. Администраторите могат:

Преглед на текущия статус на устройството
Рестартиране на устройството отдалечено
Изпращане на отчет за проблеми за отстраняване на неизправности
Изтриване на устройството

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

Използвайте тази процедура, за да видите отчет за статуса на устройството от Control Hub. Статусът включва подробности като статус на регистрация, MAC адрес, SIP адрес, IP адрес и сериен номер.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Щракнете върху подходящото устройство.

Рестартиране на устройството

Използвайте тази процедура, за да рестартирате устройство от интерфейса на Control Hub.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Изберете устройство.
4	От падащия списък Действия изберете Рестартиране.

Съобщаване за проблем

Ако срещнете проблеми с устройство, използвайте тази процедура, за да изпратите на Cisco TAC отчет за проблеми за отстраняване на неизправности.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Щракнете върху приложимото устройство.
4	От Действия изберете Съобщаване за проблем.
5	Прегледайте резюмето на отчета.

Изтриване на устройство

Използвайте тази процедура, за да изтриете устройство от Control Hub.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Изберете приложимото устройство.
4	От падащия списък Действия изберете Изтриване.

Промяна на собственика на устройството

Използвайте тази процедура, за да преместите съществуващо устройство, което е било включено с помощта на кодове за активиране, към нов собственик на устройството.

Тази процедура приема, че опцията Разрешаване на код за активиране е активирана за Самоличност/Профил на устройство , която това устройство използва.

1

Изтрийте съществуващата регистрация на устройство от Webex:

В Webex Control Hub отворете клиентската организация, към която принадлежи текущият собственик на устройството.
Под Управление щракнете върху Устройства.
Поставете отметка в квадратчето, което е в близост до устройството, което искате да преместите.
Щракнете върху Изтрий.

Регистрацията на устройството изтрива от Webex.

2

В BroadWorks деактивирайте регистрирането на устройства за съществуващия потребител:

В BroadWorks CommPilot отворете Самоличност/профил на устройство , който устройството използва.
Щракнете върху раздела Активиране на устройство .
Щракнете върху Деактивиране на устройство.

Устройството деактивира и дерегистрира от BroadWorks. MAC адресът се изтрива от старата конфигурация за самоличност/профил на устройство .

3

В BroadWorks активирайте устройството, като използвате кода за активиране от различна самоличност/профил на устройство , използван от друг потребител:

В BroadWorks CommPilot отворете различна конфигурация за самоличност/профил на устройство за друг потребител.
Уверете се, че Разрешаване на код за активиране е отметнато за използвания тип самоличност/профил на устройство .
В прозореца Профил на самоличност/устройство щракнете върху раздела Активиране на устройство .
Щракнете върху Искане на код за активиране.

Показва се новият код за активиране. Новият потребител трябва да въведе този код, за да се включи в устройството.

Какво да направите след това

Новият собственик на устройството въвежда кода за активиране на устройството.
Устройството се регистрира отново както в Webex, така и в BroadWorks с помощта на новата конфигурация. Новият профил за самоличност/устройство в BroadWorks се актуализира автоматично с MAC адреса на устройството.

Наблюдение на изпълнението

За тази функция съществуват следните броячи за производителност.

Брояч	Описание
Модул: enterprises.broadsoft.broadworks.deviceАктивиране.активиране
bwDASActivateRequests	Броят на общия брой получени заявки за активиране. Това включва активиране на искания на BroadWorks и активиране на искания на Webex.
bwDASActivateFailures	Общият брой заявки за активиране, които не са завършили успешно. Това включва заявки за активиране на BroadWorks, които са неуспешни, и заявки за Webex, които са неуспешни.
bwDASActivateBroadworksRequests	Броят получени заявки за активиране на BroadWorks.
bwDASActivateBroadWorksFailures	Брой заявки за активиране на BroadWorks, които не са завършили успешно. Този брояч не отчита грешките при удостоверяване.
bwDASActivateWebexRequests	Броят получени заявки за активиране на Webex.
bwDASActivateWebexFailures	Брой заявки за активиране на Webex, които не са завършили успешно.
Модул: enterprises.broadsoft.broadworks.dms.dmBridge
bwDMBridgeRequests	Брой изпратени заявки от DMBridge.
bwDMBridgeFailures	Брой заявки от DMBridge, които не са завършили успешно.

Функции на крайните потребители за интегрирани устройства с Webex

Унифицирана хронология на обажданията

MPP телефони с Webex Aware

Webex Aware Cisco MPP устройства в платформата Webex за BroadWorks вече ще могат да показват единна хронология на повикванията за повиквания, извършени/получени от клиента на Webex на потребителя и неговите устройства. Това позволява подобрена среда за работа на крайните потребители, тъй като те могат да наблюдават и използват повикванията, извършени/получени чрез приложението си Webex чрез регистри на повикванията на техните MPP устройства, заедно с всички локални повиквания, обработени на устройството им.

Обединената история на обажданията на Webex ще бъде източникът по подразбиране за преглед на историята на обажданията на потребителя. Тази история на обажданията съдържа обаждания, направени от всички телефони, Webex Video Devices или Webex App.

Засегнати модели на 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:

Broadworks – тази функция зависи от съответните корекции на BroadWorks, които се инсталират. Подробностите могат да бъдат намерени тук.
Устройство – трябва да се приложат най-новите MPP конфигурации. Задължителни комплекти за CPE могат да бъдат намерени тук (влизане с ИД на CCO).

Очаквания/въздействия/ограничения:

Основна линия (само за текущи потребители)
- Единна хронология на повикванията ще се поддържа, както е посочено.
- Поддръжка защита на поверителността – Защита/скриване на хронологията на повикванията, когато е зададена потребителска парола.
- Ако телефонът не е наясно с облака, ще се показва само „локалната хронология“ на повикванията към и от това устройство.
Други линии (споделени или други)
- Ще се поддържа само локална хронология на повикванията към и от устройство.
Устройства в работната област
- Единна хронология на повикванията няма да се поддържа в този екземпляр.

Когато функцията е включена, цялата локална хронология на повикванията на MPP (извлечена от BroadWorks) ще бъде изтрита.

Webex за интегрирани устройства с RoomOS на BroadWorks

Интегрираните устройства Cisco RoomOS Webex за BroadWorks вече ще могат да показват единна хронология на повикванията за повиквания, извършени/получени от клиента на Webex на потребителя и неговите устройства. Това позволява подобрена среда за работа на крайните потребители, тъй като те могат да наблюдават и използват повикванията, извършени/получени чрез приложението си Webex чрез регистри на повикванията на устройствата си RoomOS, както и всички локални повиквания, обработвани на устройствата им.

Обединената история на обажданията на Webex ще бъде източникът по подразбиране за преглед на историята на обажданията на потребителя. Тази история на обажданията съдържа обаждания, направени от всички телефони, Webex Video Devices или Webex App.

Налично на моделите устройства RoomOS по-долу:

Устройства с RoomOS
Серия бюро: Бюро, Бюро Мини, Бюро Pro
Серия Room
Серия RoomKit
Уебекс борд серия

Разрешаване на функции:

Интеграцията на устройства с Webex за BroadWorks трябва да бъде внедрена и функционална за устройствата с RoomOS. Повече подробности можете да намерите в това ръководство Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Изисквания за корекция и DTAF:

Broadworks – тази функция зависи от съответните корекции на BroadWorks, които се инсталират. Подробностите могат да бъдат намерени тук.

Изисквания за конфигуриране:

Конфигурациите по-долу трябва да бъдат зададени, както е указано
- Конфигурация на BWKS: Feature_Toggle_Webex_Call=Да

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

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

Налично на моделите устройства RoomOS по-долу:

Устройства с RoomOS
Серия бюро: Бюро, Бюро Мини, Бюро Pro
Серия Room
Серия RoomKit
Уебекс борд серия

Разрешаване на функции:

Интеграцията на устройства с Webex за BroadWorks трябва да бъде внедрена и функционална за MPP устройства. Повече подробности можете да намерите в това ръководство Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Изисквания за конфигуриране:

Превключвателят за услуга за указател „xConfiguration Webex DirectoryServiceSupport“ трябва да бъде активиран на Устройството.

Въведение

Относно това ръководство

Този документ е предназначен за администратори на партньори в организации на доставчици на услуги, които разгръщат Webex за Cisco BroadWorks. Ръководството описва как да включите и обслужвате Room OS и MPP устройства за Webex за Cisco BroadWorks. Ръководството е разделено на две глави:

Включване на устройства— Описва как да се включат устройства Room OS (серия Room и Room Kit, серия Desk и серия Board) и MPP устройства към Webex за Cisco BroadWorks.
Изправност на устройството – описва как да управлявате вградени устройства в Control Hub.

Интегриране на устройства за Webex за Cisco BroadWorks

Общ преглед на включването на устройства

Тази глава описва как да се включат устройства в Webex за Cisco BroadWorks. Тази глава обхваща следните случаи на използване:

Включване на нови устройства за операционна система Webex Room (с използване на кодове за активиране)
Включване на нови MPP устройства
Добавяне на възможност за Webex към съществуващи MPP устройства

Препоръчахме да разположите тази функция на независими от версията ADP сървъри. Въпреки това, XSP поддържа и тази функция. Ако използвате XSP, тогава когато този документ се отнася до "ADP", можете да замените "XSP", освен ако текстът не посочва само ADP.
Тази функция поддържа устройства в персоналната област и в работната област.

Включване в операционна система Room

Webex за Cisco BroadWorks поддържа включване на код за активиране както за споделени, така и за устройства с операционна система Room за работна област.

Включване на устройство с кодове за активиране

Включването на устройства с кодове за активиране осигурява прост и защитен начин за включване на устройства с Room OS. Кодът за активиране представлява 16-цифрена еднократна генерирана от системата парола, която потребителят трябва да въведе на устройство, за да се включи в устройството. Кодът за активиране е сигурно свързан със съответния потребителски акаунт и гарантира, че само предвиденият потребител включва устройство, свързано със същия акаунт. След като потребителят въведе правилния код, устройството се свързва както с Webex, така и с BroadWorks, завършва регистрацията, изтегля своя конфигурационен файл и е готово за използване.

Следните устройства с операционна система Room поддържат включване с кодове за активиране:

Серия Webex Board (Room OS)
Серия Webex Desk (Room OS)
Серия стаи на Webex (Room OS)

Процес на включване за Room OS

Следният процес показва какво се случва, когато устройство с Room OS се включи с помощта на кодове за активиране:

Администраторът на партньора осигурява основния потребител и устройство в BroadWorks и след това генерира кода за активиране в BroadWorks.
Имейл, който съдържа кода за активиране на устройството, се изпраща на собственика на устройството.
Собственикът на устройството стартира устройството.
Устройството подканва собственика на устройството да въведе кода за активиране.
Собственикът на устройството въвежда кода за активиране на устройството.
Устройството се включва в BroadWorks и Webex с помощта на следния подпроцес:
- Устройството Room OS изпраща заявка за активиране на услугите на Webex. Кодът за активиране се проверява от GDS и ако кодът е правилен, устройството се включва в Webex. Webex връща маркер на машината на устройството.
- Устройството изпраща заявка за активиране до DM на BroadWorks заедно с маркера на машината и MAC адреса.
- BroadWorks упълномощава и включва устройството.
- Устройството изпраща искане до BroadWorks DM за актуализирана конфигурация. Маркерът на машината е включен за упълномощаване.
- BroadWorks упълномощава маркера, намира актуализирания конфигурационен файл и връща актуализирания конфигурационен файл.
- Room OS ще се опита да намери NAPTR запис за домейна, посочен в конфигурационния файл, тъй като очаква да намери SRV запис за _sip._tls.<domain_in_config> Ако няма NAPTR запис, RoomOS ще опита и ще потърси SRV запис, последван съответно от A запис.
  
  SRV записът трябва да е _sip._tls. тъй като roomOS ще поддържа само TLS за транспорт и SRTP за мултимедия.
Устройството се регистрира и е готово за използване.

Следващата схема предоставя опростен общ преглед на процеса на включване.

За подробна информация за включването на операционна система Room, включително по-подробни диаграми на потоци, вижте описанието на функцията Подобрения в Cisco BroadWorks за включване на устройство с Webex-Aware.

Удостоверяване на устройство (чрез маркери за OAuth носител)

Удостоверяването на устройства за устройства за Room OS изисква да активирате Cisco OAuth Bearer Tokens в BroadWorks. По време на включването маркерът за носител се предава чрез заглавката за активиране на упълномощаване и служи за идентифициране на устройството. IdP валидира маркера на носител и връща UUID (машинен UUID за устройства в работната област или потребителски UUID за лични устройства) като тема носител. BroadWorks записва UUID като име на устройство в мрежовия сървър.

Изисквания за Room OS

Минимална версия на операционна система за стая

Стая 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 (независимо от версията)

Изисквания за конфигуриране на BroadWorks

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

При конфигуриране на поточно осигуряване не е задължително да се използва поточно осигуряване за осигуряване на потребителите, т.е. можете да продължите да използвате съществуващите си методи за осигуряване (API, доверен/ненадежден имейл, личност на потребителя и т.н.) за осигуряване на потребители. Вижте „Изисквания за осигуряване“ в ръководството за решение Webex за Cisco BroadWorks.
Уверете се, че интегрираната IM+P услуга е разрешена в BroadWorks и насочва към моста за обезпечаване на BroadWorks.

URL адресът на моста за обезпечаване е зададен, когато към организацията е приложен шаблонът за клиент. Това трябваше да е завършено по време на първоначалната ви настройка на Webex за Cisco BroadWorks. За да намерите съществуващия URL адрес в Partner Hub, вижте Конфигуриране на сървър за приложения с URL адрес на услугата за обезпечаване в ръководството за решение Webex за Cisco BroadWorks.
Ако имате няколко партньорски организации, изисквате специализиран екземпляр на услугата за управление на устройства (DMS) за всеки партньор.

Изисквания за код за активиране при включване с Room OS

Уверете се, че е зададено следното:

Разположете услугата за активиране на устройства в BroadWorks. За подробности вижте Защитено включване в Cisco BroadWorks с помощта на кодове за активиране.
Проверете дали настройката за DAS URL адрес за клъстера на BroadWorks е зададена на URL адреса на услугите за управление на устройства (DMS). За да видите текущата настройка за DAS URL адрес в Partner Hub, отидете на Настройки > BroadWorks Calling > Преглед на клъстери и изберете подходящия клъстер. URL адресът се показва под Настройки на интерфейса.

Ако в клъстера на BroadWorks има много клиенти (>50), възможността за добавяне на URL адреса за DAS не се поддържа. В такива случаи се препоръчва да се свържете с инженер по поддръжката на Cisco TAC за съдействие.

Следните функции на BroadWorks трябва да бъдат активирани в AS:

101377 подобрения за включване на Webex и MPP устройства
25088 Слушалки за поддръжка за DECT устройства
24104 Поддръжка на многоклетъчна верижна верига за DECT устройства
20077 подобрения в управлението на устройства
19559 Подобрения в управлението на визуални устройства
02283 Подобрения в персонализирането на профила на устройството

Например изпълнете следната команда, за да разрешите 101377. Променете номера на компонента, когато активирате другите функции: AS_CLI/System/ActivatableFeature> activate 101377

Ако всички изброени корекции са инсталирани и функция, която може да се активира, не е посочена за вашето конкретно издание на AS, това е така, защото вече е включена във вашето базово издание на AS и не изисква активиране.

Изпълнете следната CLI команда на мрежовия сървър:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Уверете се, че сертифициращият орган, който подписва вашия SBC сертификат, е посочен в надеждния списък на Room OS. Можете да прегледате надеждния списък на операционната система Room от уеб портала за устройства. В портала изберете Защита > Край на сътрудничеството , за да видите списъка на СО.

Поток за включване на операционна система Room

Изпълнете следните задачи, за да конфигурирате системата си да поддържа включване на устройства с кодове за активиране за следните устройства Webex Room OS:

Серия платки Webex
Серия бюро Webex
Серия стаи Webex

1	Конфигуриране на услуги за Room OS Конфигурирайте поддръжка на BroadWorks за устройства с Room OS.
2	Осигуряване на устройства с операционна система Room Осигурете новото устройство в BroadWorks.
3	Заявка за код за активиране В профила на устройството заявете код за активиране. Кодът ще бъде изпратен автоматично по имейл на основния потребител.

Конфигуриране на услуги за Room OS

Преди да можете да включите нови устройства за операционна система Room, задайте следните параметри на системно ниво, за да включите удостоверяването с OAuth.

1

Подайте заявка за услуга с агента за включване или със Cisco TAC, за да осигурите Cisco OAuth за вашия акаунт за федериране на Cisco Identity Provider. Дайте име на заявката си за услуга „ADP AuthService Configuration“.

Ако вече сте получили идентификационни данни за Cisco OAuth Identity Provider, използвайки един от потоците в този документ, няма нужда да създавате ново искане. Ако обаче сте получили идентификационни данни за Cisco OAuth с използване на поток, който не е в този документ, попълнете нова заявка за услуга, за да актуализирате идентификационните си данни.

Cisco ви дава OAuth клиент ID, клиент тайна и опресняване маркер, който е валиден за 60 дни. Ако маркерът изтече, преди да го използвате с вашия ADP, можете да изпратите друга заявка.

2

Активирайте OAuth, като използвате командата CLI:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth> set enable true

3

Уверете се, че обхватът на OAuth включва Broadworks-connector-user (обхватът е активиран по подразбиране). Изпълнете тази команда, за да проверите скобите си:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth/Scopes> get

4

Конфигурирайте параметрите на доставчика на самоличност на Cisco с помощта на командите на CLI по-долу.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> set enabled false

set clientId —вижте отговора на заявката за услуга за ИД.
set clientSecret —вижте отговора на заявката за услуга за тайна.
set issuerName —вижте следната таблица за URL адрес.
set issuerUrl —вижте следната таблица за URL адрес.
set tokenInfoUrl —вижте следните таблици за URL адрес.
set ciResponseBodyMaxSizeInBytes 65536

Таблица 1. Задаване на issuerName и issuerURL
Ако CI клъстер е...	Задаване на issuerName и issuerURL на...
US-A	https://idbroker.webex.com/idb
ЕС	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ако не знаете своя CI клъстер, можете да получите информацията от подробностите за клиента в изгледа „Помощен център“ на Control Hub.

Таблица 2. Задаване на маркерInfoURL
Ако "Отбори Клъстър" е...	Задаване на маркерInfoURL на...(IdP прокси URL)
ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
АФРА	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Ако не знаете своя клъстер на Teams, можете да получите информацията от подробностите за клиента в изгледа „Помощен център“ на Control Hub. За тестване можете да потвърдите, че tokenInfoURL е валиден, като замените частта „`idp/authenticate`“ от URL адреса с „`ping`“.

5

Конфигурирайте доставчиците на самоличност за Cisco Federation с помощта на следните команди:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> add FederationPartner refreshToken

New Password:

Re-type New Password:

...Done

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> get

Partner Name Refresh Token

==================================

FederationPartner ********

1 entry found.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set partnerName FederationPartner

Маркерът за обновяване вече е в контекста на CiscoIdentityProvider/Partners и partnerName от контекста на CiscoIdentityProvider/Federation трябва да съответства на партньора, добавен в контекста на CiscoIdentityProvider/Partners.

Ако изпълнявате ADP RI зареждане, по-старо от 2022.10, R23 XSP без корекция AP.xsp.23.0.1075.ap383838 или R22 XSP, тогава:

Не е необходимо да задавате партньор в „System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>“
Маркерът за обновяване трябва да бъде зададен в: System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Федериране>

6

Изчистете всички съществуващи скоби в следните три контексти под ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

Scopes
Admin/RolesAllowed
Admin/ScopesAllowed

За всеки контекст стартирайте, get за да получите съществуващите скоби и след това ги изтрийте. Например:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Scopes> get
   delete 
   delete

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/RolesAllowed> get
   delete 
   delete

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/ScopesAllowed> get
   delete 
   delete

Осигуряване на устройства с операционна система Room

В BroadWorks осигурете устройството Room OS (серия Webex Board, серия Webex Desk или серия Webex Room).

1	В BroadWorks CommPilot проверете конфигурацията на Самоличност/Тип профил на устройство , за да видите дали съществува типът устройство за това устройство с Room OS. Ако типът устройство не съществува в BroadWorks, импортирайте типа устройство в BroadWorks, като използвате DTAF файл, който можете да изтеглите от cisco.com.
2	След като импортирате типа устройство, се уверете, че в конфигурацията за Самоличност/Тип на профила на устройството съществуват следните настройки: Поставете отметка в квадратчето Разрешаване на код за активиране Поставете отметка в квадратчето Изпращане на заявка за код за активиране през сървъра за съобщения . Задайте режим на удостоверяване на носител.
3	Потвърдете, че файлът с профила на устройството има настройките за SIP, които искате да използвате. Във файла с тип профил на самоличност/устройство се уверете, че режимът на удостоверяване е носител.
4	Създайте профил на устройството с настройките за новото си устройство. На страницата Добавяне/промяна на профил на устройство оставете полето за MAC адрес празно.
5	Конфигуриране на основния потребител. На страницата Добавяне на потребители отметнете или премахнете отметката от isPlace в зависимост от това дали възнамерявате устройството да е лично, или за споделена работна област. Отметнато – устройство в работната област Неотметнато – Лично устройство Споделените устройства за работна област също изискват да зададете основен потребител. Можете да зададете желания основен потребител.
6	Попълнете опцията, която съответства на типа устройство и метода на обезпечаване, който искате да използвате: Устройството е за споделена работна област – използвайте Осигуряване на API за работна област на BroadWorks , за да завършите осигуряването за устройството на работната област. Устройството е лично; искате да осигурите чрез публични API – използвайте Осигуряване на API за абонати на BroadWorks , за да завършите осигуряването за основния потребител. Устройството е лично; искате потребителите да използват самостоятелно активиране – пренасочете URL адреса на портала за активиране на потребители към потребителя. Потребителят трябва да потвърди имейл адреса си, за да завърши осигуряването. Устройството е лично; искате да използвате поточно осигуряване – отидете на стъпка 7.
7	Ако устройството е за лична употреба и искате да използвате поточно обезпечаване, тогава за основния потребител задайте интегрираната IM+P услуга. На страницата Потребител > Профил добавете услугата IM+P: От страницата Профил щракнете върху Задаване на услуги. В списъка с Налични услуги изберете Интегриран IM&P и използвайте стрелката, за да преместите елемента в полето Потребителски услуги . Щракнете върху OK. Щракнете върху Профил. Само поток на надеждни имейли. Добавете имейл адреса на потребителя. Тази настройка служи като имейл за IM&P за поточно осигуряване на Webex за Cisco BroadWorks. Това не е задължително, ако използвате ненадежден имейл поток. Шаблонът на клиент в Webex трябва да се конфигурира с настройки за поточно осигуряване с надеждни имейли или ненадеждни имейли. За подробности вижте Напътствия за решението Webex за Cisco BroadWorks.

Какво да направите след това

Поискайте код за активиране за устройството Room OS.

Заявка за код за активиране

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

1	На страницата Самоличност/Профил на устройство потърсете и отворете профила на устройството за новото си устройство.
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 вижте описанието на функцията Подобрения в DMS на Cisco BroadWorks за активиране на 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 (независимо от версията)

Изисквания за конфигуриране на BroadWorks

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

При конфигуриране на поточно осигуряване не е задължително да се използва поточно осигуряване за осигуряване на потребителите, т.е. можете да продължите да използвате съществуващите си методи за осигуряване (API, доверен/ненадежден имейл, личност на потребителя и т.н.) за осигуряване на потребители. Вижте „Изисквания за осигуряване“ в ръководството за решение Webex за Cisco BroadWorks.
Уверете се, че интегрираната IM+P услуга е разрешена в BroadWorks и насочва към моста за обезпечаване на BroadWorks.

URL адресът на моста за обезпечаване е зададен, когато към организацията е приложен шаблонът за клиент. Това трябваше да е завършено по време на първоначалната ви настройка на Webex за Cisco BroadWorks. За да намерите съществуващия URL адрес в Partner Hub, вижте Конфигуриране на сървър за приложения с URL адрес на услугата за обезпечаване в ръководството за решение Webex за Cisco BroadWorks.
Ако имате няколко партньорски организации, изисквате специализиран екземпляр на услугата за управление на устройства (DMS) за всеки партньор.

Сертификати и защитни стени

Уверете се, че сте конфигурирали следното:

Изисквания за сертификата – MPP устройствата използват удостоверяване с mTLS при използване на сертификата на устройството. MAC адресът на устройството, който сертификатът предоставя, удостоверява устройството. Изтеглете необходимите сертификати за вашето MPP устройство от https://www.cisco.com/security/pki/.
- Cisco Root CA 2048 (crca2048) – PEM
- Корневи Cisco CA 2099 (crca2099) – PEM
- Cisco Root CA M1 (crcam1) – PEM
- Cisco Root CA M2 (crcam2) - CER
- Cisco Manufacturing CA (CMCA) - PEM
- Cisco Manufacturing CA (CMCA2) - PEM
- Cisco Manufacturing CA III (cmca3) – PEM
Качете сертификатите си, за да установите доверие в ADP или защитната стена. Например, ако се качвате в ADP, използвайте тази команда:

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts/updateTrust>
Изисквания за защитната стена – ако 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> activate 101377

Ако всички изброени корекции са инсталирани и функция, която може да се активира, не е посочена за вашето конкретно издание на AS, това е така, защото вече е включена във вашето базово издание на AS и не изисква активиране.

Изпълнете следния CLI на мрежовия сървър:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Изисквания за код за активиране

По желание Кодовете за активиране не са задължителни за включване на MPP устройство. Посочете, ако искате да използвате кодове за активиране, вижте Заявка за код за активиране за MPP за допълнителни изисквания, които са специфични за кодовете за активиране с MPP.

Поток за включване на MPP устройство

Изпълнете следните задачи, за да конфигурирате системата си да поддържа включване на MPP устройство в Webex за Cisco BroadWorks.

Ако добавяте възможности за Webex към MPP устройство, което вече съществува в BroadWorks, изпълнете само стъпки 1 и 2.

1	Конфигуриране на услуги за MPP (Нови или съществуващи MPP устройства). Конфигурирайте системна поддръжка за MPP в Webex за Cisco BroadWorks.
2	Надстройване на фърмуера на MPP устройството (Съществуващи MPP устройства). За всички съществуващи MPP устройства, за които искате да добавите възможност за Webex, надстройте до най-новия фърмуер на устройството.
3	Осигуряване на MPP устройство (Само за нови MPP устройства). Ако устройството не съществува в BroadWorks, осигурете устройството и основния потребител в BroadWorks.
4	Заявка за код за активиране за MPP (По избор). Ако искате да използвате кодове за активиране за включване на MPP устройства, поискайте код за активиране.

Конфигуриране на услуги за MPP

Актуализирайте системните си настройки на BroadWorks, за да поддържате MPP устройства (нови или съществуващи) в Webex за Cisco BroadWorks. Изпълнете тази стъпка само веднъж. Не е необходимо да повтаряте тази процедура за всяко MPP устройство.

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

Ако ADP е зад защитна стена, защитната стена трябва да бъде конфигурирана с правило за извличане на MAC адреса от сертификата на устройството и за поставяне в заглавка за удостоверяване, която след това се препраща към ADP. Например моделът на самоличност може да .*([0-9a-fA-F]{12}).* се използва за извличане на MAC адреса, който след това може да бъде поставен в заглавка, която използва описателно име (например macaddress).

Вижте документацията на защитната стена за помощ с конфигурациите.

1

Подайте заявка за услуга с агента за включване или със Cisco TAC, за да осигурите Cisco OAuth за вашия акаунт за федериране на Cisco Identity Provider. Използвайте \„ADP AuthService Configuration\“, за да заглавието на заявката си.

Cisco ви дава OAuth клиент ID, клиент тайна и опресняване маркер, който е валиден за 60 дни. Ако маркерът изтече, преди да го използвате с вашия ADP, можете да изпратите друга заявка.

Ако вече сте получили идентификационни данни за Cisco OAuth Identity Provider, използвайки един от потоците в този документ, няма нужда да създавате ново искане. Ако обаче сте получили идентификационни данни за Cisco OAuth с използване на поток, който не е в този документ, попълнете нова заявка за услуга, за да актуализирате идентификационните си данни.

2

Конфигурирайте параметрите на доставчика на самоличност на Cisco чрез изпълнение на следните CLI команди.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> set enabled false

set clientId —вижте отговора на заявката за услуга за ИД.
set clientSecret —вижте отговора на заявката за услуга за тайна.
set issuerName —вижте следната таблица за URL адрес.
set issuerUrl —вижте следната таблица за URL адрес.
set ciResponseBodyMaxSizeInBytes 65536

Таблица 3. Задаване на issuerName и issuerURL
Ако CI клъстер е...	Задаване на issuerName и issuerURL на...
US-A	https://idbroker.webex.com/idb
ЕС	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ако не знаете своя CI клъстер, можете да получите информацията от подробностите за клиента в изгледа „Помощен център“ на Control Hub.

3

Задайте URL адреса на DM моста, като използвате командата CLI по-долу. URL адресът на DM Bridge е различен за всеки клъстер на Teams (който сте изтеглили в стъпка 2).

ADP_CLI/Applications/BroadworksDms/DeviceActivation/DMBridge> set
url = 
scope = dm-bridge:device_auth

Таблица 4. URL адрес на _DM мост
Ако "Отбори Клъстър" е...	Задаване на URL адрес на_DM мост на...
ACHM	dm-bridge-a.wbx2.com
AORE	dm-bridge-r.wbx2.com
АФРА	dm-bridge-k.wbx2.com

4

Активирайте извличането и удостоверяването на MAC адреси чрез заглавката за удостоверяване или сертификата за удостоверяване. Поради съображения за защита препоръчваме да използвате само една от опциите:

Заглавка за удостоверяване – ако ADP е зад защитна стена, използвайте CLI на ADP, за да активирате извличането на MAC адрес за заглавката за удостоверяване. Тази конфигурация дава на ADP възможност да разпознае MAC адреса от заглавката за удостоверяване. Например:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> set enable true

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> set identityPattern "macaddress:.*([0-9a-fA-F]{12}).*"

В този пример macaddress е зададено име с .*([0-9a-fA-F]{12}).* представяне на модела, който се присвоява на заглавката. Ако наричате заглавката нещо различно от macaddress, коригирайте съответно CLI.
Сертификат за удостоверяване – ако ADP не е зад защитна стена, удостоверяване възниква директно между устройството и ADP. Използвайте командите на CLI по-долу, за да разрешите извличането на MAC адрес на сертификата на устройството за удостоверяване:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> set enable true

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> set identityPattern ".*([0-9a-fA-F]{12}).*"

Надстройване на фърмуера на MPP устройството

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

Уверете се, че BroadWorks е актуализиран с поддръжка на услуги за MPP.

Надстройте фърмуера на устройството до най-новата версия, за да сте сигурни, че MPP устройството поддържа възможностите на Webex.

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

Какво да направите след това

Съществуващи MPP устройства – след надстройването устройството се включва автоматично в Webex. Потребителят може да започне да използва услугите на Webex на устройството.
Нови MPP устройства—Осигуряване на новото MPP устройство в BroadWorks.

Осигуряване на MPP устройство

Ако новото MPP устройство не съществува в BroadWorks, осигурете устройството в BroadWorks.

1	В BroadWorks CommPilot проверете конфигурацията на Самоличност/Тип профил на устройство , за да видите дали съществува типът устройство за това MPP устройство. Ако типът устройство не съществува в BroadWorks, импортирайте типа устройство в BroadWorks, като използвате DTAF файл, изтеглен от cisco.com.
2	В BroadWorks CommPilot отворете Самоличност/Тип профил на устройство и поставете отметка в квадратчето Разрешаване на код за активиране .
3	Създайте файл за самоличност/тип на профила на устройството с настройките за SIP, които искате да използвате.
4	Създайте профил на самоличност/устройство с настройки за новото си устройство. В полето MAC адрес въведете MAC адреса на устройството. Ако използвате кодове за активиране за включване на MPP устройства, оставете полето MAC адрес празно.
5	Конфигуриране на основния потребител. На страницата Добавяне на потребители поставете отметка в квадратчето isPlace в зависимост от това дали устройството е лично, или за споделена работна област: Отметнато – устройство в работната област Неотметнато – Лично устройство
6	Попълнете опцията, която съответства на типа устройство и метода на обезпечаване, който искате да използвате: Устройството е за споделена работна област – използвайте Осигуряване на API за работна област на BroadWorks , за да завършите осигуряването за устройството на работната област. Устройството е лично; искате да осигурите чрез публични API – използвайте Осигуряване на API за абонати на BroadWorks , за да завършите осигуряването за основния потребител. Устройството е лично; искате потребителите да използват самостоятелно активиране – пренасочете URL адреса на портала за активиране на потребители към потребителя. Потребителят трябва да потвърди имейл адреса си, за да завърши осигуряването. Устройството е лично; искате да използвате поточно осигуряване – отидете на стъпка 7.
7	Ако устройството е за лична употреба и искате да използвате поточно обезпечаване, тогава за основния потребител задайте интегрираната IM+P услуга. На страницата Потребител > Профил добавете услугата IM+P: От страницата Профил щракнете върху Задаване на услуги. В списъка с Налични услуги изберете Интегриран IM&P и използвайте стрелката, за да преместите елемента в полето Потребителски услуги . Щракнете върху OK. Щракнете върху Профил. Само поток на надеждни имейли. Добавете имейл адреса на потребителя. Тази настройка служи като имейл за IM&P за поточно осигуряване на Webex за Cisco BroadWorks. Това не е задължително, ако използвате ненадежден имейл поток. Шаблонът на клиент в Webex трябва да се конфигурира с настройки за поточно осигуряване с надеждни имейли или ненадеждни имейли. За подробности вижте Напътствия за решението Webex за Cisco BroadWorks.

Какво да направите след това

По желание Ако искате да използвате кодове за активиране за включване на MPP устройства, поискайте кода за активиране в BroadWorks.

Заявка за код за активиране за MPP

(По избор) Webex за Cisco BroadWorks не изисква кодове за активиране за включването на нови MPP устройства. Ако обаче решите да използвате кодове за активиране, изпълнете процедурата Искане на код за активиране , за да поискате код за активиране за ново устройство.

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

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

Услуга за активиране на устройство— Изпълнете следните изисквания, за да разрешите услугата за активиране на устройство:

Разположете услугата за активиране на устройства в BroadWorks. За подробности вижте Защитено включване в Cisco BroadWorks с помощта на кодове за активиране.
Насочете услугата за активиране на устройства (DAS) към услугите за управление на устройства (DMS) в BroadWorks КАТО използвате следната команда CLI:

AS_CLI/Interface/DAS> set url
Проверете дали настройката за DAS URL адрес за клъстера на BroadWorks е зададена на URL адреса на услугите за управление на устройства (DMS). За да видите текущата настройка за DAS URL адрес в Partner Hub, отидете на Настройки > BroadWorks Calling > Преглед на клъстери и изберете подходящия клъстер. URL адресът се показва под Настройки на интерфейса.

Ако в клъстера на BroadWorks има много клиенти (>50), възможността за добавяне на 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> get
  set gdsDomain  e.g. https://activation.webex.com
  set clientId 
  clientSecret 
  refreshToken

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

Заявка за код за активиране

Изпълнете следните стъпки, за да поискате код за активиране на ново MPP устройство.

На страницата Самоличност/Профил на устройство потърсете и отворете профила на устройството за новото си устройство.
Щракнете върху раздела Активиране на устройство .
Щракнете върху Искане на код за активиране.

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

Изправност на устройството

Общ преглед на изправността

Control Hub съдържа опции за изправност, които позволяват на администраторите да виждат статуса на устройството, заедно с набор от опции за поддръжка. Администраторите могат:

Преглед на текущия статус на устройството
Рестартиране на устройството отдалечено
Изпращане на отчет за проблеми за отстраняване на неизправности
Изтриване на устройството

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

Използвайте тази процедура, за да видите отчет за статуса на устройството от Control Hub. Статусът включва подробности като статус на регистрация, MAC адрес, SIP адрес, IP адрес и сериен номер.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Щракнете върху подходящото устройство.

Рестартиране на устройството

Използвайте тази процедура, за да рестартирате устройство от интерфейса на Control Hub.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Изберете устройство.
4	От падащия списък Действия изберете Рестартиране.

Съобщаване за проблем

Ако срещнете проблеми с устройство, използвайте тази процедура, за да изпратите на Cisco TAC отчет за проблеми за отстраняване на неизправности.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Щракнете върху приложимото устройство.
4	От Действия изберете Съобщаване за проблем.
5	Прегледайте резюмето на отчета.

Изтриване на устройство

Използвайте тази процедура, за да изтриете устройство от Control Hub.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Изберете приложимото устройство.
4	От падащия списък Действия изберете Изтриване.

Промяна на собственика на устройството

Използвайте тази процедура, за да преместите съществуващо устройство, което е било включено с помощта на кодове за активиране, към нов собственик на устройството.

Тази процедура приема, че опцията Разрешаване на код за активиране е активирана за Самоличност/Профил на устройство , която това устройство използва.

1

Изтрийте съществуващата регистрация на устройство от Webex:

В Webex Control Hub отворете клиентската организация, към която принадлежи текущият собственик на устройството.
Под Управление щракнете върху Устройства.
Поставете отметка в квадратчето, което е в близост до устройството, което искате да преместите.
Щракнете върху Изтрий.

Регистрацията на устройството изтрива от Webex.

2

В BroadWorks деактивирайте регистрирането на устройства за съществуващия потребител:

В BroadWorks CommPilot отворете Самоличност/профил на устройство , който устройството използва.
Щракнете върху раздела Активиране на устройство .
Щракнете върху Деактивиране на устройство.

Устройството деактивира и дерегистрира от BroadWorks. MAC адресът се изтрива от старата конфигурация за самоличност/профил на устройство .

3

В BroadWorks активирайте устройството, като използвате кода за активиране от различна самоличност/профил на устройство , използван от друг потребител:

В BroadWorks CommPilot отворете различна конфигурация за самоличност/профил на устройство за друг потребител.
Уверете се, че Разрешаване на код за активиране е отметнато за използвания тип самоличност/профил на устройство .
В прозореца Профил на самоличност/устройство щракнете върху раздела Активиране на устройство .
Щракнете върху Искане на код за активиране.

Показва се новият код за активиране. Новият потребител трябва да въведе този код, за да се включи в устройството.

Какво да направите след това

Новият собственик на устройството въвежда кода за активиране на устройството.
Устройството се регистрира отново както в Webex, така и в BroadWorks с помощта на новата конфигурация. Новият профил за самоличност/устройство в BroadWorks се актуализира автоматично с MAC адреса на устройството.

Наблюдение на изпълнението

За тази функция съществуват следните броячи за производителност.

Брояч	Описание
Модул: enterprises.broadsoft.broadworks.deviceАктивиране.активиране
bwDASActivateRequests	Броят на общия брой получени заявки за активиране. Това включва активиране на искания на BroadWorks и активиране на искания на Webex.
bwDASActivateFailures	Общият брой заявки за активиране, които не са завършили успешно. Това включва заявки за активиране на BroadWorks, които са неуспешни, и заявки за Webex, които са неуспешни.
bwDASActivateBroadworksRequests	Броят получени заявки за активиране на BroadWorks.
bwDASActivateBroadWorksFailures	Брой заявки за активиране на BroadWorks, които не са завършили успешно. Този брояч не отчита грешките при удостоверяване.
bwDASActivateWebexRequests	Броят получени заявки за активиране на Webex.
bwDASActivateWebexFailures	Брой заявки за активиране на Webex, които не са завършили успешно.
Модул: enterprises.broadsoft.broadworks.dms.dmBridge
bwDMBridgeRequests	Брой изпратени заявки от DMBridge.
bwDMBridgeFailures	Брой заявки от DMBridge, които не са завършили успешно.

Функции на крайните потребители за интегрирани устройства с Webex

Унифицирана хронология на обажданията

MPP телефони с Webex Aware

Webex Aware Cisco MPP устройства в платформата Webex за BroadWorks вече ще могат да показват единна хронология на повикванията за повиквания, извършени/получени от клиента на Webex на потребителя и неговите устройства. Това позволява подобрена среда за работа на крайните потребители, тъй като те могат да наблюдават и използват повикванията, извършени/получени чрез приложението си Webex чрез регистри на повикванията на техните MPP устройства, заедно с всички локални повиквания, обработени на устройството им.

Обединената история на обажданията на Webex ще бъде източникът по подразбиране за преглед на историята на обажданията на потребителя. Тази история на обажданията съдържа обаждания, направени от всички телефони, Webex Video Devices или Webex App.

Засегнати модели на 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:

Broadworks – тази функция зависи от съответните корекции на BroadWorks, които се инсталират. Подробностите могат да бъдат намерени тук.
Устройство – трябва да се приложат най-новите MPP конфигурации. Задължителни комплекти за CPE могат да бъдат намерени тук (влизане с ИД на CCO).

Очаквания/въздействия/ограничения:

Основна линия (само за текущи потребители)
- Единна хронология на повикванията ще се поддържа, както е посочено.
- Поддръжка защита на поверителността – Защита/скриване на хронологията на повикванията, когато е зададена потребителска парола.
- Ако телефонът не е наясно с облака, ще се показва само „локалната хронология“ на повикванията към и от това устройство.
Други линии (споделени или други)
- Ще се поддържа само локална хронология на повикванията към и от устройство.
Устройства в работната област
- Единна хронология на повикванията няма да се поддържа в този екземпляр.

Когато функцията е включена, цялата локална хронология на повикванията на MPP (извлечена от BroadWorks) ще бъде изтрита.

Webex за интегрирани устройства с RoomOS на BroadWorks

Интегрираните устройства Cisco RoomOS Webex за BroadWorks вече ще могат да показват единна хронология на повикванията за повиквания, извършени/получени от клиента на Webex на потребителя и неговите устройства. Това позволява подобрена среда за работа на крайните потребители, тъй като те могат да наблюдават и използват повикванията, извършени/получени чрез приложението си Webex чрез регистри на повикванията на устройствата си RoomOS, както и всички локални повиквания, обработвани на устройствата им.

Обединената история на обажданията на Webex ще бъде източникът по подразбиране за преглед на историята на обажданията на потребителя. Тази история на обажданията съдържа обаждания, направени от всички телефони, Webex Video Devices или Webex App.

Налично на моделите устройства RoomOS по-долу:

Устройства с RoomOS
Серия бюро: Бюро, Бюро Мини, Бюро Pro
Серия Room
Серия RoomKit
Уебекс борд серия

Разрешаване на функции:

Интеграцията на устройства с Webex за BroadWorks трябва да бъде внедрена и функционална за устройствата с RoomOS. Повече подробности можете да намерите в това ръководство Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Изисквания за корекция и DTAF:

Broadworks – тази функция зависи от съответните корекции на BroadWorks, които се инсталират. Подробностите могат да бъдат намерени тук.

Изисквания за конфигуриране:

Конфигурациите по-долу трябва да бъдат зададени, както е указано
- Конфигурация на BWKS: Feature_Toggle_Webex_Call=Да

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

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

Налично на моделите устройства RoomOS по-долу:

Устройства с RoomOS
Серия бюро: Бюро, Бюро Мини, Бюро Pro
Серия Room
Серия RoomKit
Уебекс борд серия

Разрешаване на функции:

Интеграцията на устройства с Webex за BroadWorks трябва да бъде внедрена и функционална за MPP устройства. Повече подробности можете да намерите в това ръководство Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Изисквания за конфигуриране:

Превключвателят за услуга за указател „xConfiguration Webex DirectoryServiceSupport“ трябва да бъде активиран на Устройството.

Въведение

Относно това ръководство

Този документ е предназначен за администратори на партньори в организации на доставчици на услуги, които разгръщат Webex за Cisco BroadWorks. Ръководството описва как да включите и обслужвате Room OS и MPP устройства за Webex за Cisco BroadWorks. Ръководството е разделено на две глави:

Включване на устройства— Описва как да се включат устройства Room OS (серия Room и Room Kit, серия Desk и серия Board) и MPP устройства към Webex за Cisco BroadWorks.
Изправност на устройството – описва как да управлявате вградени устройства в Control Hub.

Хронология на промените на документи

Следващата таблица обобщава хронологията на промените за този документ.

Дата	Версия на документа	Описание на промяната
12 май 2023 г.	1.7	Добавено е Webex за интегрирани устройства Cisco RoomOS на BroadWorks и подобрения в търсенето на указатели за W4B Integrated RoomOS устройства в раздела Функции на крайния потребител за интегрирани устройства на Webex.
27 февруари 2023 г.	1.6	Актуализирани са стъпките Конфигуриране на услуги за Room OS под Включване на устройство.
17 февруари 2023 г.	1.5	Добавена е секцията Унифицирана хронология на повикванията за MPP телефони, които са наясно с Webex под Функции на крайния потребител за интегрирани устройства с Webex.
октомври 14, 2022	1.4	Актуализиран процес на включване за Room OS в раздела Room OS Onboarding , за да включва SRV записи. Актуализирани са изискванията за конфигуриране на BroadWorks в раздела Изисквания за операционна система Room с показалец към ръководството за решение за изискванията за поточно осигуряване.
20 юни 2022 г.	1.3	Актуализирани са предпоставките за Room OS и предпоставките за MPP устройство с показалец към ръководството за решение за изискванията за поточно осигуряване. Актуализирани са Осигуряване на устройства за операционна система Room и Осигуряване на MPP устройство , за да включват информация за различни методи на осигуряване.
03 юни 2022 г.	1.2	Коригиран номер за активиране на функцията за тип профил на устройството (02283) в предпоставки за Room OS и предпоставки за MPP устройство
май 27, 2022	1.1	Коригирано изискване за специализиран DMS екземпляр на партньорска организация. Добавена е глава Предговор . Актуализирано заглавие като „Ръководство за интеграция на устройства“.
май 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 за работна област.

Включване на устройство с кодове за активиране

Включването на устройства с кодове за активиране осигурява прост и защитен начин за включване на устройства с Room OS. Кодът за активиране представлява 16-цифрена еднократна генерирана от системата парола, която потребителят трябва да въведе на устройство, за да се включи в устройството. Кодът за активиране е сигурно свързан със съответния потребителски акаунт и гарантира, че само предвиденият потребител включва устройство, свързано със същия акаунт. След като потребителят въведе правилния код, устройството се свързва както с Webex, така и с BroadWorks, завършва регистрацията, изтегля своя конфигурационен файл и е готово за използване.

Следните устройства с операционна система Room поддържат включване с кодове за активиране:

Серия Webex Board (Room OS)
Серия Webex Desk (Room OS)
Серия стаи на Webex (Room OS)

Процес на включване за Room OS

Следният процес показва какво се случва, когато устройство с Room OS се включи с помощта на кодове за активиране:

Администраторът на партньора осигурява основния потребител и устройство в BroadWorks и след това генерира кода за активиране в BroadWorks.
Имейл, който съдържа кода за активиране на устройството, се изпраща на собственика на устройството.
Собственикът на устройството стартира устройството.
Устройството подканва собственика на устройството да въведе кода за активиране.
Собственикът на устройството въвежда кода за активиране на устройството.
Устройството се включва в BroadWorks и Webex с помощта на следния подпроцес:
- Устройството Room OS изпраща заявка за активиране на услугите на Webex. Кодът за активиране се проверява от GDS и ако кодът е правилен, устройството се включва в Webex. Webex връща маркер на машината на устройството.
- Устройството изпраща заявка за активиране до DM на BroadWorks заедно с маркера на машината и MAC адреса.
- BroadWorks упълномощава и включва устройството.
- Устройството изпраща искане до BroadWorks DM за актуализирана конфигурация. Маркерът на машината е включен за упълномощаване.
- BroadWorks упълномощава маркера, намира актуализирания конфигурационен файл и връща актуализирания конфигурационен файл.
- Room OS ще се опита да намери NAPTR запис за домейна, посочен в конфигурационния файл, тъй като очаква да намери SRV запис за _sip._tls.<domain_in_config> Ако няма NAPTR запис, RoomOS ще опита и ще потърси SRV запис, последван съответно от A запис.
  
  SRV записът трябва да е _sip._tls. тъй като roomOS ще поддържа само TLS за транспорт и SRTP за мултимедия.
Устройството се регистрира и е готово за използване.

Следващата схема предоставя опростен общ преглед на процеса на включване.

За подробна информация за включването на операционна система Room, включително по-подробни диаграми на потоци, вижте описанието на функцията Подобрения в Cisco BroadWorks за включване на устройство с Webex-Aware.

Удостоверяване на устройство (чрез маркери за OAuth носител)

Удостоверяването на устройства за устройства за Room OS изисква да активирате Cisco OAuth Bearer Tokens в BroadWorks. По време на включването маркерът за носител се предава чрез заглавката за активиране на упълномощаване и служи за идентифициране на устройството. IdP валидира маркера на носител и връща UUID (машинен UUID за устройства в работната област или потребителски UUID за лични устройства) като тема носител. BroadWorks записва UUID като име на устройство в мрежовия сървър.

Изисквания за Room OS

Минимална версия на операционна система за стая

Стая 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 (независимо от версията)

Изисквания за конфигуриране на BroadWorks

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

При конфигуриране на поточно осигуряване не е задължително да се използва поточно осигуряване за осигуряване на потребителите, т.е. можете да продължите да използвате съществуващите си методи за осигуряване (API, доверен/ненадежден имейл, личност на потребителя и т.н.) за осигуряване на потребители. Вижте „Изисквания за осигуряване“ в ръководството за решение Webex за Cisco BroadWorks.
Уверете се, че интегрираната IM+P услуга е разрешена в BroadWorks и насочва към моста за обезпечаване на BroadWorks.

URL адресът на моста за обезпечаване е зададен, когато към организацията е приложен шаблонът за клиент. Това трябваше да е завършено по време на първоначалната ви настройка на Webex за Cisco BroadWorks. За да намерите съществуващия URL адрес в Partner Hub, вижте Конфигуриране на сървър за приложения с URL адрес на услугата за обезпечаване в ръководството за решение Webex за Cisco BroadWorks.
Ако имате няколко партньорски организации, изисквате специализиран екземпляр на услугата за управление на устройства (DMS) за всеки партньор.

Изисквания за код за активиране при включване с Room OS

Уверете се, че е зададено следното:

Разположете услугата за активиране на устройства в BroadWorks. За подробности вижте Защитено включване в Cisco BroadWorks с помощта на кодове за активиране.
Проверете дали настройката за DAS URL адрес за клъстера на BroadWorks е зададена на URL адреса на услугите за управление на устройства (DMS). За да видите текущата настройка за DAS URL адрес в Partner Hub, отидете на Настройки > BroadWorks Calling > Преглед на клъстери и изберете подходящия клъстер. URL адресът се показва под Настройки на интерфейса.

Ако в клъстера на BroadWorks има много клиенти (>50), възможността за добавяне на 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 OS. Можете да прегледате надеждния списък на операционната система Room от уеб портала за устройства. В портала изберете Защита > Край на сътрудничеството , за да видите списъка на СО.

Поток за включване на операционна система Room

Изпълнете следните задачи, за да конфигурирате системата си да поддържа включване на устройства с кодове за активиране за следните устройства Webex Room OS:

Серия платки Webex
Серия бюро Webex
Серия стаи Webex

1	Конфигуриране на услуги за Room OS Конфигурирайте поддръжка на BroadWorks за устройства с Room OS.
2	Осигуряване на устройства с операционна система Room Осигурете новото устройство в BroadWorks.
3	Заявка за код за активиране В профила на устройството заявете код за активиране. Кодът ще бъде изпратен автоматично по имейл на основния потребител.

Конфигуриране на услуги за Room OS

Преди да можете да включите нови устройства за операционна система Room, задайте следните параметри на системно ниво, за да включите удостоверяването с OAuth.

1

Подайте заявка за услуга с агента за включване или със Cisco TAC, за да осигурите Cisco OAuth за вашия акаунт за федериране на Cisco Identity Provider. Дайте име на заявката си за услуга „ADP AuthService Configuration“.

Ако вече сте получили идентификационни данни за Cisco OAuth Identity Provider, използвайки един от потоците в този документ, няма нужда да създавате ново искане. Ако обаче сте получили идентификационни данни за Cisco OAuth с използване на поток, който не е в този документ, попълнете нова заявка за услуга, за да актуализирате идентификационните си данни.

Cisco ви дава OAuth клиент ID, клиент тайна и опресняване маркер, който е валиден за 60 дни. Ако маркерът изтече, преди да го използвате с вашия ADP, можете да изпратите друга заявка.

2

Активирайте OAuth, като използвате командата CLI:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth> задаване на разрешаване на „вярно“

3

Уверете се, че обхватът на OAuth включва Broadworks-connector-user (обхватът е активиран по подразбиране). Изпълнете тази команда, за да проверите скобите си:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth/Scopes> вземане

4

Конфигурирайте параметрите на доставчика на самоличност на Cisco с помощта на командите на CLI по-долу.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> зададе активирано невярно

задайте clientId – вижте отговора на заявката за услуга за ИД.
задаване на clientSecret – вижте отговора на заявката за услуга за тайна.
set issuerName – вижте таблицата по-долу за URL адрес.
задаване на issuerUrl – вижте таблицата по-долу за URL адрес.
задайте tokenInfoUrl <IdPProxy_URL> – вижте таблиците по-долу за URL.
задаване на ciResponseBodyMaxSizeInBytes 65536

Таблица 1. Задаване на issuerName и issuerURL
Ако CI клъстер е...	Задаване на issuerName и issuerURL на...
US-A	https://idbroker.webex.com/idb
ЕС	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ако не знаете своя CI клъстер, можете да получите информацията от подробностите за клиента в изгледа „Помощен център“ на Control Hub.

Таблица 2. Задаване на маркерInfoURL
Ако "Отбори Клъстър" е...	Задаване на маркерInfoURL на...(IdP прокси URL)
ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
АФРА	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Ако не знаете своя клъстер на Teams, можете да получите информацията от подробностите за клиента в изгледа „Помощен център“ на Control Hub. За тестване можете да потвърдите, че tokenInfoURL е валиден, като замените частта „`idp/authenticat`e“ от URL адреса с `„pin`g“.

5

Конфигурирайте доставчиците на самоличност за Cisco Federation с помощта на следните команди:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> добавяне на маркер за обновяване на FederationPartner

Нова парола:

Въведете отново новата парола:

...Готово

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> вземане

Маркер за обновяване на името на партньор

==================================

Партньор на федерацията *******

Намерен е 1 запис.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

задаване на flsUrl https://cifls.webex.com/federation
задаване на refreshPeriodInMinutes 60
задаване на партньорИме на федериранеПартньор

Маркерът за обновяване вече е в контекста на CiscoIdentityProvider/Partners и partnerName от контекста на CiscoIdentityProvider/Federation трябва да съответства на партньора, добавен в контекста на CiscoIdentityProvider/Partners.

Ако изпълнявате ADP RI зареждане, по-старо от 2022.10, R23 XSP без корекция AP.xsp.23.0.1075.ap383838 или R22 XSP, тогава:

Не е необходимо да задавате партньор в „System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>“
Маркерът за обновяване трябва да бъде зададен в: System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Федериране>

6

Изчистете всички съществуващи скоби в следните три контекста под ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

Обхвати
Позволени администраторски/роли
Позволен от администратор/скопи

За всеки контекст изпълнете get , за да получите съществуващите скоби и след това ги изтрийте. Например:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Scopes> получите изтриване на <name_of_scope_1> изтриване на <name_of_scope_2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/RolesAllowed> получите изтриване на <name_of_scope_1> изтриване на <name_of_scope_2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/ScopesAllowed> получите изтриване на <name_of_scope_1> изтриване на <name_of_scope_2>

Осигуряване на устройства с операционна система Room

В BroadWorks осигурете устройството Room OS (серия Webex Board, серия Webex Desk или серия Webex Room).

1	В BroadWorks CommPilot проверете конфигурацията на Самоличност/Тип профил на устройство , за да видите дали съществува типът устройство за това устройство с Room OS. Ако типът устройство не съществува в BroadWorks, импортирайте типа устройство в BroadWorks, като използвате DTAF файл, който можете да изтеглите от cisco.com.
2	След като импортирате типа устройство, се уверете, че в конфигурацията за Самоличност/Тип на профила на устройството съществуват следните настройки: Поставете отметка в квадратчето Разрешаване на код за активиране Поставете отметка в квадратчето Изпращане на заявка за код за активиране през сървъра за съобщения . Задайте режим на удостоверяване на носител.
3	Потвърдете, че файлът с профила на устройството има настройките за SIP, които искате да използвате. Във файла с тип профил на самоличност/устройство се уверете, че режимът на удостоверяване е носител.
4	Създайте профил на устройството с настройките за новото си устройство. На страницата Добавяне/промяна на профил на устройство оставете полето за MAC адрес празно.
5	Конфигуриране на основния потребител. На страницата Добавяне на потребители отметнете или премахнете отметката от isPlace в зависимост от това дали възнамерявате устройството да е лично, или за споделена работна област. Отметнато – устройство в работната област Неотметнато – Лично устройство Споделените устройства за работна област също изискват да зададете основен потребител. Можете да зададете желания основен потребител.
6	Попълнете опцията, която съответства на типа устройство и метода на обезпечаване, който искате да използвате: Устройството е за споделена работна област – използвайте Осигуряване на API за работна област на BroadWorks , за да завършите осигуряването за устройството на работната област. Устройството е лично; искате да осигурите чрез публични API – използвайте Осигуряване на API за абонати на BroadWorks , за да завършите осигуряването за основния потребител. Устройството е лично; искате потребителите да използват самостоятелно активиране – пренасочете URL адреса на портала за активиране на потребители към потребителя. Потребителят трябва да потвърди имейл адреса си, за да завърши осигуряването. Устройството е лично; искате да използвате поточно осигуряване – отидете на стъпка 7.
7	Ако устройството е за лична употреба и искате да използвате поточно обезпечаване, тогава за основния потребител задайте интегрираната IM+P услуга. На страницата Потребител > Профил добавете услугата IM+P: От страницата Профил щракнете върху Задаване на услуги. В списъка с Налични услуги изберете Интегриран IM&P и използвайте стрелката, за да преместите елемента в полето Потребителски услуги . Щракнете върху OK. Щракнете върху Профил. Само поток на надеждни имейли. Добавете имейл адреса на потребителя. Тази настройка служи като имейл за IM&P за поточно осигуряване на Webex за Cisco BroadWorks. Това не е задължително, ако използвате ненадежден имейл поток. Шаблонът на клиент в Webex трябва да се конфигурира с настройки за поточно осигуряване с надеждни имейли или ненадеждни имейли. За подробности вижте Напътствия за решението Webex за Cisco BroadWorks.

Какво да направите след това

Поискайте код за активиране за устройството Room OS.

Заявка за код за активиране

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

1	На страницата Самоличност/Профил на устройство потърсете и отворете профила на устройството за новото си устройство.
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 вижте описанието на функцията Подобрения в DMS на Cisco BroadWorks за активиране на 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 (независимо от версията)

Изисквания за конфигуриране на BroadWorks

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

При конфигуриране на поточно осигуряване не е задължително да се използва поточно осигуряване за осигуряване на потребителите, т.е. можете да продължите да използвате съществуващите си методи за осигуряване (API, доверен/ненадежден имейл, личност на потребителя и т.н.) за осигуряване на потребители. Вижте „Изисквания за осигуряване“ в ръководството за решение Webex за Cisco BroadWorks.
Уверете се, че интегрираната IM+P услуга е разрешена в BroadWorks и насочва към моста за обезпечаване на BroadWorks.

URL адресът на моста за обезпечаване е зададен, когато към организацията е приложен шаблонът за клиент. Това трябваше да е завършено по време на първоначалната ви настройка на Webex за Cisco BroadWorks. За да намерите съществуващия URL адрес в Partner Hub, вижте Конфигуриране на сървър за приложения с 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 устройство. Посочете, ако искате да използвате кодове за активиране, вижте Заявка за код за активиране за MPP за допълнителни изисквания, които са специфични за кодовете за активиране с MPP.

Поток за включване на MPP устройство

Изпълнете следните задачи, за да конфигурирате системата си да поддържа включване на MPP устройство в Webex за Cisco BroadWorks.

Ако добавяте възможности за Webex към MPP устройство, което вече съществува в BroadWorks, изпълнете само стъпки 1 и 2.

1	Конфигуриране на услуги за MPP (Нови или съществуващи MPP устройства). Конфигурирайте системна поддръжка за MPP в Webex за Cisco BroadWorks.
2	Надстройване на фърмуера на MPP устройството (Съществуващи MPP устройства). За всички съществуващи MPP устройства, за които искате да добавите възможност за Webex, надстройте до най-новия фърмуер на устройството.
3	Осигуряване на MPP устройство (Само за нови MPP устройства). Ако устройството не съществува в BroadWorks, осигурете устройството и основния потребител в BroadWorks.
4	Заявка за код за активиране за MPP (По избор). Ако искате да използвате кодове за активиране за включване на MPP устройства, поискайте код за активиране.

Конфигуриране на услуги за MPP

Актуализирайте системните си настройки на BroadWorks, за да поддържате MPP устройства (нови или съществуващи) в Webex за Cisco BroadWorks. Изпълнете тази стъпка само веднъж. Не е необходимо да повтаряте тази процедура за всяко MPP устройство.

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

Ако ADP е зад защитна стена, защитната стена трябва да бъде конфигурирана с правило за извличане на MAC адреса от сертификата на устройството и за поставяне в заглавка за удостоверяване, която след това се препраща към ADP. Например моделът на самоличност .*([0-9a-fA-F]{12}).* може да се използва за извличане на MAC адреса, който след това може да бъде поставен в заглавка, която използва описателно име (например macaddress).

Вижте документацията на защитната стена за помощ с конфигурациите.

1

Подайте заявка за услуга с агента за включване или със Cisco TAC, за да осигурите Cisco OAuth за вашия акаунт за федериране на Cisco Identity Provider. Използвайте \„ADP AuthService Configuration\“, за да заглавието на заявката си.

Cisco ви дава OAuth клиент ID, клиент тайна и опресняване маркер, който е валиден за 60 дни. Ако маркерът изтече, преди да го използвате с вашия ADP, можете да изпратите друга заявка.

Ако вече сте получили идентификационни данни за Cisco OAuth Identity Provider, използвайки един от потоците в този документ, няма нужда да създавате ново искане. Ако обаче сте получили идентификационни данни за Cisco OAuth с използване на поток, който не е в този документ, попълнете нова заявка за услуга, за да актуализирате идентификационните си данни.

2

Конфигурирайте параметрите на доставчика на самоличност на Cisco чрез изпълнение на следните CLI команди.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> зададе активирано невярно

задайте clientId – вижте отговора на заявката за услуга за ИД.
задаване на clientSecret – вижте отговора на заявката за услуга за тайна.
set issuerName – вижте таблицата по-долу за URL адрес.
задаване на issuerUrl – вижте таблицата по-долу за URL адрес.
задаване на ciResponseBodyMaxSizeInBytes 65536

Таблица 3. Задаване на issuerName и issuerURL
Ако CI клъстер е...	Задаване на issuerName и issuerURL на...
US-A	https://idbroker.webex.com/idb
ЕС	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ако не знаете своя CI клъстер, можете да получите информацията от подробностите за клиента в изгледа „Помощен център“ на Control Hub.

3

Задайте URL адреса на DM моста, като използвате командата CLI по-долу. URL адресът на DM Bridge е различен за всеки клъстер на Teams (който сте изтеглили в стъпка 2).

ADP_CLI/Applications/BroadworksDms/DeviceActivation/DMBridge> задайте url адрес = <url_of_DM_Bridge> обхват = dm-bridge:device_auth

Таблица 4. URL адрес на _DM мост
Ако "Отбори Клъстър" е...	Задаване на URL адрес на_DM мост на...
ACHM	dm-bridge-a.wbx2.com
AORE	dm-bridge-r.wbx2.com
АФРА	dm-bridge-k.wbx2.com

4

Активирайте извличането и удостоверяването на MAC адреси чрез заглавката за удостоверяване или сертификата за удостоверяване. Поради съображения за защита препоръчваме да използвате само една от опциите:

Заглавка за удостоверяване – ако ADP е зад защитна стена, използвайте CLI на ADP, за да активирате извличането на MAC адрес за заглавката за удостоверяване. Тази конфигурация дава на ADP възможност да разпознае MAC адреса от заглавката за удостоверяване. Например:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> задаване на разрешаване на „вярно“

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> задайте identityPattern \„macaddress:.*([0-9a-fA-F]{12}).*"

В този пример macaddress е зададено име с .*([0-9a-fA-F]{12}).* представлява модела, който се присвоява на заглавката. Ако наричате заглавката нещо различно от macaddress, коригирайте съответно CLI.
Сертификат за удостоверяване – ако ADP не е зад защитна стена, удостоверяване възниква директно между устройството и ADP. Използвайте командите на CLI по-долу, за да разрешите извличането на MAC адрес на сертификата на устройството за удостоверяване:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> задаване на разрешаване на „вярно“

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> задайте identityPattern ".*([0-9a-fA-F]{12}).*"

Надстройване на фърмуера на MPP устройството

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

Уверете се, че BroadWorks е актуализиран с поддръжка на услуги за MPP.

Надстройте фърмуера на устройството до най-новата версия, за да сте сигурни, че MPP устройството поддържа възможностите на Webex.

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

Какво да направите след това

Съществуващи MPP устройства – след надстройването устройството се включва автоматично в Webex. Потребителят може да започне да използва услугите на Webex на устройството.
Нови MPP устройства—Осигуряване на новото MPP устройство в BroadWorks.

Осигуряване на MPP устройство

Ако новото MPP устройство не съществува в BroadWorks, осигурете устройството в BroadWorks.

1	В BroadWorks CommPilot проверете конфигурацията на Самоличност/Тип профил на устройство , за да видите дали съществува типът устройство за това MPP устройство. Ако типът устройство не съществува в BroadWorks, импортирайте типа устройство в BroadWorks, като използвате DTAF файл, изтеглен от cisco.com.
2	В BroadWorks CommPilot отворете Самоличност/Тип профил на устройство и поставете отметка в квадратчето Разрешаване на код за активиране .
3	Създайте файл за самоличност/тип на профила на устройството с настройките за SIP, които искате да използвате.
4	Създайте профил на самоличност/устройство с настройки за новото си устройство. В полето MAC адрес въведете MAC адреса на устройството. Ако използвате кодове за активиране за включване на MPP устройства, оставете полето MAC адрес празно.
5	Конфигуриране на основния потребител. На страницата Добавяне на потребители поставете отметка в квадратчето isPlace в зависимост от това дали устройството е лично, или за споделена работна област: Отметнато – устройство в работната област Неотметнато – Лично устройство
6	Попълнете опцията, която съответства на типа устройство и метода на обезпечаване, който искате да използвате: Устройството е за споделена работна област – използвайте Осигуряване на API за работна област на BroadWorks , за да завършите осигуряването за устройството на работната област. Устройството е лично; искате да осигурите чрез публични API – използвайте Осигуряване на API за абонати на BroadWorks , за да завършите осигуряването за основния потребител. Устройството е лично; искате потребителите да използват самостоятелно активиране – пренасочете URL адреса на портала за активиране на потребители към потребителя. Потребителят трябва да потвърди имейл адреса си, за да завърши осигуряването. Устройството е лично; искате да използвате поточно осигуряване – отидете на стъпка 7.
7	Ако устройството е за лична употреба и искате да използвате поточно обезпечаване, тогава за основния потребител задайте интегрираната IM+P услуга. На страницата Потребител > Профил добавете услугата IM+P: От страницата Профил щракнете върху Задаване на услуги. В списъка с Налични услуги изберете Интегриран IM&P и използвайте стрелката, за да преместите елемента в полето Потребителски услуги . Щракнете върху OK. Щракнете върху Профил. Само поток на надеждни имейли. Добавете имейл адреса на потребителя. Тази настройка служи като имейл за IM&P за поточно осигуряване на Webex за Cisco BroadWorks. Това не е задължително, ако използвате ненадежден имейл поток. Шаблонът на клиент в Webex трябва да се конфигурира с настройки за поточно осигуряване с надеждни имейли или ненадеждни имейли. За подробности вижте Напътствия за решението Webex за Cisco BroadWorks.

Какво да направите след това

По желание Ако искате да използвате кодове за активиране за включване на MPP устройства, поискайте кода за активиране в BroadWorks.

Заявка за код за активиране за MPP

(По избор) Webex за Cisco BroadWorks не изисква кодове за активиране за включването на нови MPP устройства. Ако обаче решите да използвате кодове за активиране, изпълнете процедурата Искане на код за активиране , за да поискате код за активиране за ново устройство.

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

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

Услуга за активиране на устройство— Изпълнете следните изисквания, за да разрешите услугата за активиране на устройство:

Разположете услугата за активиране на устройства в BroadWorks. За подробности вижте Защитено включване в Cisco BroadWorks с помощта на кодове за активиране.
Насочете услугата за активиране на устройства (DAS) към услугите за управление на устройства (DMS) в BroadWorks КАТО използвате следната команда CLI:

AS_CLI/Interface/DAS> задаване на URL адрес <url_of_DMS>
Проверете дали настройката за DAS URL адрес за клъстера на BroadWorks е зададена на URL адреса на услугите за управление на устройства (DMS). За да видите текущата настройка за DAS URL адрес в Partner Hub, отидете на Настройки > BroadWorks Calling > Преглед на клъстери и изберете подходящия клъстер. URL адресът се показва под Настройки на интерфейса.

Ако в клъстера на BroadWorks има много клиенти (>50), възможността за добавяне на 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 заявка за услуга>, напр. https://activation.webex.com задайте ид на клиент <id_from_service_request> clientSecret <secret_from_service_request> refhToken <token_from_service_request>

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

Заявка за код за активиране

Изпълнете следните стъпки, за да поискате код за активиране на ново MPP устройство.

На страницата Самоличност/Профил на устройство потърсете и отворете профила на устройството за новото си устройство.
Щракнете върху раздела Активиране на устройство .
Щракнете върху Искане на код за активиране.

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

Изправност на устройството

Общ преглед на изправността

Control Hub съдържа опции за изправност, които позволяват на администраторите да виждат статуса на устройството, заедно с набор от опции за поддръжка. Администраторите могат:

Преглед на текущия статус на устройството
Рестартиране на устройството отдалечено
Изпращане на отчет за проблеми за отстраняване на неизправности
Изтриване на устройството

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

Използвайте тази процедура, за да видите отчет за статуса на устройството от Control Hub. Статусът включва подробности като статус на регистрация, MAC адрес, SIP адрес, IP адрес и сериен номер.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Щракнете върху подходящото устройство.

Рестартиране на устройството

Използвайте тази процедура, за да рестартирате устройство от интерфейса на Control Hub.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Изберете устройство.
4	От падащия списък Действия изберете Рестартиране.

Съобщаване за проблем

Ако срещнете проблеми с устройство, използвайте тази процедура, за да изпратите на Cisco TAC отчет за проблеми за отстраняване на неизправности.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Щракнете върху приложимото устройство.
4	От Действия изберете Съобщаване за проблем.
5	Прегледайте резюмето на отчета.

Изтриване на устройство

Използвайте тази процедура, за да изтриете устройство от Control Hub.

1	Влезте в екземпляра на Control Hub за клиентска организация.
2	Щракнете върху Устройства.
3	Изберете приложимото устройство.
4	От падащия списък Действия изберете Изтриване.

Промяна на собственика на устройството

Използвайте тази процедура, за да преместите съществуващо устройство, което е било включено с помощта на кодове за активиране, към нов собственик на устройството.

Тази процедура приема, че опцията Разрешаване на код за активиране е активирана за Самоличност/Профил на устройство , която това устройство използва.

1

Изтрийте съществуващата регистрация на устройство от Webex:

В Webex Control Hub отворете клиентската организация, към която принадлежи текущият собственик на устройството.
Под Управление щракнете върху Устройства.
Поставете отметка в квадратчето, което е в близост до устройството, което искате да преместите.
Щракнете върху Изтрий.

Регистрацията на устройството изтрива от Webex.

2

В BroadWorks деактивирайте регистрирането на устройства за съществуващия потребител:

В BroadWorks CommPilot отворете Самоличност/профил на устройство , който устройството използва.
Щракнете върху раздела Активиране на устройство .
Щракнете върху Деактивиране на устройство.

Устройството деактивира и дерегистрира от BroadWorks. MAC адресът се изтрива от старата конфигурация за самоличност/профил на устройство .

3

В BroadWorks активирайте устройството, като използвате кода за активиране от различна самоличност/профил на устройство , използван от друг потребител:

В BroadWorks CommPilot отворете различна конфигурация за самоличност/профил на устройство за друг потребител.
Уверете се, че Разрешаване на код за активиране е отметнато за използвания тип самоличност/профил на устройство .
В прозореца Профил на самоличност/устройство щракнете върху раздела Активиране на устройство .
Щракнете върху Искане на код за активиране.

Показва се новият код за активиране. Новият потребител трябва да въведе този код, за да се включи в устройството.

Какво да направите след това

Новият собственик на устройството въвежда кода за активиране на устройството.
Устройството се регистрира отново както в Webex, така и в BroadWorks с помощта на новата конфигурация. Новият профил за самоличност/устройство в BroadWorks се актуализира автоматично с MAC адреса на устройството.

Наблюдение на изпълнението

За тази функция съществуват следните броячи за производителност.

Брояч	Описание
Модул: enterprises.broadsoft.broadworks.deviceАктивиране.активиране
bwDASActivateRequests	Броят на общия брой получени заявки за активиране. Това включва активиране на искания на BroadWorks и активиране на искания на Webex.
bwDASActivateFailures	Общият брой заявки за активиране, които не са завършили успешно. Това включва заявки за активиране на BroadWorks, които са неуспешни, и заявки за Webex, които са неуспешни.
bwDASActivateBroadworksRequests	Броят получени заявки за активиране на BroadWorks.
bwDASActivateBroadWorksFailures	Брой заявки за активиране на BroadWorks, които не са завършили успешно. Този брояч не отчита грешките при удостоверяване.
bwDASActivateWebexRequests	Броят получени заявки за активиране на Webex.
bwDASActivateWebexFailures	Брой заявки за активиране на Webex, които не са завършили успешно.
Модул: enterprises.broadsoft.broadworks.dms.dmBridge
bwDMBridgeRequests	Брой изпратени заявки от DMBridge.
bwDMBridgeFailures	Брой заявки от DMBridge, които не са завършили успешно.

Функции на крайните потребители за интегрирани устройства с Webex

Унифицирана хронология на обажданията

MPP телефони с Webex Aware

Webex Aware Cisco MPP устройства в платформата Webex за BroadWorks вече ще могат да показват единна хронология на повикванията за повиквания, извършени/получени от клиента на Webex на потребителя и неговите устройства. Това позволява подобрена среда за работа на крайните потребители, тъй като те могат да наблюдават и използват повикванията, извършени/получени чрез приложението си Webex чрез регистри на повикванията на техните MPP устройства, заедно с всички локални повиквания, обработени на устройството им.

Обединената история на обажданията на Webex ще бъде източникът по подразбиране за преглед на историята на обажданията на потребителя. Тази история на обажданията съдържа обаждания, направени от всички телефони, Webex Video Devices или Webex App.

Засегнати модели на 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:

Broadworks – тази функция зависи от съответните корекции на BroadWorks, които се инсталират. Подробностите могат да бъдат намерени тук.
Устройство – трябва да се приложат най-новите MPP конфигурации. Задължителни комплекти за CPE могат да бъдат намерени тук (влизане с ИД на CCO).

Очаквания/въздействия/ограничения:

Основна линия (само за текущи потребители)
- Единна хронология на повикванията ще се поддържа, както е посочено.
- Поддръжка защита на поверителността – Защита/скриване на хронологията на повикванията, когато е зададена потребителска парола.
- Ако телефонът не е наясно с облака, ще се показва само „локалната хронология“ на повикванията към и от това устройство.
Други линии (споделени или други)
- Ще се поддържа само локална хронология на повикванията към и от устройство.
Устройства в работната област
- Единна хронология на повикванията няма да се поддържа в този екземпляр.

Когато функцията е включена, цялата локална хронология на повикванията на MPP (извлечена от BroadWorks) ще бъде изтрита.

Webex за интегрирани устройства с RoomOS на BroadWorks

Интегрираните устройства Cisco RoomOS Webex за BroadWorks вече ще могат да показват единна хронология на повикванията за повиквания, извършени/получени от клиента на Webex на потребителя и неговите устройства. Това позволява подобрена среда за работа на крайните потребители, тъй като те могат да наблюдават и използват повикванията, извършени/получени чрез приложението си Webex чрез регистри на повикванията на устройствата си RoomOS, както и всички локални повиквания, обработвани на устройствата им.

Обединената история на обажданията на Webex ще бъде източникът по подразбиране за преглед на историята на обажданията на потребителя. Тази история на обажданията съдържа обаждания, направени от всички телефони, Webex Video Devices или Webex App.

Налично на моделите устройства RoomOS по-долу:

Устройства с RoomOS
Серия бюро: Бюро, Бюро Мини, Бюро Pro
Серия Room
Серия RoomKit
Уебекс борд серия

Разрешаване на функции:

Интеграцията на устройства с Webex за BroadWorks трябва да бъде внедрена и функционална за устройствата с RoomOS. Повече подробности можете да намерите в това ръководство Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Изисквания за корекция и DTAF:

Broadworks – тази функция зависи от съответните корекции на BroadWorks, които се инсталират. Подробностите могат да бъдат намерени тук.

Изисквания за конфигуриране:

Конфигурациите по-долу трябва да бъдат зададени, както е указано
- Конфигурация на BWKS: Feature_Toggle_Webex_Call=Да

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

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

Налично на моделите устройства RoomOS по-долу:

Устройства с RoomOS
Серия бюро: Бюро, Бюро Мини, Бюро Pro
Серия Room
Серия RoomKit
Уебекс борд серия

Разрешаване на функции:

Интеграцията на устройства с Webex за BroadWorks трябва да бъде внедрена и функционална за MPP устройства. Повече подробности можете да намерите в това ръководство Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Изисквания за конфигуриране:

Превключвателят за услуга за указател „xConfiguration Webex DirectoryServiceSupport“ трябва да бъде активиран на Устройството.

Благодарим за обратната връзка.

Ръководство за интегриране на устройства за Webex за Cisco BroadWorks

Въведение

Относно това ръководство

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

Интегриране на устройства за Webex за Cisco BroadWorks

Преглед на включването на устройството

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

Включване на устройство с кодове за активиране

Процес на внедряване за Room OS

Удостоверяване на устройството (чрез токени на носител на OAuth)

Предпоставки за ОС стая

Минимална версия на ОС за стая

Изисквания за корекция на BroadWorks

Изисквания за платформата BroadWorks

Изисквания за конфигурация на BroadWorks

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

Поток за въвеждане на ОС на стаята

Конфигуриране на услуги за Room OS

Устройства с операционна система в стаята за предоставяне

Заявете код за активиране

MPP Приобщаване към Webex

Включване на MPP устройство (нови устройства)

Включване на MPP устройство (съществуващи устройства)

Повече информация

Предпоставки за MPP устройство

Минимална MPP версия

Изисквания за корекция на BroadWorks

Изисквания за платформата BroadWorks

Изисквания за конфигурация на BroadWorks

Сертификати и защитни стени

Активиране на функция

Изисквания за код за активиране

Поток за въвеждане на MPP устройство

Конфигуриране на услуги за MPP

Надстройте фърмуера на MPP устройство

Предоставяне на MPP устройство

Заявете код за активиране за MPP

Предпоставки за използване на кодове за активиране с MPP устройства

Заявете код за активиране

Възможност за обслужване на устройството

Преглед на обслужването

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

Рестартирайте устройството

Съобщаване за проблем

Изтриване на устройството

Промяна на собственика на устройството

Мониторинг на производителността

Функции за крайния потребител за интегрирани устройства Webex

Унифицирана хронология на обажданията

MPP телефони, Webex

Webex за BroadWorks интегрирани RoomOS устройства

Подобрения в търсенето в директория за Webex за интегрирани RoomOS устройства на BroadWorks

Въведение

Относно това ръководство

Хронология на промените на документи

Интегриране на устройства за Webex за Cisco BroadWorks

Общ преглед на включването на устройства

Включване в операционна система Room

Включване на устройство с кодове за активиране

Процес на включване за Room OS

Удостоверяване на устройство (чрез маркери за OAuth носител)

Изисквания за Room OS

Минимална версия на операционна система за стая

Изисквания за корекция за BroadWorks

Изисквания за платформата BroadWorks

Изисквания за конфигуриране на BroadWorks

Изисквания за код за активиране при включване с Room OS

Поток за включване на операционна система Room

Конфигуриране на услуги за Room OS

Осигуряване на устройства с операционна система Room

Заявка за код за активиране

MPP включване в Webex

Включване на MPP устройство (нови устройства)

Включване на MPP устройство (съществуващи устройства)

Повече информация

Изисквания за MPP устройство

Минимална версия на MPP

Изисквания за корекция за BroadWorks

Изисквания за платформата BroadWorks