Webex 中的 Cisco BroadWorks 故障排除

本文主要分為三個部分:

  • 資源,這是您可能需要的工具、閱讀資料、記錄檔及聯絡人的清單。
  • 程序,描述在疑難排解客戶問題時您可以採取一些動作。
  • 特定的問題,會分類並列出已知發生的問題、如何發現問題以及可能的解決方法。

Webex for Cisco BroadWorks 故障排除資源

有用的日誌文件

記錄檔名稱

來源

可用於疑難排解

PSLog

應用程式伺服器

流程佈建

雄貓 access_log

XSP

Webex 應用程式登入

XsiActionsLogXSP

Webex App 登入與 Webex IDP 代理程式的交互,以及裝置設定檔查詢的用戶端交互

authenticationService log

XSP

Webex 應用程式登入(權杖驗證和發出)

XSLogXSP?

推送通知適用的行動裝置訂閱

通話訊號

Webex app startup log

Windows: \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac:/Users/{username}/Library/Logs/SparkMacDesktop/current_log

行動裝置:使用傳送記錄檔

啟動(序列)使用者權限檢查

BWC 資料庫初始化,用於連接 BroadWorks

getUserProfile & JwT 權杖取得記錄

BroadWorks 通話

Webex 應用程式日誌

用戶端

Windows: \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac:/Users/{username}/Library/Logs/SparkMacDesktop/current_log

行動裝置:使用傳送記錄檔

所有用於註冊和通話的 SIP 流量

送往 BWKS 後端之持續流量

需要訊號傳輸的通話中功能 (Hold/Resume, 轉帳等等。 )

Media (Webex Media Engine) log

用戶端

Windows: \Users\{username}\AppData\Local\CiscoSpark\media\*.log

Mac: /Users/{username}/Library/Logs/SparkMacDesktop/media/

行動裝置:使用傳送記錄檔

所有媒體記錄

通話交涉轉碼器

通話中功能

閱讀清單

已知問題和限制

已知問題和限制 文章包含有關我們在 Webex for BroadWorks 解決方案中發現的已知問題的最新資訊。

可服務性連接器

Webex 可服務性服務提高了思科技術支援人員診斷基礎架構問題的速度。它可以自動執行查找、檢索和儲存診斷日誌以及 SR 案例中的資訊的任務。此服務還會觸發針對診斷簽章的分析,以便 TAC 可以更高效地識別並解決內部部署設備的問題。

有關如何部署 Serviceability 連接器的詳細信息,請參閱 Cisco Webex Serviceability Connector 部署指南

Webex BroadWorks 故障排除流程

升級問題

遵循一些疑難排解指引之後,您應該對問題的根源有相當程度的瞭解。

過程

  1. 從與該問題相關的系統中收集盡可能多的信息。
  2. 聯絡思科的相應團隊來開立案例。

收集哪些客戶資訊

如果您認為需要提交案例或呈報問題,那麼在協助使用者進行疑難排解時應收集以下資訊:

  • 使用者識別碼:CI 電子郵件地址或使用者 UUID(這是 Webex 標識符,但如果您也獲得使用者的 BroadWorks 標識符,那會有所幫助)。
  • 組織識別碼。
  • 出現該問題的大致時間範圍。
  • 客戶端平台和版本。
  • 從客戶端發送或收集日誌。
  • 如果客戶端顯示,請記錄追蹤 ID。

在幫助台檢查用戶詳細信息

擁有幫助台管理員(基本或進階)角色權限的合作夥伴管理員可以使用此程序透過幫助台檢視檢查使用者詳細資料。

過程

  1. 登入 幫助台
  2. 搜尋,然後按一下使用者。這會開啟使用者摘要螢幕。
  3. 按一下使用者名稱以查看詳細的使用者組態。此檢視中的有用資訊包括使用者的 UUID、通用身分 (CI) 叢集、Webex 應用程式叢集、呼叫行為、BroadWorks 帳戶 GUID
  4. 如果您需要在另一項工具中使用該資訊,請按一下複製,或將其附加至 Cisco 案例。

在幫助台中查看客戶組織

擁有幫助台管理員(基本或進階)角色權限的合作夥伴管理員可以使用此程序在幫助台檢視中查看客戶組織詳細資料。

過程

  1. 登入 幫助台
  2. 搜尋,然後按一下客戶組織名稱。
  3. 向下捲動直到看到 客戶入口網站視圖 ,然後按 查看客戶名稱 以查看客戶組織的唯讀視圖 - 包括使用者和配置。

從合作夥伴中心檢索使用者日誌

在解決桌面和行動用戶端問題時,合作夥伴(和 TAC)能夠查看客戶端日誌非常重要。

