適用於 Cisco BroadWorks 的 Webex 的裝置整合指南

日期	文件版本	變更描述
2023 年 5 月 12 日	1.7	新增適用於 BroadWorks 整合的Cisco RoomOS 裝置的Webex 和W4B 整合的 RoomOS 裝置的目錄搜尋增強功能之下「 Webex整合的裝置」部分的最終使用者功能。
2023 年 2 月 27 日	1.6	已更新配置 Room OS 的服務下的步驟裝置上線。
2023 年 2 月 17 日	1.5	新增Webex感知 MPP 電話的統一通話記錄區段下Webex整合裝置的最終使用者功能。
2022 年 10 月 14 日	1.4	已更新 Room OS 的上線流程之下Room OS 新手上路部分以包含SRV 記錄。已更新BroadWorks 組態需求下Room OS 先決條件部分，並附有指向解決方案指南的指示器，以了解流程佈建需求。
2022 年 6 月 20 日	1.3	已更新Room OS 先決條件和MPP 裝置先決條件並附有指向解決方案指南的指示器，以了解流程佈建需求。已更新佈建 Room OS 裝置和佈建 MPP 裝置以包含不同佈建方法的資訊。
2022 年 6 月 3 日	1.2	已更正了裝置設定檔類型功能啟動號 (02283) 的Room OS 先決條件和MPP 裝置先決條件
2022 年 5 月 27 日	1.1	修正了每個合作夥伴組織對專用 DMS 實例的需求。新增前言章節。已將標題更新為「裝置整合指南」。
2022 年 5 月 20 日	1.0	初始公佈

裝置上線概觀

本章描述瞭如何將裝置加入Webex for Cisco BroadWorks。本章涵蓋以下用例：

板載新的Webex Room OS 裝置（使用啟動碼）
板載新的 MPP 裝置
將Webex功能新增至現有的 MPP 裝置

我們建議您在與版本無關的 ADP 伺服器上部署此功能。但是，XSP 也支援此功能。如果您使用 XSP，則當本文件提及「ADP」時，您可以取代「XSP」，除非文字僅指定 ADP。
此功能支援「個人」和「工作區」裝置。

Room OS 新手上路

適用於Cisco BroadWorks 的Webex支援共用和工作區 Room OS 裝置的啟動碼上線。

使用啟動碼進行裝置啟動

使用啟動碼進行裝置上線提供了一種簡單且安全的方式來上線 Room OS 裝置。啟用代碼是由系統產生的 16 位數一次性密碼，使用者必須在裝置上輸入該密碼才能上線裝置。啟用代碼會安全地鏈結至預期的使用者帳戶，並確保僅預期的使用者登上鍊結至相同帳戶的裝置。使用者輸入正確的代碼後，裝置會連線至Webex和 BroadWorks，完成註冊，下載其組態檔，並準備好使用。

以下 Room OS 裝置支援使用啟動碼進行上線：

Webex Board 系列（協作室作業系統）
Webex Desk 系列（Room OS）
Webex Room 系列（Room OS）

Room OS 的上線過程

以下流程顯示當 Room OS 裝置使用啟用碼上線時發生的情況：

合作夥伴管理員在 BroadWorks 中佈建主要使用者和裝置，然後在 BroadWorks 中生成啟動碼。
包含裝置啟動碼的電子郵件會傳送給裝置所有者。
裝置所有者啟動裝置。
裝置會提示裝置所有者輸入啟用代碼。
裝置所有者在裝置上輸入啟動碼。
使用以下子流程將裝置加入 BroadWorks 和Webex ：
- Room OS 裝置會向Webex服務傳送啟用請求。啟用代碼會經過 GDS 驗證，如果代碼正確，則裝置會上線Webex。Webex向裝置返回機器權杖。
- 裝置會傳送啟用請求至 BroadWorks DM，以及機器權杖和MAC 位址。
- BroadWorks 會授權並上線裝置。
- 裝置會向 BroadWorks DM 傳送請求，以要求更新設定。包含機器權杖是為了授權。
- BroadWorks 會授權權杖，找到更新的設定檔，並傳回更新的設定組態檔。
- Room OS 將嘗試尋找設定組態檔中指定網域的 NAPTR 記錄，因為它預期為_sip。_tls .<domain_in_config > 如果不存在 NAPTR 記錄，則 RoomOS 將嘗試尋找 SRV 記錄，然後是 A 記錄。
  
  SRV 記錄必須是_sip。_tls 。因為roomOS 將僅支援TLS用於傳輸，以及SRTP用於媒體。
裝置已註冊並可以使用。

下圖提供了新手上路過程的簡化概觀。

