共同レジデンシー要件

• 認証サービスは Xsi アプリケーションと共同レジデンシーをもつ必要があります。これらのインターフェイスは、サービスの承認のために長期間トークンを受け入れる必要があります。 トークンを検証するには、認証サービスが必要です。

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

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

• Xsi、CTI、認証サービスおよび DMS アプリケーションを共同で検索できます。

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

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

Xsi インターフェイス

Cisco BroadWorks Xtended Services Interface Configuration Guide の説明に従って、Xsi-Actions および Xsi-Events アプリケーションをインストールし、構成します。

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

Broadworks と Webex の統合に使用されるすべての Xsi-Events は、Applications/Xsi-Events/GeneralSettings で定義された同じ callControlApplicationName を持つ必要があります。 例:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

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

callControlApplicationName を変更するか、すべての Xsi-Events Webapps に同じ名前がない場合は、サブスクリプションとテレフォニー イベントの機能に影響します。

認証サービス（CI トークン検証使用）を設定する

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

Mutual TLS (mTLS) も、認証サービスの代替認証方法としてサポートされています。 同じ XSP|ADP サーバーから複数の Webex 組織を実行している場合、CI トークン検証は同じ XSP|ADP 認証サービスへの複数の接続をサポートしないため、mTLS 認証を使用する必要があります。 CI トークン検証の代わりに mTLS 認証を認証サービスに構成するには、「サービスの設定 (認証サービスに mTLS を使用)」の付録を参照してください。

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

1. Cisco BroadWorks 版 Webex の OAuth 資格情報を取得する。

2. 各 XSP|ADP サーバに次のパッチをインストールします。 リリースに適切なパッチをインストールします。

   • R22 の場合:

     AP.platform.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap368601

   • R23 の場合:

     AP.xsp.23.0.1075.ap376509

     AP.platform.23.0.1075.ap376509

   • R24 の場合—パッチは必要ありません

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

3. 各 XSP サービスに AuthenticationService 各 XSP|ADP サービス上のアプリケーション。

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

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService

   2. このコマンドを実行して、XSP|ADP に AuthenticationService を展開します。

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...

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

   • IdenTrust Commercial Root CA 1

   • Go Daddy Root Certificate Authority - G2

   これらの証明書が次の CLI の下にあることを確認します。

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

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

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

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

   ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>

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

   AuthenticationService アプリケーションは、ADP_CLI/System/SSLCommonSettings/GeneralSettings の下の validatePeerIdentity 設定から除外され、常にピア ID を検証します。 この設定の詳細については、Cisco Broadworks X509 証明書検証 FDを参照してください。

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

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get

   • set clientId client-Id-From-Step1

   • set enabled true

   • set clientSecret client-Secret-From-Step1

   • set ciResponseBodyMaxSizeInBytes 65536

   • set issuerName <URL> — URL には、CI クラスタに適用される IssuerName URL を入力します。 次の表を参照してください。

   • set issuerUrl <URL> — URL には、CI クラスタに適用される IssuerUrl を入力します。 次の表を参照してください。

   • set tokenInfoUrl <IdPProxy URL> —Teams クラスタに適用される IdP プロキシ URL を入力します。 次の表を参照してください。

   表 1. issuerName と issuerURL の設定

   CI クラスターが...	issuerName と issuerURL を...
   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. tokenInfoURL の設定

   Teams クラスターが...	tokenInfoURL を...(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 の [ヘルプデスク] ビューの [顧客] 詳細から情報を取得できます。 テストでは、tokenInfoURL が " を置き換えることで有効であることを確認できます idp/authenticate 」の部分を「 ping 」に置き換えることで、URL が有効かどうかを検証できます。

6. 次のコマンドを実行して、Webex のシステムでユーザー プロファイル必要な Webex エンタイトルメントを指定します。

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user

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

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get

   • set flsUrl https://cifls.webex.com/federation

   • set refreshPeriodInMinutes 60

   • set refreshToken refresh-Token-From-Step1

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

   XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get

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

   • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

   • set tokenIssuer BroadWorks

   • set tokenDurationInHours 720

10. Generate and Share RSA Keys. 1 つの XSP|ADP でキーを生成し、他のすべての XSP|ADP にコピーする必要があります。 これは次の要因による影響です。

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

    • 鍵ペアは、トークンを発行するために最初に必要な認証サービスにより生成されます。

    キーをサイクルするか、キーの長さを変更する場合は、次の設定を繰り返して、すべての XSP|ADP を再起動する必要があります。

    1. キーペアを生成するために使用する XSP|ADP を 1 つ選択します。

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

       https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)

       （これにより、XSP|ADP 上にプライベート キーとパブリック キーのペアが生成されます（まだペアが存在しない場合））

    3. 鍵ストアのロケーションは構成できません。 次のとおり鍵をエクスポートします。

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. エクスポートしたファイル /var/broadworks/tmp/authService.keys 他の XSP|ADP の同じ場所に移動し、 .keys ファイルから解凍します。

    5. 他の XSP|ADP の各キーをインポートします。

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys

