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

使用日誌分析、支援工作流程、故障排除指南和錯誤代碼參考,診斷並解決 Webex for Cisco BroadWorks 客戶的問題。

本文面向服務提供者組織的技術支援團隊,他們負責為自己和客戶提供支援。他們應該熟悉一般故障排除、閱讀日誌和處理使用者案例。

本文分為三個主要部分:

  • 資源-提供您可能需要的工具、閱讀材料、日誌和聯絡人清單。
  • 流程-描述在解決客戶問題時可以採取的一些操作。
  • 具體問題-對已知發生的問題進行分類和列出,說明如何發現這些問題,以及如何可能解決這些問題。

故障排除資源

有用的日誌文件

記錄檔名稱

來源

可用於疑難排解

PSLog

應用程式伺服器

流程佈建

湯姆貓 access_log

XSP

Webex App 登入

XsiActionsLog

XSP

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

authenticationService log

XSP

Webex App 登入(令牌驗證和頒發)

XSLog

應用程式伺服器

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

通話訊號

Webex App 啟動日誌

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 連接器部署指南

故障排除過程

問題升級

在按照一些故障排除指南操作後,你應該可以大致了解問題的根源所在。

過程

  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 應用 | 報告問題
  • 請行動用戶端使用者傳送日誌,然後您可以透過合作夥伴中心或幫助台取得這些日誌。

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

    已提交支持案件的案件編號

取得通話環境資料

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

過程

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

確認 Webex 是否已註冊至 BroadWorks。

Webex App 會檢查以下資訊以確定是否註冊 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)」的授權,也就是透過思科管理的雲端通話服務進行 Webex App 通話。

檢查組織的通話行為

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

解決具體問題

合作夥伴中心問題

1. 管理員無法查看客戶組織

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

使用者配置問題

1. 整合 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
傳訊伺服器使用者名稱佈建帳戶名稱
傳訊伺服器密碼佈建帳戶密碼、確認密碼

2. 整合 IM & 特定使用者的 P 錯誤

如果您使用的是直通式配置,並且假設配置功能正常運行,則此說明適用。 some/most 使用者(這樣就可以排除設定問題)。如果您看到“整合 IM”, & 例如,BroadWorks 中的 P 錯誤 “[Error 18215] 訊息伺服器配置錯誤” “[Error 如果出現「18211」錯誤(與訊息伺服器通訊錯誤),您應該調查以下潛在原因:

  • 使用者的電子郵件地址可能已存在 CI。在幫助中心搜尋該用戶,查看其電子郵件地址是否已存在。這不一定能得出確切結論,因為該使用者可能屬於某個組織,而您在幫助中心無權查看該組織的資料。
  • 在被指派整合式 IM&P 服務之前,使用者已獨立註冊 Webex。在這種情況下,一種選擇是讓使用者刪除他們的免費帳戶,這樣他們就可以成為您正在配置的客戶組織的一部分。說明在… https://help.webex.com/5m4i4y
  • 該使用者未在其個人資料中指派主要電話號碼(所有 Webex for Cisco BroadWorks 使用者都必須有一個主要 DID)。請參閱從 AS 分析 PSLog 的主題。

3. 使用者配置失敗,回應來自配置橋接器

如果使用者在分配整合即時通訊工具後幾分鐘內沒有出現在控制中心,則可能會出現問題。 & 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 中的現有使用者符合該請求中的電子郵件地址。

4. 使用者已在 CI 中

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

使用者登入問題

1. 用戶啟動入口網站無法載入

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

2. 單一登入失敗

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

呼叫配置和註冊問題

使用者在 Webex 中完成設定並成功登入 Webex 應用程式後,應用程式會註冊至 BroadWorks。以下是預期的註冊流程以及註冊成功後出現的正常跡象(從 Webex 應用程式中可以看到):

1. 預期註冊順序

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

2. 客戶註冊成功預期跡象

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

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

3. 客戶端沒有通話圖標

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

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

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

註冊不成功。Webex App 用戶端無法透過 BroadWorks 註冊的原因有很多:

4. 正在使用同一客戶測試多個呼叫服務

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

5. 身份驗證服務配置錯誤

根據解決方案指南檢查託管驗證服務的 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 設定頁面取得憑證)。

6. BroadWorks 標記的設定不正確

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

7. 桌面用戶端在成功建立 SSO 連線後斷開電話服務。

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

8. 桌面設備未指派給用戶

該簽名出現在客戶端日誌中:

[0x70000476b000] BroadWorksConfigDownloader.cpp:106

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

9. 來電只會響一聲或無人接聽。