如需 Room OS 上線的詳細資訊（包括更詳細的流程圖），請參閱功能說明Webex 感知裝置上線的Cisco BroadWorks 增強。

裝置驗證（透過 OAuth 持有人權杖）

Room OS 裝置的裝置驗證要求您在 BroadWorks 上啟用Cisco OAuth 持有人權杖。在上線期間，持有人權杖會透過啟用授權標題來傳遞，並用來識別裝置。IdP 驗證持有人權杖，並返回 UUID（工作區裝置的機器 UUID 或個人裝置的使用者 UUID）作為持有人主旨。BroadWorks 將 UUID 儲存為網路伺服器中的裝置名稱。

Room OS 先決條件

最低的 Room OS 版本

Room OS 10.13 最低

BroadWorks 修補程式需求

自發行版無關 (RI) ADP 伺服器 2021.11 版起支援此功能，無需修補程式。

對於非 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 組態需求

若要實施此解決方案，必須將流程佈建設定為允許 Broadworks 將裝置佈建為Webex。

在配置流程佈建時，不一定要使用流程佈建來佈建佈建使用者，即您可以繼續使用現有的佈建方法（API、受信任/不受信任的電子郵件、使用者自行等）來佈建使用者。請參閱第適用於Cisco BroadWorks 解決方案指南的Webex 。
請確保整合的 IM+P 服務在 BroadWorks 上啟用並指向 BroadWorks 佈建橋接器。

當客戶範本套用於組織時，已指派佈建橋接器URL 。這應該已在初始Webex for Cisco BroadWorks 設定期間完成。若要在 Partner Hub 中尋找現有URL ，請參閱使用 Provisioning Service URL設定應用程式伺服器在適用於Cisco BroadWorks 解決方案指南的Webex 。
如果您有多個合作夥伴組織，則每個合作夥伴都需要一個專用的 Device Management Service (DMS) 實例。

使用 Room OS 啟動啟動碼的先決條件

確保已設定以下內容：

在 BroadWorks 上部署裝置啟動服務。有關詳細資訊，請參閱Cisco BroadWorks 使用啟動碼的安全上線。
驗證 BroadWorks 叢集的 DAS URL設定是否已設定為 Device Management Services (DMS) URL。若要在 Partner Hub 中檢視目前的 DAS URL設定，請轉至設定 > BroadWorks 通話 >檢視叢集並選取適當的叢集。URL出現在介面設定。

必須在 AS 上啟動下列 BroadWorks 功能：

101377 Webex和 MPP 裝置上線的增強
25088 DECT裝置的支援聽筒
24104 DECT裝置支援多儲存格鏈結
20077 裝置管理增強
19559 視覺裝置管理增強
02283 裝置設定檔類型自訂增強功能

例如，執行以下指令以啟用 101377。在啟動其他功能時變更功能號碼：AS_CLI/System/ActivatableFeature> 啟動 101377

如果已安裝所有列出的修補程式，並且未列出您的特定 AS 發行版的可啟動功能，這是因為該功能已包含在您的 AS 基本發行版中，而且不需要啟動。

在網路伺服器上執行以下CLI 指令：

NS_CLI/System/DeviceManagement> asLocationLookup啟用 true

確保為您的 SBC 憑證簽署的 CA 列於 Room OS 信任清單中。您可以從下列位置檢視 Room OS信任清單：裝置網路入口網站。在入口網站上，選取安全性 > Collaboration Edge 以檢視 CA 清單。

Room OS 新手上路流程

請完成以下任務以設定您的系統，以支援以下Webex Room OS 裝置的使用啟動碼進行裝置上線：

Webex Board系列
Webex Desk 系列
Webex Room 系列

1	配置 Room OS 的服務設定 Room OS 裝置的 BroadWorks 支援。
2	佈建 Room OS 裝置在 BroadWorks 上佈建新裝置。
3	要求啟動碼在裝置設定檔中，請求啟動碼。代碼將自動以電子郵件形式傳送給主要使用者。

配置 Room OS 的服務

在您可以上線任何新的 Room OS 裝置之前，請設定以下系統層級參數以開啟 OAuth 驗證。

向您的上線代理或Cisco TAC提出服務請求，為您的Cisco身份提供者聯盟帳戶佈建Cisco OAuth。將您的服務請求命名為「ADP AuthService 設定」。

如果您已使用本文件中的其中一個流程獲得Cisco OAuth 身份提供者憑證，則不需要建立新的請求。但是，如果您使用未在此文件中的流程獲得Cisco OAuth 憑證，請完成新的服務請求來更新您的憑證。