11. ウェブ コンテナに authService URL を提供します。 XSP|ADP の Web コンテナは、トークンを検証するために authService URL を必要とします。 各 XSP|ADP で:

    1. 次のように、認証サービス URL を BroadWorks Communications ユーティリティの外部認証サービスとして追加します。

       XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1/authService

    2. 次のように、コンテナに認証サービス URL を追加します。

       XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService

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

    3. パラメータを次で確認します: get です。

    4. XSP|ADP を再起動します。

認証サービスのクライアント認証要件を削除する (R24 のみ)

R24 で CI トークン検証で構成された認証サービスがある場合、認証サービスのクライアント認証要件も削除する必要があります。 以下の CLI コマンドを実行します。

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false

HTTP インターフェイスでの TLS および暗号の設定 (XSI および認証サービス)

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

最も一般的 = System > Transport > HTTP > HTTP サーバー インターフェイス = 最も具体的

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

XSP|ADP での HTTP サーバ TLS インターフェイス設定の読み取り

1. XSP|ADP にサインインし、 XSP|ADP_CLI/Interface/Http/HttpServer>

2. コマンド get を入力して、結果を読み取ります。 インターフェイス (IP アドレス) と、それぞれの インターフェイスがセキュアかどうか、およびクライアント認証が必要かどうか確認する必要があります。

Apache tomcat は各セキュアインターフェイスに証明書を要求しています。必要な場合、システムは自己署名証明書を生成してください。

XSP|ADP_CLI/Interface/Http/HttpServer> get

TLS 1.2 プロトコルを HTTP サーバー インターフェイスに追加する

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

HTTP Server インターフェイスで TLSv1.2 プロトコルを構成するには:

1. XSP|ADP にサインインし、 XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

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

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

TLS 暗号化構成の HTTP サーバー インターフェイスでの編集

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

1. XSP|ADP にサインインし、 XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

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

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

   XSP|ADP CLI では、openSSL 暗号スイート名ではなく、IANA 標準暗号スイート名が必要です。 たとえば、openSSL 暗号 ECDHE-ECDSA-CHACHA20-POLY1305 を HTTP サーバーインターフェイスに追加するには、次を使用します： XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 どちらかの名前でスイートを検索する場合は、https://ciphersuite.info/ を参照してください。

XSP|ADP、アプリケーション サーバ、プロファイル サーバでのデバイス管理の設定

デバイス管理には、プロファイルサーバと XSP|ADP が必須です。 『BroadWorks デバイス管理設定ガイド』の手順に沿って構成する必要があります。

CTI サブスクリプションに対するアプリケーションサーバーを構成する

Cisco BroadWorks 版 Webex CTI クライアント証明書の共通名 (CN) でアプリケーション サーバーの ClientIdentity を更新します。

Webex と共に使用する各アプリケーション サーバーに対して、以下のように証明書 ID を ClientIdentity に追加します。

AS_CLI/System/ClientIdentity> add bwcticlient.webex.com

Cisco BroadWorks 版 Webex クライアント証明書の共通名は bwcticlient.webex.com です。

CTI インターフェイスで TLS と暗号を構成する

XSP|ADP CTI インターフェイスの構成可能性のレベルは次のとおりです。

最も一般的 = System > Transport > CTI インターフェイス > CTI インターフェイス = 最も具体的

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

新規インストールでは、システムレベルでデフォルトで次の暗号がインストールされます。 インターフェイスレベルで何も設定されていない場合（たとえば、CTI インターフェイスまたは HTTP インターフェイス）、この暗号リストが適用されます。 このリストは時間の経過とともに変更される場合があります。 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_DHE_DSS_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_DSS_WITH_AES_128_CBC_SHA256 TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256

XSP|ADP での CTI TLS インターフェイス設定の読み取り

1. XSP|ADP にサインインし、 XSP|ADP_CLI/Interface/CTI/CTIServer>

2. コマンド get を入力して、結果を読み取ります。 インターフェイス (IP アドレス) と、それぞれに対して、サーバー証明書を必要とするかどうか、およびクライアント認証が必要かどうか確認する必要があります。

   XSP|ADP_CLI/Interface/CTI/CTIServer> get
     Interface IP  Port  Secure  Server Certificate  Client Auth Req
   =================================================================
     10.155.6.175  8012    true                true             true
   

TLS 1.2 プロトコルを CTI インターフェイスに追加する

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

CTI インターフェイスで TLSv1.2 プロトコルを構成するには:

1. XSP|ADP にサインインし、 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

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

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

TLS 暗号構成の HTTP インターフェイスでの編集

CTI インターフェイスで必要な暗号を構成するには:

