2026年10月10日 | 269 回表示 | 0 人がこの投稿記事が役に立ったと考えています

シスコブロードワークス XSP|ADPS 向けに Webex でサービスを設定してください

list-menuフィードバックがある場合
このガイドでは、認証、TLS/mTLS 設定、共存要件、XSI インターフェイスのセットアップを中心に、Cisco BroadWorks で XSP|ADP を Webex と統合するように設定するために必要なサービスとアプリケーションの概要を説明しています。

シスコブロードワークス XSP|ADPS 向けに Webex でサービスを設定してください

NPSアプリケーションは別のXSP|ADPで実行する必要があります。 そのXSP|ADPの要件は、「ネットワークからの着信通知の設定」で説明されています。

XSP|ADPには、次のアプリケーション/サービスが必要です。

サービス/アプリケーション

認証が必要です

サービス/アプリケーションの目的

XSI-イベント

TLS（サーバーはクライアントに対して自身を認証します）

通話制御、サービス通知

XSI-アクションズ

TLS（サーバーはクライアントに対して自身を認証します）

通話制御、アクション

デバイス管理

TLS（サーバーはクライアントに対して自身を認証します）

通話設定のダウンロード

認証サービス

TLS（サーバーはクライアントに対して自身を認証します）

ユーザー認証

コンピューター・テレフォニー・インテグレーション

mTLS（クライアントとサーバーは互いに認証します）

テレフォニープレゼンス

通話設定 Webviewアプリケーション

TLS（サーバーはクライアントに対して自身を認証します）

Webex アプリ内のセルフケアポータルにユーザー通話設定を公開します

このセクションでは、 これらのインターフェイスにTLSとmTLSに必要な構成を適用する方法について説明しますが、 XSP|ADPにアプリケーションをインストールするには、既存のドキュメントを参照する必要があります。

共同居住の要件

  • 認証サービスはXsiアプリケーションと共存する必要があります。なぜなら、これらのインターフェースはサービス認証用の長期間有効なトークンを受け入れる必要があるからです。 これらのトークンを検証するには、認証サービスが必要です。

  • 認証サービスとXsiは、必要に応じて同じポートで実行できます。

  • 規模 （専用デバイス管理XSP、ADPファームなど）に応じて、他のサービス/アプリケーションを分離できます。

  • Xsi、CTI、認証サービス、DMSアプリケーションを同じ場所に配置できます。

  • BroadWorksとWebexの統合に使用されるXSP|ADPには、他のアプリケーションやサービスをインストールしないでください。

  • NPSアプリケーションを他のアプリケーションと同じ場所に配置しないでください。

Xsiインターフェース

Cisco BroadWorks Xtended Services インターフェイス設定ガイドの説明に従って、Xsi-Actions と Xsi-Events アプリケーションをインストールして設定します。

CTIインターフェイスに使用するXSP|ADPには、 Xsi-Eventsアプリケーションのインスタンスを1つだけ導入する必要があります。

BroadworksとWebexの統合に使用されるすべてのXSIイベントには、アプリケーション/XSIイベント/一般設定で定義されているのと同じCallControlアプリケーション名が必要です。 例えば:

adp_cli/アプリケーション/XSI-イベント/一般設定> 取得

コールコントロールアプリケーション名 = com.broadsoft.xsi-events

ユーザーがWebexに登録すると、Webexはプレゼンスと通話履歴のテレフォニーイベントを受信するために、AS上のユーザーのサブスクリプションを作成します。 サブスクリプションはCallControlApplicationNameに関連付けられており、ASはそれを使用してどのXsi-Eventsにテレフォニーイベントを送信するかを判断します。

CallControlApplicationNameを変更したり、すべてのXsi-Events Webアプリで同じ名前を使わなかったりすると、サブスクリプションとテレフォニーイベントの機能に影響します。

認証サービスの設定（CIトークンの検証を含む）

この手順を使用して、TLSでCIトークン検証を使用するように認証サービスを設定します。 この認証方法は、R22以降を実行していて、システムがサポートしている場合にお勧めです。

認証サービスの代替認証方法として、相互TLS（mTLS）もサポートされています。 同じ XSP|ADP サーバー上で運営されている複数の Webex 組織がある場合は、mTLS 認証を使用する必要があります。CI トークンの検証では、同じ XSP|ADP 認証サービスへの複数の接続はサポートされていないからです。

CIトークン検証の代わりに認証サービスのmTLS認証を設定するには、設定サービスの付録（認証サービスのmTLS）を参照してください。