Cisco 為您提供了有效期限為 60 天的 OAuth 用戶端 ID、用戶端密碼及重新整理權杖。如果權杖在您將其用於 ADP 之前就已到期，您可以提出另一個請求。

使用此CLI 指令啟用 OAuth：

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth> 設定啟用 true

確保 OAuth 範圍包括Broadworks 連接器使用者（預設為啟用範圍）。執行以下指令以檢查您的範圍：

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth/Scopes> 取得

使用以下 CLI 指令配置Cisco身份提供者參數。

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> 設定啟用 false

設定用戶端Id — 請參閱ID的服務請求回應。
設定用戶端私密— 請參閱服務請求回應以了解密碼。
設定發行者名稱— 請參閱下表的URL。
設定 issuerUrl — 請參閱下表的URL。
設定 tokenInfoUrl <IdPProxy_ - 請參閱下表的URL。
set ciResponseBodyMaxSizeInBytes 65536

表格 1. 設定 issuerName 和 issuerURL
如果 CI 叢集為...	將 issuerName 和 issuerURL 設定為...
US-A	https://idbroker.webex.com/idb
EU	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
如果您不知道您的CI 叢集，您可以從 Control Hub 的技術支援檢視中的客戶詳細資料中取得資訊。

表 2. 設定 tokenInfoURL
如果 Teams 叢集為...	將 tokenInfoURL 設定為...（IdP 代理URL）
ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA	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
如果您不知道您的團隊叢集，您可以從 Control Hub 的技術支援檢視中的客戶詳細資料中取得資訊。為了進行測試，您可以透過將「 `idp/驗證`的URL的一部分， `ping` 」。

使用下列指令為Cisco聯盟設定身分提供者：

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> 新增 FederationPartner 重新整理權杖

新密碼：

重新鍵入新密碼：

...完成

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> 取得

合作夥伴名稱重新整理權杖

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

同盟合作夥伴 ********

找到 1 個項目。

ADP_ CLI/系統/通訊公用工具/預設設定/外部驗證/CiscoIdentity提供者/同盟>

set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
設定 PartnerName FederationPartner

重新整理權杖現在位於 CiscoIdentityProvider/Partners 內容下，CiscoIdentity提供者/同盟內容中的 PartnerName 需要與在 CiscoIdentityProvider/Partners 內容中新增的合作夥伴相符。

如果您正在執行比 2022.10 更舊的 ADP RI 載入、不含修補程式 AP.xsp.23.0.1075.ap383838 或 R22 XSP 的 R22 XSP，則：

您不需要在「系統/CommunicationUtility/預設設定/外部驗證/CiscoIdentity提供者/聯盟>」下設定合作夥伴
重新整理權杖必須在以下設定：系統/通訊公用程式/預設設定/外部驗證/CiscoIdentity提供者/同盟>

清除以下三個內容中的所有現有範圍： ADP_ CLI/系統/通訊公用工具/預設設定/外部驗證/CiscoIdentity提供者/...

範圍
允許的管理員/角色
允許的管理員/範圍

對於每個內容，執行取得 以取得現有的範圍，然後將其刪除。例如：

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 OS 裝置

在 BroadWorks 上，佈建 Room OS 裝置（Webex Board 系列、 Webex Desk 系列或Webex Room 系列）。

1	在 BroadWorks CommPilot 上，勾選身分/裝置設定檔類型設定，以查看此 Room OS 裝置是否存在該裝置類型。如果 BroadWorks 上不存在該裝置類型類型，請使用您從 cisco.com 下載的 DTAF 檔案將裝置類型匯入 BroadWorks。
2	匯入裝置類型後，請確保下列設定存在於身分/裝置設定檔類型設定：檢查允許啟動碼加入勾選方塊檢查透過傳訊 Server 傳送啟動碼請求勾選方塊。設定驗證模式至持有人。
3	驗證裝置設定檔是否具有您要使用的SIP設定。在身分識別/裝置設定檔類型檔案請確保驗證模式是持有人。
4	使用新裝置的設定建立裝置設定檔。在身分/裝置設定檔新增/修改頁面上， MAC 位址欄位保留空白。
5	設定主要使用者。於使用者新增頁面上，勾選或取消勾選已放置根據您打算將裝置用作個人還是用於共用工作區。已勾選 — 工作區裝置未勾選 - 個人裝置共用工作區裝置還需要您指定主要使用者。您可以指定所需的主要使用者。
6	完成與您要使用的裝置類型和佈建方法相對應的選項：裝置用於共用工作區 — 使用佈建 BroadWorks 工作區用於完成工作區裝置的佈建的API 。裝置是個人的；您想要使用公用 API 來佈建 — 使用佈建 BroadWorks 訂閱者API 以完成主要使用者的佈建。裝置是個人的；您希望使用者使用的自我啟動 — 將使用者啟動入口網站URL轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。裝置是個人的；您想要使用佈建流程 — 轉至步驟 7。
7	如果裝置是供個人使用的，而您要使用佈建流程，則對於主要使用者，請指定整合的 IM+P 服務。於使用者 >設定檔頁面上，新增IM+P 服務：從設定檔頁面，按一下指定服務。在清單中可用的服務，選取整合的 IM&P 並使用箭頭將項目移動到使用者服務方塊。按一下確定。按一下設定檔。僅受信任的電子郵件流程。新增使用者電子郵件地址。此設定可用作Webex for Cisco BroadWorks 佈建流程的 IM&P 電子郵件。如果您使用的是不受信任的電子郵件流程，則不需要這樣做。必須使用用於使用信任的電子郵件或不受信任的電子郵件的佈建流程的設定來配置Webex上的客戶範本。有關詳細資訊，請參閱適用於Cisco BroadWorks 解決方案指南的Webex 。