1. XSP|ADP にサインインし、 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

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

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

   XSP|ADP CLI では、openSSL 暗号スイート名ではなく、IANA 標準暗号スイート名が必要です。 たとえば、openSSL 暗号 ECDHE-ECDSA-CHACHA20-POLY1305 を CTI インターフェイスに追加するには、次を使用します： XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 どちらかの名前でスイートを検索する場合は、https://ciphersuite.info/ を参照してください。

CTI インターフェイスの信頼アンカー（R22 以降）

この手順は、XSP|ADP がインターネットに接続しているか、パススルー プロキシ経由でインターネットに接続していることを前提としています。 証明書の構成はブリッジ プロキシとは異なります (「TLS ブリッジ プロキシの TLS 証明書要件」を参照してください)。

CTI イベントを Webex にパブリッシュするインフラストラクチャ内の各 XSP|ADP について、次の手順を実行します。

1. Partner Hub にサインインします。

2. [設定] > [BroadWorks Calling] に移動し、[Webex CA 証明書 をダウンロードする] をクリックして CombinedCertChain2023.txt をローカルコンピューターに取得します。

   これらのファイルには、2 つの証明書の 2 セットが含まれています。 XSP|ADP にファイルをアップロードする前に、ファイルを分割する必要があります。 すべてのファイルが必要です。

3. 証明書チェーンを 2 つの証明書に分割 - combinedcertchain2023.txt

   1. 開く combinedcertchain2023.txt を開きます。

   2. 行 -----BEGIN CERTIFICATE----- および -----END CERTIFICATE----- を含むテキストの最初のブロックを選択して切り取り、テキストブロックを新しいファイルに貼り付けます。

   3. 新しいファイルを次の名前で保存します： root2023.txt です。

   4. 元のファイルを次の名前で保存します： issuing2023.txt です。 元のファイルにはテキストのブロックが 1 つだけ残っており、次の行で囲まれているはずです： -----BEGIN CERTIFICATE----- および -----END CERTIFICATE----- です。

4. 保護している XSP|ADP の一時的な場所に両方のテキスト ファイルをコピーします。例: /var/broadworks/tmp/root2023.txt および /var/broadworks/tmp/issuing2023.txt

5. XSP|ADP にサインインし、 /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

6. （オプション） help updateTrust を実行してパラメータとコマンドの形式を確認します。

7. 証明書ファイルを新しい信頼アンカーにアップロードする - 2023

   XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt

   XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt

   すべてのエイリアスには別の名前が必要です。 webexclientroot2023 、および webexclientissuing2023 信頼アンカーの例エイリアスです。すべてのエントリが一意である限り、独自のエイリアスを使用できます。

8. アンカーが更新されるのを確認します。

   XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get

     Alias   Owner                                   Issuer
   =============================================================================
   webexclientissuing2023       Internal Private TLS SubCA      Internal Private Root
   webexclientroot2023       Internal Private Root      Internal Private Root[self-signed]

9. クライアントの証明書を使った認証を許可する:

   XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

CTI インターフェイスを追加し、mTLS を有効にする

1. CTI SSL インターフェイスを追加します。

   CLI コンテキストは、BroadWorks バージョンに依存します。 コマンドはインターフェイスに自己署名サーバー証明書を作成し、インターフェイスにクライアント証明書が必要な必要があります。

   • BroadWorks R22 および R23 の場合:

     XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true

2. XSP|ADP の CTI インターフェイスのサーバ証明書とキーを置き換えます。 この場合、CTI インターフェイスの IP アドレスが必要です。次のコンテキストから読み取るできます。

   • BroadWorks R22 および R23 の場合:

     XSP|ADP_CLI/Interface/CTI/CTIServer> get

     次に、以下のコマンドを実行して、インターフェイスの自己署名証明書を独自の証明書と秘密鍵に置き換わります。

     XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>

3. XSP|ADP を再起動します。

Webex で BroadWorks CTI Events へのアクセスを有効にする

Partner Hub でクラスターを構成するときに、CTI インターフェイスを追加し、検証する必要があります。 詳細については、「Partner Hub でパートナー組織を構成する」を参照してください。

Partner Hub でクラスターを構成するときに、CTI インターフェイスを追加し、検証する必要があります。 詳細については、「Partner Hub でパートナー組織を構成する」を参照してください。

• Webex が BroadWorks CTI Events をサブスクライブすることができる CTI アドレスを指定します。

• CTI サブスクリプションはサブスクライバー別を基本とし、そのサブスクライバーが Cisco BroadWorks 版 Webex にプロビジョニングされている間のみ成立し、維持されます。

ユーザーエクスペリエンス

• Windows ユーザーの場合: [通話設定] をクリックし、[] をクリックします。 [コール設定（Call Preferences）] > [コールの詳細設定（Advanced Call Settings）] を開きます。

• Mac ユーザーの場合 プロファイル画像をクリックし、基本設定 > コールの詳細設定。

XSP|ADP にコール設定 Webview をインストールする

CSWV アプリケーションは、ご使用の環境で Xsi-Actions インターフェイスをホストするのと同じ XSP|ADP 上にある必要があります。 XSP|ADP 上の管理されていないアプリケーションであるため、Web アーカイブファイルをインストールして展開する必要があります。

