在此文章中
dropdown icon
簡介
    關於本指南
dropdown icon
Cisco BroadWorks 的 Webex 裝置整合
    裝置上線概觀
    dropdown icon
    Room OS 上線
      協作室作業系統先決條件
      Room OS 加入流程
    dropdown icon
    MPP 上線至 Webex
      MPP 裝置先決條件
      MPP 裝置上線流程
dropdown icon
裝置可服務性
    服務能力概觀
    檢視裝置狀態
    重新啟動裝置
    報告問題
    刪除裝置
    變更裝置擁有者
    效能監控
dropdown icon
Webex 整合裝置的一般使用者功能
    統一通話歷史記錄
    Webex for BroadWorks 整合的 RoomOS 裝置的目錄搜尋增強功能
本文適用於：
2025年3月14日 |

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

list-menu在此文章中
list-menu意見回饋？

裝置整合指南的目標為合作夥伴層級的管理員。本文件說明如何使用此解決方案部署和管理裝置。

簡介

關於本指南

本文件適用於服務提供者組織中部署Webex for Cisco BroadWorks 的合作夥伴管理員。本指南說明如何為 Cisco BroadWorks 版 Webex 上線和服務 Room OS 和 MPP 裝置。本指南分為兩個章節：

  • 裝置上線- 描述瞭如何將 Room OS 裝置（Room and Room Kit 系列、Desk 系列和 Board 系列）和 MPP 裝置加入Webex for Cisco BroadWorks。
  • 裝置可服務性- 描述瞭如何在 Control Hub 中管理已上線的裝置。

文件變更歷史記錄

下表總結了本文件的變更歷史記錄。

日期

文件版本

變更描述

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

  • 初始公佈

Cisco BroadWorks 的 Webex 裝置整合

裝置上線概觀

本章描述瞭如何將裝置加入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 驗證。
1

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

如果您已使用本文件中的其中一個流程獲得Cisco OAuth 身份提供者憑證，則不需要建立新的請求。但是，如果您使用未在此文件中的流程獲得Cisco OAuth 憑證，請完成新的服務請求來更新您的憑證。
Cisco 為您提供了有效期限為 60 天的 OAuth 用戶端 ID、用戶端密碼及重新整理權杖。如果權杖在您將其用於 ADP 之前就已到期，您可以提出另一個請求。
2

使用此CLI 指令啟用 OAuth：

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

3

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

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

使用以下 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 」 。

5

使用下列指令為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提供者/同盟>

6

清除以下三個內容中的所有現有範圍： 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 服務：

  1. 從設定檔 頁面，按一下指定服務。

  2. 在清單中可用的服務，選取整合的 IM&P 並使用箭頭將項目移動到使用者服務 方塊。

  3. 按一下確定。

  4. 按一下設定檔。

  5. 僅受信任的電子郵件流程。新增使用者電子郵件 地址。此設定可用作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 裝置上Webex的相關資訊，請參閱功能說明針對Webex啟用 MPP 裝置的Cisco BroadWorks DMS 增強。

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 地址)。

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

1

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

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

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

執行下列 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 的技術支援檢視中的客戶詳細資料中取得資訊。
3

使用以下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

4

使用驗證標頭或驗證憑證啟用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 服務：

  1. 從設定檔 頁面，按一下指定服務。

  2. 在清單中可用的服務，選取整合的 IM&P 並使用箭頭將項目移動到使用者服務 方塊。

  3. 按一下確定。

  4. 按一下設定檔。

  5. 僅受信任的電子郵件流程。新增使用者電子郵件 地址。此設定可用作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. 在身分識別/裝置設定檔 頁面上，搜尋並開啟新裝置的裝置設定檔。

  2. 按一下裝置啟動 標籤。

  3. 按一下請求啟動碼。

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

裝置可服務性

服務能力概觀

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刪除現有的裝置註冊：

  1. 在Webex Control Hub 中，開啟當前裝置所有者所屬的客戶組織。

  2. 低於管理，按一下裝置。

  3. 選取您要移動的裝置旁的勾選方塊。

  4. 按一下刪除。

    裝置註冊會從Webex中刪除。
2

在 BroadWorks 上，停用現有使用者下的裝置註冊：

  1. 在 BroadWorks CommPilot 上，開啟身分識別/裝置設定檔 裝置使用的名稱。

  2. 按一下裝置啟動 標籤。

  3. 按一下停用裝置。

    裝置會從 BroadWorks 停用和取消註冊。MAC 位址會從舊的 身分識別/裝置設定檔 設定。
3

在 BroadWorks 上，使用其他網站中的啟動碼來啟動裝置身分識別/裝置設定檔 已由其他使用者使用：

  1. 在 BroadWorks CommPilot 上，開啟不同的身分識別/裝置設定檔 其他使用者的設定。

  2. 請確保允許啟動碼加入 已檢查身分/裝置設定檔類型 已使用。

  3. 在身分識別/裝置設定檔 視窗中，按一下裝置啟動 標籤。

  4. 按一下要求啟動碼。

    顯示新的啟用碼。新使用者必須輸入此代碼才能上線裝置。

下一步

  • 新的裝置所有者在裝置上輸入啟動碼。

  • 裝置會使用新設定向Webex和 BroadWorks 重新註冊。新的身分識別/裝置設定檔 在 BroadWorks 上，會使用裝置MAC 位址自動更新。

效能監控

此功能存在下列效能計數器。

計數器

說明

模組：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 請求數。

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

統一通話歷史記錄

Webex感知 MPP 電話

Webex for BroadWorks 平台上的Webex感知Cisco MPP 裝置現在可以顯示從使用者的Webex用戶端及其裝置撥打/接聽的通話的統一通話歷史記錄。這樣做可改善最終使用者裝置的體驗，因為他們可以透過 MPP 裝置上的通話記錄以及裝置上處理的所有本地通話，觀察和使用透過Webex 應用程式撥打/接聽的通話。

Webex Unified 通話記錄將成為檢視使用者通話歷史記錄的預設來源。此通話歷史記錄包含從所有電話、 Webex視訊裝置或Webex應用程式撥打的電話。

受影響的IP電話機型：

  • MPP68xx系列 6821、6841、6851、6861

  • MPP78xx系列 7811、7821、7841、7861

  • MPP88xx 系列 8811、8841、8845、8851、8861、8865、8875

功能啟用：

需要滿足以下條件才能啟用該功能

Patch 和 DTAF 需求：

  • BroadWorks - 此功能取決於所安裝的相關 BroadWorks 修補程式。可找到詳細資料在這裡。

  • 裝置 - 需要套用最新的 MPP 設定。可找到所需的 CPE 套件在這裡 （使用 CCO ID登入）。

預期/影響/限制：

  • 主要線路 (僅限目前使用者)

    • 如前所述，將支援統一通話記錄。

    • 支援 隱私權保護 - 設定使用者密碼時保護/隱藏通話記錄。

    • 若電話不是雲端感知，則只會顯示此裝置來回通話的「本地記錄」。

  • 其他線路（共用或其他方式）

    • 僅支援與裝置之間的通話的本地記錄。

  • 工作區裝置

    • 此實例將不支援統一通話記錄。

開啟該功能後，MPP（衍生自 BroadWorks）上的所有本地通話歷史記錄都將被刪除。

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

Webex for BroadWorks 整合的Cisco RoomOS 裝置現在可以顯示從使用者的Webex用戶端及其裝置撥打/接聽的通話的統一通話歷史記錄。這樣做可改善最終使用者裝置的體驗，因為他們可以透過 RoomOS 裝置上的通話記錄以及裝置上處理的所有本地通話，觀察和使用透過Webex 應用程式撥打/接聽的通話。

Webex Unified 通話記錄將成為檢視使用者通話歷史記錄的預設來源。此通話歷史記錄包含從所有電話、 Webex視訊裝置或Webex應用程式撥打的電話。

在下列 RoomOS 裝置型號上提供：

  • RoomOS 裝置

  • 桌面系列：Desk, Desk Mini, Desk 專業版

  • Room 系列

  • Room Kit 系列

  • Webex Board 系列