現在、認証サービスにmTLSを使用している場合は、TLSでCIトークン検証を使用するように再設定する必要はありません。

  1. シスコブロードワークス向け Webex の OAuth 認証情報の取得。

  2. 次のパッチを各XSP|ADPサーバーにインストールしてください。 あなたのリリースに適したパッチをインストールしてください：

    XSPへの参照には、XSPまたはADPのいずれかが含まれます。

  3. 認証サービスアプリケーションを各XSP|ADPサービスにインストールします。

    1. 次のコマンドを実行して、 XSP|ADP上の認証サービスアプリケーションを/authServiceコンテキストパスにアクティブにします。

      xsp|adp_cli/メンテナンス/管理対象オブジェクト> アプリケーション認証サービスを有効にする 22.0_1.1123/AuthService

    2. このコマンドを実行して、XSP |ADP に認証サービスを展開します。

      xsp|adp_cli/メンテナンス/管理対象オブジェクト> アプリケーションをデプロイ/AuthService/AuthServiceBroadworksソフトウェアマネージャーが/AuthServiceをデプロイしています...

  4. Broadworksビルド2022.10以降、Javaに付属している認証局は、新しいバージョンのJavaに切り替えたときに、自動的にBroadWorksトラストストアに含まれなくなりました。 認証サービスは、アクセストークンを取得するためにWebexへのTLS接続を開きます。IDBrokerとWebex URLを検証するには、トラストストアに次のものが必要です。

    • アイディーントラストコマーシャルルート CA 1

    • ゴー・ダディ・ルート Certificate Authority-G2

    これらの証明書が次のCLIに存在することを確認してください

    adp_cli/システム/SSL共通設定/トラスト/デフォルト > 取得

    存在しない場合は、次のコマンドを実行してデフォルトのJavaトラストをインポートします。

    adp_cli/システム/SSL 共通設定/トラスト/デフォルト > JavaCA トラストのインポート

    または、次のコマンドでこれらの証明書をトラストアンカーとして手動で追加することもできます。

    adp_CLI/システム/SSL 共通設定/トラスト/ブロードワークス > アップデートトラスト <alias><trustAnchorFile>

    ADPが以前のリリースからアップグレードされた場合、古いリリースの認証局は新しいリリースに自動的にインポートされ、手動で削除されるまでインポートされ続けます。

    認証サービスアプリケーションは、ADP_CLI/システム/SSL共通設定/一般設定の「ピアIDの検証」設定から除外され、常にピアIDを検証します。 この設定の詳細については、シスコブロードワークスのX509証明書検証FDを参照してください。

  5. 各 XSP|ADP サーバーで次のコマンドを実行して ID プロバイダーを設定します。

    xsp|adp_cli/アプリケーション/認証サービス/アイデンティティプロバイダー/Cisco> get

    • クライアントIDを設定しますステップ1でクライアントIDを設定します

    • 有効に設定されています true

    • クライアントシークレットをステップ1で設定するクライアントシークレットを

    • CIレスポンス本体の最大サイズ（バイト単位）65536を設定します

    • 発行者名を設定する <URL>— URLには、CIクラスターに適用される発行者名のURLを入力します。 次の表を参照してください。

    • 発行者URLを設定 <URL>— URLには、CIクラスターに適用される発行者URLを入力してください。 次の表を参照してください。

    • settokenInFourl <IdPProxy URL>—チームクラスターに適用するIdPプロキシURLを入力してください。 次の 2 番目の表を参照してください。

    テーブル 1.発行者名と発行者URLを設定します
    もしCIクラスターが...発行者名と発行者URLを... に設定してください

    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.4つにトークンを設定してください
    もしチームクラスターが...トークンinFourlを... に設定してください(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

    • Teamsクラスターがわからない場合は、Control Hubのヘルプデスクビューにあるお客様の詳細から情報を入手できます。

    • テストのために、URLの「idp/authenticate」の部分を「ping」に置き換えることで、TokenInFourlが有効であることを確認できます。

  6. 次のコマンドを実行して、Webex のユーザープロファイルに存在する必要がある Webex 権限を指定します。

    xsp|adp_cli/アプリケーション/認証サービス/アイデンティティプロバイダー/Cisco/Scopes> スコープを設定 Broadworks-Connector: user

  7. 各XSP|ADPサーバーで次のコマンドを使用して、シスコフェデレーションのIDプロバイダーを設定します。

    xsp|adp_cli/アプリケーション/認証サービス/アイデンティティプロバイダー/Cisco/フェデレーション> get

    • flsURL https://cifls.webex.com/federation を設定します

    • 更新期間を60分で設定

    • 手順1で更新トークンの更新トークンを設定してください

  8. 次のコマンドを実行して、FLSの設定が機能していることを確認します。 このコマンドは、IDプロバイダーのリストを返します：

    xsp|adp_cli/アプリケーション/認証サービス/アイデンティティープロバイダー/Cisco/Federation/ClusterMap > Get

  9. 各XSP|ADPサーバーで次のコマンドを使用してトークン管理を設定します。

    • xsp|adp_cli/アプリケーション/認証サービス/トークン管理>

    • セットトークン発行者ブロードワークス

    • トークンの期間を720時間に設定しました

  10. RSAキーを生成して共有します。 1つのXSP|ADPでキーを生成し、 それを他のすべてのXSP|ADPにコピーする必要があります。 これは以下の要因によるものです。

    • 認証サービスのすべてのインスタンスで、トークンの暗号化/復号化に同じ公開鍵と秘密鍵のペアを使用する必要があります。

    • キーペアは、最初にトークンを発行する必要があるときに認証サービスによって生成されます。

    キーを循環させたり、キーの長さを変更したりする場合は、 次の構成を繰り返して、すべてのXSP|ADPを再起動する必要があります。

    1. キーペアの生成に使用するXSP|ADPを1つ選択してください。

    2. クライアントを使用して、 クライアントのブラウザから次のURLをリクエストして、そのXSP|ADPに暗号化されたトークンをリクエストします。

      https://<XSP|ADP-IPAddress>/authService/token?キー=ベース64 URL（クライアントの公開キー）

      （これにより、XSP|ADPに秘密鍵と公開鍵のペアが生成されます。まだ生成されていない場合は）

    3. キーストアの場所は設定できません。 キーをエクスポートしてください:

      xsp|adp_cli/アプリケーション/認証サービス/キー管理>キーのエクスポート

    4. エクスポートしたファイル /var/Broadworks/tmp/authService.keysを他のXSP|ADPの同じ場所にコピーし、必要に応じて古い.keysファイルを上書きします。

    5. 他のXSP|ADPのそれぞれのキーをインポートしてください:

      xsp|adp_cli/アプリケーション/認証サービス/キーマネジメント> インポートキー /var/Broadworks/TMP/AuthService.keys

  11. 認証サービスのURLをウェブコンテナに提供してください。 XSP|ADPのウェブコンテナには、トークンを検証するためにAuthService URLが必要です。 各XSP|ADPについて:

    1. 認証サービスのURLを、BroadWorksコミュニケーションユーティリティの外部認証サービスとして追加してください:

      xsp|adp_cli/システム/通信ユーティリティ/デフォルト設定/外部認証/認証サービス> URLを設定 http://127.0.0.1:80/authService

    2. 認証サービスのURLをコンテナに追加してください:

      xsp|adp_cli/メンテナンス/コンテナオプション> tomcat bw.authservice.authServiceURL http://127.0.0.1:80/authService を追加

      これにより、Webexは認証サービスを使用して、認証情報として提示されたトークンを検証できます。

    3. パラメータをgetで確認してください。

    4. XSP|ADP を再起動してください。

認証サービスのクライアント認証要件を削除してください（R24のみ）

R24で認証サービスにCIトークンの検証を設定している場合は、認証サービスのクライアント認証要件も削除する必要があります。 次の CLI コマンドを実行してください。

adp_cli/インターフェイス/HTTP/SSL共通設定/クライアント認証/Webアプリ>認証サービスクライアント認証をfalseに設定してください <interfaceIp><port>

HTTPインターフェイスでのTLSと暗号の設定（XSIと認証サービス用）

認証サービス、Xsi-Actions、Xsi-Eventsアプリケーションは、 HTTPサーバーインターフェイスを使用します。 これらのアプリケーションのTLS設定レベルは次のとおりです。

最も一般的な = システム > トランスポート > HTTP > HTTP サーバーインターフェイス = 最も具体的

さまざまなSSL設定を表示または変更するために使用するCLIコンテキストは次のとおりです。

特異性 CLIコンテキスト
システム (グローバル)

xsp|adp_CLI/システム/SSL共通設定/JSSE/暗号>

xsp|adp_CLI/システム/SSL共通設定/JSSE/プロトコル>
このシステムのトランスポートプロトコル

xsp|adp_CLI/システム/SSL共通設定/オープンSSL/暗号>

xsp|adp_CLI/システム/SSL共通設定/オープンSSL/プロトコル>
このシステムの HTTP

xsp|adp_cli/インターフェイス/HTTP/SSL共通設定/暗号>

xsp|adp_cli/インターフェイス/HTTP/SSL共通設定/プロトコル>
このシステムの特定のHTTPサーバーインターフェイス

xsp|adp_cli/インターフェイス/HTTP/httpserver/SSL設定/暗号>

xsp|adp_cli/インターフェイス/HTTP/HTTPサーバー/SSL設定/プロトコル>

XSP|ADPでHTTPサーバーのTLSインターフェイス構成を読みます

  1. XSP|ADPにサインインして、XSP|ADP_CLI/インターフェイス/HTTP/HTTPサーバー>に移動します

  2. getコマンドを入力して結果を読んでください。 インターフェイス（IPアドレス）と、それぞれについて、それらが安全かどうか、 クライアント認証が必要かどうかを確認する必要があります。

Apache Tomcatでは、安全なインターフェイスごとに証明書が義務付けられています。システムは、 必要な場合は自己署名証明書を生成します。

XSP|ADP_CLI/Interface/Http/HttpServer> get

Results displayed after entering the get command, showing interfaces (IP addresses) and, for each, whether they are secure and whether they require client authentication.

HTTPサーバーインターフェイスへのTLS 1.2プロトコルの追加

Webex クラウドとやり取りする HTTP インターフェイスは、TLSv1.2 用に設定する必要があります。 クラウドは以前のバージョンのTLSプロトコルをネゴシエートしません。

HTTPサーバーインターフェイスでTLSv1.2プロトコルを設定するには：

  1. XSP|ADPにサインインして、XSP|ADP_CLI/Interface/httpserver/SSL設定/プロトコル>に移動します

  2. get 443コマンドを入力して<interfaceIp>、 このインターフェイスですでに使用されているプロトコルを確認してください。

  3. add 443 TLSv1.2というコマンドを入力して、クラウドとの通信時にインターフェイスがTLS <interfaceIp>1.2を使用できるようにします。

HTTPサーバーインターフェイスでのTLS暗号設定の編集

必要な暗号を設定するには：

  1. XSP|ADPにサインインして、XSP|ADP_CLI/Interface/httpserver/SSL設定/暗号に移動してください>

  2. get 443コマンドを入力して<interfaceIp>、 このインターフェイスですでに使用されている暗号を確認してください。 シスコが推奨するスイートが少なくとも1つ必要です（「概要」セクションの「XSP|ADP IDおよびセキュリティ要件」を参照）。

  3. add 443コマンドを入力して <interfaceIp><cipherName>、HTTPサーバーインターフェイスに暗号を追加します。

    XSP|ADP CLIには、OpenSSL暗号スイート名ではなく、IANA標準の暗号スイート名が必要です。 たとえば、OpenSSL暗号 ECDHE-ECDSA-CHACHA20-POLY1305をHTTPサーバーインターフェイスに追加するには、次のようにします。XSP|ADP_CLI/Interface/HTTP/httpserver/SSLSettings/ciphers> 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305を追加します

    スイートをどちらかの名前で検索するには、https://ciphersuite.info/ を参照してください。

XSP|ADP、アプリケーションサーバー、およびプロファイルサーバーでデバイス管理を設定します

デバイス管理には、プロファイルサーバーとXSP|ADPが必須です。 これらは、 BroadWorksデバイス管理設定ガイドの指示に従って設定する必要があります。

この投稿記事は役に立ちましたか？
この投稿記事は役に立ちましたか？
価格Webex アプリMeetingsCallingメッセージング画面共有
Webex スイートCallingMeetingsメッセージングSlidoウェビナーEventsContact CenterCPaaSセキュリティControl Hub
ヘッドセットカメラDesk シリーズRoom シリーズBoard シリーズPhone シリーズアクセサリ
教育ヘルスケア行政財務スポーツとエンターテインメントフロントライン非営利スタートアップハイブリッド ワーク
ダウンロードテストミーティングに参加オンラインクラスインテグレーションアクセシビリティインクルージョンライブ & オンデマンド ウェビナーWebex CommunityWebex Developersニュース & イノベーション
Ciscoサポートへお問い合わせセールスに問い合わせWebex BlogWebex ソート リーダーシップWebex Merch Storeキャリア
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
利用規約プライバシーステートメントクッキー商標
©2026 Cisco and/or its affiliates. All rights reserved.
利用規約プライバシーステートメントクッキー商標