1. cisco.com にサインインし、ソフトウェアのダウンロードセクションで「BWCallSettingsWeb」を検索します。

2. ファイルの最新バージョンを見つけてダウンロードします。

   例: BWCallSettingsWeb_1.8.2_1.war （ https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04）は、執筆時点での最新のものでした。

3. XSP|ADP バージョンの Cisco BroadWorks Xtended Service Platform 設定ガイドに従って、Web アーカイブをインストール、アクティベート、および展開します。 （R24バージョンはhttps://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdfです）。

   1. .war ファイルを XSP|ADP の一時的な場所にコピーします。 /tmp/ です。

   2. 次の CLI コンテキストに移動し、インストール コマンドを実行します。

      XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war

      BroadWorks ソフトウェア マネージャがファイルの検証とインストールを行います。

   3. [オプション] /tmp/BWCallSettingsWeb_1.7.5_1.war を削除します（このファイルはもう必要ありません）。

   4. アプリケーションをアクティベートにする:

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      どのアプリケーションにも name と version は必須ですが、CSWV の場合は、管理対象ではないアプリケーションなので contextPath も提供する必要があります。 別のアプリケーションで使用されていない次のような値を使用できます： /callsettings です。

   5. 選択したコンテキスト パスに、コール設定アプリケーションを展開します。

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

4. クライアントに指定するコール設定 URL を、次のように予測できます。

   https://<XSP|ADP-FQDN>/callsettings/

   注意:

   • クライアント構成ファイルに入力する際に、この URL の末尾のスラッシュに指定する必要があります。

   • XSP|ADP-FQDN は Xsi-Actions FQDN と一致する必要があります。CSWV は Xsi-Actions を使用する必要があり、CORS はサポートされていません。

5. Cisco BroadWorks 版 Webex 環境の他の XSP|ADP に対してこの手順を繰り返します (必要に応じて)。

通話設定 Webview アプリケーションが XSP|ADP でアクティブになりました。

NPS プロキシの概要

Cisco BroadWorks 版 Webex との互換性のために、CNPS はパッチを適用して NPS プロキシ機能、UCaaS で VoIP のプッシュ サーバーをサポートする必要があります。

この機能は、通知プッシュ サーバーの新しい設計を実装して、モバイル クライアントのサービス プロバイダとプッシュ通知証明書の秘密鍵を共有するセキュリティ上の脆弱性を解決します。 NPS はプッシュ通知証明書と鍵をサービス プロバイダーと共有する代わりに、新しい API を使用して、短命プッシュ通知トークンを Cisco BroadWorks 版 Webex のバックエンドから取得し、このトークンを Apple APN および Google FCM サービスの認証に使用します。

この機能により、通知プッシュ サーバーが新しい Google Firebase Cloud Messaging (FCM) HTTPv1 API 経由で Android デバイスにプッシュ通知する機能も強化されています。

• 詳細については、「UCaaS の VoIP のプッシュ サーバーの機能説明」を参照してください。

• この機能の BroadWorks パッチは、以下で利用できます。 https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04です。

  NPS ソフトウェアとパッチについては、「Cisco BroadWorks 版 Webex の NPS を準備する」セクションを参照してください。

  ソフトウェアのダウンロードページからパッチを検索してダウンロードします。

• ADP サーバーの詳細については、https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.htmlを参照してください。

BroadWorks クラスターを構成する

[クラスターごとに 1 回]

これは、次の理由で行います。

• Webex クラウドが BroadWorks に対してユーザーを認証できるようにするには (XSP|ADP がホストする認証サービスを介して)。

• Webex アプリを有効にし、コール制御のために Xsi インターフェイスを使用するため。

• Webex が BroadWorks によって公開された CTI イベントをリッスンできるようにするため (テレフォニーのプレゼンスおよび通話履歴)。

クラスター ウィザードは、追加するインターフェイスを自動的に検証します。 インターフェイスの 1 つが正常に検証されない場合、クラスターの編集を続けできますが、無効なエントリがある場合はクラスターを保存できません。 正しく設定されていないクラスターによって、解決が困難な問題を引き起こす可能性があるため、これを防止します。

行う必要があること:

1. パートナー管理者資格情報を使用して、Partner Hub (admin.webex.com) にサインインします。

2. サイド メニューから [設定] ページを開き、BroadWorks Calling 設定を検索します。

3. [クラスタの追加] をクリックします。

   これにより、XSP|ADP インターフェイス（URL）を提供するウィザードが起動します。 非標準ポートを使用している場合は、インターフェイス URL にポートを追加できます。

4. このクラスターに名前を付け、[次へ] をクリックします。

   ここでのクラスタのコンセプトは、単に XSP|ADP サーバまたはファーム上に並ぶインターフェイスの集合であり、Webex がアプリケーション サーバ（AS）から情報を読み取ることを可能にします。 AS クラスタごとに 1 つの XSP|ADP、またはクラスタごとに複数の XSP|ADP、または XSP|ADP ごとに複数の AS クラスタを持つことができます。 お使いの BroadWorks システムのスケール要件については、この範囲外です。