下一步

請求 Room OS 裝置的啟動碼。

要求啟動碼

在 BroadWorks 上佈建您的裝置和使用者之後，請請求將啟動碼傳送給使用者。

1	在身分識別/裝置設定檔頁面上，搜尋並開啟新裝置的裝置設定檔。
2	按一下裝置啟動標籤。
3	按一下請求啟動碼。

系統會產生啟用代碼，並且（假設您已正確設定係統）系統將啟用代碼以電子郵件形式傳送給主要使用者。

下一步

將裝置提供給使用者。使用者插入裝置後，需要輸入在電子郵件中傳送的啟用代碼。這會將裝置板載到Webex for Cisco BroadWorks。

MPP 上線至Webex

此部分會描述如何將新的或現有的 MPP 裝置加入Webex for Cisco BroadWorks。請注意，「現有」是指 BroadWorks 上存在但沒有Webex功能的 MPP 裝置。

MPP 裝置上線（新裝置）

上線期間，管理員會更新 BroadWorks 以提供 MPP 支援，升級裝置韌體並在 BroadWorks 上佈建裝置以完成上線。

下圖提供了在使用者輸入的啟動碼經過驗證後的上線過程概觀。

MPP 裝置上線（現有裝置）

對於現有的 MPP 裝置（裝置已在 BroadWorks 上，但未上線至Webex），請更新 BroadWorks 和裝置韌體以支援 MPP 至Webex的上線。更新後，裝置會自動上線至Webex 。

MPP 裝置先決條件

最低 MPP 版本

MPP 韌體 11.3.7 最低版本

BroadWorks 修補程式需求

自發行版無關 (RI) ADP 伺服器 2021.11 版起支援此功能，無需修補程式。

對於非 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 組態需求

若要實施此解決方案，必須將流程佈建設定為允許 Broadworks 將裝置佈建為Webex。

在配置流程佈建時，不一定要使用流程佈建來佈建佈建使用者，即您可以繼續使用現有的佈建方法（API、受信任/不受信任的電子郵件、使用者自行等）來佈建使用者。請參閱第適用於Cisco BroadWorks 解決方案指南的Webex 。
請確保整合的 IM+P 服務在 BroadWorks 上啟用並指向 BroadWorks 佈建橋接器。

當客戶範本套用於組織時，已指派佈建橋接器URL 。這應該已在初始Webex for Cisco BroadWorks 設定期間完成。若要在 Partner Hub 中尋找現有URL ，請參閱使用 Provisioning Service URL設定應用程式伺服器在適用於Cisco BroadWorks 解決方案指南的Webex 。
如果您有多個合作夥伴組織，則每個合作夥伴都需要一個專用的 Device Management Service (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 位址，然後可將其放在使用描述性名稱的標頭中（例如， MAC 地址)。

如果 ADP 不在防火牆後，則不存在上述要求。

功能啟動

在 AS 上啟動下列 BroadWorks 功能：

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> asLocationLookup啟用 true

啟動碼需求

可選。MPP 裝置上線不需要啟動碼。但是，如果您想要使用啟動碼，請參閱請求 MPP 的啟動碼了解特定於 MPP 啟用代碼的其他需求。

MPP 裝置上線流程

請完成以下任務來設定您的系統，以支援 MPP 裝置上線至Webex for Cisco BroadWorks。

如果您要將Webex功能新增至 BroadWorks 上已存在的 MPP 裝置，請僅完成步驟 1 和 2。

