需共同駐留

• 身份驗證服務必須與 Xsi 應用程式共同駐留，因為這些介面必須接受長期使用權杖才能進行服務授權。 需有這項身份驗證服務才能驗證這些權杖。

• 如有必要，驗證服務和 Xsi 可以在同一連接埠上執行。

• 您可以根據需要分離其他服務/應用程式（專用裝置管理 XSP|例如 ADP 場）。

• 您可以共置 Xsi、CTI、驗證服務及 DMS 應用程式。

• 請勿在 XSP 上安裝其他應用程式或服務|用於將 BroadWorks 與Webex整合的 ADP。

• 請勿將 NPS 應用程式與任何其他應用程式共置。

Xsi 介面

按照 Cisco BroadWorks Xtended Services 介面設定指南中的說明來安裝和設定 Xsi-Actions 和 Xsi-Events 應用程式。

只應在 XSP 上部署一個 Xsi-Events 應用程式實例|用於CTI介面的 ADP。

用於將 Broadworks 與Webex整合的所有 Xsi-Events 必須具有相同的 callControlApplicationName（在應用程式/Xsi-Events/一般設定下定義）。 譬如：

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

當使用者上線Webex時， Webex會在 AS 上為該使用者建立訂閱，以便接收關於狀態和通話歷史記錄的電話事件。 訂閱與 callControlApplicationName 相關聯，AS 使用它來知道要將電話事件傳送到哪些 Xsi-Events。

變更 callControlApplicationName 或在所有 Xsi-Events Web 應用程式上使用不同的名稱，將會影響訂閱和電話事件功能。

設定驗證服務（使用 CI 權杖驗證）

使用此程序來設定驗證服務以將 CI 權杖驗證與 TLS 一同使用。 如果執行 R22 或更高版本且系統支援此驗證方法，建議使用此方法。

支援使用雙向 TLS (mTLS) 作為驗證服務的替代方法。 如果您有多個Webex組織使用相同的 XSP| ADP 伺服器，您必須使用 mTLS 驗證，因為 CI 權杖驗證不支援與同一個 XSP 的多個連線|ADP 驗證服務。 若要為驗證服務設定 mTLS 驗證而非 CI 權杖驗證，請參閱設定服務（驗證服務使用 mTLS）的附錄。

如果您目前的驗證服務使用 mTLS，那麼您不見得一定要重設為將 CI 權杖驗證搭配 TLS 一起使用。

1. 獲取Webex for Cisco BroadWorks 的 OAuth 憑證。

2. 在每個 XSP 上安裝下列修補程式|ADP 伺服器。 安裝適用於您的發行版本的修補程式：

   • 若版本為 R22：

     AP.platform.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap368601

   • 若版本為 R23：

     AP.xsp.23.0.1075.ap376509

     AP.platform.23.0.1075.ap376509

   • 若版本為 R24 — 不需要任何修補程式

   對 XSP 的任何參考都包括 XSP 或 ADP。

3. 安裝 AuthenticationService 應用程式上的每個 XSP| ADP 服務。

   1. 執行下列指令以啟動 XSP 上的 AuthenticationService 應用程式|ADP 至 /authService 內容路徑。

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService

   2. 執行此指令以在 XSP 上部署 AuthenticationService| ADP：

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...

4. 從 BroadWorks 內部版本 2022.10 開始，在切換至新版 Java 時， Java隨附的憑證授權單位不再自動包含在 BroadWorks 信任儲存區中。 驗證服務會開啟與Webex的TLS連線以擷取存取權杖，並且需要在其信任庫中具有以下內容來驗證 IDbroker 和Webex URL：

   • IdenTrust Commercial Root CA 1

   • Go Daddy Root Certificate Authority - G2

   驗證這些憑證是否存在於以下 CLI 下

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

   如果不存在，請執行以下指令以匯入預設的Java信任：

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

   或者，您可以使用以下指令將這些憑證手動新增為信任錨：

   ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>

   如果 ADP 是從先前的發行版升級，則舊發行版的憑證授權單位將自動匯入新版本，並且將繼續匯入，直到手動將其移除。

   AuthenticationService 應用程式可免除 ADP 下的 validatePeerIdentity 設定_CLI/系統/SSLCommon設定/一般設定，並且始終驗證對等身分。 請參閱Cisco Broadworks X509 憑證驗證 FD有關此設定的更多資訊。

5. 透過在每個 XSP 上執行下列指令來設定身分識別提供者|ADP 伺服器：

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get

   • set clientId client-Id-From-Step1

   • set enabled true

   • set clientSecret client-Secret-From-Step1

   • set ciResponseBodyMaxSizeInBytes 65536

   • set issuerName <URL> — 對於 URL ，請輸入適用於 CI 叢集的 IssuerName URL。 請參閱下表。

   • set issuerUrl <URL> — 對於 URL ，請輸入適用於 CI 叢集的 IssuerUrl。 請參閱下表。

   • set tokenInfoUrl <IdPProxy URL> — 輸入適用於 Teams 叢集的 IdP Proxy URL。 請參閱隨後的第二個表格。

   表 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/authenticate 」部分取代為「 ping 」。