過程

  1. 要求使用者傳送記錄檔。如需說明,請參閱:Webex 應用程式 | 報告問題
  2. 請使用者匯出呼叫環境並向您發送 ced.dat 檔案。
  3. 從合作夥伴中心或幫助台取得用戶端日誌。

    Partner Hub 選項:

    1. 登入 Partner Hub 並尋找該使用者的客戶組織。
    2. 選取疑難排解
    3. 選取記錄檔
    4. 搜尋使用者(依電子郵件)。
    5. 檢視並將用戶端記錄下載為 zip 檔。

    技術支援選項:

    1. 登入技術支援。
    2. 搜尋組織。
    3. 按一下組織(會開啟摘要螢幕)。
    4. 向下捲動以點擊 查看客戶
    5. 選取疑難排解
    6. 選取記錄檔
    7. 搜尋使用者(依電子郵件)。
    8. 檢視並將用戶端記錄下載為 zip 檔。

如何找到客戶端版本

過程

  1. 與使用者共用此鏈結: https://help.webex.com/njpf8r5
  2. 要求使用者將版本編號傳送給您。

客戶端檢查呼叫服務

過程

  1. 登入 Webex 用戶端。
  2. 檢查側邊欄上是否顯示通話選項圖示(上方有齒輪的話筒)。如果圖示不存在,表示使用者可能尚未在 Control Hub 中啟用通話服務。
  3. 開啟設定/喜好設定功能表,然後前往電話服務區段。您應該會看到已登入的 SSO 工作階段狀態(若顯示的是 Webex Calling 等其他電話服務,表示使用者使用的並不是 Webex for Cisco BroadWorks)。

    此驗證表示:

    • 用戶端已成功周遊所需的 Webex 微型服務。
    • 已成功驗證使用者。
    • 您的 BroadWorks 系統會發給客戶一個長效 JSON Web 令牌。
    • 用戶端已擷取其裝置設定檔,且已註冊 BroadWorks。

取得客戶日誌或回饋

  • 請參閱資源部分以在 Webex 桌上型電腦用戶端上尋找特定用戶端記錄檔,或要求使用者傳送記錄檔。如需說明,請參閱:Webex 應用程式 | 報告問題
  • 要求行動裝置用戶端的使用者傳送記錄檔,然後您可以透過 Partner Hub 或技術支援取得記錄檔。

    傳送記錄檔不會出現訊息。但是,如果使用者傳送意見回饋,則它會送往 Webex 應用程式開發運維團隊。如果您要追蹤 Cisco 的後續狀況,請務必記錄使用者的意見回饋編號。例如:

    已提交支援案例的案例編號

取得通話環境資料

為了移除個人識別資訊,Webex 用戶端記錄檔已大幅編校。您應該在注意問題的同時,從相同工作階段的用戶端匯出通話環境資料。

過程

  1. 在用戶端上,按一下說明 > 健全度檢查程式
  2. 選取重設資料庫。這會觸發用戶端完整重設,並載入 Webex 應用程式登入螢幕。

驗證 Webex 是否應註冊到 BroadWorks

Webex 應用程式會檢查下列資訊以決定是否向 BroadWorks 註冊:

  • 使用者對 broadworks-connector的授權。
  • 組織和使用者的呼叫行為。

檢查使用者的通話行為及連接器權限

  1. 使用您的合作夥伴管理員憑證登入 幫助台
  2. 搜尋使用者。
  3. 按一下使用者並檢查通話行為項目。它應該是「在 Webex 中通話」。

    檢查用戶的呼叫行為

  4. 按一下使用者名稱以開啟使用者詳細資料螢幕。
  5. 向下捲動找到 entitlements 部分,並驗證是否包含 broadworks-connector

    使用者詳細資料畫面 - broadworks 連接器已啟用

    如果 Webex for Cisco BroadWorks 使用者打算使用 Webex for Cisco BroadWorks,則不應擁有 bc-sp-standard 權利。這是「Webex Calling (Broadcloud)」的權限,是透過受 Cisco 管理的雲端通話服務進行的 Webex 應用程式通話。

檢查組織的通話行為

  1. 使用您的合作夥伴管理員憑證登入 幫助台
  2. 搜尋組織。
  3. 點擊組織並檢查 呼叫行為 條目。它應該是「在 Webex 中通話」。

分析 PSLog 中的使用者配置問題

使用應用程式伺服器的 PSLog 來查看對佈建橋接器的 HTTP POST 請求,以及來自 Webex 的回應。在正確的工作案例中回應是 200 OK,幾分鐘後,您可以在 Webex 中查看已建立使用者(如果是首位使用者)和新客戶組織。您可以在技術支援中搜尋在 POST 中看見的電子郵件地址,來驗證這一點。

在開始之前

在測試使用者進行佈建流程嘗試期間,從應用程式伺服器收集 PSLog。