功能啟用：

Patch 和 DTAF 需求：

  • BroadWorks - 此功能取決於所安裝的相關 BroadWorks 修補程式。可找到詳細資料在這裡。

組態需求：

  • 以下設定需要按照指定設定

    • Bwks 設定：Feature_ toggle_ Webex_呼叫 = 是

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

透過實施新的增強型Webex目錄服務， Webex for BroadWorks 整合的Cisco RoomOS 裝置使用者現在可以直接從其 RoomOS 裝置搜尋Webex組織中的人員、空間甚至裝置。此服務向Webex for BroadWorks 使用者提供增強的搜尋功能，使他們能夠在其Webex組織中尋找使用者和事物（工作區、裝置等）。

在下列 RoomOS 裝置型號上提供：

  • RoomOS 裝置

  • 桌面系列：Desk, Desk Mini, Desk 專業版

  • Room 系列

  • Room Kit 系列

  • Webex Board 系列

功能啟用：

組態需求：

  • 必須在裝置上啟用目錄服務切換「x設定Webex DirectoryServiceSupport」。

簡介

文件變更歷史記錄

下表總結了本文件的變更歷史記錄。

日期

文件版本

變更描述

2023 年 5 月 12 日

1.7

新增適用於 BroadWorks 整合的Cisco RoomOS 裝置的Webe x和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

  • 初始公佈

Cisco BroadWorks 的 Webex 裝置整合

裝置上線概觀

本章描述瞭如何將裝置加入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出現在介面設定。

    如果 BroadWorks 叢集中有很多客戶 (>50)，則不支援新增 DAS URL的功能。在這種情況下，建議聯絡Cisco TAC支援工程師以尋求協助。

必須在 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 驗證。
1

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

如果您已使用本文件中的其中一個流程獲得Cisco OAuth 身份提供者憑證，則不需要建立新的請求。但是，如果您使用未在此文件中的流程獲得Cisco OAuth 憑證，請完成新的服務請求來更新您的憑證。
Cisco 為您提供了有效期限為 60 天的 OAuth 用戶端 ID、用戶端密碼及重新整理權杖。如果權杖在您將其用於 ADP 之前就已到期，您可以提出另一個請求。
2

使用此CLI 指令啟用 OAuth：

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

3

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

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

使用以下 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

歐盟

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 」 。

5

使用下列指令為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提供者/同盟>

6

清除以下三個內容中的所有現有範圍： 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 訂閱者AP I以完成主要使用者的佈建。
  • 裝置是個人的；您希望使用者使用的自我啟動 — 將使用者啟動入口網站URL轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。
  • 裝置是個人的；您想要使用佈建流程 — 轉至步驟 7。
7

如果裝置是供個人使用的，而您要使用佈建流程，則對於主要使用者，請指定整合的 IM+ P服務。於使用者 >設定檔 頁面上，新增IM+P 服務：

  1. 從設定 檔頁面，按一下指定服務。

  2. 在清單中可用的服務，選取整合的 IM& P並使用箭頭將項目移動到使用者服 務方塊。

  3. 按一下確定。

  4. 按一下設定檔。

  5. 僅受信任的電子郵件流程。新增使用者電子郵 件地址。此設定可用作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 裝置上Webex的相關資訊，請參閱功能說明針對Webex啟用 MPP 裝置的Cisco BroadWorks DMS 增強。

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 地址)。

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

1

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

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

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

執行下列 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

歐盟

https://idbroker-eu.webex.com/idb

US-B

https://idbroker-b-us.webex.com/idb

如果您不知道您的CI 叢集，您可以從 Control Hub 的技術支援檢視中的客戶詳細資料中取得資訊。
3

使用以下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

4

使用驗證標頭或驗證憑證啟用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 訂閱者AP I以完成主要使用者的佈建。
  • 裝置是個人的；您希望使用者使用的自我啟動 — 將使用者啟動入口網站URL轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。
  • 裝置是個人的；您想要使用佈建流程 — 轉至步驟 7。
7

如果裝置是供個人使用的，而您要使用佈建流程，則對於主要使用者，請指定整合的 IM+ P服務。於使用者 >設定檔 頁面上，新增IM+P 服務：

  1. 從設定 檔頁面，按一下指定服務。

  2. 在清單中可用的服務，選取整合的 IM& P並使用箭頭將項目移動到使用者服 務方塊。

  3. 按一下確定。

  4. 按一下設定檔。

  5. 僅受信任的電子郵件流程。新增使用者電子郵 件地址。此設定可用作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出現在介面設定。

    如果 BroadWorks 叢集中有很多客戶 (>50)，則不支援新增 DAS URL的功能。在這種情況下，建議聯絡Cisco TAC支援工程師以尋求協助。

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. 在身分識別/裝置設定 檔頁面上，搜尋並開啟新裝置的裝置設定檔。

  2. 按一下裝置啟 動標籤。

  3. 按一下請求啟動碼。

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

裝置可服務性

服務能力概觀

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刪除現有的裝置註冊：

  1. 在Webex Control Hub 中，開啟當前裝置所有者所屬的客戶組織。

  2. 低於管理，按一下裝置。

  3. 選取您要移動的裝置旁的勾選方塊。

  4. 按一下刪除。

    裝置註冊會從Webex中刪除。
2

在 BroadWorks 上，停用現有使用者下的裝置註冊：

  1. 在 BroadWorks CommPilot 上，開啟身分識別/裝置設定 檔裝置使用的名稱。

  2. 按一下裝置啟 動標籤。

  3. 按一下停用裝置。

    裝置會從 BroadWorks 停用和取消註冊。MAC 位址會從舊的 身分識別/裝置設定 檔設定。
3

在 BroadWorks 上，使用其他網站中的啟動碼來啟動裝置身分識別/裝置設定 檔已由其他使用者使用：

  1. 在 BroadWorks CommPilot 上，開啟不同的身分識別/裝置設定 檔其他使用者的設定。

  2. 請確保允許啟動碼加 入已檢查身分/裝置設定檔類 型已使用。

  3. 在身分識別/裝置設定 檔視窗中，按一下裝置啟 動標籤。

  4. 按一下要求啟動碼。

    顯示新的啟動碼。新使用者必須輸入此代碼才能上線裝置。

下一步

  • 新的裝置所有者在裝置上輸入啟動碼。

  • 裝置會使用新設定向Webex和 BroadWorks 重新註冊。新的身分識別/裝置設定 檔在 BroadWorks 上，會使用裝置MAC 位址自動更新。

效能監控

此功能存在下列效能計數器。

計數器

說明

模組：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 請求數。

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

統一通話歷史記錄

Webex感知 MPP 電話

Webex for BroadWorks 平台上的Webex感知Cisco MPP 裝置現在可以顯示從使用者的Webex用戶端及其裝置撥打/接聽的通話的統一通話歷史記錄。這樣做可改善最終使用者裝置的體驗，因為他們可以透過 MPP 裝置上的通話記錄以及裝置上處理的所有本地通話，觀察和使用透過Webex 應用程式撥打/接聽的通話。

Webex Unified 通話記錄將成為檢視使用者通話歷史記錄的預設來源。此通話歷史記錄包含從所有電話、 Webex視訊裝置或Webex應用程式撥打的電話。

受影響的IP電話機型：

  • MPP68xx系列 6821、6841、6851、6861

  • MPP78xx系列 7811、7821、7841、7861

  • MPP88xx 系列 8811、8841、8845、8851、8861、8865、8875

功能啟用：

需要滿足以下條件才能啟用該功能

Patch 和 DTAF 需求：

  • BroadWorks - 此功能取決於所安裝的相關 BroadWorks 修補程式。可找到詳細資料在這裡。

  • 裝置 - 需要套用最新的 MPP 設定。可找到所需的 CPE 套件在這 裡（使用 CCO ID登入）。