6. 執行下列指令以指定需顯示在 Webex 使用者設定檔中的 Webex：

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user

7. 在每個 XSP 上使用以下指令為Cisco聯盟設定身分提供者|ADP 伺服器：

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get

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

   • set refreshPeriodInMinutes 60

   • set refreshToken refresh-Token-From-Step1

8. 執行下列指令以驗證您的 FLS 設定是否正常運作。 此指令會傳回身份識別提供者清單：

   XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get

9. 在每個 XSP 上使用以下指令配置權杖管理|ADP 伺服器：

   • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

   • set tokenIssuer BroadWorks

   • set tokenDurationInHours 720

10. 產生及共用 RSA 金鑰。 您必須在一個 XSP 上產生金鑰|然後 ADP 將它們複製到所有其他 XSP| ADP。 原因如下：

    • 您必須在驗證服務的所有實例之間使用相同的公開/私密金鑰組進行權杖加密/解密。

    • 首次要求發出權杖時，驗證服務會產生金鑰組。

    如果您循環使用金鑰或變更金鑰長度，則需要重複以下設定並重新啟動所有 XSP| ADP。

    1. 選取一個 XSP|用於產生金鑰對的 ADP。

    2. 使用用戶端從該 XSP 請求加密的權杖|ADP，透過從用戶端的瀏覽器請求以下URL ：

       https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)

       （這會在 XSP 上生成私密/公開金鑰對|ADP（如果還沒有的話）

    3. 無法設定金鑰存放區的位置。 金鑰匯出的位置如下：

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. 將匯出的檔案 /var/broadworks/tmp/authService.keys 複製到另一個 XSP 上的相同位置|ADP，覆寫較舊的 .keys 檔案（如有必要）。

    5. 匯入每個其他 XSP 上的金鑰|ADP：

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys

11. 向 Web 容器提供 authService URL。 XSP| ADP 的 Web 容器需要 authService URL ，以便可以驗證權杖。 在每個 XSP| ADP：

    1. 新增驗證服務 URL 作為 BroadWorks Communications 公用程式的外部驗證服務：

       XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

    2. 新增驗證服務 URL 至容器：

       XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

       這可讓 Webex 使用驗證服務來驗證呈現為認證的權杖。

    3. 使用下列指令檢查參數： get 。

    4. 重新啟動 XSP| ADP。

移除驗證服務的用戶端驗證要求（僅限 R24）

如果已將 R24 設為使用 CI 權杖驗證作為驗證服務，則還必須移除驗證服務的用戶端驗證要求。 請執行下列 CLI 指令：

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false

在 HTTP 介面上設定 TLS 和密碼（用於 XSI 和驗證服務）

驗證服務、Xsi-Actions 和 Xsi-Events 應用程式都會使用 HTTP 伺服器介面。 這些應用程式的 TLS 可設定程度如下：

最一般 = 系統 > 傳輸 > HTTP > HTTP 伺服器介面 = 最明確

用於檢視或修改不同 SSL 設定的 CLI 內容包括：

在 XSP 上讀取 HTTP 伺服器TLS介面組態|ADP

1. 登入 XSP| ADP 並導覽至 XSP|ADP_CLI/Interface/Http/HttpServer>

2. 輸入 get 指令並讀取結果。 您會看到介面（IP 位址），也會看到每個介面是否安全以及是否需要用戶端驗證。

Apache tomcat 會強制每個安全介面使用一個憑證；系統會在必要時產生自我簽署憑證。

XSP|ADP_CLI/Interface/Http/HttpServer> get

新增 TLS 1.2 通訊協定至 HTTP 伺服器介面

必須將與 Webex Cloud 互動的 HTTP 介面設為 TLSv1.2。 雲端不會接受舊版的 TLS 通訊協定。

在 HTTP 伺服器介面上設定 TLSv1.2 通訊協定的步驟如下：

1. 登入 XSP| ADP 並導覽至 XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

2. 輸入指令 get <interfaceIp> 443 以查看哪些通訊協定已在此介面上使用。

3. 輸入指令 add <interfaceIp> 443 TLSv1.2 以確保介面在與雲端通訊時可以使用 TLS 1.2。

在 HTTP 伺服器介面上編輯 TLS 加密設定

設定所需密碼的步驟如下：

1. 登入 XSP| ADP 並導覽至 XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

2. 輸入指令 get <interfaceIp> 443 以查看哪些密碼已在此介面上使用。 Cisco建議的套件中必須至少有一個（請參閱 XSP| ADP 身分和安全性需求在概觀部分中）。

