BroadWorks 版 Webex のトラブルシューティング特定の懸案事項

Partner Hub の問題

管理者が顧客の組織を見ることができない

Webex のパートナー組織の管理者として、フル管理者のロールを持っている必要があります。 このロールは、自分自身や他のユーザーに管理者権限を割り当てるなど、パートナー組織の管理に使用されます。 顧客の組織を管理するには、自分 (または他の人) に販売フル管理者ロールまたは販売管理者ロールを付与する必要 があります。 https://help.webex.com/fs78p5 を参照してください。

ユーザー プロビジョニングの問題

特定の企業/顧客の IM&P エラーの統合

異なるクラウド コラボレーション サービスを使用する企業が混在する場合 (UC-One SaaS および BroadWorks 版 Webex)、企業ごとにプロビジョニングアダプタを変更することを選択した可能性があります。

統合型 IM&P (より具体的な設定が存在しない限り、企業のデフォルト) に対して設定されていることを確認するには AS_CLI/Interface/Messaging> get を実行します。 特定のエンタープライズのプロビジョニング パラメータについては、エンタープライズを開いて、[サービス] > [統合型 IM&P] に移動します。

そのエンタープライズの統合型 IM&P 構成が、Partner Hub のカスタマー テンプレートに表示されている情報と正確に一致することを確認してください。 以下の設定が一致する必要があります。そうしないと、エンタープライズのすべてのユーザーに対するプロビジョニングが失敗します。

BroadWorks エンタープライズ統合型 IM&P 設定

Partner Hub のカスタマー テンプレートの設定

メッセージング サーバー URL

プロビジョニング URL

メッセージング サーバーのユーザー名

プロビジョニング アカウント名

メッセージング サーバー パスワード

プロビジョニング アカウントのパスワード、パスワードの確認

特定ユーザーの統合型 IM&P のエラー

これは、フロースルー プロビジョニングを使用し、一部/ほとんどのユーザーに対してプロビジョニングが動作すると想定する場合に適用されます (これにより、構成の問題を排除できます)。

たとえば「メッセージング サーバーの [エラー 18215] プロビジョニング エラー」や「[エラー 18211] メッセージング サーバーとの通信エラー」など、BroadWorks で統合型 IM&P エラーが発生する場合、次の潜在的な原因を調査する必要があります。

  • ユーザーのメールアドレスはすでに CI が存在している可能性があります。 ヘルプ デスク内のユーザーを検索して、メールアドレスがすでに存在するかどうかを確認します。 これは必ずしも簡潔な話ではありません。ユーザーは、ヘルプ デスクで閲覧することを許可されていないデータをもつ組織に存在している可能性があります。

  • 統合型 IM&P サービスが割り当てられる前に、ユーザーは Webex に個別にサインアップします。 この場合、1 つのオプションは、ユーザーが無料アカウントを削除して、プロビジョニング中の顧客組織の一員になれる方法です。 詳細は 以下のページ https://help.webex.com/5m4i4y を参照してください。

  • ユーザーはプロファイルにプライマリ電話番号が指定されていません (BroadWorks の全 Webex サブスクライバーはプライマリ DID を持っている必要があります)。 「AS から PSLog を分析する」を参照してください。

プロビジョニング ブリッジからの応答でユーザー プロビジョニングに失敗しました

ユーザーが Control Hub に表示されない場合、統合型 IM&P を割り当てから数分以内に、プロビジョニング ブリッジ サービスからの応答コードを確認してください。 PSLog を実行して、HTTP 応答コードを確認します。

200 OK

200 OK 応答は、ユーザーが正常にプロビジョニングされたことを意味している意味ではありません。 つまり、プロビジョニング サービスが要求を受け取り、対応するユーザー作成要求をアップストリーム サービスに正常に送信したことを意味します。