5. (オプション) Webex に接続している BroadWorks システムにあると知っている BroadWorks のユーザー アカウント名とパスワードを入力し、[次へ] をクリックします。

   検証テストは、このアカウントを使用して、クラスターのインターフェイスへの接続を検証することができます。

6. XSI アクションと XSI Events URL を追加します。

7. オプションです。 デバイスアクティベーションサービスのURLを使用してDAS URLを更新します。

8. オプションです。 BroadWorks へのログインを BroadWorks に直接接続する場合は、[BroadWorks 直接認証を有効にする] チェックボックスをオンにします。 それ以外の場合、BroadWorks への認証は、Webex がホストする IdP プロキシ サービスを通じてプロキシされます。

   このチェックボックスは、次のログイン状況に影響します。

   • ユーザー アクティベーション ポータル ログイン:ポータルにログインするときに、ユーザーは BroadWorks クレデンシャルを入力する必要があります。 上記の設定は、ログインが BroadWorks に直接接続されているか、または IdP プロキシ経由であるかどうかを決定します。

   • クライアントログイン:BroadWorks 認証 がオンボーディング テンプレートで設定されている場合、上記の設定により、Webex アプリへのクライアントログインが BroadWorks に直接接続されているか、IdP プロキシを介してプロキシされているかが決まります。

9. [次へ] をクリックします。

10. [CTI インターフェイス] ページで、次の操作を行います。

    1. 接続する CTI インターフェイスに CTI URL とポートを追加します。

    2. オプションです。 [通話履歴] トグルを有効にして、BroadWorks ユーザー ID を入力します。 このオプションを選択すると、BroadWorks の通話履歴イベントが Webex クラウドに同期されます。 ユーザーは Webex アプリで自分の通話履歴を表示できます。

    3. オプションです。 [サイレント (DND) 同期] トグルを有効にし、BroadWorks ユーザー ID を入力します。 このオプションは、Webex と BroadWorks の間の DND イベントを同期し、両方のプラットフォームで機能が同じように動作するようにします。

    4. [次へ] をクリックします。

11. 認証サービス URL を追加します。

12. [Auth Service with CI token validation (認証サービスと CI トークンの検証)] を選択します。

    認証サービスは、長期間有効なトークンをユーザーに発行する前に、Webex ID サービスに対してユーザー トークンを適切に検証するため、このオプションでは、Webex からの接続を保護するために mTLS は必要ありません。

13. 最終的な画面でエントリを確認し、[作成] をクリックします。 成功のメッセージが表示されるはずです。

    Partner Hub は URL を提供されたインターフェイスへの接続をテストするさまざまな Webex マイクロサービスに渡します。

14. [クラスターの表示] をクリックすると、新しいクラスターが表示され、検証が成功したかどうかを確認します。

15. [作成] ボタンは、ウィザードの最終 (プレビュー) 画面では無効になる場合があります。 テンプレートを保存できない場合、構成したインテグレーションの 1 つで問題がある場合を示します。

    その後のタスクでエラーが発生するのを防ぐために、このチェックを実施しました。 テンプレートを保存する前に、このガイドで説明されているようにインフラストラクチャ（XSP|ADP、ロードバランサ、ファイアウォールなど）への変更が必要な展開を設定するときに、ウィザードに戻ることができます。

BroadWorks インターフェイスへの接続の確認

1. パートナー管理者資格情報を使用して、Partner Hub (admin.webex.com) にサインインします。

2. サイド メニューから [設定] ページを開き、BroadWorks Calling 設定を検索します。

3. [クラスターの表示] をクリックします。

4. Partner Hub は、さまざまなマイクロサービスからクラスターのインターフェイスに対する接続テストを開始します。

   テストが完了したら、クラスター リスト ページには、各クラスターの隣にステータス メッセージが表示されます。

   成功のメッセージが表示されるはずです。 赤のエラー メッセージが表示された場合は、影響を受けるクラスター名をクリックして、問題を生じしている設定を確認します。

5. オプションです。 XSI-Actions、XSI-Events、DAS URL、CTI インターフェイスの設定など、そのクラスタの既存の設定を表示する場合は、クラスタを選択します。

オンボーディング テンプレートの設定

オンボーディング テンプレートは、プロビジョニング メソッドを使用してオンボードする際に、1 つ以上の顧客に共有設定を適用する方法です。 各テンプレートをクラスターに関連付ける必要があります (前のセクションで作成)。

必要な数だけテンプレートを作成できますが、顧客に関連付けられるのは 1 つのテンプレートのみです。

1. パートナー管理者資格情報を使用して、Partner Hub (admin.webex.com) にサインインします。

2. サイド メニューから [設定] ページを開き、BroadWorks Calling 設定を検索します。