3. 輸入指令 add <interfaceIp> 443 <cipherName> 以將密碼新增至 HTTP 伺服器介面。

   XSP| ADP CLI 需要 IANA 標準加密套件名稱，而不是 openSSL 加密套件名稱。 例如，若要將 openSSL 密碼 ECDHE-ECDSA-CHACHA20-POLY1305 新增至 HTTP 伺服器介面，則會使用： XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 請參閱https://ciphersuite.info/以按任一名稱尋找套件。

在 XSP 上配置裝置管理|ADP、應用程式伺服器和設定檔伺服器

設定檔伺服器和 XSP| 「裝置管理」強制使用 ADP。 必須根據 BroadWorks 裝置管理設定指南中的指示對其進行設定。

設定 CTI 訂閱的應用程式伺服器

使用 Webex for Cisco BroadWorks CTI 用戶端憑證的一般名稱 (CN) 來更新應用程式伺服器的 ClientIdentity。

請針對與 Webex 搭配使用的每個應用程式伺服器，新增憑證身份至 ClientIdentity，如下所示：

AS_CLI/System/ClientIdentity> add bwcticlient.webex.com

Webex for Cisco BroadWorks 用戶端憑證的一般名稱是 bwcticlient.webex.com 。

在 CTI 介面上設定 TLS 和密碼

XSP 的可配置性級別|ADP CTI介面如下：

最一般 = 系統 > 傳輸 > CTI 介面 > CTI 介面 = 最明確

用於檢視或修改不同 SSL 設定的 CLI 內容包括：

全新安裝時，依預設在系統層級安裝以下密碼。 若在介面層級 (例如在CTI介面或 HTTP 介面) 未設定任何內容，則適用此密碼清單。 請注意，此清單可能會隨著時間而變更： TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_DHE_DSS_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_DSS_WITH_AES_128_CBC_SHA256 TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256

在 XSP 上讀取CTI TLS介面組態|ADP

1. 登入 XSP| ADP 並導覽至 XSP|ADP_CLI/Interface/CTI/CTIServer>

2. 輸入 get 指令並讀取結果。 您會看到介面（IP 位址），也會看到每個介面是否需要伺服器憑證以及是否需要用戶端驗證。

   XSP|ADP_CLI/Interface/CTI/CTIServer> get
     Interface IP  Port  Secure  Server Certificate  Client Auth Req
   =================================================================
     10.155.6.175  8012    true                true             true
   

新增 TLS 1.2 通訊協定至 CTI 介面

XSP|與Webex 雲端互動的 ADP CTI介面必須設定為TLS 1.2 版。 雲端不會接受舊版的 TLS 通訊協定。

在 CTI 介面上設定 TLSv1.2 通訊協定的步驟如下：

1. 登入 XSP| ADP 並導覽至 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

2. 輸入指令 get <interfaceIp> 以查看哪些通訊協定已在此介面上使用。

3. 輸入指令 add <interfaceIp> TLSv1.2 以確保介面在與雲端通訊時可以使用 TLS 1.2。

在 CTI 介面上編輯 TLS 加密設定

在 CTI 介面上設定所需密碼的步驟如下：

1. 登入 XSP| ADP 並導覽至 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

2. 輸入 get 指令以查看哪些密碼已在此介面上使用。 Cisco建議的套件中必須至少有一個（請參閱 XSP| ADP 身分和安全性需求在概觀部分中）。

3. 輸入指令 add <interfaceIp> <cipherName> 以將密碼新增至 CTI 介面。

   XSP| ADP CLI 需要 IANA 標準加密套件名稱，而不是 openSSL 加密套件名稱。 例如，若要將 openSSL 密碼 ECDHE-ECDSA-CHACHA20-POLY1305 新增至 CTI 介面，則會使用： XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 請參閱https://ciphersuite.info/以按任一名稱尋找套件。

CTI介面的信任定位（R22 及更高版本）

此過程假設 XSP| ADP 面向網際網路或透過傳遞 Proxy 面向網際網路。 橋接 Proxy 的憑證設定則有所不同（請參閱 TLS 橋接 Proxy 的 TLS 憑證需求）。

對於每個 XSP|在將CTI事件發佈到Webex的基礎架構中的 ADP，請執行以下操作：

1. 登入 Partner Hub。

2. 轉至設定 > BroadWorks Calling，然後按一下下載 Webex CA 憑證以將 CombinedCertChain2023.txt 下載至本地電腦。

   這些檔案包含兩組兩個憑證。 您需要先分割檔案，然後再將其上傳至 XSP| ADP。 所有檔案都是必需的。

3. 將憑證鏈結分成兩個憑證 - combinedcertchain2023.txt

   1. 開啟 combinedcertchain2023.txt （在文字編輯器中）。

   2. 選取並剪下第一個文字區塊，包括行 -----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE----- ，然後將文字區塊貼至新檔案。

   3. 將新檔案儲存為 root2023.txt 。

   4. 將原始檔案儲存為 issuing2023.txt 。 現在，原始檔案應該只有一個文字區塊，被下列行所包圍： -----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE----- 。