預期/影響/限制：

  • 主要線路 (僅限目前使用者)

    • 如前所述，將支援統一通話記錄。

    • 支援 隱私權保護 - 設定使用者密碼時保護/隱藏通話記錄。

    • 若電話不是雲端感知，則只會顯示此裝置來回通話的「本地記錄」。

  • 其他線路（共用或其他方式）

    • 僅支援與裝置之間的通話的本地記錄。

  • 工作區裝置

    • 此實例將不支援統一通話記錄。

開啟該功能後，MPP（衍生自 BroadWorks）上的所有本地通話歷史記錄都將被刪除。

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

Webex for BroadWorks 整合的Cisco RoomOS 裝置現在可以顯示從使用者的Webex用戶端及其裝置撥打/接聽的通話的統一通話歷史記錄。這樣做可改善最終使用者裝置的體驗，因為他們可以透過 RoomOS 裝置上的通話記錄以及裝置上處理的所有本地通話，觀察和使用透過Webex 應用程式撥打/接聽的通話。

Webex Unified 通話記錄將成為檢視使用者通話歷史記錄的預設來源。此通話歷史記錄包含從所有電話、 Webex視訊裝置或Webex應用程式撥打的電話。

在下列 RoomOS 裝置型號上提供：

  • RoomOS 裝置

  • 桌面系列：Desk, Desk Mini, Desk 專業版

  • Room 系列

  • Room Kit 系列

  • Webex Board 系列

功能啟用：

Patch 和 DTAF 需求：

  • BroadWorks - 此功能取決於所安裝的相關 BroadWorks 修補程式。可找到詳細資料在這裡。

組態需求：

  • 以下設定需要按照指定設定

    • Bwks 設定：Feature_oggle_t ebex_W呼叫 = 是

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

透過實施新的增強型Webex目錄服務， Webex for BroadWorks 整合的Cisco RoomOS 裝置使用者現在可以直接從其 RoomOS 裝置搜尋Webex組織中的人員、空間甚至裝置。此服務向Webex for BroadWorks 使用者提供增強的搜尋功能，使他們能夠在其Webex組織中尋找使用者和事物（工作區、裝置等）。

在下列 RoomOS 裝置型號上提供：

  • RoomOS 裝置

  • 桌面系列：Desk, Desk Mini, Desk 專業版

  • Room 系列

  • Room Kit 系列

  • Webex Board 系列

功能啟用：

組態需求：

  • 必須在裝置上啟用目錄服務切換「x設定Webex DirectoryServiceSupport」。

簡介

關於本指南

本文件適用於部署 Webex for Cisco BroadWorks 的服務提供者組織中的合作夥伴管理員。本指南說明如何為 Cisco BroadWorks 版 Webex 上線和服務 Room OS 和 MPP 裝置。本指南分為兩個章節：

  • 裝置上線— 說明如何將 Room OS 裝置（Room 和 Room Kit 系列、Desk 系列和 Board 系列）和 MPP 裝置加入 Webex for Cisco BroadWorks。
  • 裝置可服務性- 說明如何在 Control Hub 中管理已加入的裝置。

文件變更歷史記錄

下表總結了此文件的變更歷史記錄。

日期

文件版本

變更描述

2023 年 5 月 12 日

1.7

已新增Webex for BroadWorks 整合的 Cisco RoomOS 裝置 和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 設定需求 在協作室作業系統先決條件 區段，其中包含指向解決方案指南的指示器，以了解流程佈建需求。

2022 年 6 月 20 日

1.3

  • 已更新協作室作業系統先決條件 和MPP 裝置先決條件 以及指向解決方案指南的指示器，以了解流程佈建需求。

  • 已更新佈建協作室作業系統裝置 和佈建 MPP 裝置 以包含不同佈建方法的資訊。

2022 年 6 月 3 日

1.2

  • 已更正裝置設定檔類型功能啟用號碼 (02283)協作室作業系統先決條件 和MPP 裝置先決條件

2022 年 5 月 27 日

1.1

  • 更正了每個合作夥伴組織的專用 DMS 執行個體的需求。

  • 已新增前言 章節。

  • 已將標題更新為「裝置整合指南」。

2022 年 5 月 20 日

1.0

  • 初始發布

Cisco BroadWorks 的 Webex 裝置整合

裝置上線概觀

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

  • 加入新的 Webex Room OS 裝置（使用啟用代碼）

  • 加入新的 MPP 裝置

  • 將 Webex 功能新增至現有 MPP 裝置

  • 我們建議您在與版本無關的 ADP 伺服器上部署此功能。但是，XSP 也支援此功能。如果您使用的是 XSP，則當本文件提及「ADP」時，您可以替換為「XSP」，除非文字僅指定 ADP。

  • 此功能同時支援個人裝置和工作區裝置。

Room OS 上線

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

使用啟用代碼的裝置上線

使用啟用代碼的裝置上線提供了一種簡單且安全的方式來上線 Room OS 裝置。啟用代碼是系統產生的 16 位一次性密碼，使用者必須在裝置上輸入該密碼才能加入裝置。啟用代碼會安全地鏈結至預期使用者帳戶，並確保只有預期使用者才能登錄鏈結至相同帳戶的裝置。使用者輸入正確的代碼後，裝置會同時連線至 Webex 和 BroadWorks，完成註冊，下載其設定檔案，然後即可使用。

以下 Room OS 裝置支援使用啟用代碼加入：

  • Webex Board 系列（Room OS）

  • 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 記錄，因為它預期會找到 的 SRV 項目_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 最低 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 設定需求

  • 若要實作此解決方案，必須設定 Flowthrough 佈建以允許 Broadworks 將裝置佈建給 Webex。

    設定流程佈建時，不一定要使用流程佈建來佈建使用者，也就是說，您可以繼續使用現有的佈建方法（API、受信任/不受信任的電子郵件、使用者自己等）來佈建使用者。請參閱「佈建需求」 Webex for Cisco BroadWorks 解決方案指南。

  • 確保整合的 IM+P 服務已在 BroadWorks 上啟用並指向 BroadWorks 佈建橋接。

    將客戶範本套用至組織時，已指定佈建橋接器 URL。這應該已在您初始設定 Webex for Cisco BroadWorks 期間完成。若要在 Partner Hub 中尋找現有的 URL，請參閱使用 Provisioning Service URL 設定應用程式伺服器 在Webex for Cisco BroadWorks 解決方案指南。

  • 如果您有多個合作夥伴組織，則每個合作夥伴都需要專用的裝置管理服務 (DMS) 實例。

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

確保已設定以下內容：

  • 在 BroadWorks 上部署裝置啟動服務。有關詳細資訊，請參閱使用啟用代碼的 Cisco BroadWorks 安全上線。

  • 驗證 BroadWorks 叢集的 DAS URL 設定是否設定為裝置管理服務 (DMS) URL。若要在 Partner Hub 中檢視目前的 DAS URL 設定，請轉至設定 > BroadWorks 通話 >檢視叢集 並選取適當的叢集。該 URL 出現在介面設定。

    如果 BroadWorks 叢集中有許多客戶 (>50)，則不支援新增 DAS URL 的功能。在這種情況下，建議聯絡 Cisco TAC 支援工程師以尋求協助。

必須在 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> asLocationLookupEnabled true

確保簽署 SBC 憑證的 CA 列於協作室作業系統信任清單中。您可以從以下位置檢視協作室作業系統信任清單：裝置 Web 入口網站。在入口網站上，選取安全性 >協作邊緣 以檢視 CA 清單。

Room OS 加入流程

完成下列工作以設定您的系統，以支援下列 Webex Room OS 裝置的使用啟用代碼的裝置上線：

  • Webex Board系列

  • Webex Desk 系列

  • Webex Room 系列

1

設定 Room OS 的服務

為 Room OS 裝置設定 BroadWorks 支援。

2

佈建協作室作業系統裝置

在 BroadWorks 上佈建新裝置。

3

請求啟用代碼

在裝置設定檔中，請求啟用代碼。代碼將自動透過電子郵件傳送給主要使用者。