設計により、プロビジョニング トランザクションは非同期です。 このサービスは 200 OK を応答します。ユーザー作成プロセスには数分かかり、パフォーマンス上の理由により、同じユーザーを作成するために複数の要求を受け取りたくないためです。

しかし、200 OK 応答の後、最終的にユーザーが顧客組織に表示されない場合、ユーザー作成がプロビジョニング サービスの Webex サービス アップストリームで失敗したこと示す場合があります。

200 OK 応答があるプロビジョニングの失敗をエスカレーションする必要があります

400 Bad 要求

この応答をプロビジョニング サービスから引き起こす可能性がある問題に関する詳細を持つ HTTP 応答を確認します。 <message> ノードのいくつかの例:

  • 「レガシー プロビジョニング API による BroadWorks メールを信頼できません。」

    失敗したユーザーのプロビジョニング要求に関連付けられたメール アドレスは有効ではないか、入力ミスですが、メール アドレスが信頼できることをテンプレートで確認しました。 BroadWorks でユーザーのプロファイル、特にメール ID を確認します。

  • 「顧客の組織はデータベースで見つからず、新しい組織作成フラグは有効になっていません。」

    この失敗したプロビジョニング要求は、Webex で新しい顧客組織を作成する必要がありますが、テンプレートが新しいカスタマー組織が作成されるのを防ぐために構成されています。 新しい組織を、Webex の既存の顧客と一致しないメール ドメインに対して許可する場合は、Partner Hub でテンプレートを再構成し、プロビジョニング要求を再テストできます。 しかし、このユーザーに対して新しい組織が作成されないことが予想される場合、おそらくメール アドレスに入力ミスがあると想定されます (特にドメイン部分)。 BroadWorks で、ユーザーのメール ID を確認します。

403 Forbidden

プロビジョニング要求に成功する可能性はありません。 この場合、要求と応答を調査する必要があります。 たとえば、組織の適切なプロビジョニング ブリッジ URL ではなく、プロビジョニング要求のターゲットとして IP アドレスが表示される場合 (ソリューション ガイドのファイアウォールの構成に関するトピックを参照してください)、アプリケーション サーバーに必要なパッチが欠落している可能性があります (ap373197)。

すべての必要なパッチがアプリケーション サーバーに適用され、関連する構成が正常なフロースルー プロビジョニングに対して完了した構成を確認してください。

409 Conflict

Webex に要求のメール アドレスと一致する既存のユーザーがいるので、プロビジョニングの要求は処理できません。

CI にすでにユーザーがいます

HTTP POST 要求からサブスクライバー メールを取得し、それをヘルプ デスクで検索します。

許可されていない場合はユーザーを見ることができないかもしれませんが、ユーザーが「無料」組織 (例:「消費者」) に所属しているのも見える場合があります。

このユーザーに無料アカウントの削除を求めるか、別のメールアドレスを使用してプロビジョンすることができます。 https://help.webex.com/ndta402 を参照してください。

ユーザーのサインインの問題

ユーザー アクティベーション ポータルがロードされない

BroadWorks の通常のサインイン フローには、ユーザーがパスワードを入力するユーザー アクティベーション ポータルが含まれます。 ユーザーが Webex アプリのサインイン画面でメール アドレスを入力した後で、ポータルがロードされない場合があります。

この問題は、クライアント側またはサービス側にある可能性があります。 クライアント側では、これは通常、クライアントのネイティブブラウザが何らかの形でサービスと互換性がないことが原因です。

シングル サイン オンに失敗しました

  • BroadWorks で、ユーザーに Webex アプリのデバイス タイプが割り当てられているか確認します (ソリューション ガイドの「環境を準備する」セクションの「デバイス プロファイル」セクションを参照してください)。

  • ユーザーが正しいパスワードを使用していることを確認します: ユーザーの顧客組織(Partner Hub)のプロビジョンに使用したテンプレートが BroadWorks 認証用に設定されている場合、ユーザーは BroadWorks の「Web Access」パスワードを入力する必要があります。