4. 將兩個文字檔案複製到 XSP 上的臨時位置|您要保護的 ADP，例如 /var/broadworks/tmp/root2023.txt 和 /var/broadworks/tmp/issuing2023.txt

5. 登入 XSP| ADP 並導覽至 /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

6. （可選）執行 help updateTrust 以查看參數和指令格式。

7. 將憑證檔案上傳至新的信任定位點 - 2023

   XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt

   XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt

   所有別名必須具有不同的名稱。 webexclientroot2023 和 webexclientissuing2023 是信任錨的別名範例；您可以使用自己的，只要所有項目都是獨一無二的。

8. 確認起點已更新：

   XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get

     Alias   Owner                                   Issuer
   =============================================================================
   webexclientissuing2023       Internal Private TLS SubCA      Internal Private Root
   webexclientroot2023       Internal Private Root      Internal Private Root[self-signed]

9. 允許用戶端使用憑證進行身份驗證：

   XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

新增 CTI 介面並啟用 mTLS

1. 新增 CTI SSL 介面。

   CLI 內容視 BroadWorks 版本而有所不同。 下列指令會在介面上建立自我簽署伺服器憑證，並強制介面索取用戶端憑證。

   • 在 BroadWorks R22 和 R23 上：

     XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true

2. 取代 XSP 上的伺服器憑證和金鑰|ADP 的CTI介面。 更換時需輸入 CTI 介面的 IP 位址；此位址可從下列內容中讀取：

   • 在 BroadWorks R22 和 R23 上：

     XSP|ADP_CLI/Interface/CTI/CTIServer> get

     然後執行下列指令，即可用您自己的憑證和私密金鑰取代介面的自我簽署憑證：

     XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>

3. 重新啟動 XSP| ADP。

啟用存取 Webex 上的 BroadWorks CTI Events 的權限

當您在 Partner Hub 中設定您的叢集時，必須新增及驗證 CTI 介面。 如需詳細說明，請參閱在 Partner Hub 中設定您的合作夥伴組織。

當您在 Partner Hub 中設定您的叢集時，必須新增及驗證 CTI 介面。 如需詳細說明，請參閱在 Partner Hub 中設定您的合作夥伴組織。

• 指定 Webex 可用來訂閱 BroadWorks CTI Events 的 CTI 位址。

• CTI 訂閱是按訂閱者提供的服務，訂閱者必須先佈建 Webex for Cisco BroadWorks，才能使用 CTI 訂閱並接受其維護服務。

使用者體驗

• Windows 使用者： 按一下呼叫設定然後按一下開啟呼叫喜好設定>進階呼叫設定。

• Mac 使用者： 按一下設定檔圖片，然後喜好設定>進階呼叫設定。

在 XSP 上安裝呼叫設定 Web 檢視|ADP

CSWV 應用程式必須位於相同的 XSP 上|在您的環境中託管 Xsi-Actions 介面的 ADP。 它是 XSP 上的非託管應用程式|ADP，所以您需要安裝和部署網路歸檔檔案。

1. 登入 cisco.com 並在軟體下載區段中搜尋「BWCallSettingsWeb」。

2. 尋找並下載該檔案的最新版本。

   例如： BWCallSettingsWeb_1.8.2_1.war （ https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04 ) 是在撰寫本文時最近的一次。

3. 根據適用於您的 XSP 的Cisco BroadWorks Xtended Service 平台組態指南安裝、啟動和部署 Web 歸檔|ADP 版本。 （R24 版本是https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf)。

   1. 將 .war 檔案複製到 XSP 上的臨時位置|ADP，例如 /tmp/ 。

   2. 導覽至下列 CLI 內容，然後執行安裝指令：

      XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war

      BroadWorks 軟體管理員會驗證並安裝檔案。

   3. [可選] 刪除 /tmp/BWCallSettingsWeb_1.7.5_1.war （不再需要此檔案）。

   4. 啟動應用程式：

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      任何應用程式都必須輸入 名稱和版本，但是針對 CSWV，您還必須輸入 contextPath，因為它是未管理的應用程式。 您可使用未由另一個應用程式使用的任何值，例如 /callsettings 。

   5. 在選定的內容路徑上部署 Call Settings 應用程式：

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

4. 現在，您可預測您將為用戶端指定的通話設定 URL 如下：

   https://<XSP|ADP-FQDN>/callsettings/

   附註：

   • 當您在用戶端設定檔中輸入此 URL 時，必須在此 URL 的結尾加上斜線。

   • XSP| ADP-FQDN 必須符合 Xsi-Actions FQDN，因為 CSWV 需要使用 Xsi-Actions，而且不支援 CORS。

5. 對其他 XSP 重複此程序|您的Webex for Cisco BroadWorks 環境中的 ADP（如有必要）。