1	配置 MPP 的服務（新的或現有的 MPP 裝置）。在Webex for Cisco BroadWorks 上設定 MPP 的系統支援。
2	升級 MPP 裝置韌體（現有的 MPP 裝置）。對於您想要為其新增Webex功能的任何現有 MPP 裝置，請升級至最新裝置韌體。
3	佈建 MPP 裝置（僅限新的 MPP 裝置）。如果裝置在 BroadWorks 上不存在，請在 BroadWorks 上佈建裝置和主要使用者。
4	請求 MPP 的啟動碼（選用）。如果您想要將啟動碼用於板載 MPP 裝置，請申請啟動碼。

配置 MPP 的服務

更新您的 BroadWorks系統設定，以在Webex for Cisco BroadWorks 上支援 MPP 裝置（新的或現有的）。此步驟只需完成一次。您不需要為每個 MPP 裝置重複此過程。

在開始之前

如果 ADP 位於防火牆之後，則必須為防火牆設定規則，以從裝置憑證中擷取MAC 位址，並將其放在「驗證」標頭中，然後再轉寄至 ADP。譬如，身分型式.*（[0-9a-fA-F]{12} )。* 可用於擷取MAC 位址，然後可將其放在使用描述性名稱的標頭中（例如， MAC 地址)。

請參閱防火牆文件以了解設定的相關說明。

向您的上線代理或Cisco TAC提出服務請求，為您的Cisco身份提供者聯盟帳戶佈建Cisco OAuth。使用「ADP AuthService 設定」來為您的請求命名。

Cisco 為您提供了有效期限為 60 天的 OAuth 用戶端 ID、用戶端密碼及重新整理權杖。如果權杖在您將其用於 ADP 之前就已到期，您可以提出另一個請求。

執行下列 CLI 指令以配置Cisco身份提供者參數。

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> 設定啟用 false

設定用戶端Id — 請參閱ID的服務請求回應。
設定用戶端私密— 請參閱服務請求回應以了解密碼。
設定發行者名稱— 請參閱下表的URL。
設定 issuerUrl — 請參閱下表的URL。
set ciResponseBodyMaxSizeInBytes 65536

表 3. 設定 issuerName 和 issuerURL
如果 CI 叢集為...	將 issuerName 和 issuerURL 設定為...
US-A	https://idbroker.webex.com/idb
EU	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
如果您不知道您的CI 叢集，您可以從 Control Hub 的技術支援檢視中的客戶詳細資料中取得資訊。

使用以下CLI 指令設定 DM 橋接器的 url。每個 Teams 叢集的 DM 橋接器URL都不同（您在步驟 2 中提取）。

ADP_CLI/Applications/BroadworksDms/DeviceActivation/DMBridge> 設定 url = <url_of_ DM_橋接器> 範圍 = dm 橋接器：device_auth

表 4. DM_橋接URL
如果 Teams 叢集為...	設定 DM_將URL橋接至...
ACHM	dm-橋接器-a.wbx2.com
AORE	dm-橋接器-r.wbx2.com
AFRA	dm-橋接器-k.wbx2.com

使用驗證標頭或驗證憑證啟用MAC 位址擷取和驗證。基於安全原因，我們建議您僅使用以下選項之一：

驗證標題 — 如果 ADP 在防火牆後，請使用 ADP 上的 CLI 為驗證標題啟用MAC 位址擷取。此組態使 ADP 能夠從驗證標題識別MAC 位址。例如：

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> 設定啟用 true

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> 設定身份識別模式 "mac 位址:.*([0-9a-fA-F]{12} )。*」

在此範例中， MAC 地址 是指定的名稱， .*（[0-9a-fA-F]{12} )。* 代表會指定給標題的型式。如果您將標題稱為MAC 地址，請相應地調整您的 CLI。
驗證憑證 — 如果 ADP 不在防火牆後，則直接在裝置與 ADP 之間進行驗證。使用以下 CLI 指令可在裝置憑證上啟用MAC 位址擷取以進行驗證：

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> 設定啟用 true

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> 設定身份識別模式 ".*([0-9a-fA-F]{12} )。*」

升級 MPP 裝置韌體

在開始之前

確保 BroadWorks 已更新為使用 MPP 的服務支援。

將裝置韌體升級至最新版本，以確保 MPP 裝置支援Webex功能。

有關韌體升級的更多資訊，請參閱您的電話機型韌體發行版的發行說明。

下一步

現有的 MPP 裝置 — 升級後，裝置會自動加入Webex 。使用者可以在裝置上開始使用Webex服務。
新 MPP 裝置 — 在 BroadWorks 上佈建新的 MPP 裝置。