過程

  1. 要檢查的第一件事是 HTTP 回應代碼:
    • 200 OK 以外的其他內容都表示使用者佈建失敗。
    • 如果使用者設定檔中的某些內容在配置橋的 Webex 服務上游不起作用,則 200 OK 仍可能表示失敗。
    • 400 響應中可能包含 message 節點。配置橋無法處理 subscriberProfile中的某些內容。訂閱者詳細資料可能有問題,或者與範本中的設定不相容。
    • 401 表示在 AS 上輸入的佈建認證與 Partner Hub 範本中輸入的認證不符。
    • 403 可能指示應用程式伺服器上有某些錯誤設定。檢查請求的目標。它不應該是 IP 位址,而是您可以在 Partner Hub 的範本上查看的佈建橋接器 URL。
    • 409 表示提供的 subscriberProfile 與現有的 Webex 資料有衝突。可能有使用該電子郵件地址的現有使用者。檢查響應中的 message
  2. 您也可以檢查原始 HTTP POST 是否有可能導致佈建失敗的任何可疑值。POST 包含一個 subscriberProfile XML 結構。當中需要檢查的有用節點為:
    • bwuserid: 如果您需要在 BroadWorks 中編輯訂閱者設定檔,請使用此功能來尋找該設定檔。
    • group: 如果範本處於“服務提供者模式”,則該名稱將小寫並成為您在合作夥伴中心看到的客戶組織的名稱。
    • serviceProvider: 如果範本為「企業者模式」,則此為小寫,並且成為您於 Partner Hub 中查看的客戶組織名稱。
    • primaryPhoneNumber: 必須存在。如果沒有提供,則佈建會失敗。
    • email: 成為 Webex 中的使用者 ID。必須有效且為 Webex 的唯一值,否則佈建會失敗。

      忽略 services 節:它由 AS 建立,且被 Webex 接受,但不被 Webex 使用。

分析 XSP 日誌以排除訂戶登入故障

此流程說明 BroadWorks 驗證模式。您可以在 Partner Hub 的 BroadWorks 範本上看到驗證模式。請參閱中的https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726設定您的客戶範本

下面的階梯圖展示了當使用者在 Webex 應用程式中進行 BroadWorks 身份驗證時,使用者、用戶端、Webex 服務和 BroadWorks 系統之間的互動。此外,Webex 和 XSP 之間的連線由 MTLS 保護。

以下討論說明在您調查成功登入的記錄檔時,預期可查看的內容。 分析 XSP 日誌以排除訂戶登入故障 -flow

使用者與用戶端互動,用戶端與 Webex 服務互動:

  • 使用者將電子郵件地址提供給 Webex 應用程式(圖中的 1)。
  • CI 知道重新導向此使用者以輸入其 BroadWorks 密碼(透過 UAP)(圖中的 2)。
  • IDP Proxy 將獲取設定檔請求提交至 XSP 上的 Xsi 介面。

在 tomcat 中 access_log:

  • 從 Webex 到 Xsi-Actions 介面(圖中的 2.1),尋找訂閱者設定檔的 GET 請求。它具有 Webex 使用者 ID。譬如:

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

在 XsiActionsLog 中:

  • 尋找來自 Webex 的設定檔 GET 請求(圖中的 2.1)。它具有 Webex 使用者 ID。譬如:

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile 標題包括 authorization: Basicuser-agent: broadworksTeamsClient

  • 然後,XSP 針對 BroadWorks 執行 OCI-P 基本驗證(AuthenticationVerifyRequest 和 AuthenticationVerifyResponse,如透過 Xsi 執行基本驗證的其他任何應用程式),以及 UserGetRequest 和 ServiceProviderGetRequest 以收集訂閱者資訊。
  • Xsi 對 Webex 的回應包含一個 XML Profile 區塊,其中包含 (BroadWorks) userId 和其他詳細資訊(圖中的 2.2)。

用戶端和 Webex 服務互動:

  • IDP 代理程式會比對從 BroadWorks 收到的使用者設定檔並向客戶端發出 SAML 斷言(圖中的 2.3)。
  • 客戶端用 SAML 斷言交換 CI 令牌(圖中的 3)。
  • 用戶端會檢查已登入的使用者是否具有 broadworks-connector 權限(圖中的 4)。您可以在幫助台檢查使用者權限。
  • 用戶端使用 CI 令牌從 IDP 代理程式請求 JSON Web 令牌 (JWT)(圖中的 5)。
  • IDP 代理程式在 CI 處驗證 CI 令牌。
  • IDP 代理程式向身分驗證服務請求 JWT。

在 authenticationService 記錄檔中:

  • 尋找來自 Webex 的令牌請求(圖中 5.2),例如:GET /authService/token 包含 http_bw_userid 標題和其他內容。
  • XSP 執行 OCI-P UserGetLoginInfoRequest來驗證提供的使用者 ID 是否對應於 BroadWorks 使用者(圖中的 5.3)。AuthService 已憑藉 mTLS 連接建立與 Webex 的信任,因此可以發出 LLT。
  • 尋找來自 LongLivedTokenManager - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks …StatusCode=200 的回應(圖中的 5.4),您可以使用 trackingid: CLIENT… 標頭將其與原始請求關聯起來。

在 XsiActionsLog 中:

  • 客戶端能夠在 Xsi-Actions 介面上出示長效令牌以取得其裝置設定檔(圖中的 6)。譬如:GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device 帶有標題 authorization: Bearer tokenuser-agent: WebexTeams (variant/version)
  • Xsi-Actions 介面將令牌 POST 到 authservice(配置為在環回介面上)例如:127.0.0.1:80 POST http://127.0.0.1:80/authService/token 您可以將其與 GET 中的 trackingid: CLIENT… 標題以及 POST中的 X-BROADSOFT-CORRELATION-ID : CLIENT… 標題關聯起來。

