在此文章中
Webex for Cisco BroadWorks 故障排除
dropdown icon
Webex for Cisco BroadWorks 故障排除資源
    有用的日誌文件
    閱讀清單
    已知問題和限制
    可服務性連接器
dropdown icon
Webex for BroadWorks 故障排除流程
    問題升級
    需要收集哪些客戶資訊
    請在幫助中心查看用戶詳細信息
    在幫助台查看客戶組織
    從合作夥伴中心檢索使用者日誌
    如何找到客戶端版本
    客戶檢查是否正在呼叫服務
    取得客戶端日誌或回饋
    取得通話環境資料
    確認 Webex 是否已註冊至 BroadWorks。
    分析 PSLog 以尋找使用者配置問題
    分析 XSP 日誌以排查使用者登入問題
dropdown icon
Webex for BroadWorks 故障排除特定問題
    合作夥伴中心問題
    使用者配置問題
    使用者登入問題
    呼叫配置和註冊問題
    通話設定網頁檢視問題
    域名聲明問題
    最終使用者錯誤代碼
    目錄同步錯誤代碼
更改歷史記錄

Webex for Cisco BroadWorks 疑難排解指南

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

服務提供者機構中負責自身及客戶技術支援的技術人員需要這份指南。您應該熟悉一般故障排除、閱讀日誌和處理使用者案例。

Webex for Cisco BroadWorks 故障排除

本文分為三個主要部分:

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

Webex for Cisco BroadWorks 故障排除資源

有用的日誌文件

記錄檔名稱

來源

可用於疑難排解

PSLog

應用程式伺服器

流程佈建

湯姆貓 access_log

XSP

Webex App 登入

XsiActionsLog

XSP

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

authenticationService log

XSP

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

XSLog

應用程式伺服器

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

通話訊號

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

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

Webex for 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 日誌以排查訂閱者登入流程問題

使用者與用戶端互動,用戶端與 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 代理程式(圖中的 5)請求 JSON Web Token (JWT)。
  • 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 到驗證服務(配置為位於回環介面上)。例如:你可以將它與127.0.0.1:80 POST http://127.0.0.1:80/authService/tokenGET 中的 trackingid: CLIENT… 標題和 POST中的 X-BROADSOFT-CORRELATION-ID : CLIENT… 標題關聯起來。

在 authenticationService 記錄檔中:

  • 從 Xsi 接收 POST(回送)

  • StatusCode=200 返回Xsi

  • 並且回應中包含一個“token”JSON區塊,用於驗證令牌。

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

在 XsiActionsLog 中:

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

用戶端如常繼續:

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

Webex for BroadWorks 故障排除特定問題

合作夥伴中心問題

管理員無法查看客戶組織

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

使用者配置問題

整合 IM & 特定企業的P誤差 / 顧客

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

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

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

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

整合 IM & 特定使用者的 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 向 AS 發送 SIP REGISTER 請求(如果 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.

通話設定網頁檢視問題

自我照顧 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>。

更新通用身份資訊中的使用者資訊失敗。請使用使用者 API 再次更新使用者資訊。

200014

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

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

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

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

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

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

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

200043電子郵件驗證失敗,因為使用者客戶配置映射不正確。使用者應使用其他電子郵件地址再試一次。否則,管理員必須刪除使用此電子郵件地址的其他使用者。
200044驗證電子郵件失敗,因為 userId 在此 BroadWorks 叢集上已被使用。使用者應使用其他電子郵件地址再試一次。否則,管理該現有使用者帳戶(其使用此電子郵件地址)的客戶組織管理員必須刪除該使用者帳戶。
200045透過自行啟用新增使用者失敗,因為使用者已屬於另一個組織。使用者應使用不同的電子郵件地址重新嘗試註冊。否則,管理不同組織的客戶組織管理員應該刪除現有帳戶。
200046透過自助啟動新增使用者失敗,因為在同一個 BroadWorks 叢集下存在多個具有相同 broadworksUserId 的待處理使用者。管理員應從控制中心刪除待處理使用者。
200047透過自助啟動新增使用者失敗,因為該使用者 ID 已在此 BroadWorks 叢集上使用。使用者應使用其他電子郵件地址再試一次。否則,管理現有使用者帳戶的客戶組織管理員應刪除該現有使用者帳戶,或移除其他授權。
200048透過自行啟用新增使用者失敗,因為已使用不同的 BroadWorks 使用者 ID 佈建電子郵件地址。使用者應使用其他電子郵件地址再試一次。
200049透過自助啟動新增使用者失敗,因為該使用者 ID 已在此 BroadWorks 叢集上使用。使用者應使用其他電子郵件地址再試一次。否則,管理現有使用者帳戶的客戶組織管理員應刪除該現有使用者帳戶,或移除其他授權。
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年10月29日更新了 有用的日誌檔案XSLog 來源列。
2025年4月23日BroadWorks Calling Webex 應用程式日誌 來源中刪除 bwc 資料夾。
2023年7月29日「從合作夥伴中心檢索使用者日誌 」和 「取得用戶端日誌或回饋 」部分中,新增了對 「 Webex 應用程式 | 」的「報告問題 」 (以產生日誌)的參考
2022 年 6 月 27 日已更新 閱讀清單 ,缺少 Connect (Android) 遷移到 Firebase 方法的連結。
2022年6月21日更新了 閱讀列表 鏈接,使其指向 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 Serviceability Connection 的資訊。
2020 年 12 月 8 日更新文件。將品牌 Webex Teams 更名為 Webex(應用程式)。新增最終使用者錯誤代碼。
2020 年 11 月 3 日新增通話設定網頁檢視。
2020 年 10 月 22 日新文件已發布。
本文是否有幫助?
本文是否有幫助?