佈建 MPP 裝置

如果 BroadWorks 上不存在新的 MPP 裝置，請在 BroadWorks 上佈建該裝置。

1	在 BroadWorks CommPilot 上，勾選身分/裝置設定檔類型組態，以查看此 MPP 裝置是否存在該裝置類型。如果 BroadWorks 上不存在該裝置類型類型，請使用從 cisco.com 下載的 DTAF 檔案將裝置類型匯入 BroadWorks。
2	在 BroadWorks CommPilot 上，開啟身分/裝置設定檔類型並檢查允許啟動碼加入勾選方塊。
3	建立身分/裝置設定檔類型包含您要使用的SIP設定的檔案。
4	建立身分識別/裝置設定檔包含新裝置的設定。在MAC 位址欄位，輸入裝置MAC 位址。如果您使用啟動碼板載 MPP 裝置，請保留MAC 位址欄位為空。
5	設定主要使用者。於使用者新增頁面，設定已放置根據裝置是個人的還是用於共用工作區的勾選方塊：已勾選 — 工作區裝置未勾選 - 個人裝置
6	完成與您要使用的裝置類型和佈建方法相對應的選項：裝置用於共用工作區 — 使用佈建 BroadWorks 工作區用於完成工作區裝置的佈建的API 。裝置是個人的；您想要使用公用 API 來佈建 — 使用佈建 BroadWorks 訂閱者API 以完成主要使用者的佈建。裝置是個人的；您希望使用者使用的自我啟動 — 將使用者啟動入口網站URL轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。裝置是個人的；您想要使用佈建流程 — 轉至步驟 7。
7	如果裝置是供個人使用的，而您要使用佈建流程，則對於主要使用者，請指定整合的 IM+P 服務。於使用者 >設定檔頁面上，新增IM+P 服務：從設定檔頁面，按一下指定服務。在清單中可用的服務，選取整合的 IM&P 並使用箭頭將項目移動到使用者服務方塊。按一下確定。按一下設定檔。僅受信任的電子郵件流程。新增使用者電子郵件地址。此設定可用作Webex for Cisco BroadWorks 佈建流程的 IM&P 電子郵件。如果您使用的是不受信任的電子郵件流程，則不需要這樣做。必須使用用於使用信任的電子郵件或不受信任的電子郵件的佈建流程的設定來配置Webex上的客戶範本。有關詳細資訊，請參閱適用於Cisco BroadWorks 解決方案指南的Webex 。

下一步

可選。如果您想要將啟動碼用於板載 MPP 裝置，請在 BroadWorks 上申請啟動碼。

請求 MPP 的啟動碼

（選用）適用於Cisco BroadWorks 的Webex不需要啟動碼即可上線新的 MPP 裝置。但是，如果您確實決定使用啟動碼，請完成要求啟動碼 為新裝置請求啟動碼的流程。

將啟動碼用於 MPP 裝置的先決條件

如果您在 MPP 裝置上使用啟用代碼，請確保您的系統符合以下啟動代碼的特定需求。

裝置啟動服務— 完成以下需求以啟用裝置啟動服務：

在 BroadWorks 上部署裝置啟動服務。有關詳細資訊，請參閱Cisco BroadWorks 使用啟動碼的安全上線。
使用以下CLI 指令將裝置啟動服務 (DAS) 指向 BroadWorks AS 上的裝置管理服務 (DMS)：

AS_CLI/Interface/DAS> 設定 url <url_of_ DMS>
驗證 BroadWorks 叢集的 DAS URL設定是否已設定為 Device Management Services (DMS) URL。若要在 Partner Hub 中檢視目前的 DAS URL設定，請轉至設定 > BroadWorks 通話 >檢視叢集並選取適當的叢集。URL出現在介面設定。

Cisco Global Discovery Services (GDS) — 需要 GDS 才能佈建啟動碼。透過完成以下兩個步驟在 BroadWorks 上啟用 GDS：

建立服務請求以佈建您的 GDS 帳戶。Cisco會為您提供用戶端ID、用戶端密碼、重新整理權杖和 GDS 網域。

佈建 GDS 帳戶後，使用以下 CLI 在 ADP 上啟用 GDS：

ADP_CLI/Applications/BroadworksDms/DeviceActivation/IdentityProviders/Cisco> 取得設定 gdsDomain <gds_domain_from 服務請求> 例如https://activation.webex.com 設定用戶端Id <id_from_service_request > 用戶端密碼 <secret_from_service_request > 重新整理權杖 <token_from_service_request >

除了上述特定於啟動碼的先決條件之外，您的系統還必須符合中的一般 MPP 先決條件MPP 裝置先決條件。