在 authenticationService 記錄檔中:

  • 從 Xsi 接收 POST(回送)

  • A StatusCode=200 回到 Xsi

  • 以及令牌驗證回應,其主體中有一個「token」 JSON 區塊。

  • 使用以下項目相互關聯: trackingid: CLIENT…

在 XsiActionsLog 中:

  • 收到來自 authservice 的 200 OK 訊息後,Xsi-Actions 應用程式現在發送 OCI-P 請求 UserPrimaryAndSCADeviceGetListRequest
  • 接收包含 accessDeviceTable XML 結構的 OCI-P UserPrimaryAndSCADeviceGetListResponse
  • OCI-P 回應被編碼為 Xsi 回應給客戶端,包括 AccessDevices XML 結構,其中有 deviceTypes。譬如:Business Communicator – PC 以及用戶端可在其中擷取裝置設定檔的 URL。

用戶端如常繼續:

  • 選擇設備條目並與 DMS 互動以取得設備設定檔(圖中的 6)。
  • 透過從 DMS 配置中檢索的 SBC 註冊到 BroadWorks(圖中的 7)。

Webex BroadWorks 特定問題故障排除

合作夥伴中心問題

管理員無法查看客戶組織

身為 Webex 中合作夥伴組織的管理員,您應該擁有 完全管理員角色。該角色用於管理您的合作夥伴組織,包括將管理特權指派給您自己和其他人。要管理客戶組織,您需要授予自己(或其他人) 銷售完全管理員 角色或 銷售管理員 角色。有關詳細信息,請參閱 在 Control Hub 中指派組織帳戶角色

使用者配置問題

整合即時通訊 & 特定企業的P誤差 / 顧客

如果您的企業混用不同的雲端協作服務(例如 UC-One SaaS 和 Webex for Cisco BroadWorks),您可能已選擇根據每個企業修改佈建配接器。

檢查整合 IM 的配置 & P(企業預設設置,除非有更具體的設定),運行 AS_CLI/Interface/Messaging> get。對於特定企業的設定參數,請開啟該企業並前往 服務 > 整合即時通訊 & P

檢查該企業的整合式 IM&P 設定,是否與 Partner Hub 中的客戶範本中所顯示的完全相同。下列設定必須相符,否則企業中的所有使用者的佈建會失敗:

BroadWorks Enterprise 整合式 IM&P 設定 Partner Hub 客戶範本設定
傳訊伺服器 URL 佈建 URL
傳訊伺服器使用者名稱佈建帳戶名稱
傳訊伺服器密碼佈建帳戶密碼、確認密碼

整合即時通訊 & 特定使用者的 P 錯誤