コーリングの構成と登録の問題

ユーザーが Webex でプロビジョニングされ、Webex アプリに正常にサインインした後で、アプリは BroadWorks に登録します。 以下は予想される登録シーケンスであり、結果として健全な登録の兆候です (Webex アプリから見た場合):

予想される登録シーケンス

  1. クライアントは XSI に発信し、デバイス管理トークンと DMS への URL を取得します。

  2. クライアントはステップ 1 からトークンを提示することで、DMS からそのデバイス プロファイルを要求します。

  3. クライアントはデバイス プロファイルを読み取り、SIP 資格情報、アドレス、およびポートを取得します

  4. クライアントはステップ 3 からの情報を使用して SIP REGISTER を SBC に送信します。

  5. SBC は SIP REGISTER を AS に送信します (SBC が SIP ユーザーをまだ知らない場合、SBC は AS を検索するために NS の検索を実行する場合があります。)

クライアント登録の成功が予想される兆候

コーリング オプション アイコンが Webex インターフェイスに表示されます。

Webex アプリの電話サービス タブ (Windows では [設定] > [電話サービス]、Mac では [環境設定] > [電話サービス]) で、メッセージは「SSO セッション: サインインしています」は、アプリが (この場合、BroadWorks に) 正常に登録されたことを意味します。

クライアントに Calling アイコンはありません

ほとんどの場合、これはユーザーが正しいライセンス/エンタイトルメントを持っていないことを意味します。

クライアントが電話サービス タブを表示するが、セッション SSO されない

これは登録が失敗したことを示します。 Webex アプリ クライアントが BroadWorks への登録に失敗する理由は次のように複数あります。

同じクライアントで複数のコーリング サービスをテストする

この既知の問題は、異なるコーリングバックの間でクライアントが変更された場合に生じる場合があります。 Webex アプリ クライアントを経由して提供される (同じ) 異なるコーリング サービスのトライアル中に発生する可能性が高い。 クライアント データベース (リンク) をリセットして、この問題を解決することができます。

認証サービスの構成ミス

認証サービスをホストする XSP をソリューション ガイドに対して確認します (「BroadWorks XSP の Webex でサービスを設定する」 を参照してください)。 具体的には、次の操作を行います。

  • RSA 鍵 (1 つの XSP で生成された) がすべての XSP にコピーされます

  • 認証サービス URL がすべての XSP のウェブ コンテナに提供され、Partner Hub のクラスターに正しく入力されました

  • 証明書による外部認証は次のように設定されます。

    XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get allowUserApp = false allowClientApp = true
  • MTLS を使用する場合、Webex クライアント証明書を XSP にアップロードする必要があります (BroadWorks 設定ページの Partner Hub から証明書を取得できます)

BroadWorks タグの構成ミス

Webex アプリに必要な BroadWorks タグを構成済み (ソリューションガイドの「Webex に必要なBroadWorksタグ」を参照) であり、競合や間違った値が無いことを確認します。

特に、%SBC_ADDRESS_WXT% タグは、Webex アプリ クライアントの SIP 登録に向けた SBC である必要があります。

デスクトップ クライアントが SSO 接続に成功した後、電話サービスが切断される

この問題は、同じプラットフォーム タイプで同じユーザーが複数のクライアントにサインインすると発生する可能性があります。 たとえば、ユーザーが Windows の Webex アプリに正常にサインインし、異なる Windows マシンで Webex アプリにサインインした場合、アクティブな SSO セッションは 1 台のマシンにのみあります。 これは仕様です。

絶対にこの問題を回避する必要がある場合は、BroadWorks に同じデバイス タイプの複数のインスタンスを構成することができますが、固有の SIP アドレスを持つ必要があります。 この構成は、BroadWorks の Webex の範囲外にあります。

ユーザーに対してプロビジョニングされていないデスクトップ デバイス

この署名は、クライアント (\bwc\) ログに表示されます。