3. [Add template] をクリックします。

   ウィザードを起動すると、このテンプレートを使用する顧客に構成を提供することができます。

4. [クラスター] ドロップダウンを使用して、このテンプレートで使用するクラスターを選択します。

5. [テンプレート名] を入力して、[次へ] をクリックします。

6. 次の推奨設定を使用して、プロビジョニング モードを構成します。

   表 3. 異なるプロビジョニング モードに対して推奨されるプロビジョニング設定

   設定名	信頼済みメールによるフロースルー	メールなしのフロースルー プロビジョニング	ユーザー セルフプロビジョニング
   BroadWorks Flow Through Provisioning を有効にする (On** の場合、プロビジョニング アカウント クレデンシャルを含む)	オン BroadWorks 構成に基いてプロビジョニング アカウント名とパスワードを提供します。	オン BroadWorks 構成に基いてプロビジョニング アカウント名とパスワードを提供します。	オフ
   Control Hub で新規組織を自動作成	オン†	オン†	オン†
   サービス プロバイダのメール アドレス	ドロップダウンからメール アドレスを選択します (長いリストの場合は、いくつかの文字を入力してアドレスを検索します)。 このメール アドレスは、オンボーディング テンプレートで作成された新しい顧客組織への委任された管理者アクセスを付与されるパートナー組織内の管理者を識別します。
   国	このテンプレートに使用する国を選択します。 選択した国は、このテンプレートで作成された顧客組織を特定の地域に一致させます。 現在、地域は (EMEAR) または (北米および他の世界) である場合があります。 「このスプレッドシートで国と地域のマッピング」を参照してください。 組織国は、Webex ミーティングサイトの Cisco PSTN のデフォルトの国際コールイン番号を決定します。 詳細については、ヘルプページの「国」セクションを参照してください。
   BroadWorks Enterprise モードがアクティブ	このテンプレートを使用してプロビジョニングした顧客が BroadWorks の企業である場合、これを有効にします。 彼らがグループの場合は、このスイッチをオフにしたままにしてください。 BroadWorksでエンタープライズとグループが混在する場合は、これらの異なるケースに対して異なるテンプレートを作成する必要があります。

   表中のメモ:

   • †このスイッチは、サブスクライバのメール ドメインが既存の Webex 組織と一致しない場合に、新しい顧客組織が作成されるのを確認します。

     手動注文およびフルフィルメント プロセス (Cisco Commerce Workspace 経由) を使用して Webex で顧客組織を作成しない限り、これは常にオンである必要があります (これらの組織のユーザーのプロビジョニングを開始する前に)。 このオプションは、「ハイブリッド プロビジョニング」モデルと呼ばれることが多く、この文書の範囲外にあります。

   • ** 「プロビジョニング アカウント」とは、BroadWorks システムレベルの管理者アカウントを指します。 BroadWorks では、次の属性を持つ管理者アカウントが必要です。 Administrator Type=Provisioning、Read-only=Off。

7. このテンプレートを使用する顧客のデフォルトのサービス パッケージを選択します (概要セクションの「パッケージ」を参照してください。[Basic]、[Standard]、[Premium]、[Softphone] のいずれかです)。

   Partner Hub 経由で個々のユーザーに対してこの設定をオーバーライドできます。

8. オプションです。 Webex 通話を無効にするには、[Cisco Webex 無料通話を無効にする] をオンにします。

9. [ミーティング参加の構成] で次のいずれかのオプションを選択します。

   • Cisco のコールイン番号 (PSTN)

   • パートナー提供のコールイン番号 (BEdPSTN) - このオプションを選択する場合、このオプションの設定方法の詳細については、『Cisco BroadWorks 版 Webex の Bring Your Own PSTN ソリューション ガイド』を参照してください。

10. [次へ] をクリックします。

11. 信頼されたメールまたは信頼されていないメールを使用して、ID の確認方法に関して、サブスクライバをプロビジョニングするには、2 つのアプローチがあります。

    Trusted Email ワークフローでは、ユーザーは BroadWorks に追加するパートナーにメール アドレスを提供します。 パートナーは、フロースルーまたは API 方法の一部としてメール アドレスをプロビジョニングする責任があります。

    すべてのサブスクライバがパートナーとして完全にプロビジョニングされ、エンドユーザーからのアクションが不要であることを保証するため、信頼されたプロビジョニング方法を使用することを強くお勧めします。

    信頼できないメールの場合、ユーザーはプロビジョニングする前にメールを確認する必要があります。または、ユーザーは自分でアクティベートできます。

    信頼できないケースでは、以下の表の検証設定に基づいて複数のプロビジョニング モードがあります。

    表 4. 信頼できないプロビジョニング モードの推奨ユーザー検証設定

    設定名	メールなしのフロースルー プロビジョニング	ユーザー セルフプロビジョニング
    プロビジョニング管理者が最初	推奨*	適用できません
    ユーザーにセルフ アクティベーションを許可する	適用できません	必須

    • 表中のメモ:

    • * Webex の各顧客組織には、管理者ロールを持つ少なくとも 1 人のユーザーが必要です。 BroadWorks で統合型 IM&P を割り当てる最初のユーザーは、Webex で新しい顧客組織が作成された場合、顧客管理者のロールを受け取ります。 サービス プロバイダーとして、ロールを取得するユーザーをコントロールできます。 この設定を確認すると、プロビジョニングした最初のユーザがアクティブになるまで、ユーザがアクティベーションを完了できなくなります。 この設定をオフにすると、新規組織で最初にアクティブになるユーザーが顧客管理者になります。