要求啟動碼

請完成下列步驟來請求新的 MPP 裝置的啟動碼。

在身分識別/裝置設定檔頁面上，搜尋並開啟新裝置的裝置設定檔。
按一下裝置啟動標籤。
按一下請求啟動碼。

系統會產生啟用代碼，並透過電子郵件將代碼傳送給主使用者。使用者必須在裝置上輸入代碼才能完成上線。

1	在 BroadWorks CommPilot 上，勾選身分/裝置設定檔類型設定，以查看此 Room OS 裝置是否存在該裝置類型。如果 BroadWorks 上不存在該裝置類型類型，請使用您從 cisco.com 下載的 DTAF 檔案將裝置類型匯入 BroadWorks。
2	匯入裝置類型後，請確保下列設定存在於身分/裝置設定檔類型設定：檢查允許啟動碼加入勾選方塊檢查透過傳訊 Server 傳送啟動碼請求勾選方塊。設定驗證模式至持有人。
3	驗證裝置設定檔是否具有您要使用的SIP設定。在身分識別/裝置設定檔類型檔案請確保驗證模式是持有人。
4	使用新裝置的設定建立裝置設定檔。在身分/裝置設定檔新增/修改頁面上， MAC 位址欄位保留空白。
5	設定主要使用者。於使用者新增頁面上，勾選或取消勾選已放置根據您打算將裝置用作個人還是用於共用工作區。已勾選 — 工作區裝置未勾選 - 個人裝置共用工作區裝置還需要您指定主要使用者。您可以指定所需的主要使用者。
6	完成與您要使用的裝置類型和佈建方法相對應的選項：裝置用於共用工作區 — 使用佈建 BroadWorks 工作區用於完成工作區裝置的佈建的API 。裝置是個人的；您想要使用公用 API 來佈建 — 使用佈建 BroadWorks 訂閱者API 以完成主要使用者的佈建。裝置是個人的；您希望使用者使用的自我啟動 — 將使用者啟動入口網站URL轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。裝置是個人的；您想要使用佈建流程 — 轉至步驟 7。
7	如果裝置是供個人使用的，而您要使用佈建流程，則對於主要使用者，請指定整合的 IM+P 服務。於使用者 >設定檔頁面上，新增IM+P 服務：從設定檔頁面，按一下指定服務。在清單中可用的服務，選取整合的 IM&P 並使用箭頭將項目移動到使用者服務方塊。按一下確定。按一下設定檔。僅受信任的電子郵件流程。新增使用者電子郵件地址。此設定可用作Webex for Cisco BroadWorks 佈建流程的 IM&P 電子郵件。如果您使用的是不受信任的電子郵件流程，則不需要這樣做。必須使用用於使用信任的電子郵件或不受信任的電子郵件的佈建流程的設定來配置Webex上的客戶範本。有關詳細資訊，請參閱適用於Cisco BroadWorks 解決方案指南的Webex 。

1	配置 MPP 的服務（新的或現有的 MPP 裝置）。在Webex for Cisco BroadWorks 上設定 MPP 的系統支援。
2	升級 MPP 裝置韌體（現有的 MPP 裝置）。對於您想要為其新增Webex功能的任何現有 MPP 裝置，請升級至最新裝置韌體。
3	佈建 MPP 裝置（僅限新的 MPP 裝置）。如果裝置在 BroadWorks 上不存在，請在 BroadWorks 上佈建裝置和主要使用者。
4	請求 MPP 的啟動碼（選用）。如果您想要將啟動碼用於板載 MPP 裝置，請申請啟動碼。

