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

Дата	Версия на документа	Описание на промяната
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 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 удостоверяване.

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

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

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

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

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

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

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

Конфигурирайте параметрите на 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 с " `пинг` ".

Конфигурирайте доставчици на идентичност за 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>

Изчистете всички съществуващи обхвати в следните три контекста под 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 сървър без изисквания за корекция.

За 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

Изпълнете следния 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 ).

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

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

Конфигурирайте параметрите на 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.

Задайте 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

Активирайте извличането и удостоверяването на 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	От Действия падащо меню, изберете Изтрийте .

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

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

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

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

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

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

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

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

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

В 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 за 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

Малък бизнес

Предприятие

Устройства

Решения за

Ресурси

Фирма