12. [次へ] をクリックします。

13. Webex へのユーザーログインのデフォルト認証モード (BroadWorks 認証 または Webex 認証) を選択します。

    この設定は、ユーザー アクティベーション ポータルへのユーザー ログインには影響しません。 ユーザーは、オンボーディング テンプレートの設定方法に関係なく、ポータルにログインするときに BroadWorks ユーザー ID とパスワードを使用する必要があります。

    この設定は新しく作成された顧客組織にのみ適用されます。 パートナー管理者が既存の顧客組織に新しい認証設定を適用しようとすると、既存の設定が適用されるため、既存のユーザーがアクセス権を失うことはありません。 既存の顧客組織の認証モードを変更するには、Cisco TAC でチケットを開く必要があります。

    (「環境 の準備」セクションの「認証モード」を参照してください)。

14. [次へ] をクリックします。

15. [基本設定] で次の設定を行います。

    1. ログイン ページでユーザーのメール アドレスをあらかじめ入力するかを選択します。

       BroadWorks 認証を選択し、BroadWorks の代替 ID 属性にユーザーのメール アドレスを設定している場合にのみ、このオプションを使用してください。 そうでない場合、BroadWorks ユーザー名を使用する必要があります。 ログイン ページに、必要に応じてユーザーを変更するオプションが与えられますが、ログインの問題が発生する可能性があります。

    2. ディレクトリの同期を有効にする場合、[すべての新しい顧客組織の電話ディレクトリの同期を有効にする] を [オン] に切り替えます。

       このオプションにより、Webex は BroadWorks の連絡先を顧客組織に読み込み、ユーザーが Webex アプリから連絡先を見つけて発信することができるようになります。

    3. パートナー管理者 を入力します。

       この名前は Webex からの自動メール メッセージで使用され、メール アドレスを検証するためにユーザーを招待します。

    4. 既存の組織のプロビジョニングのトグルがオン (デフォルト 設定はオン) になっていることを確認します。

    5. [次へ] をクリックします。

16. 最終画面でエントリーを確認します。 ウィザードの上部にあるナビゲーション コントロールをクリックして、戻って、詳細を変更できます。 [作成] をクリックします。

    成功のメッセージが表示されるはずです。

17. [テンプレートの表示] をクリックすると、他のテンプレートと一緒に新しいテンプレートがリストされます。

18. 必要に応じて、テンプレート名をクリックしてテンプレートを変更または削除します。

    プロビジョニング アカウントの詳細を再入力する必要はありません。 空のパスワード/パスワード確認フィールドは、必要な場合は資格情報を変更するためのフィールドとしてありますが、ウィザードで指定した値を保持するには空のままにします。

19. 顧客に指定したい共有設定が異なる場合は、さらにテンプレートを追加します。

    次のタスクではテンプレートの詳細が必要になるので、以下の [テンプレートの表示] ページを開いたままにします。

パッチ アプリケーション サーバ（R22、R23、および R24 のみ）

1. まだ実行していない場合は、リリースに適用される次のパッチを適用してください。

   • R22 の場合: AP.as.22.0.1123.ap373197

   • R23 の場合: AP.as.23.0.1075.ap373197

   • R24 の場合: AP.as.24.0.944.ap384177

   Cisco BroadWorks 版 Webex の導入要件を構成する BroadWorks パッチの完全なリストについては、[参照] セクションの「BroadWorks ソフトウェア要件」を参照してください。

2. コンテキストを Maintenance/ContainerOptions コンテキストに移動します。

3. プロビジョニング URL パラメータを有効にする:

   /AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true

Partner Hub からプロビジョニング URL を取得する

AS コマンドの 詳細 (インターフェイス > メッセージングとサービス > 統合型 IM&P) については、「Cisco BroadWorks アプリケーション サーバー コマンド ライン管理ガイド」を参照してください。

1. Partner Hub にサインインし、 [Settings (設定)] > [BroadWorks Calling] の順に移動します。

2. [テンプレートの表示] をクリックします。

3. Webex でこのエンタープライズ/グループのサブスクライバをプロビジョニングするために使用するテンプレートを選択します。

   テンプレートの詳細が、右のフライアウト ペインに表示されます。 テンプレートをまだ作成していない場合は、プロビジョニング URL を取得する前に作成する必要があります。