1	在 BroadWorks CommPilot 上，勾選身分/裝置設定檔類型組態，以查看此 MPP 裝置是否存在該裝置類型。如果 BroadWorks 上不存在該裝置類型類型，請使用從 cisco.com 下載的 DTAF 檔案將裝置類型匯入 BroadWorks。
2	在 BroadWorks CommPilot 上，開啟身分/裝置設定檔類型並檢查允許啟動碼加入勾選方塊。
3	建立身分/裝置設定檔類型包含您要使用的SIP設定的檔案。
4	建立身分識別/裝置設定檔包含新裝置的設定。在MAC 位址欄位，輸入裝置MAC 位址。如果您使用啟動碼板載 MPP 裝置，請保留MAC 位址欄位為空。
5	設定主要使用者。於使用者新增頁面，設定已放置根據裝置是個人的還是用於共用工作區的勾選方塊：已勾選 — 工作區裝置未勾選 - 個人裝置
6	完成與您要使用的裝置類型和佈建方法相對應的選項：裝置用於共用工作區 — 使用佈建 BroadWorks 工作區用於完成工作區裝置的佈建的API 。裝置是個人的；您想要使用公用 API 來佈建 — 使用佈建 BroadWorks 訂閱者API 以完成主要使用者的佈建。裝置是個人的；您希望使用者使用的自我啟動 — 將使用者啟動入口網站URL轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。裝置是個人的；您想要使用佈建流程 — 轉至步驟 7。
7	如果裝置是供個人使用的，而您要使用佈建流程，則對於主要使用者，請指定整合的 IM+P 服務。於使用者 >設定檔頁面上，新增IM+P 服務：從設定檔頁面，按一下指定服務。在清單中可用的服務，選取整合的 IM&P 並使用箭頭將項目移動到使用者服務方塊。按一下確定。按一下設定檔。僅受信任的電子郵件流程。新增使用者電子郵件地址。此設定可用作Webex for Cisco BroadWorks 佈建流程的 IM&P 電子郵件。如果您使用的是不受信任的電子郵件流程，則不需要這樣做。必須使用用於使用信任的電子郵件或不受信任的電子郵件的佈建流程的設定來配置Webex上的客戶範本。有關詳細資訊，請參閱適用於Cisco BroadWorks 解決方案指南的Webex 。

1	登入客戶組織的 Control Hub 實例。
2	按一下裝置。
3	選取裝置。
4	從動作下拉式，選擇重新開機。

1	登入客戶組織的 Control Hub 實例。
2	按一下裝置。
3	按一下適用的裝置。
4	從動作，選擇報告問題。
5	複查報告摘要。

1	登入客戶組織的 Control Hub 實例。
2	按一下裝置。
3	按一下相應的裝置。

1	登入客戶組織的 Control Hub 實例。
2	按一下裝置。
3	選取適用的裝置。
4	從動作下拉，選取刪除。

計數器	說明
模組：Enterprises.broadsoft.broadworks.裝置啟動.啟動
bwDASActivate請求	收到的啟動請求總數。這包括啟動 BroadWorks 請求和啟動Webex請求。
bwDASActivateFailures	無法成功完成的啟動請求總數。這包括失敗的啟動 BroadWorks 請求和失敗的啟動Webex請求。
bwDASActivateBroadWorks 請求	收到的啟動 BroadWorks 請求數。
bwDASActivateBroadWorks 失敗	無法成功完成的啟動 BroadWorks 請求數。此計數器不考慮授權和驗證失敗。
bwDASActivateWebex請求	收到的啟動Webex請求數。
bwDASActivateWebex失敗	無法成功完成的啟動Webex請求數。
模組：Enterprises.broadsoft.broadworks.dms.dm橋接器
bwDMB 橋接器請求	已傳送的 DMBridge 請求數。
bwDMB 橋接器失敗	無法成功完成的 DMBridge 請求數。

適用於 Cisco BroadWorks 的 Webex 的裝置整合指南

簡介

關於本指南

文件變更歷史記錄

Cisco BroadWorks 的 Webex 裝置整合

裝置上線概觀

Room OS 新手上路

使用啟動碼進行裝置啟動

Room OS 的上線過程

裝置驗證（透過 OAuth 持有人權杖）

Room OS 先決條件

最低的 Room OS 版本

BroadWorks 修補程式需求

BroadWorks 平台需求

BroadWorks 組態需求

使用 Room OS 啟動啟動碼的先決條件

Room OS 新手上路流程

配置 Room OS 的服務

佈建 Room OS 裝置

要求啟動碼

MPP 上線至Webex

MPP 裝置上線（新裝置）

MPP 裝置上線（現有裝置）

更多資訊

MPP 裝置先決條件

最低 MPP 版本

BroadWorks 修補程式需求

BroadWorks 平台需求

BroadWorks 組態需求

憑證和防火牆

功能啟動

啟動碼需求

MPP 裝置上線流程

配置 MPP 的服務

升級 MPP 裝置韌體

佈建 MPP 裝置

請求 MPP 的啟動碼

將啟動碼用於 MPP 裝置的先決條件

要求啟動碼

裝置可服務性

服務能力概觀

檢視裝置狀態

重新開機裝置

報告問題

刪除裝置

變更裝置所有者

效能監控

Webex整合裝置的最終使用者功能

統一通話歷史記錄

Webex感知 MPP 電話

適用於 BroadWorks 整合的 RoomOS 裝置的Webex

適用於 BroadWorks 整合的 RoomOS 裝置的Webex的目錄搜尋增強功能

小型企業

企業

裝置

解決方案，適用於

資源

公司