「通話設定 Web 檢視」應用程式現在在 XSP 上可用|ADP。

NPS Proxy 概觀

為了與 Webex for Cisco BroadWorks 相容，您必須修補 CNPS 以支援 UCaaS VoIP 推送伺服器這個 NPS Proxy 功能。

此功能會在通知推送伺服器中進行新設計以解決與行動用戶端的服務提供者共用推送通知憑證私密金鑰的安全弱點。 NPS 不與服務提供者共用推送通知憑證和金鑰，而是使用新 API 從 Webex for Cisco BroadWorks 後端取得短暫使用的推送通知權杖，並使用此權杖來接受 Apple APNs 和 Google FCM 服務的驗證。

此功能還加強了通知推送伺服器透過新的 Google Firebase 雲訊息傳遞 (FCM) HTTPv1 API 將通知推送至 Android 裝置的功能。

• 如需詳細資訊，請參閱 UCaaS VoIP 推送伺服器功能說明。

• 該功能的 BroadWorks 修補程式可用於： https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04。

  如需 NPS 軟體和修補程式，請參閱準備您的 NPS for Webex for Cisco BroadWorks 。

  從軟體下載頁搜尋並下載修補程式。

• ADP 伺服器的相關資訊可在 https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html 上找到。

設定 BroadWorks 叢集

[每個叢集一次]

這麼做的原因如下：

• 若要讓Webex雲端針對 BroadWorks 驗證使用者（透過 XSP| ADP 託管的驗證服務)。

• 讓 Webex 應用程式得以使用 Xsi 介面進行通話控制。

• 讓 Webex 得以聽取 BroadWorks 發佈的 CTI 事件（電話線上狀態及通話歷史記錄）。

當您新增介面時，叢集精靈會自動驗證介面。 如果有任何介面未成功驗證，您可繼續編輯該叢集，但如果輸入了任何無效的內容，您就無法儲存該叢集。 我們必須防範未然，因為叢集如果設定錯誤，可能會造成難以解決的問題。

您需要執行的操作：

1. 使用您的合作夥伴管理員認證登入 Partner Hub (admin.webex.com)。

2. 從側邊功能表中開啟設定頁面，然後找出 BroadWorks Calling 設定。

3. 按一下新增叢集。

   這會啟動一個精靈，您在其中提供 XSP| ADP 介面（URL）。 如果您使用非標準連接埠，則可新增連接埠至介面 URL。

4. 命名此叢集並按一下下一步。

   此處的叢集概念只是介面的集合，通常並置在 XSP 上。| ADP 伺服器或場，可讓Webex從您的應用程式伺服器 (AS) 讀取資訊。 您可能有一個 XSP|每個 AS 叢集或多個 XSP 的 ADP|每個叢集的 ADP 數，或每個 XSP 多個 AS 叢集|ADP。 您的 BroadWorks 系統規模需求不在本文探討的範圍內。

5. （可選）輸入就您所知位於與 Webex 連線的 BroadWorks 系統內的 BroadWorks 使用者帳戶名稱和密碼，然後按一下下一步。

   驗證測試可使用此帳戶來驗證與叢集內介面的連線。

6. 新增您的 XSI Actions 和 XSI Events URL。

7. 可選 更新DAS URL使用裝置啟動服務的URL 。

8. 可選 檢查啟用直接 BroadWorks 驗證如果您希望 BroadWorks 的登入直接至 BroadWorks，勾選方塊。 否則，對 BroadWorks 的驗證將透過 Webex 託管的 IdP 代理服務進行代理。

   此勾選方塊會影響以下登入情況：

   • 使用者啟動入口網站登入 — 使用者在登入入口網站時必須輸入其 BroadWorks 憑證。 上述設定決定登入是直接 BroadWorks 還是透過 IdP Proxy。

   • 用戶端登入 — 如果BroadWorks 驗證是在上線範本中設定，則上述設定決定用戶端登入Webex應用程式是直接登入 BroadWorks 還是透過 IdP Proxy 進行代理。

9. 按下一步。

10. 在 CTI 介面頁上，執行以下操作：

    1. 在想要與其連線的 CTI 介面中新增 CTI URL 和連接埠。

    2. 可選 啟用通話記錄切換，然後輸入您的 BroadWorks使用者 ID。 選擇此選項後，BroadWorks通話歷史記錄事件會同步到Webex雲端。 使用者可在 Webex 應用程式中查看其通話記錄。

    3. 可選 啟用勿打擾 (DND) 同步切換，然後輸入您的 BroadWorks使用者 ID。 此選項在Webex與 BroadWorks 之間同步 DND 事件，確保該功能在兩個平台上相同的運作。

    4. 按下一步。

11. 新增您的驗證服務 URL。

12. 選取使用 CI 權杖驗證的驗證服務。

    此選項不需要 mTLS 來保護與 Webex 的連線，因為驗證服務會針對 Webex 身份識別服務正確驗證使用者權杖，然後再發出長時間使用權杖給使用者。