4. プロビジョニング アダプター URL をコピーします。

複数のテンプレートがある場合、他のテンプレートにもこれを繰り返します。

(オプション) アプリケーション サーバーでシステム全体のプロビジョニングパラメータを構成する

UC-One SaaS を使用している場合は、システム全体のプロビジョニングとサービス ドメインを設定したくない場合があります。 (「環境の準備」セクションの「意思決定ポインター」を参照してください)。

1. アプリケーション サーバーにサインインしてメッセージ インターフェイスを設定してください。

   1. AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL

   2. AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name

   3. AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password

   4. AS_CLI/Interface/Messaging> set enableSynchronization true

2. 統合型 IMP インターフェイスをアクティベートする:

   1. /AS_CLI/Service/IntegratedIMP> set serviceDomain example.com

   2. /AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true

Control Hub で与えられた、 provisioningURL パラメータの完全修飾名を入力する必要があります。 ホスト名を解決するために、アプリケーションサーバーが DNS にアクセスできない場合、AS 上の /etc/hosts ファイルにマッピングを作成する必要があります。

(オプション) アプリケーション サーバーでエンタープライズごとのプロビジョニング パラメーターを構成する

1. BroadWorks UI で、構成するエンタープライズを開き、[サービス] > [統合型 IM&P] に移動します。

2. [サービス ドメインを使用する] を選択し、値を入力します (Webex はパラメーターを無視します。 次を使用できます： example.com) として共有する必要があります。

3. [メッセージング サーバーを使用] を選択します。

4. [URL] フィールドで、Partner Hub のテンプレートからコピーしたプロビジョニング URL を貼り付けます。

   Control Hub で与えられた、 provisioningURL パラメータの完全修飾名を入力する必要があります。 ホスト名を解決するために、アプリケーションサーバーが DNS にアクセスできない場合、AS 上の /etc/hosts ファイルにマッピングを作成する必要があります。

5. [ユーザー名] フィールドに、プロビジョニング管理者の名前を入力します。 これは、Partner Hub のテンプレートの値と一致する必要があります。

6. プロビジョニング管理者のパスワードを入力します。 これは、Partner Hub のテンプレートの値と一致する必要があります。

7. [IM&P ID のデフォルト ユーザー ID] で [プライマリ] を選択します。

8. [適用] をクリックします。

9. フロースルー プロビジョニングを構成するべき、その他のエンタープライズについても、同じ手順を繰り返します。

ユーザー プロビジョニング データ

ユーザー プロビジョニング中に BroadWorks と Webex の間で交換されるユーザー データについては、「サービス プロバイダーのユーザー プロビジョニング」を参照してください。

BroadWorks アプリケーション サーバーに Webex アプリ構成テンプレートを追加する

Webex アプリは DTAF ファイルで構成されます。 クライアントは、XSP|ADP のデバイス管理サービスを介して、アプリケーション サーバから設定 XML ファイルをダウンロードします。

1. 必要な DTAF ファイルを取得します (「環境の準備」セクションの「デバイス プロファイル」を参照してください)。

2. [BroadWorks システム] > [リソース] > [デバイス管理タグ セット] で適切なタグセットを持っていることを確認します。

3. 各クライアントに対してプロビジョニングを行います。

   1. 特定のクライアント向け DTAF zip ファイルをダウンロードし、抽出します。

   2. DTAF ファイルを BroadWorks に [システム] > [Id/デバイス プロファイル タイプ] にインポートする

   3. 編集のために新しく追加されたデバイス プロファイルを開き、以下を行います。

      • XSP|ADP ファームの FQDN と Device Access Protocol を入力します。

      • [リモートパーティ情報のサポート] チェックボックスをオンにします。 このサポートは、デスクトップ共有が機能するために必要です。

        アプリケーションサーバーで次の CLI コマンドを実行することで、リモートパーティのサポートを有効にすることもできます。 AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

   4. お使い環境に合わせてテンプレートを変更します (下表を参照)。

   5. プロファイルを保存する。

4. [ファイルと認証] をクリックしてから、すべてのシステム ファイルを再構築するオプションを選択します。

Webex アプリのブランディングをカスタマイズする

• パートナーのカスタマイズ—パートナー管理者は、パートナーが管理するパートナー組織および/または顧客に適用される高度なブランディングカスタマイズを適用できます。 詳細は、「高度なブランディングのカスタマイズの設定」を参照してください。

• 顧客のカスタマイズ—パートナーが顧客が独自のブランディングのカスタマイズを適用することを許可している場合、顧客管理者は「Webex に会社のブランディングを追加」の手順に従うことができます。

ユーザー アクティベーション ポータルは、クライアント ブランディングに追加したのと同じロゴを使用します。

問題の報告とヘルプ URL をカスタマイズする

これらのオプションをカスタマイズするには、管理者は上記の両方のブランディング記事にある「フィードバックとヘルプサイトのURLを追加」の手順に従うことができます。