設定 Room OS 的服務
在您可以加入任何新的 Room OS 裝置之前，請先設定以下系統層級參數以開啟 OAuth 驗證。
1

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

如果您已使用本文件中的其中一個流程取得 Cisco OAuth 身分識別提供者憑證，則無需建立新請求。但是，如果您使用本文件中未包含的流程獲取 Cisco OAuth 憑證，請完成新的服務請求以更新您的憑證。
Cisco 為您提供了有效期限為 60 天的 OAuth 用戶端 ID、用戶端密碼及重新整理權杖。如果權杖在您將其與 ADP 一起使用之前已過期，您可以提出另一個請求。
2

使用此 CLI 指令啟用 OAuth：

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

3

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

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

使用以下 CLI 指令設定 Cisco 身份識別提供者參數。

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

  • 設定 clientId — 請參閱 ID 的服務請求回應。

  • 設定 clientSecret — 請參閱服務請求回應以了解密碼。

  • 設定 issuerName — 有關 URL，請參閱下表。

  • 設定 issuerUrl — 有關 URL，請參閱下表。

  • 設定 tokenInfoUrl <IdPProxy_ — 有關 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. 設定 tokenInfoURL
如果 Teams 叢集為...將 tokenInfoURL 設定為...（IdP Proxy 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

  • 如果您不知道您的Teams 叢集，您可以從 Control Hub 的「技術支援」視圖中的「客戶詳細資料」獲取資訊。

  • 對於測試，您可以驗證 tokenInfoURL 是否有效，方法是將「 idp/驗證" 部分的 URL 包含 " ping 」。

5

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

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> 新增 FederationPartnerrefreshToken

新密碼：

重新鍵入新密碼：

...完成

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

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

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

FederationPartner ********

找到 1 個項目。

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

  • set flsUrl https://cifls.webex.com/federation

  • set refreshPeriodInMinutes 60

  • 設定 partnerName FederationPartner

重新整理權杖現在位於 CiscoIdentityProvider/Partners 內容下，且 CiscoIdentityProvider/Federation 內容中的 partnerName 需要與 CiscoIdentityProvider/Partners 內容中新增的合作夥伴相符。

如果您正在執行早於 2022.10 的 ADP RI 載入、沒有修補程式 AP.xsp.23.0.1075.ap383838 的 R23 XSP 或 R22 XSP，則：

  • 您無需在「System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>」下設定合作夥伴

  • 必須在以下位置設定重新整理權杖：System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

6

清除以下三個上下文中的所有現有範圍ADP_ CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

  • 範圍

  • 管理員/允許的角色

  • 管理員/允許的範圍

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

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 上不存在該裝置類型，請使用從 cisco.com 下載的 DTAF 檔案將該裝置類型匯入 BroadWorks。

2

匯入裝置類型後，請確保下列設定存在於身分/裝置設定檔類型 設定：

  • 檢查允許啟用代碼上線 勾選方塊

  • 檢查透過 Messaging Server 傳送啟用代碼請求 勾選方塊。

  • 設定驗證模式 至承載。

3

驗證裝置設定檔是否具有您要使用的 SIP 設定。在身分/裝置設定檔類型檔案 確保驗證模式 是承載。

4

使用新裝置的設定建立裝置設定檔。在身分/裝置設定檔新增/修改 頁面，將 MAC 位址欄位保留為空。

5

設定主要使用者。在使用者新增 頁，選取或取消選取isPlace 根據您打算將裝置用於個人還是共用工作區。

  • 已選取 — 工作區裝置

  • 未選取 — 個人裝置

共用工作區裝置還要求您指定主要使用者。您可以指定所需的主要使用者。
6

填寫與您要使用的裝置類型和佈建方法相對應的選項：

  • 裝置用於共用工作區 — 使用佈建 BroadWorks 工作區 用於完成工作區裝置佈建的 API。
  • 裝置是個人的；您想要使用公用 API 進行佈建 — 使用佈建 BroadWorks 訂閱者 API 以完成主要使用者的佈建。
  • 裝置是個人的；您希望使用者使用自行啟動—將使用者啟動入口網站 URL 轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。
  • 裝置是個人的；您想要使用佈建流程—請移至步驟 7。
7

如果裝置供個人使用，並且您想要使用佈建流程，則對於主要使用者，請指派整合的 IM+P 服務。在使用者 >設定檔 頁面，新增 IM+P 服務：

  1. 從設定檔 頁面上，按一下指定服務。

  2. 在清單中可用服務，選取整合的 IM&P 並使用箭頭將項目移至使用者服務 方塊。

  3. 按一下確定。

  4. 按一下設定檔。

  5. 僅限受信任的電子郵件流程。新增使用者電子郵件 地址。此設定充當 IM&P 電子郵件，用於佈建 Webex for Cisco BroadWorks 的流程。如果您使用的是不受信任的電子郵件流程，則不需要這樣做。

    Webex 上的客戶範本必須使用受信任電子郵件或不受信任電子郵件的佈建流程設定進行設定。有關詳細資訊，請參閱Webex for Cisco BroadWorks 解決方案指南。

下一步

請求 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 裝置加入 Webex 的更多資訊，請參閱功能說明適用於 Webex 啟用 MPP 裝置的 Cisco BroadWorks DMS 增強。

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 設定需求

  • 若要實作此解決方案，必須設定 Flowthrough 佈建以允許 Broadworks 將裝置佈建給 Webex。

    設定流程佈建時，不一定要使用流程佈建來佈建使用者，也就是說，您可以繼續使用現有的佈建方法（API、受信任/不受信任的電子郵件、使用者自己等）來佈建使用者。請參閱「佈建需求」 Webex for Cisco BroadWorks 解決方案指南。

  • 確保整合的 IM+P 服務已在 BroadWorks 上啟用並指向 BroadWorks 佈建橋接。

    將客戶範本套用至組織時，已指定佈建橋接器 URL。這應該已在您初始設定 Webex for Cisco BroadWorks 期間完成。若要在 Partner Hub 中尋找現有的 URL，請參閱使用 Provisioning Service URL 設定應用程式伺服器 在Webex for 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 位址，然後可將其放在使用描述性名稱的標頭中（例如， 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> asLocationLookupEnabled 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 位址）。

請參閱防火牆說明文件以獲取有關設定的說明。

1

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

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

如果您已使用本文件中的其中一個流程取得 Cisco OAuth 身分識別提供者憑證，則無需建立新請求。但是，如果您使用本文件中未包含的流程獲取 Cisco OAuth 憑證，請完成新的服務請求以更新您的憑證。
2

執行下列 CLI 指令來設定 Cisco 身份識別提供者參數。

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

  • 設定 clientId — 請參閱 ID 的服務請求回應。

  • 設定 clientSecret — 請參閱服務請求回應以了解密碼。

  • 設定 issuerName — 有關 URL，請參閱下表。

  • 設定 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

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

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

表 4. DM_橋接器 URL

如果 Teams 叢集為...

設定 DM_橋接 URL 至...

ACHM

dm-bridge-a.wbx2.com

AORE

dm-bridge-r.wbx2.com

AFRA

dm-bridge-k.wbx2.com

4