<Error> [0x70000476b000] BroadWorksConfigDownloader.cpp:106 onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - デバイス プロファイル「Business Communicator - PC」が見つかりません。

コール設定 Webview の問題

セルフ ケア ボタン/リンクが Webex アプリに表示されない

この問題には、ボタン/リンクが表示されているが、それをクリックすると外部ブラウザが開くという異なる症状があります。

  • 必要なクライアント構成テンプレートが展開され、CSW タグが適切に設定されていることを確認します。(「BroadWorks 版 Webex ソリューション ガイド」 の 「コール設定 Webview」セクションを参照)。

  • Webex アプリが BroadWorks でコールに対して登録されていることを確認します。

  • Webex アプリが CSWV をサポートする最新のバージョンであることを確認してください。

セルフ ケア ボタン/リンクをクリックした後の空白ページまたはエラーが発生する

一般的に、Webex アプリのこの動作は、BroadWorks XSP の CSWV アプリケーションの構成または展開の問題を示します。

CSWV ログ、アクセス ログ、config-wxt.xml レポジトリ、テンプレート ファイルなど、さらに調査の詳細を収集し、ケースを発生させます。

エンドユーザー エラー コード

次の表では、クライアントユーザーアクティベーション ポータルで確認できるエンドユーザー エラー コードを示します。


これは、エラー コードの徹底的なリストではありません。 この表は、Webex アプリがユーザーに明確な指示を提供していない既存のエラー コードのみをリストします。
表 1. エンドユーザー エラー コード

エラーコード

エラーメッセージ

200010

Broadworks ユーザーとしてが未承認のため、資格情報を確認できませんでした。

200018

ユーザーがロックアウトされたため、資格情報の検証に失敗しました

200019

セルフアクティベーションのためにユーザーを追加するときに、資格情報の検証に失敗しました

200022

ユーザーが未承認のため、メールを送信できませんでした。

200026

事前確認の失敗または保留中のユーザーの不正確な状態によりメールの検証に失敗しました PartnerOrgUUID: {partnerOrgUUID}、 BroadoworksUUID: {broadworksUUID}、ConfigSetUUID: {configSetUUID}

200039

emailId が別の組織ですでに使用されているため、メールを検証できません

200040

configSet が customerConfig の configSet に一致しないため、メールを検証中に失敗しました

200041

ユーザーが競合しているエンタイトルメントである別の共闘するサービスにすでにエンタイトルメントが付与されているため、メールの検証に失敗しました

200042

メールが別の BroadWorks UserID と既に関連付けられているため、メールの検証に失敗しました

200043

ユーザー構成マッピングが正しくないため、メールの検証に失敗しました

200044

userId がこの BroadWorks クラスターで既に使用されているので、メールの検証に失敗しました

200045

ユーザーがすでに別の組織の一員であるため、セルフアクティベーションを通じてユーザーを追加できませんでした

200046

複数の保留中ユーザーが同じ BroadWorks クラスターの下で同じ BroadWorksUserIDで存在するため、セルフアクティベーションを通じてユーザーを追加できませんでした

200047

userId がこの BroadWorks クラスターで既に使用されているので、セルフアクティベーションを通じてユーザーを追加できませんでした

200048

メール アドレスがすでに別の BroadWorks userId でプロビジョニングされているため、セルフアクティベーションを通じてユーザーを追加できません

200049

userId がこの BroadWorks クラスターで既に使用されているので、セルフアクティベーションを通じてユーザーを追加できませんでした

200050

provisioningID がサブスクライバーの企業の想定される provisioningID と一致しないため、セルフアクティベーションを通じてユーザーを追加できませんでした。

200051

この要求で指定された spEnterpriseId が、BroadWorks クラスターからすでにプロビジョニングされているサービス プロバイダ またはエンタープライズと競合するため、セルフアクティベーションを通じてユーザーを追加できませんでした。