若您使用佈建流程,並且假定佈建對部分/大多數使用者有效(因此您可以排除設定問題),則適用此情況。如果您在 BroadWorks 中看到整合式 IM&P 錯誤,例如「[傳訊伺服器的 [錯誤 18215] 佈建錯誤」及「傳訊伺服器的 [錯誤 18211] 通訊錯誤」,您應該調查下列潛在原因:

  • 使用者的電子郵件地址可能已存在 CI。在技術支援中搜尋使用者,以檢查其電子郵件地址是否已存在。這樣不見得能取得確切的結果,因為使用者可能存在於在技術支援中不允許您查看其資料的組織。
  • 在被指派整合式 IM&P 服務之前,使用者已獨立註冊 Webex。在這種情況下,一種選擇是讓使用者刪除他們的免費帳戶,以便他們可以成為您正在配置的客戶組織的一部分。說明位於 https://help.webex.com/5m4i4y
  • 使用者沒有將主要電話號碼指派至設定檔(Webex for Cisco BroadWorks 的所有訂閱者都必須有主要 DID)。請參閱從 AS 分析 PSLog 的主題。

配置橋接器響應用戶配置失敗

如果使用者未出現在 Control Hub 中,請在指派整合式 IM&P 數分鐘內,查看佈建橋接器服務的回應代碼。執行 PSLog 以查看 HTTP 回應代碼。

200 OK

200 OK 回應 並不表示使用者已成功配置。這表示佈建服務已收到請求,且已成功將對應的使用者建立請求提交至上游服務。佈建操作是非同步設計。服務會回應 200 OK,因為使用者建立過程可能需要幾分鐘,並且基於效能理由,我們不想收到建立相同使用者的多個請求。但是,如果使用者在 200 OK 回應後最終沒有出現在客戶組織中,則可能表示佈建服務的 Webex 服務上游建立使用者失敗。您需要呈報得到 200 OK 回應的佈建失敗。

400 Bad Request

檢查 HTTP 回應,針對可能導致佈建服務提供此回應之潛在問題,當中可能會有更多詳細資訊。幾個 節點的範例:

  • 「無法信任使用舊版佈建 API 的 BroadWorks 電子郵件。」與使用者佈建請求失敗相關的電子郵件地址無效或鍵入錯誤,但您已經在範本中聲明電子郵件地址可信任。在 BroadWorks 中檢查使用者的設定檔,尤其是電子郵件 ID。
  • 資料庫中未找到客戶組織,且未啟用新組織建立標誌。 」此失敗的佈建請求應該會在 Webex 中建立新的客戶組織,但您的範本已設定成阻止建立新的客戶組織。如果您想要允許新組織,對於與 Webex 中現有客戶不相符的電子郵件網域,您可以在 Partner Hub 中重新設定範本,然後重新測試佈建請求。但是,如果您預期不會為此使用者建立新組織,那麼電子郵件地址可能鍵入錯誤(特別是網域部分)。在 BroadWorks 中檢查使用者的電子郵件 ID。

403 Forbidden

佈建請求不可能成功。在這種情況下,您需要調查請求和回應。例如,如果您看到 IP 位址作為佈建請求的目標,而不是組織的適當佈建橋接器 URL(請參閱解決方案指南中的防火牆設定主題),可能表示您的應用程式伺服器遺漏了必要的修補程式 (ap373197)。

檢查所有必要的修補程式是否都適用於應用程式伺服器,並且您已完成成功佈建流程相關的設定。

409 Conflict

佈建請求無法處理,因為 Webex 中的現有使用者符合該請求中的電子郵件地址。

使用者已在 CI 中

從 HTTP POST 請求中取得訂閱者電子郵件,然後在技術支援中搜尋。如果您未獲允許的話,可能看不到該使用者,但您可能也會看到該使用者位於「免費」組織中,例如「消費者」。您可以要求此使用者刪除其免費帳戶,或者您可以使用其他電子郵件地址來進行佈建。請參閱 https://help.webex.com/ndta402

使用者登入問題

用戶啟動入口網站未載入

一般 Webex for Cisco BroadWorks 登入流程包括使用者啟用入口網站,使用者可在該處輸入密碼。有時,此入口網站在使用者於 Webex 應用程式登入畫面中提供其電子郵件地址後無法載入。此問題可能由用戶端或服務端造成。在用戶端,通常是因為用戶端的原生瀏覽器某方面與服務不相容所致。

單一登入失敗

  • 在 BroadWorks 中,檢查使用者是否已被指派 Webex 應用程式的裝置類型(請參閱裝置設定檔一節,其位於解決方案指南的準備環境一節中)。
  • 檢查使用者是否使用了正確的密碼。如果您用於設定使用者客戶組織(在合作夥伴中心)的範本配置了 BroadWorks 驗證,則使用者應該輸入他們的 BroadWorks「Web 存取」密碼。如果使用者的電子郵件地址未配置為備用使用者 ID,則使用者可能還需要輸入其 BroadWorks 使用者 ID。確保使用者正確輸入了大寫和小寫字元。

呼叫配置和註冊問題

在 Webex 中佈建使用者並且他們成功登入 Webex 應用程式後,應用程式會註冊到 BroadWorks。以下是預期的註冊順序以及註冊良好(從 Webex 應用程式看到的那樣)產生的標誌:

預期註冊順序

  1. 用戶端呼叫 XSI 以取得裝置管理權杖以及 DMS 的 URL 網址。
  2. 用戶端會向 DMS 請求其裝置設定檔,請求方式為出示步驟 1 的權杖。
  3. 用戶端讀取裝置設定檔,並擷取 SIP 認證、位址和連接埠。
  4. 用戶端使用步驟 3 的資訊將 SIP REGISTER 傳送至 SBC。
  5. SBC 將 SIP REGISTER 傳送到 AS(如果 SBC 還不知道 SIP 用戶,SBC 可能會在 NS 中執行查找以定位 AS。)。

客戶註冊成功的預期跡象

通話選項圖示出現在 Webex 介面中。

在 Webex 應用程式電話服務標籤中(例如 設定 > Windows 上的 電話服務偏好設定 > 電話服務 (在 Mac 上),訊息「SSO 會話:您已登入」表示應用程式註冊成功(此案例中為 BroadWorks)。

客戶端沒有呼叫圖標

在大多數情況下,這表示使用者沒有正確的授權/權限。

用戶端顯示「電話服務」選項卡,但沒有 SSO 會話

Webex 用戶端顯示電話服務選項卡,但沒有 SSO 會話

註冊不成功。Webex 應用程式用戶端向 BroadWorks 註冊失敗有多種原因:

使用相同的客戶端測試多個呼叫服務

此已知問題可能是用戶端變更不同通話後端所致。此情況最有可能在試用透過(同一)Webex 應用程式用戶端提供的不同通話服務期間發生。您可以重設用戶端資料庫(鏈結)以解決此問題。

身份驗證服務配置錯誤

根據解決方案指南檢查託管驗證服務的 XSP(請參閱在 Webex for Cisco BroadWorks XSP 上設定服務)。具體地說:

  • RSA 金鑰(在一個 XSP 上產生)會複製到所有 XSP
  • 驗證服務 URL 已提供給所有 XSP 上的 Web 容器,且在 Partner Hub 的叢集中正確輸入
  • 憑證的外部驗證已設定:

    XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get

    allowUserApp = false

    allowClientApp = true

  • 使用 MTLS 時,您必須將 Webex 用戶端憑證上傳至 XSP(您可以從合作夥伴中心的 BroadWorks 設定頁面上取得憑證)。

BroadWorks 標記的設定不正確

檢查您是否已為 Webex 應用程式設定所需的 BroadWorks 標籤。有關設定標籤的信息,請參閱 Webex for Cisco BroadWorks 設定指南 。確保沒有衝突或不正確的值。具體來說, %SBC_ADDRESS_WXT% 標籤應該是面向 Webex 應用程式用戶端的 SIP 註冊器的 SBC。

SSO 連線成功後,桌面用戶端會中斷電話服務

此問題可能由同一使用者在同一平台類型上登入多個用戶端所致。例如,如果使用者在 Windows 上成功登入 Webex 應用程序,然後在另一台 Windows 電腦上登入 Webex 應用程序,則其中一台電腦上只有一個活動的 SSO 會話。這是依設計而定。如果您務必要解決此問題,您可以將 BroadWorks 設定為擁有同一裝置類型的多個實例,但這些實例必須具有唯一的 SIP 位址。此設定超出 Webex for Cisco BroadWorks 的範圍。

未為使用者配置桌面設備

在客戶端日誌中可以看到此簽章:

[0x70000476b000] BroadWorksConfigDownloader.cpp:106

onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - the device profile 'Business Communicator - PC' is not found.

呼叫設定 webview 問題

自我照顧 button/link 未顯示在 Webex 應用程式中

此問題的另一種表現是有顯示按鈕/鏈結,但點選後會開啟外部瀏覽器。

  • 驗證所需的用戶端設定範本是否已部署以及 CSW 標籤是否已正確設定。(請參閱 Webex for Cisco BroadWorks 解決方案指南中的 呼叫設定 Webview 部分)。
  • 驗證 Webex 應用程式已在 BroadWorks 中註冊通話。
  • 檢查 Webex 應用程式是支援 CSWV 的最新版本。

點擊“自助服務”後出現空白頁或錯誤 button/link

通常,Webex 應用程式中的此行為表示 BroadWorks XSP 上 CSWV 應用程式有設定或部署問題。收集詳細資料以進一步的調查,包括 CSWV 記錄檔、存取記錄檔、config-wxt.xml 存放庫和範本檔案,然後報告案例。

域名聲明問題

使用者註冊錯誤可能是因註冊網域時發生錯誤而造成。在註冊任何網域之前,請確保您瞭解下列各項須知:

  • 服務提供者不應聲明其所管理的客戶組織的網域名稱。他們只能註冊位於服務提供者內部組織中的使用者網域。註冊其他組織中的使用者網域(即使是服務提供者管理的網域)可能會導致客戶組織中發生使用者註冊錯誤,因為使用者身分驗證請求是透過服務提供者傳送,而不是透過客戶組織傳送。
  • 如果兩個客戶組織(A 公司和 B 公司)共用相同的網域,且 A 公司已註冊該網域,則 B 公司的使用者可能會無法註冊該網域,因為使用者身分驗證請求其實是透過已註冊該網域的組織(A 公司)傳送。

    如果您註冊的網域有誤,必須解除註冊,請參閱 Webex 文章管理網域

最終使用者錯誤代碼

下表概述在用戶端使用者啟用入口網站中可以看到的使用者錯誤代碼。

這不是錯誤代碼的詳盡清單。表格中僅列出 Webex 應用程式目前未為使用者提供明確方向的現有錯誤代碼。

表 1. 表 1:最終使用者錯誤代碼

錯誤碼

錯誤訊息

建議的動作

100006

登入失敗:使用者 ID/Password 是不正確的。

檢查使用者是否使用了正確的密碼。如果您用於設定使用者客戶組織(在合作夥伴中心)的範本配置了 BroadWorks 驗證,則使用者應該輸入他們的 BroadWorks「Web 存取」密碼。如果使用者的電子郵件地址未配置為備用使用者 ID,則使用者可能還需要輸入其 BroadWorks 使用者 ID。

確保使用者正確輸入了大寫和小寫字元。

200010

由於 BroadWorks 使用者未經授權,因此無法驗證憑證。

使用者應嘗試使用其他使用者名稱和密碼組合。

否則,管理員就必須重設 BroadWorks 的密碼。

200013

抱歉,您現在無法透過 Webex 加入 <name of SP offer> 。請在幾分鐘後再試一次。如果問題仍然存在,請聯絡您的 <customer organization administrator>。

無法更新 Common Identity 中的使用者資訊。請使用使用者 API 再次更新使用者。

200014

請聯絡您的 <Service Provider> 管理員。

檢查以確保您的配置準確並且請求中的配置 ID 正確。
200016由於未找到會話,因此驗證憑證失敗。使用者應重新整理瀏覽器並重試使用者名稱/密碼。
200018由於使用者被鎖定,因此無法驗證憑證。使用者應等待 10 分鐘,然後再試一次。
200019由於新增使用者自我啟動失敗,因此驗證憑證失敗。管理員應檢查控制中心中的自啟動設定。
200022由於使用者未經身份驗證,因此無法傳送電子郵件。使用者應重試上線並輸入認證。
200025抱歉,您現在無法加入自我激活。請幾分鐘後再試。如果問題仍然存在,請聯絡您的系統管理員。讓用戶幾分鐘後再試一次。如果這不起作用,請諮詢思科支援。
200026由於預先檢查失敗或待處理使用者的 PartnerOrgUUID 狀態不正確,導致電子郵件驗證失敗 : {partnerOrgUUID} ,BroadoworksUUID : {broadworksUUID} ,配置設定UUID : {configSetUUID}管理員應通知使用者他們輸入的電子郵件地址錯誤,因為與該電子郵件地址相關聯的是其他組織。
200039驗證電子郵件失敗,因為 emailId 已在其他組織中使用。使用者應嘗試使用該驗證連結重新上線,但使用其他 BroadWorks 使用者 ID。

否則,不同組織的客戶組織管理員應該刪除現有使用者帳戶。

200040由於 configSet 與 customerConfig 中的 configSet 不匹配,因此驗證電子郵件失敗。管理員應將使用者使用的驗證連結與 Control Hub 中所設定的連結進行比對。這兩個連結必須和 configSet 一樣。
200041驗證電子郵件失敗,因為使用者已獲得另一項衝突服務的授權,即權利衝突。使用者應嘗試使用該驗證連結重新上線,並使用其他 BroadWorks 使用者 ID。

否則,管理衝突服務的客戶組織管理員應該刪除衝突的服務或授權。

200042驗證電子郵件失敗,因為電子郵件已與另一個 BroadWorks UserId 關聯。使用者應使用其他電子郵件地址再試一次。

否則,管理員必須刪除使用此電子郵件地址的其他使用者。

200043由於用戶客戶配置映射不正確,因此驗證電子郵件失敗。使用者應使用其他電子郵件地址再試一次。否則,管理員必須刪除使用此電子郵件地址的其他使用者。
200044由於該 BroadWorks 叢集上已使用 userId,因此驗證電子郵件失敗。使用者應使用其他電子郵件地址再試一次。否則,管理該現有使用者帳戶(其使用此電子郵件地址)的客戶組織管理員必須刪除該使用者帳戶。
200045透過自行啟用新增使用者失敗,因為使用者已屬於另一個組織。使用者應使用不同的電子郵件地址重新嘗試加入。否則,管理不同組織的客戶組織管理員應該刪除現有帳戶。
200046透過自我啟動新增使用者失敗,因為在同一 BroadWorks 叢集下存在多個具有相同 broadworksUserId 的待處理使用者。管理員應從 Control Hub 中刪除待處理的使用者。
200047由於該 BroadWorks 叢集上已使用 userId,因此無法透過自我啟動新增使用者。使用者應使用其他電子郵件地址再試一次。否則,管理現有使用者帳戶的客戶組織管理員應刪除該現有使用者帳戶,或移除其他授權。
200048透過自行啟用新增使用者失敗,因為已使用不同的 BroadWorks 使用者 ID 佈建電子郵件地址。使用者應使用其他電子郵件地址再試一次。
200049由於該 BroadWorks 叢集上已使用 userId,因此無法透過自我啟動新增使用者。使用者應使用其他電子郵件地址再試一次。否則,管理現有使用者帳戶的客戶組織管理員應刪除該現有使用者帳戶,或移除其他授權。
200050由於 provisioningID 與訂閱者企業的預期 provisioningID 不匹配,因此無法透過自我啟動新增使用者。管理員應將使用者使用的驗證連結與 Control Hub 中所設定的連結進行比對。這兩個連結必須和 configSet 一樣。
200051透過自我啟動新增使用者失敗,因為此請求中指定的 spEnterpriseId 與已從此 BroadWorks 叢集配置的服務提供者或企業衝突。管理員應檢查 Control Hub 中的現有組織,並確保它們所建立的組織名稱不與現存的組織重複。
200054由於客戶組織和合作夥伴組織的區域不匹配,因此驗證電子郵件失敗。管理員應檢查 Control Hub 中的合作夥伴組織及客戶組織設定,並確保其設定的區域相符。
300005預檢失敗,因為使用者已在佇列中並處於配置過程中。用戶配置仍在進行中。請等待幾分鐘後再檢查。

目錄同步的錯誤代碼

下列錯誤代碼適用於目錄同步。

錯誤碼

錯誤訊息

600000

「Broadworks 外部目錄使用者同步」發生非預期錯誤。

600001

「BroadWorks 外部目錄使用者同步」失敗。
600002

「BroadWorks 外部目錄使用者同步」在完成之前必須終止。

600003

「Broadworks 外部目錄使用者同步」僅部分成功。部分客戶組織無法同步。

600004ConfigSet 未啟用「BroadWorks 外部目錄使用者同步」。
600005ConfigSet 正在進行「BroadWorks 外部目錄使用者同步」。
600006「BroadWorks 外部目錄使用者同步」執行緒忙碌或正在關閉,因此將不會接受更多同步請求,請稍後重試。
600007找不到 CustomerConfig 的身分識別組織。
600008在合作夥伴組織中找不到 CustomerConfig。
600009由於與 CustomerConfig 關聯的 Broadworks 叢集正忙,因此無法執行 Broadworks 外部目錄使用者同步。
600010由於沒有與 CustomerConfig 關聯的 Broadworks 集群,因此無法執行 Broadworks 外部目錄使用者同步。
600011CustomerConfig 未啟用「BroadWorks 外部目錄使用者同步」。
600012「Broadworks 外部目錄使用者同步」無法執行,因為 CustomerConfig 已啟用「混合目錄同步」。
600013「BroadWorks 外部目錄使用者同步」無法將使用者和機器帳戶新增至身分識別存放區。
600014在嘗試連線至 Broadworks 叢集時,「Broadworks 外部目錄使用者同步」失敗。來自 Broadworks 的錯誤 - %s。
600015「Broadworks 外部目錄使用者同步」在身分識別存放區中找不到任何相符的使用者。
600017BroadWorks 電話清單同步無法同步所有使用者和企業/組織聯絡人。
600018對於企業/組織中的使用者,BroadWorks 電話清單同步失敗。
600019BroadWorks 電話清單同步無法同步企業/組織聯絡人。
600020BroadWorks 外部目錄使用者同步正在進行中,因此無法停用 BroadWorks 外部目錄使用者同步。
600022由於企業沒有供應的使用者,BroadWorks 外部目錄單一使用者同步無法進行。
600023無法進行 BroadWorks 外部目錄單一使用者同步,因為此組織中已存在該使用者。
600024BroadWorks 外部目錄單一使用者同步無法進行,因為在 BroadWorks 中找不到符合的使用者。
600025BroadWorks 外部目錄使用者同步在 CI 中消費者帳戶使用者同步。
600026BroadWorks 外部目錄使用者同步無法更新 CI 中的機器帳戶。
600027由於在 BroadWorks 中找到多個使用者,因此無法進行 BroadWorks 外部目錄單一使用者同步。
600028BroadWorks 外部目錄單一使用者同步無法實現,因為至少應該完成一個企業目錄同步。
600029BroadWorks 外部目錄使用者同步失敗,因為企業沒有供應使用者。

變更歷史記錄

此表包含本指南的變更歷史記錄。

日期變更
2025年4月23日BroadWorks Calling Webex 應用程式日誌 來源中刪除了 bwc 資料夾。
2023年7月29日從合作夥伴中心檢索使用者日誌 取得客戶端日誌或回饋 部分中新增了對 Webex 應用程式 | 報告問題 (以產生日誌)的參考。
2022 年 6 月 27 日已更新 閱讀清單 ,其中缺少有關 Connect (Android) 遷移到 Firebase 程式方法的連結。
2022年6月21日更新了 ReadingList 連結以指向 Cisco.com 上的新 URL。更新了 呼叫設定和註冊問題 ,新增了指向 Webex for Cisco BroadWorks 設定指南 的鏈接,以解決 BroadWorks 標籤的問題。
2022 年 4 月 14 日 在「檢查幫助台中的使用者詳細資料」和「查看幫助台中的客戶組織 」添加了上下文語句,以闡明幫助台的角色要求。
2022年3月26日目錄同步的錯誤代碼中新增了新的錯誤代碼。
2021 年 11 月 15 日最終使用者錯誤代碼中新增了錯誤代碼 200013、200014、200025 和 300005。
2021 年 9 月 28 日新增了 個目錄同步錯誤代碼。
2021 年 7 月 15 日最終使用者錯誤代碼中新增了錯誤訊息 100006。也更新了 用戶登入問題。
2021 年 7 月 14 日新增了指向 已知問題和限制 文章的連結主題。
2021 年 7 月 2 日已更新 Webex 品牌更名的產品名稱。
2021 年 6 月 18 日更新了圖形中的 Webex 標誌。
2021 年 6 月 8 日最終使用者錯誤代碼 表中新增了「建議的動作」欄位。
2021 年 6 月 4 日更正 最終使用者錯誤代碼 表。
2021 年 5 月 19 日新增了 網域聲明問題 部分。
2021 年 4 月 22 日更新了 最終使用者錯誤代碼 ,新增了兩個附加程式碼:200016 和 200054。
2021 年 4 月 13 日新增了有關 Webex 可服務性連線的資訊。
2020 年 12 月 8 日更新文件。將品牌 Webex Teams 更名為 Webex(應用程式)。新增了最終用戶錯誤代碼。
2020 年 11 月 3 日新增了呼叫設定 Webview。
2020 年 10 月 22 日引入了新文件。