撥入 Webex 行動端的來電只會響一聲,否則使用者無法接聽來電。同一用戶的其他終端可能會繼續響鈴。

如何識別?

在 Webex 行動用戶端日誌中,尋找推送呼叫流程中的 XSI 錯誤代碼 101002。譬如:

回應代碼:400

handlePushCallInfoFailure:BWC:INTERNAL: 推播呼叫:callID 的 xsi 狀態:<callID> xsi 錯誤代碼:101002

closePushCallWithReason:BWC:INTERNAL: 嘗試關閉帶有 ID 的推送呼叫。 = <callID>, 原因 = 呼叫放棄

原因: 錯誤代碼 101002 可能表示在 LocateUser 回應中傳回了錯誤的應用程式伺服器 (AS)。當使用者遷移到輔助 AS 時,可能會發生這種情況。

建議檢查的項目:

從部署了推送功能的 ADP 或 XSP 伺服器上,為受影響的使用者執行 LocateUser 以下命令:

curl 'http://:80/servlet/LocateUser?url=&returnCompatibleXSP=true&callPRequest=true'

範例: curl 'http://1.1.1.1:80/servlet/LocateUser?url=9721112222@gmail.com&returnCompatibleXSP=true&callPRequest=true'

解析度:如果LocateUser 傳回使用者的輔助 AS,則在主 NS 伺服器上執行 migrateUserToDefaultNode.pl 腳本,將使用者移轉回叢集的主應用程式伺服器。

透過 SSH 登入 NS 伺服器,進入 /usr/local/broadworks/bw_base/bin 目錄,然後執行:migrateUserToDefaultNode.pl

範例: migrateUserToDefaultNode.pl bwas1

若要取得 hostingNE 的值,請執行: NS_CLI/System/Device/HostingNE> get

腳本首先檢查是否能找到您作為參數提供的宿主網路環境 (NE)。在驗證託管 NE 有效後,它會將 DN、副檔名和 URL 更新為該託管 NE 的預設節點。

盡可能在流量較低的時段執行腳本。但是,如果需要恢復受影響用戶的服務,通常隨時執行該腳本都是可以接受的。

該腳本不能僅供單一使用者執行。它會遷移 LocateUser 輸出中列出的所有使用者。如果無法執行腳本,請在 BroadWorks 中刪除並重建受影響的用戶,以便將使用者重建在正確的 AS 上。

使用者裝置向輔助 AS 發送的任何 SIP 訊息都可能導致使用者遷移。除非傳入的請求繼續到達輔助 AS,否則使用者通常會在預設的 15 分鐘間隔後回滾到主 AS。例如,如果 SBC 無法連線到 AS1 並遞歸連線到輔助 AS,則受影響的使用者可能會轉移到輔助 AS。根據部署情況,如果 SBC 持續無法連線到主 AS,則單一中繼群組或使用者可能會繼續綁定到輔助 AS。

如需相關資訊,請參閱下列文件:

通話設定網頁檢視問題

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

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

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

2. 點擊「自我照顧」後出現空白頁面或錯誤。 button/link

通常情況下,Webex App 中的這種行為表示 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 中的合作夥伴組織及客戶組織設定,並確保其設定的區域相符。
200056使用者註冊流程進行中失敗,郵件內容相同。使用者註冊流程已在使用相同電子郵件地址進行。用戶應稍等幾分鐘後再試。如果問題仍然存在,管理員應檢查該電子郵件地址是否有待處理或重複的入職記錄,並在重試之前清除待處理使用者狀態。
300005預檢失敗,因為使用者已在佇列中,正在辦理配置手續。用戶配置仍在進行中。請稍等幾分鐘後再查看。
300006您現在無法加入 <name of SP offer> 。請在幾分鐘後再試一次。如果問題仍然存在,請聯絡您的 <customer organization administrator>。參考 #: <reference ID>用戶應在幾分鐘後重試。如果上述方法無效,請聯絡 Cisco API 支援團隊。 https://developer.webex.com/

目錄同步錯誤代碼

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

錯誤碼

錯誤訊息

600000

BroadWorks外部目錄使用者同步出現意外錯誤。

600001

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

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

600003

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

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

更改歷史記錄

表格記錄了本指南的變更歷史。

日期變更
2026年7月28日
  • 在 「呼叫配置和註冊問題」 部分下方新增了一個新的子部分 「來電響一聲或無法接聽 」 。

  • 新增錯誤代碼詳情:200056 和 300006。

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 日新文件已發布。
本文是否有幫助?
本文是否有幫助?