13. 在最終畫面上檢查您輸入的內容，然後按一下建立。 然後會顯示成功訊息。

    Partner Hub 會將 URL 傳遞給各種 Webex 微服務，以測試與輸入的介面之間的連線情況。

14. 按一下檢視叢集，您會看到新叢集以及驗證是否成功。

15. 精靈最後的（預覽）畫面上的建立按鈕可能會停用。 若您無法儲存範本，表示您剛才所設定的其中一項整合有問題。

    我們執行此檢查的用意是為了防止後續工作項目出錯。 您可以在設定部署時返回精靈，這可能需要修改您的基礎架構（例如 XSP| ADP、負載平衡器或防火牆)，然後才能儲存範本。

檢查與 BroadWorks 介面的連線

1. 使用您的合作夥伴管理員認證登入 Partner Hub (admin.webex.com)。

2. 從側邊功能表中開啟設定頁面，然後找出 BroadWorks Calling 設定。

3. 按一下檢視叢集。

4. Partner Hub 進行連線測試時會從各種微服務開始，然後再測試叢集中的介面。

   測試完成後，叢集清單頁面會在每個叢集旁顯示狀態訊息。

   然後會顯示綠色的成功訊息。 若您看到紅色的錯誤訊息，請按一下受影響的叢集名稱以查看是哪個設定造成問題。

5. 可選 如果您要查看該叢集的現有設定，請選取一個叢集，例如 XSI-Actions、XSI-Events、DAS URL和CTI介面設定。

設定您的新手上路範本

加入範本是您透過佈建方法加入一個或多個客戶時將共用設定套用至一個或多個客戶的方法。 您必須在每個範本與（您在上一節所建立的）叢集之間建立關聯。

您可視需要建立多個範本，但只有一個範本能與客戶聯結。

1. 使用您的合作夥伴管理員認證登入 Partner Hub (admin.webex.com)。

2. 從側邊功能表中開啟設定頁面，然後找出 BroadWorks Calling 設定。

3. 按一下新增範本。

   這樣會啟動精靈，您可在其中為要使用此範本的客戶輸入設定。

4. 使用叢集下拉式清單來選擇要使用此範本的叢集。

5. 輸入範本名稱，然後按一下下一步。

6. 使用以下建議設定來設定您的佈建模式：

   表 3. 不同佈建模式使用的建議佈建設定

   設定名稱	使用受信任電子郵件的佈建流程	無需電子郵件即可進行佈建流程	使用者自行佈建
   啟用 BroadWorks 佈建流程（包括佈建帳戶憑證（若開啟**）	開啟 根據 BroadWorks 設定輸入帳戶名稱和密碼。	開啟 根據 BroadWorks 設定輸入帳戶名稱和密碼。	關閉
   自動在 Control Hub 中建立新組織	開啟†	開啟†	開啟†
   服務提供者電子郵件地址	從下拉式清單中選取電子郵件地址（若清單很長，可先輸入部分字元以尋找地址）。 此電子郵件地址可識別合作夥伴組織內的管理員，該管理員將被授予對使用加入範本建立的任何新客戶組織的委派管理員存取權。
   國家或地區	選擇此範本要用於哪個國家/地區。 您選擇的國家/地區會與使用此範本建立的某地區客戶組織聯結。 目前，此地區可能是（歐洲、中東及非洲）或（北美及世界其他地方）。 請參閱此試算表中的國家/地區對應表。 組織國家/地區將決定Cisco PSTN 在Webex Meeting 網站中的預設全球撥入號碼。 請參閱的「國家/地區」區段說明頁獲取更多資訊。
   BroadWorks 企業模式啟用	若您使用此範本佈建的客戶是使用 BroadWorks 的企業，則啟用此選項。 如果他們是群組，請關閉此選項。 若同時有企業與群組使用 BroadWorks，則應針對不同情況建立不同的範本。

   表格中的注意事項：

   • † 此選項開關可確保當訂閱者的電子郵件網域與現有的 Webex 組織不符時，會建立新的客戶組織。

     此選項開關應保持開啟，除非您使用手動訂購和履行流程（透過 Cisco Commerce Workspace）在您尚未佈建客戶組織中的使用者之前，在 Webex 中建立客戶組織。 該選項通常稱為「混合式佈建」模式，不在本文探討的範圍內。

   • ** 「佈建帳戶」是指 BroadWorks 系統層級管理員帳戶。 在 BroadWorks 上，您需要一個具有下列屬性的管理員帳戶： 管理員類型=佈建，唯讀=關閉。

7. 為使用此範本的客戶選取預設服務套件（請參閱「概觀」一節中的套件）；有基本、標準、高級或軟體電話四種套件。

   您可以透過 Partner Hub 針對個別使用者覆寫此設定。

8. 可選 檢查停用Cisco Webex免費通話如果您要停用Webex Calls，。