使用驗證標頭或驗證憑證啟用 MAC 位址擷取和驗證。基於安全性考量，我們建議您僅使用其中一個選項：

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

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

    ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> set identityPattern "macaddress:.*([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> set identityPattern ".*([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

設定主要使用者。在使用者新增 頁面，設定isPlace 勾選方塊，根據裝置是個人裝置還是共用工作區：

  • 已選取 — 工作區裝置

  • 未選取 — 個人裝置

6

填寫與您要使用的裝置類型和佈建方法相對應的選項：

  • 裝置用於共用工作區 — 使用佈建 BroadWorks 工作區 用於完成工作區裝置佈建的 API。
  • 裝置是個人的；您想要使用公用 API 進行佈建 — 使用佈建 BroadWorks 訂閱者 API 以完成主要使用者的佈建。
  • 裝置是個人的；您希望使用者使用自行啟動—將使用者啟動入口網站 URL 轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。
  • 裝置是個人的；您想要使用佈建流程—請移至步驟 7。
7

如果裝置供個人使用，並且您想要使用佈建流程，則對於主要使用者，請指派整合的 IM+P 服務。在使用者 >設定檔 頁面，新增 IM+P 服務：

  1. 從設定檔 頁面上，按一下指定服務。

  2. 在清單中可用服務，選取整合的 IM&P 並使用箭頭將項目移至使用者服務 方塊。

  3. 按一下確定。

  4. 按一下設定檔。

  5. 僅限受信任的電子郵件流程。新增使用者電子郵件 地址。此設定充當 IM&P 電子郵件，用於佈建 Webex for Cisco BroadWorks 的流程。如果您使用的是不受信任的電子郵件流程，則不需要這樣做。

    Webex 上的客戶範本必須使用受信任電子郵件或不受信任電子郵件的佈建流程設定進行設定。有關詳細資訊，請參閱Webex for Cisco BroadWorks 解決方案指南。

下一步

可選。如果您要使用啟用代碼來加入 MPP 裝置，請在 BroadWorks 上請求啟用代碼。
請求 MPP 的啟用代碼

（可選）Webex for Cisco BroadWorks 不需要啟用代碼即可加入新的 MPP 裝置。但是，如果您決定使用啟用代碼，請完成請求啟用代碼 程序來請求新裝置的啟用代碼。

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

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

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

  • 在 BroadWorks 上部署裝置啟動服務。有關詳細資訊，請參閱使用啟用代碼的 Cisco BroadWorks 安全上線。

  • 使用以下 CLI 指令將裝置啟動服務 (DAS) 指向 BroadWorks AS 上的裝置管理服務 (DMS)：

    AS_CLI/Interface/DAS> 設定 URL <url_of_ DMS>

  • 驗證 BroadWorks 叢集的 DAS URL 設定是否設定為裝置管理服務 (DMS) URL。若要在 Partner Hub 中檢視目前的 DAS URL 設定，請轉至設定 > BroadWorks 通話 >檢視叢集 並選取適當的叢集。該 URL 出現在介面設定。

    如果 BroadWorks 叢集中有許多客戶 (>50)，則不支援新增 DAS URL 的功能。在這種情況下，建議聯絡 Cisco TAC 支援工程師以尋求協助。

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. 在身分/裝置設定檔 頁面上，搜尋並開啟新裝置的裝置設定檔。

  2. 按一下裝置啟動 標籤。

  3. 按一下請求啟用代碼。

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

裝置可服務性

服務能力概觀

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 刪除現有的裝置註冊：

  1. 在 Webex Control Hub 中，開啟目前裝置所有者所屬的客戶組織。

  2. 低於管理，按一下裝置。

  3. 選取與您要移動的裝置相鄰的方塊。

  4. 按一下刪除。

    裝置註冊將從 Webex 中刪除。
2

在 BroadWorks 上，停用現有使用者下的裝置註冊：

  1. 在 BroadWorks CommPilot 上，開啟身分/裝置設定檔 裝置使用。

  2. 按一下裝置啟動 標籤。

  3. 按一下停用裝置。

    裝置會從 BroadWorks 停用並取消註冊。MAC 位址會從舊 身分/裝置設定檔 組態。
3

在 BroadWorks 上，使用來自其他身分/裝置設定檔 由其他使用者使用：

  1. 在 BroadWorks CommPilot 上，開啟不同的身分/裝置設定檔 其他使用者的組態。

  2. 確保允許啟用代碼上線 已檢查身分/裝置設定檔類型 已使用。

  3. 在身分/裝置設定檔 視窗中，按一下裝置啟動 標籤。

  4. 按一下請求啟用代碼。

    隨即顯示新的啟用代碼。新使用者必須輸入此代碼才能加入裝置。

下一步

  • 新的裝置所有者在裝置上輸入啟用代碼。

  • 裝置會使用新設定向 Webex 和 BroadWorks 重新註冊。新的身分/裝置設定檔 在 BroadWorks 上使用裝置 MAC 位址自動更新。

效能監控

此功能存在以下效能計數器。

計數器

說明

模組：Enterprises.broadsoft.broadworks.deviceActivation.activate

bwDASActivateRequests

收到的啟動請求總數。這包括啟動 BroadWorks 請求和啟動 Webex 請求。

bwDASActivateFailures

無法成功完成的啟動請求總數。這包括啟動失敗的 BroadWorks 請求和啟動失敗的 Webex 請求。

bwDASActivateBroadWorks 請求

收到的啟動 BroadWorks 請求數。

bwDASActivateBroadWorks 失敗次數

無法成功完成的啟動 BroadWorks 請求數。此計數器不考慮授權和驗證失敗。

bwDASActivateWebex 請求

收到的啟動 Webex 請求數。

bwDASActivateWebex失敗

無法成功完成的啟動 Webex 請求數。

模組：Enterprises.broadsoft.broadworks.dms.dmBridge

bwDMBridge 請求

已傳送的 DMBridge 請求數。

bwDMBridge 失敗

無法成功完成的 DMBridge 請求數。

Webex 整合裝置的一般使用者功能

統一通話歷史記錄

Webex 感知 MPP 電話

Webex for BroadWorks 平台上的 Webex 感知 Cisco MPP 裝置現在能夠顯示從使用者的 Webex 用戶端及其裝置撥打/接聽的通話的統一通話歷史記錄。這樣可以改善最終使用者裝置的體驗，因為他們可以透過其 MPP 裝置上的通話記錄以及在其裝置上處理的所有本地通話來觀察和使用透過 Webex 應用程式撥打/接聽的通話。

Webex Unified 通話記錄將成為檢視使用者通話歷史記錄的預設來源。此通話歷史記錄包含從所有電話、 Webex視訊裝置或Webex應用程式撥打的電話。

受影響的 IP 電話機型：

  • MPP68xx系列 6821、6841、6851、6861

  • MPP78xx系列 7811、7821、7841、7861

  • MPP88xx 8811、8841、8845、8851、8861、8865、8875 系列

功能啟用：

必須滿足以下條件才能啟用該功能

修補程式和 DTAF 需求：

  • Broadworks - 此功能取決於安裝的相關 BroadWorks 修補程式。可以找到詳細資訊這裡。

  • 裝置 - 需要套用最新的 MPP 組態。可以找到所需的 CPE 套件這裡 （使用 CCO ID 登入）。

預期/影響/限制：

  • 主要線路（僅限目前使用者）

    • 如前所述，將支援統一通話歷史記錄。

    • 支援隱私保護 - 設定使用者密碼時保護/隱藏通話記錄。

    • 如果電話不是雲端感知，則只會顯示此裝置的通話的「本地歷史記錄」。

  • 其他線路（共用或其他方式）

    • 僅支援與裝置之間的本地通話記錄。

  • 工作區裝置

    • 此實例將不支援統一通話歷史記錄。

開啟此功能後，將刪除 MPP（衍生自 BroadWorks）上的所有本地通話記錄。

Webex for BroadWorks 整合的 RoomOS 裝置

Webex for BroadWorks 整合的 Cisco RoomOS 裝置現在將能夠顯示從使用者的 Webex 用戶端及其裝置撥打/接聽的通話的統一通話歷史記錄。這可改善最終使用者裝置的體驗，因為他們可以透過其 RoomOS 裝置上的通話記錄來觀察和使用透過 Webex 應用程式撥打/接聽的通話，以及在其裝置上處理的所有本地通話。

Webex Unified 通話記錄將成為檢視使用者通話歷史記錄的預設來源。此通話歷史記錄包含從所有電話、 Webex視訊裝置或Webex應用程式撥打的電話。

適用於以下 RoomOS 裝置機型：

  • RoomOS 裝置

  • 桌面系列：Desk、Desk Mini、Desk Pro

  • Room 系列

  • RoomKit 系列

  • Webex Board 系列

功能啟用：

修補程式和 DTAF 需求：

  • Broadworks - 此功能取決於安裝的相關 BroadWorks 修補程式。可以找到詳細資訊這裡。

設定需求：

  • 下列組態需依指定設定

    • Bwks 設定：Feature_ Toggle_ Webex_呼叫=是

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

Webex for BroadWorks 整合的 Cisco RoomOS 裝置使用者現在可以透過實施新的增強型 Webex 目錄服務，直接從其 RoomOS 裝置搜尋 Webex 組織中的人員、空間甚至裝置。此服務向 Webex for BroadWorks 使用者提供增強的搜尋和查找功能，以便能夠在其 Webex 組織中尋找使用者和事物（工作區、裝置等）。

適用於以下 RoomOS 裝置機型：

  • RoomOS 裝置

  • 桌面系列：Desk、Desk Mini、Desk Pro

  • Room 系列

  • RoomKit 系列

  • Webex Board 系列

功能啟用：

設定需求：

  • 需要在裝置上啟用目錄服務切換「xConfiguration Webex DirectoryServiceSupport」。

簡介

關於本指南

本文件適用於部署 Webex for Cisco BroadWorks 的服務提供者組織中的合作夥伴管理員。本指南說明如何為 Cisco BroadWorks 版 Webex 上線和服務 Room OS 和 MPP 裝置。本指南分為兩個章節：

  • 裝置上線— 說明如何將 Room OS 裝置（Room 和 Room Kit 系列、Desk 系列和 Board 系列）和 MPP 裝置加入 Webex for Cisco BroadWorks。
  • 裝置可服務性- 說明如何在 Control Hub 中管理已加入的裝置。

Cisco BroadWorks 的 Webex 裝置整合

裝置上線概觀

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

  • 加入新的 Webex Room OS 裝置（使用啟用代碼）

  • 加入新的 MPP 裝置

  • 將 Webex 功能新增至現有 MPP 裝置

  • 我們建議您在與版本無關的 ADP 伺服器上部署此功能。但是，XSP 也支援此功能。如果您使用的是 XSP，則當本文件提及「ADP」時，您可以替換為「XSP」，除非文字僅指定 ADP。

  • 此功能同時支援個人裝置和工作區裝置。

Room OS 上線

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

使用啟用代碼的裝置上線

使用啟用代碼的裝置上線提供了一種簡單且安全的方式來上線 Room OS 裝置。啟用代碼是系統產生的 16 位一次性密碼，使用者必須在裝置上輸入該密碼才能加入裝置。啟用代碼會安全地鏈結至預期使用者帳戶，並確保只有預期使用者才能登錄鏈結至相同帳戶的裝置。使用者輸入正確的代碼後，裝置會同時連線至 Webex 和 BroadWorks，完成註冊，下載其設定檔案，然後即可使用。

以下 Room OS 裝置支援使用啟用代碼加入：

  • Webex Board 系列（Room OS）

  • 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 記錄，因為它預期會找到 的 SRV 項目_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 最低 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 設定需求

  • 若要實作此解決方案，必須設定 Flowthrough 佈建以允許 Broadworks 將裝置佈建給 Webex。

    設定流程佈建時，不一定要使用流程佈建來佈建使用者，也就是說，您可以繼續使用現有的佈建方法（API、受信任/不受信任的電子郵件、使用者自己等）來佈建使用者。請參閱「佈建需求」 Webex for Cisco BroadWorks 解決方案指南。

  • 確保整合的 IM+P 服務已在 BroadWorks 上啟用並指向 BroadWorks 佈建橋接。

    將客戶範本套用至組織時，已指定佈建橋接器 URL。這應該已在您初始設定 Webex for Cisco BroadWorks 期間完成。若要在 Partner Hub 中尋找現有的 URL，請參閱使用 Provisioning Service URL 設定應用程式伺服器 在Webex for Cisco BroadWorks 解決方案指南。

  • 如果您有多個合作夥伴組織，則每個合作夥伴都需要專用的裝置管理服務 (DMS) 實例。

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

確保已設定以下內容：

  • 在 BroadWorks 上部署裝置啟動服務。有關詳細資訊，請參閱使用啟用代碼的 Cisco BroadWorks 安全上線。

  • 驗證 BroadWorks 叢集的 DAS URL 設定是否設定為裝置管理服務 (DMS) URL。若要在 Partner Hub 中檢視目前的 DAS URL 設定，請轉至設定 > BroadWorks 通話 >檢視叢集 並選取適當的叢集。該 URL 出現在介面設定。

    如果 BroadWorks 叢集中有許多客戶 (>50)，則不支援新增 DAS URL 的功能。在這種情況下，建議聯絡 Cisco TAC 支援工程師以尋求協助。

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

  • 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 憑證的 CA 列於協作室作業系統信任清單中。您可以從以下位置檢視協作室作業系統信任清單：裝置 Web 入口網站。在入口網站上，選取安全性 >協作邊緣 以檢視 CA 清單。

Room OS 加入流程

完成下列工作以設定您的系統，以支援下列 Webex Room OS 裝置的使用啟用代碼的裝置上線：

  • Webex Board系列

  • Webex Desk 系列

  • Webex Room 系列

1

設定 Room OS 的服務

為 Room OS 裝置設定 BroadWorks 支援。

2

佈建協作室作業系統裝置

在 BroadWorks 上佈建新裝置。

3

請求啟用代碼

在裝置設定檔中，請求啟用代碼。代碼將自動透過電子郵件傳送給主要使用者。

設定 Room OS 的服務
在您可以加入任何新的 Room OS 裝置之前，請先設定以下系統層級參數以開啟 OAuth 驗證。
1

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

如果您已使用本文件中的其中一個流程取得 Cisco OAuth 身分識別提供者憑證，則無需建立新請求。但是，如果您使用本文件中未包含的流程獲取 Cisco OAuth 憑證，請完成新的服務請求以更新您的憑證。
Cisco 為您提供了有效期限為 60 天的 OAuth 用戶端 ID、用戶端密碼及重新整理權杖。如果權杖在您將其與 ADP 一起使用之前已過期，您可以提出另一個請求。
2

使用此 CLI 指令啟用 OAuth：

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

3

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

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

使用以下 CLI 指令設定 Cisco 身份識別提供者參數。

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

  • set clientId — 請參閱 ID 的服務請求回應。

  • 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. 設定 tokenInfoURL
如果 Teams 叢集為...將 tokenInfoURL 設定為...（IdP Proxy 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

  • 如果您不知道您的Teams 叢集，您可以從 Control Hub 的「技術支援」視圖中的「客戶詳細資料」獲取資訊。

  • 對於測試，您可以驗證 tokenInfoURL 是否有效，方法是將「idp/authenticate " 部分的 URL 包含 "ping 」。

5

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

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 內容下，且 CiscoIdentityProvider/Federation 內容中的 partnerName 需要與 CiscoIdentityProvider/Partners 內容中新增的合作夥伴相符。

如果您正在執行早於 2022.10 的 ADP RI 載入、沒有修補程式 AP.xsp.23.0.1075.ap383838 的 R23 XSP 或 R22 XSP，則：

  • 您無需在「System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>」下設定合作夥伴

  • 必須在以下位置設定重新整理權杖：System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

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

佈建協作室作業系統裝置
在 BroadWorks 上，佈建 Room OS 裝置（Webex Board 系列、Webex Desk 系列或 Webex Room 系列）。
1

在 BroadWorks CommPilot 上，勾選身分/裝置設定檔類型 設定，以查看此 Room OS 裝置是否存在該裝置類型。如果 BroadWorks 上不存在該裝置類型，請使用從 cisco.com 下載的 DTAF 檔案將該裝置類型匯入 BroadWorks。

2

匯入裝置類型後，請確保下列設定存在於身分/裝置設定檔類型 設定：

  • 檢查允許啟用代碼上線 勾選方塊

  • 檢查透過 Messaging Server 傳送啟用代碼請求 勾選方塊。

  • 設定驗證模式 至承載。

3

驗證裝置設定檔是否具有您要使用的 SIP 設定。在身分/裝置設定檔類型檔案 確保驗證模式 是承載。

4

使用新裝置的設定建立裝置設定檔。在身分/裝置設定檔新增/修改 頁面，將 MAC 位址欄位保留為空。

5

設定主要使用者。在使用者新增 頁，選取或取消選取isPlace 根據您打算將裝置用於個人還是共用工作區。

  • 已選取 — 工作區裝置

  • 未選取 — 個人裝置

共用工作區裝置還要求您指定主要使用者。您可以指定所需的主要使用者。
6

填寫與您要使用的裝置類型和佈建方法相對應的選項：

  • 裝置用於共用工作區 — 使用佈建 BroadWorks 工作區 用於完成工作區裝置佈建的 API。
  • 裝置是個人的；您想要使用公用 API 進行佈建 — 使用佈建 BroadWorks 訂閱者 API 以完成主要使用者的佈建。
  • 裝置是個人的；您希望使用者使用自行啟動—將使用者啟動入口網站 URL 轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。
  • 裝置是個人的；您想要使用佈建流程—請移至步驟 7。
7

如果裝置供個人使用，並且您想要使用佈建流程，則對於主要使用者，請指派整合的 IM+P 服務。在使用者 >設定檔 頁面，新增 IM+P 服務：

  1. 從設定檔 頁面上，按一下指定服務。

  2. 在清單中可用服務，選取整合的 IM&P 並使用箭頭將項目移至使用者服務 方塊。

  3. 按一下確定。

  4. 按一下設定檔。

  5. 僅限受信任的電子郵件流程。新增使用者電子郵件 地址。此設定充當 IM&P 電子郵件，用於佈建 Webex for Cisco BroadWorks 的流程。如果您使用的是不受信任的電子郵件流程，則不需要這樣做。

    Webex 上的客戶範本必須使用受信任電子郵件或不受信任電子郵件的佈建流程設定進行設定。有關詳細資訊，請參閱Webex for Cisco BroadWorks 解決方案指南。

下一步

請求 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 裝置加入 Webex 的更多資訊，請參閱功能說明適用於 Webex 啟用 MPP 裝置的 Cisco BroadWorks DMS 增強。

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 設定需求

  • 若要實作此解決方案，必須設定 Flowthrough 佈建以允許 Broadworks 將裝置佈建給 Webex。

    設定流程佈建時，不一定要使用流程佈建來佈建使用者，也就是說，您可以繼續使用現有的佈建方法（API、受信任/不受信任的電子郵件、使用者自己等）來佈建使用者。請參閱「佈建需求」 Webex for Cisco BroadWorks 解決方案指南。

  • 確保整合的 IM+P 服務已在 BroadWorks 上啟用並指向 BroadWorks 佈建橋接。

    將客戶範本套用至組織時，已指定佈建橋接器 URL。這應該已在您初始設定 Webex for Cisco BroadWorks 期間完成。若要在 Partner Hub 中尋找現有的 URL，請參閱使用 Provisioning Service URL 設定應用程式伺服器 在Webex for Cisco BroadWorks 解決方案指南。

  • 如果您有多個合作夥伴組織，則每個合作夥伴都需要專用的裝置管理服務 (DMS) 實例。

憑證和防火牆

確保您已設定下列項目：

  • 憑證需求—MPP 裝置透過裝置憑證使用 mTLS 驗證。憑證提供的裝置 MAC 位址會驗證裝置。從以下位置下載 MPP 裝置所需的憑證：https://www.cisco.com/security/pki/ 。

    • Cisco 根 CA 2048 (crca2048) - PEM

    • Cisco 根 CA 2099 (crca2099) - PEM

    • Cisco 根 CA M1 (crcam1) - PEM

    • Cisco 根 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 不在防火牆後面，則不存在上述要求。

功能啟用

在 AS 上啟動下列 BroadWorks 功能：

  • 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 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 位址，然後可將其放在使用描述性名稱的標頭中（例如，macaddress ）。

請參閱防火牆說明文件以獲取有關設定的說明。

1

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

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

如果您已使用本文件中的其中一個流程取得 Cisco OAuth 身分識別提供者憑證，則無需建立新請求。但是，如果您使用本文件中未包含的流程獲取 Cisco OAuth 憑證，請完成新的服務請求以更新您的憑證。
2

執行下列 CLI 指令來設定 Cisco 身份識別提供者參數。

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

  • set clientId — 請參閱 ID 的服務請求回應。

  • 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

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

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

表 4. DM_橋接器 URL

如果 Teams 叢集為...

設定 DM_橋接 URL 至...

ACHM

dm-bridge-a.wbx2.com

AORE

dm-bridge-r.wbx2.com

AFRA

dm-bridge-k.wbx2.com

4

使用驗證標頭或驗證憑證啟用 MAC 位址擷取和驗證。基於安全性考量，我們建議您僅使用其中一個選項：

  • 驗證標頭—如果 ADP 位於防火牆後面，請使用 ADP 上的 CLI 為驗證標頭啟用 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 裝置 — 在 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

設定主要使用者。在使用者新增 頁面，設定isPlace 勾選方塊，根據裝置是個人裝置還是共用工作區：

  • 已選取 — 工作區裝置

  • 未選取 — 個人裝置

6

填寫與您要使用的裝置類型和佈建方法相對應的選項：

  • 裝置用於共用工作區 — 使用佈建 BroadWorks 工作區 用於完成工作區裝置佈建的 API。
  • 裝置是個人的；您想要使用公用 API 進行佈建 — 使用佈建 BroadWorks 訂閱者 API 以完成主要使用者的佈建。
  • 裝置是個人的；您希望使用者使用自行啟動—將使用者啟動入口網站 URL 轉寄給使用者。使用者必須驗證其電子郵件地址才能完成佈建。
  • 裝置是個人的；您想要使用佈建流程—請移至步驟 7。
7

如果裝置供個人使用，並且您想要使用佈建流程，則對於主要使用者，請指派整合的 IM+P 服務。在使用者 >設定檔 頁面，新增 IM+P 服務：

  1. 從設定檔 頁面上，按一下指定服務。

  2. 在清單中可用服務，選取整合的 IM&P 並使用箭頭將項目移至使用者服務 方塊。

  3. 按一下確定。

  4. 按一下設定檔。

  5. 僅限受信任的電子郵件流程。新增使用者電子郵件 地址。此設定充當 IM&P 電子郵件，用於佈建 Webex for Cisco BroadWorks 的流程。如果您使用的是不受信任的電子郵件流程，則不需要這樣做。

    Webex 上的客戶範本必須使用受信任電子郵件或不受信任電子郵件的佈建流程設定進行設定。有關詳細資訊，請參閱Webex for Cisco BroadWorks 解決方案指南。

下一步

可選。如果您要使用啟用代碼來加入 MPP 裝置，請在 BroadWorks 上請求啟用代碼。
請求 MPP 的啟用代碼

（可選）Webex for Cisco BroadWorks 不需要啟用代碼即可加入新的 MPP 裝置。但是，如果您決定使用啟用代碼，請完成請求啟用代碼 程序來請求新裝置的啟用代碼。

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

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

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

  • 在 BroadWorks 上部署裝置啟動服務。有關詳細資訊，請參閱使用啟用代碼的 Cisco BroadWorks 安全上線。

  • 使用以下 CLI 指令將裝置啟動服務 (DAS) 指向 BroadWorks AS 上的裝置管理服務 (DMS)：

    AS_CLI/Interface/DAS> set url

  • 驗證 BroadWorks 叢集的 DAS URL 設定是否設定為裝置管理服務 (DMS) URL。若要在 Partner Hub 中檢視目前的 DAS URL 設定，請轉至設定 > BroadWorks 通話 >檢視叢集 並選取適當的叢集。該 URL 出現在介面設定。

    如果 BroadWorks 叢集中有許多客戶 (>50)，則不支援新增 DAS URL 的功能。在這種情況下，建議聯絡 Cisco TAC 支援工程師以尋求協助。

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

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

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

    ADP_CLI/Applications/BroadworksDms/DeviceActivation/IdentityProviders/Cisco> get
  set gdsDomain  e.g. https://activation.webex.com
  set clientId 
  clientSecret 
  refreshToken
除了上述特定於啟用代碼的先決條件之外，您的系統還必須滿足以下項目中的一般 MPP 先決條件： MPP 裝置先決條件。
請求啟用代碼

完成下列步驟以請求新 MPP 裝置的啟用代碼。

  1. 在身分/裝置設定檔 頁面上，搜尋並開啟新裝置的裝置設定檔。

  2. 按一下裝置啟動 標籤。

  3. 按一下請求啟用代碼。

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

裝置可服務性

服務能力概觀

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 刪除現有的裝置註冊：

  1. 在 Webex Control Hub 中，開啟目前裝置所有者所屬的客戶組織。

  2. 低於管理，按一下裝置。

  3. 選取與您要移動的裝置相鄰的方塊。

  4. 按一下刪除。

    裝置註冊將從 Webex 中刪除。
2

在 BroadWorks 上，停用現有使用者下的裝置註冊：

  1. 在 BroadWorks CommPilot 上，開啟身分/裝置設定檔 裝置使用。

  2. 按一下裝置啟動 標籤。

  3. 按一下停用裝置。

    裝置會從 BroadWorks 停用並取消註冊。MAC 位址會從舊 身分/裝置設定檔 組態。
3

在 BroadWorks 上，使用來自其他身分/裝置設定檔 由其他使用者使用：

  1. 在 BroadWorks CommPilot 上，開啟不同的身分/裝置設定檔 其他使用者的組態。

  2. 確保允許啟用代碼上線 已檢查身分/裝置設定檔類型 已使用。

  3. 在身分/裝置設定檔 視窗中，按一下裝置啟動 標籤。

  4. 按一下請求啟用代碼。

    隨即顯示新的啟用代碼。新使用者必須輸入此代碼才能加入裝置。

下一步

  • 新的裝置所有者在裝置上輸入啟用代碼。

  • 裝置會使用新設定向 Webex 和 BroadWorks 重新註冊。新的身分/裝置設定檔 在 BroadWorks 上使用裝置 MAC 位址自動更新。

效能監控

此功能存在以下效能計數器。

計數器

說明

模組：Enterprises.broadsoft.broadworks.deviceActivation.activate

bwDASActivateRequests

收到的啟動請求總數。這包括啟動 BroadWorks 請求和啟動 Webex 請求。

bwDASActivateFailures

無法成功完成的啟動請求總數。這包括啟動失敗的 BroadWorks 請求和啟動失敗的 Webex 請求。

bwDASActivateBroadWorks 請求

收到的啟動 BroadWorks 請求數。

bwDASActivateBroadWorks 失敗次數

無法成功完成的啟動 BroadWorks 請求數。此計數器不考慮授權和驗證失敗。

bwDASActivateWebex 請求

收到的啟動 Webex 請求數。

bwDASActivateWebex失敗

無法成功完成的啟動 Webex 請求數。

模組：Enterprises.broadsoft.broadworks.dms.dmBridge

bwDMBridge 請求

已傳送的 DMBridge 請求數。

bwDMBridge 失敗

無法成功完成的 DMBridge 請求數。

Webex 整合裝置的一般使用者功能

統一通話歷史記錄

Webex 感知 MPP 電話

Webex for BroadWorks 平台上的 Webex 感知 Cisco MPP 裝置現在能夠顯示從使用者的 Webex 用戶端及其裝置撥打/接聽的通話的統一通話歷史記錄。這樣可以改善最終使用者裝置的體驗，因為他們可以透過其 MPP 裝置上的通話記錄以及在其裝置上處理的所有本地通話來觀察和使用透過 Webex 應用程式撥打/接聽的通話。

Webex Unified 通話記錄將成為檢視使用者通話歷史記錄的預設來源。此通話歷史記錄包含從所有電話、 Webex視訊裝置或Webex應用程式撥打的電話。

受影響的 IP 電話機型：

  • MPP68xx系列 6821、6841、6851、6861

  • MPP78xx系列 7811、7821、7841、7861

  • MPP88xx 8811、8841、8845、8851、8861、8865、8875 系列

功能啟用：

必須滿足以下條件才能啟用該功能

修補程式和 DTAF 需求：

  • Broadworks - 此功能取決於安裝的相關 BroadWorks 修補程式。可以找到詳細資訊這裡。

  • 裝置 - 需要套用最新的 MPP 組態。可以找到所需的 CPE 套件這裡 （使用 CCO ID 登入）。

預期/影響/限制：

  • 主要線路（僅限目前使用者）

    • 如前所述，將支援統一通話歷史記錄。

    • 支援隱私保護 - 設定使用者密碼時保護/隱藏通話記錄。

    • 如果電話不是雲端感知，則只會顯示此裝置的通話的「本地歷史記錄」。

  • 其他線路（共用或其他方式）

    • 僅支援與裝置之間的本地通話記錄。

  • 工作區裝置

    • 此實例將不支援統一通話歷史記錄。

開啟此功能後，將刪除 MPP（衍生自 BroadWorks）上的所有本地通話記錄。

Webex for BroadWorks 整合的 RoomOS 裝置

Webex for BroadWorks 整合的 Cisco RoomOS 裝置現在將能夠顯示從使用者的 Webex 用戶端及其裝置撥打/接聽的通話的統一通話歷史記錄。這可改善最終使用者裝置的體驗，因為他們可以透過其 RoomOS 裝置上的通話記錄來觀察和使用透過 Webex 應用程式撥打/接聽的通話，以及在其裝置上處理的所有本地通話。

Webex Unified 通話記錄將成為檢視使用者通話歷史記錄的預設來源。此通話歷史記錄包含從所有電話、 Webex視訊裝置或Webex應用程式撥打的電話。

適用於以下 RoomOS 裝置機型：

  • RoomOS 裝置

  • 桌面系列：Desk、Desk Mini、Desk Pro

  • Room 系列

  • RoomKit 系列

  • Webex Board 系列

功能啟用：

修補程式和 DTAF 需求：

  • Broadworks - 此功能取決於安裝的相關 BroadWorks 修補程式。可以找到詳細資訊這裡。

設定需求：

  • 下列組態需依指定設定

    • Bwks 設定：Feature_ Toggle_ Webex_呼叫=是

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

Webex for BroadWorks 整合的 Cisco RoomOS 裝置使用者現在可以透過實施新的增強型 Webex 目錄服務，直接從其 RoomOS 裝置搜尋 Webex 組織中的人員、空間甚至裝置。此服務向 Webex for BroadWorks 使用者提供增強的搜尋和查找功能，以便能夠在其 Webex 組織中尋找使用者和事物（工作區、裝置等）。

適用於以下 RoomOS 裝置機型：

  • RoomOS 裝置

  • 桌面系列：Desk、Desk Mini、Desk Pro

  • Room 系列

  • RoomKit 系列

  • Webex Board 系列

功能啟用：

設定需求：

  • 需要在裝置上啟用目錄服務切換「xConfiguration Webex DirectoryServiceSupport」。

本文是否有幫助？
本文是否有幫助？
定價Webex 應用程式MeetingsCalling傳訊螢幕共用
Webex SuiteCallingMeetings傳訊SlidoWebinarsSocioContact CenterCPaaS安全性Control Hub
耳機攝影機Desk 系列Room 系列Board 系列電話系列配件
教育醫療保健政府財務運動與娛樂前線非營利啟動混合式工作
下載加入測驗會議線上課程整合協助工具包容性即時和隨選網路研討會Webex 社群Webex 開發人員新聞與創新
Cisco聯絡技術支援聯絡銷售人員Webex BlogWebex 思想領導力Webex Merch Store職業
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
條款和條件隱私權聲明Cookie商標
©2025 Cisco 和/或其子公司。保留所有權利。
條款和條件隱私權聲明Cookie商標