9. 在會議加入設定中選取以下選項之一：

   • Cisco 撥入號碼 (PSTN)

   • 合作夥伴提供的撥入號碼 (BYoPSTN) — 如果您選取此選項，請參閱隨身攜帶您自己的 Webex for Cisco BroadWorks PSTN 解決方案指南以瞭解如何設定此選項的相關詳細資訊。

10. 按下一步。

11. 關於如何驗證身分，有兩種佈建訂閱者的方法 — 使用受信任的電子郵件或不受信任的電子郵件。

    在受信任的電子郵件工作流程中，使用者向合作夥伴提供電子郵件地址，合作夥伴將他們新增到 BroadWorks 中。 您身為合作夥伴，負責將電子郵件地址佈建為流程或API方法的一部分。

    強烈建議使用受信任的佈建方法，因為它可確保所有訂閱者都由您作為合作夥伴完全佈建，並且最終使用者無需執行任何所需的動作。

    在不受信任的電子郵件情況下，使用者需要在佈建前驗證其電子郵件，或者使用者可以自行啟動。

    在「不受信任」情況下，根據下表中的驗證設定，有幾種佈建模式：

    表 4. 針對不信任佈建模式的建議使用者驗證設定

    設定名稱	無需電子郵件即可進行佈建流程	使用者自行佈建
    優先佈建管理員	建議*	不適用
    允許使用者自行啟動	不適用	必填

    • 表格中的注意事項：

    • * Webex中的每個客戶組織必須至少有一個具有管理員角色的使用者。 如果在Webex中建立了新的客戶組織，則第一個在 BroadWorks 中指定整合的 IM&P 的使用者將擔任客戶管理員角色。 作為服務提供者，您可能希望控制誰獲得角色。 選取此設定會阻止使用者完成啟動，直到您佈建的第一個使用者被啟動為止。 若您取消勾選此設定，則新組織中啟用的第一位使用者將成為客戶管理員。

12. 按下一步。

13. 選擇預設驗證模式（ BroadWorks 驗證或Webex驗證) 用於使用者登入Webex。

    此設定對使用者登入到使用者啟動入口網站沒有影響。 使用者在登入入口網站時必須使用其 BroadWorks使用者 ID和密碼，而與如何設定上線範本無關。

    此設定只會套用於新建立的客戶組織。 如果合作夥伴管理員試圖將新的驗證設定套用於現有客戶組織，則會套用現有設定，以便現有使用者不會失去存取權。 若要變更現有客戶組織的驗證模式，則必須向 Cisco TAC 開立報修單。

    （請參閱「準備環境」一節中的驗證模式）。

14. 按下一步。

15. 在喜好設定中設定下列內容：

    1. 選擇是否要在登入頁中預先填入使用者電子郵件地址。

       必須選取 BroadWorks 驗證並且將使用者的電子郵件地址放在 BroadWorks 的替代 ID 屬性中，才能使用此選項。 否則，他們必須使用其 BroadWorks 使用者名稱。 登入頁面備有必要時變更使用者的選項，但這可能會導致登入問題。

    2. 若要啟用目錄同步處理，請開啟所有新的客戶組織皆啟用電話目錄同步處理。

       此選項可讓 Webex 將 BroadWorks 聯絡人讀取至客戶組織，以便使用者可以從 Webex 應用程式中尋找並呼叫他們。

    3. 輸入合作夥伴管理員。

       此名稱用於 Webex 為了請使用者驗證其電子郵件地址而自動寄出的電子郵件。

    4. 確保佈建現有組織切換按鈕為開啟（預設設定為開啟）。

    5. 按下一步。

16. 在最終畫面上檢查您輸入的內容。 按一下精靈最上方的瀏覽控制項可返回並變更任何詳細資訊。 按一下建立。

    然後會顯示成功訊息。

17. 按一下檢視範本，您會看到您的新範本與所有其他範本一起列出。

18. 如有必要，按一下範本名稱以修改或刪除範本。

    無需重新輸入佈建帳戶詳細資訊。 此處的密碼空白/密碼確認欄位可在必要時用來變更認證，但保留空白可讓您提供給精靈的值維持不變。

19. 如果您有其他共用設定要提供給客戶，請新增更多範本。

    使檢視範本頁面保持開啟，因為下列工作項目可能需要範本的詳細資訊。

修補程式應用程式伺服器 (僅適用於 R22、R23 和 R24)

1. 如果您尚未執行此操作，請套用以下適用於您的發行版的修補程式：。

   • 若版本為 R22： AP.as.22.0.1123.ap373197

   • 若版本為 R23： AP.as.23.0.1075.ap373197

   • 若版本為 R24： AP.as.24.0.944.ap384177

   如需構成在Cisco BroadWorks 中部署Webex所需的 BroadWorks 修補程式的完整清單，請參閱BroadWorks 軟體需求在參考部分中。

2. 切換至 Maintenance/ContainerOptions 環境。

3. 啟用佈建 URL 參數：

   /AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true

從 Partner Hub 取得佈建 URL

如需有關 AS 指令的詳細資訊，請參閱 Cisco BroadWorks 應用程式伺服器命令列介面管理指南（介面 > 傳訊與服務 > 整合式 IM&P）。

1. 請登入 Partner Hub，然後前往 設定 > BroadWorks Calling。

2. 按一下檢視範本。

3. 選取您用於在 Webex 中佈建此企業/群組訂閱者的範本。

   範本詳細資訊會顯示在右邊的外框窗格中。 如果尚未建立範本，則必須先建立範本，然後才能取得佈建 URL。

4. 複製佈建配接器 URL。

如果您有多個範本，其他範本也必須重複此操作。

（選項）在應用程式伺服器上設定全系統通用的佈建參數

若您使用的是 UC-One SaaS，您可能不想設定全系統通用的佈建和服務網域。 請參閱「準備環境」一節中的決定點。

1. 請登入應用程式伺服器並設定傳訊介面。

   1. AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL

   2. AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name

   3. AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password

   4. AS_CLI/Interface/Messaging> set enableSynchronization true

2. 啟動整合式 IMP 介面：

   1. /AS_CLI/Service/IntegratedIMP> set serviceDomain example.com

   2. /AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true

您必須輸入 provisioningURL 參數的完整名稱，如在 Control Hub 中所指定。 如果應用程式伺服器無法存取 DNS 來解析主機名稱，則必須在 AS 上的下列檔案中建立對映： /etc/hosts 。

（選項）在應用程式伺服器上根據各企業需求，設定不同的佈建參數

1. 在 BroadWorks 使用者介面中，開啟您想要設定的企業，然後移至服務 > 整合式 IM&P。

2. 選取 使用服務網域並輸入虛擬值（Webex 會略過此參數。 您可以使用 example.com ）。

3. 選取使用傳訊伺服器。

4. 在 URL 欄位中，貼入您從 Partner Hub 範本複製的佈建 URL。

   您必須輸入 provisioningURL 參數的完整名稱，如在 Partner Hub 中所指定。 如果應用程式伺服器無法存取 DNS 來解析主機名稱，則必須在 AS 上的下列檔案中建立對映： /etc/hosts 。

5. 在使用者名稱欄位中，輸入佈建管理員的名稱。 此名稱必須與 Partner Hub 中範本上的值一樣。

6. 輸入佈建管理員的密碼。 此名稱必須與 Partner Hub 中範本上的值一樣。

7. 在 IM&P ID 的預設使用者身份中，選取主要。

8. 按一下套用。

9. 針對您想要設定的其他企業，也必須重複上述佈建流程。

使用者佈建資料

如需在使用者佈建期間在 BroadWorks 與Webex之間交換的使用者資料的相關資訊，請參閱服務提供者使用者佈建。

新增 Webex 應用程式設定範本至 BroadWorks 應用程式伺服器

Webex 應用程式已使用 DTAF 檔案進行設定。 用戶端透過 XSP 上的裝置管理服務從應用程式伺服器下載組態XML 檔案。| ADP。

1. 取得所需的 DTAF 檔案（請參閱「準備環境」一節中的裝置設定檔）。

2. 確定 BroadWorks 系統 > 資源 > 裝置管理標記組中的標記組正確無誤。

3. 針對每個要佈建的用戶端：

   1. 下載並解壓縮特定用戶端的 DTAF zip 壓縮檔。

   2. 將 DTAF 檔案匯入位於 BroadWorks 中的系統 > 資源 > 身份/裝置設定檔類型

   3. 開啟新增的裝置設定檔進行編輯，然後：

      • 輸入 XSP| ADP 場 FQDN 和裝置存取通訊協定。

      • 勾選支援遠端方資訊勾選方塊。 必須具備此支援，桌面共用才能起作用。

        您也可以在「應用程式伺服器」上執行下列 CLI 指令來啟用遠端方支援： AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

   4. 根據環境修改範本（請參閱下表）。

   5. 儲存設定檔。

4. 按一下檔案和驗證，然後選取重新建立所有系統檔案的選項。

自訂Webex應用程式的品牌

• 合作夥伴自訂 — 合作夥伴管理員可以套用適用於合作夥伴組織和/或合作夥伴管理的客戶的進階自訂自訂。 請參閱配置進階品牌自訂。

• 客戶自訂 — 如果合作夥伴允許客戶套用他們自己的品牌自訂，則客戶管理員可以遵循下列程序（位於將您的公司品牌新增至Webex 。

使用者啟動入口網站使用您為用戶端自訂新增的相同標誌。

自訂問題報告及説明 URL

若要自訂這些選項，管理員可以遵循「新增意見回饋和說明網站 URL」程序，該程序可在上述兩篇自訂文章中找到。