この記事の内容
NPS 認証プロキシの概要
dropdown icon
NPS 認証プロキシの前提条件
    最小バージョンと共存制限
    共有NPS
    パン HTTP/2
    アンドロイド FCMv1
NPS プロキシ移行の概要
ブロードワークスのコラボレートiOSアプリを HTTP/2に移行してください
ブロードワークス UC-One Connect/SaaS アンドロイドアプリを FCMv1 に移行
BroadWorks UC-One Connect/SaaS アンドロイドアプリをFCMv1(ADP上)に移行します
FCM レガシーモードを再度有効にします
dropdown icon
NPS 認証プロキシパッチをインストールしてください
    R22パッチ
    R23パッチ
認証プロキシを使用するようにNPSを設定してください
NPSを再起動し、プッシュ通知をテストします
NPS プロキシを使用するように Cisco BroadWorks NPS を更新してください:設定ガイド
list-menuこの記事の内容
list-menuフィードバックがある場合

この構成ガイドで、NPSプロキシを利用するようにCisco BroadWorks NPSを更新する方法を学んでください。シームレスな統合とネットワークパフォーマンスの向上のためのステップバイステップの説明、考慮事項、ベストプラクティスをご覧ください。

NPS 認証プロキシの概要

この記事では、NPS認証プロキシを使用するように共有NPSを構成して、 Webexアプリへの通話通知のプッシュにも使用できるようにする方法について説明します。 お使いの NPS が他のアプリをサポートしていない場合は、Webex for BroadWorks ソリューションガイドの簡単な手順に従ってください。

NPS プロキシの概要

Webex for BroadWorksとの互換性を保つには、NPSのプロキシ機能、UCaaSのVoIP用プッシュサーバーをサポートするようにNPSにパッチを適用する必要があります。

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

この機能は、新しいGoogle Firebaseクラウドメッセージング(FCM)HTTPv1 APIを介してAndroidデバイスに通知をプッシュする通知プッシュサーバーの機能も強化します。

NPS 認証プロキシの前提条件

NPSをホストするXSP(またはアプリケーションデリバリープラットフォームADP)は、次の要件を満たしている必要があります。

最小バージョンと共存制限

  • NPSは専用のXSP/ADPでアクティブ化する必要があり、NPSはサーバー上でホストされている唯一のアプリケーションでなければなりません。 これは、プッシュ通知の配信を妨げないようにするためです。

  • 1つの展開にあるNPSアプリは1つだけにしてください。 モバイルUC-One Collaborate/Connect、またはUC-One SaaSを使用していて、BroadWorksにWebexを実装している場合は、この1つのNPSをすべてのアプリで共有する必要があります。

  • NPSはバージョンR22以降のXSP、またはADPでなければなりません。

    R22/R23 XSPは、XSPがNPSのみを実行していて、ASがR21.SP1の場合、R21スタックと互換性があります。 詳細については、BroadWorks互換性マトリックスを参照してください。

  • ADPサーバーの詳細については、Cisco BroadWorksアプリケーションデリバリープラットフォームを参照してください。

共有NPS

NPSプロキシを使用するように共有NPSを構成する前に、次の注意事項をお読みください。

  • NPS が(Webex アプリだけでなく)他のアプリで使用されている場合:まず NPS プロキシを設定してから、NPS を FCM レガシー API の使用から FCM HTTP v1 API の使用に変更します。

  • NPSプロキシを使用する古いアプリで通知が正しく機能することを確認したら、AndroidアプリのFCM APIキーとiOSアプリのAPN認証キーを削除します。

パン HTTP/2

アンドロイド FCMv1

  • Cisco/Broadsoft製ではないAndroidアプリをデプロイした場合は、 NPSがNPSプロキシを使用するように構成する前に、それらのアプリがFCMv1キーを使用するように構成してください。

  • XSP/ADPが現在ConnectまたはUC-One SaaSアプリをサポートしている場合は、 NPSプロキシを設定した後にFCMv1キーを有効にしてください。 追加のアプリをすべてFCMv1キーに移行し、有効にしてテストし、 セットアップ手順を完了する準備ができるまで無効にすることをお勧めします( 移行フローはこの記事に記載されています)。

NPS プロキシ移行の概要

NPS認証プロキシへの移行の視覚的な要約
テーブル 1.NPS プロキシに移行するタスクの概要

シーケンス

タスクタイトル

タスクはいつ、なぜ必要ですか?

1

UC-One SaaS(またはコネクト)iOSアプリケーションのNPSをHTTP/2に移行してください。

NPSがそれらのアプリをサポートしていて、まだHTTP/2用に設定されていない場合。

2

UC-One SaaS(またはコネクト)アンドロイドアプリのNPSをFCMv1に移行してください。

NPSがそれらのアプリをサポートしていて、まだFCMv1用に設定されていない場合。

3

FCMv1モードを有効にして、プッシュ通知をテストしてください。

NPSがUC-One Connectおよび/または他の(シスコ以外の)Androidアプリをサポートしている場合。

4

FCM レガシーモードを再度有効にします。

NPSがUC-One SaaSをサポートしている場合。 NPSプロキシを設定する前に、FCMv1を有効のままにしておくと、UC-One SaaSへのプッシュ通知が失敗し始めます。

5

NPS認証プロキシパッチをインストールしてください。

NPSがXSP R22またはXSP R23上にある場合。

6

NPS認証プロキシを使用するようにNPSを設定する:

  • NPSのテクニカルサポートを添付してください

  • CI OAuthアカウントをリクエストしてください

  • NPSでCIアカウントを作成し、更新トークンのタイムアウトを設定します

  • アンドロイドアプリIDを追加してください

  • iOSアプリIDを追加してください

  • URLと接続タイムアウトを確認/設定する

  • AS許可リストにアプリを追加してください

  • FCMv1を (再) 有効にします

  • XSP/ADPを再起動してください

  • iOSとアンドロイドアプリ用のテスト用PN

常に必要です。

7

FCM レガシーモードのキーを削除してください。

FCMv1でNPSで正常にサポートされているアプリ用。

ブロードワークスのコラボレートiOSアプリを HTTP/2に移行してください

このタスクは、iOSプラットフォーム上のUC-One SaaSおよびWebexアプリへのプッシュ通知には必須です。

始める前に

XSPがR22を実行している場合は、APNSにHTTP/2を使用するようにNPSアプリケーションを構成する前に、ap354313を適用する必要があります。

1

XSP_CLI/Applications/NotificationPushServer/APNS/Production>でプロダクションURLと接続パラメータを設定してください

URL を設定 https://api.push.apple.com/3/device

セット接続プールサイズ 2

接続タイムアウトを3000に設定してください

接続アイドルタイムアウトを秒単位で設定してください 600

注意:接続タイムアウトを1000未満に設定しないでください。

2

APNSアプリケーションコンテキストにアプリケーションIDを追加してください。認証キーは必ず省略して、空に設定してください。

UC-One SaaSの場合:xsp_cli/Applications/NotificationPushServer/APNS/Production/Tokens> com.broadsoft.uc-oneを追加してください

Webexアプリの場合:XSP_CLI/アプリケーション/通知プッシュサーバー/APNS/プロダクション/トークン> com.cisco.squaredを追加してください

3

XSP_CLI/アプリケーション/通知/プッシュサーバー/APNS/プロダクション/トークンで認証キーを確認してください>get

4

com.broadsoft.uc-oneの認証キーが空でない場合は、XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens>「-authkey」でクリアできます

5

HTTP/2を有効にする:

xsp_cli/アプリケーション/通知/プッシュサーバー/APNS/一般設定> HTTP2を有効にしてtrueに設定

6

UC-One SaaSアプリのみ:リセラーポータルにサインインして、設定 > BroadWorks > に移動します。

7

「通知プッシュサーバー」セクションまでスクロールし、リリースを選択して(リリース22など)、ポータルに表示される指示に従ってください。

ブロードワークス UC-One Connect/SaaS アンドロイドアプリを FCMv1 に移行

  • このタスクはXSP上のNPSに適用されます。 NPSがADPを利用している場合は無視してください。

  • この手順を使用して、UC-One ConnectまたはUC-One SaaS アンドロイドアプリのFCMv1通知に移行できます。

  • UC-OneまたはWebex Androidアプリへのプッシュ通知を認証するためにNPSプロキシを使用する場合は、FCMv1を使用する必要があります。

  • このタスクでは、NPS認証プロキシの構成の一部としてFCMv1を有効にできるように、NPSを準備します。 NPS認証プロキシを設定する準備ができるまで、FCMv1を有効にしないでください。そうしないと、SaaSクライアントへの通知が失敗します。

1

FirebaseコンソールからプロジェクトIDを取得してください:

  1. console.firebase.google.com にサインインしてください。

  2. UC-One(ConnectまたはSaaS)アプリプロジェクトを選択し、そのプロジェクト設定を開きます。

  3. 「一般」タブを開いて、プロジェクトIDを記録してください。

2

Firebaseからサービスアカウントのプライベートキーを取得してください:

  1. プロジェクト設定の「サービスアカウント」タブに移動します。

  2. 新しいサービスアカウントを作成して、その秘密鍵を取得してください。

  3. または、既存のサービスアカウントを開いて、そのための新しい秘密鍵を生成してください。

    注:サービスアカウントには firebaseadmin-sdkの権限が必要です。

  4. キーを安全な場所にダウンロードしてください。

3

NPSをホストしているXSPにキーをコピーしてください。

4

プロジェクトIDと関連する秘密鍵をFCMプロジェクトのコンテキストに追加します。

XSP_CLI/アプリケーション/通知プッシュサーバー/FCM/プロジェクト > プロジェクトIDパス/キーファイルへの追加

5

UC-One(ConnectまたはSaaS)アプリケーションと関連するプロジェクトIDをFCMアプリケーションコンテキストに追加します。

xsp_cli/Applications/NotificationPushServer/FCM/Applications> ApplicationID com.broadsoft.connect ProjectID project-IDを追加

6

FCMの設定を、ここに示されている属性と推奨値と照合してください。 必要に応じて、コマンドの set バージョンを使用して値を変更してください。

XSP_CLI/アプリケーション/通知/プッシュサーバー/FCMを実行>取得

パラメーター

推奨値

認証URL

https://www.googleapis.com/oauth2/v4/token

プッシュURL

https://fcm.googleapis.com/v1/projects/ プロジェクト ID /メッセージ:送信します

スコープ

https://www.googleapis.com/auth/firebase.messaging

トークン・タイム・タイムは秒単位です

3600

接続プールのサイズ

10

接続タイムアウト (ミリ秒)

3000

接続アイドルタイムアウト (秒)

600

BroadWorks UC-One Connect/SaaS アンドロイドアプリをFCMv1(ADP上)に移行します

  • このタスクはADPのNPSに適用されます。 NPSがXSP上にある場合は無視してください。

  • この手順を使用して、UC-One ConnectまたはUC-One SaaS アンドロイドアプリのFCMv1通知に移行できます。

  • UC-OneまたはWebex Androidアプリへのプッシュ通知を認証するためにNPSプロキシを使用する場合は、FCMv1を使用する必要があります。

  • このタスクでは、NPS認証プロキシの構成の一部としてFCMv1を有効にできるように、NPSを準備します。 NPS認証プロキシを設定する準備ができるまで、FCMv1を有効にしないでください。そうしないと、SaaSクライアントへの通知が失敗します。

1

FirebaseコンソールからプロジェクトIDを取得してください:

  1. console.firebase.google.com にサインインしてください。

  2. UC-One(ConnectまたはSaaS)アプリプロジェクトを選択し、そのプロジェクト設定を開きます。

  3. 「一般」タブを開いて、プロジェクトIDを記録してください。

2

Firebaseからサービスアカウントのプライベートキーを取得してください:

  1. プロジェクト設定の「サービスアカウント」タブに移動します。

  2. 新しいサービスアカウントを作成して、その秘密鍵を取得してください。

  3. または、既存のサービスアカウントを開いて、そのための新しい秘密鍵を生成してください。

    注:サービスアカウントには firebaseadmin-sdkの権限が必要です。

  4. キー(.jsonファイル)を安全な場所にダウンロードしてください。

3

.json ファイルを ADP サーバー /bw/install にインポートします。

4

ADP CLIにログインして、プロジェクトとAPIキーをFCMプロジェクトのコンテキストに追加します。

adp_cli/アプリケーション/通知/プッシュサーバー/FCM/Projects> connect-ucaas /bw/install/ filename.jsonを追加

5

アプリケーションとプロジェクトIDをFCMアプリケーションコンテキストに追加します。

adp_cli/Applications/notificationPushserver/FCM/Applications> ApplicationID com.broadsoft.ucaas.connect ProjectID project-IDを追加

6

設定を確認してください:

ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get
Project ID Accountkey
========================
connect-ucaas ********
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas

FCM レガシーモードを再度有効にします

これは(移行の一環として)次の場合にのみ行う必要があります。

  • あなたのNPSは、UC-One SaaSまたはブロードワークス・コネクトのアンドロイドアプリに使用されます。

  • 他のアプリへのコールプッシュ通知がFCMv1 APIで動作することをすでにテストしました。

これらのアプリのFCMv1キーは、NPS認証プロキシの設定プロセス中にのみ有効にする必要があるため、FCMv1を一時的に無効にしています。

1

共有NPSをホストしているXSPにサインインします。

2

FCMコンテキストに移動して、FCM v1を無効にします。xsp_cli/Applications/NotificationPushServer/FCM> V1Enabled Falseに設定すると、FCMレガシーAPIキーの使用に戻ります。

認証プロキシを使用するようにNPSを設定してください

1

オンボーディング連絡先またはTACにサービスリクエストを作成して、(Webex Common Identity)OAuthクライアントアカウントをプロビジョニングしてください。 サービスリクエストにタイトルを付けてください。認証プロキシ設定のNPS構成。

OAuthクライアントID、クライアントシークレット、60日間有効な更新トークンを渡します。 NPSで使用する前にトークンの有効期限が切れた場合は、別のリクエストを出すことができます。
2

NPSでクライアントアカウントを作成してください:

XSP_CLI/アプリケーション/通知/プッシュサーバー/CiscoCI/クライアント>ステップ1からクライアントIDを設定

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

コマンドを実行して、入力した値が提供された値と一致することを確認します。XSP_CLI/アプリケーション/通知プッシュサーバー/CiscoCI/クライアント> 取得

3

NPSのプロキシURLを入力し、トークンの更新間隔を設定します(30分を推奨)。

地域ベースのFQDN:

米国東部:

xsp_cli/Applications/NotificationPushServer/CloudNPSサービス> URLを設定 https://broadworks-idp-proxy-a.wbx2.com/nps/

米国西部:

xsp_cli/Applications/NotificationPushServer/CloudNPSサービス> URLを設定 https://broadworks-idp-proxy-r.wbx2.com/nps/

ヨーロッパ:

xsp_cli/Applications/NotificationPushServer/CloudNPSサービス> URLを設定 https://broadworks-idp-proxy-k.wbx2.com/nps/

xsp_cli/アプリケーション/通知プッシュサーバー/クラウドNPSサービス> VoIPトークンの更新間隔を1800に設定してください

サウジアラビア:

xsp_cli/Applications/NotificationPushServer/CloudNPSサービス> URLを設定 https://broadworks-idp-proxy-d.wbx2.com/nps/

オーストラリア:

xsp_cli/Applications/NotificationPushServer/CloudNPSサービス> URLを設定 https://broadworks-idp-proxy-m.wbx2.com/nps/

DNS解決の遅延によりプッシュ通知がタイムアウトした場合は、BroadWorksサーバーの「/etc/resolv.conf」ファイルのタイムアウト値を増やしてください。

4

(Android通知用) AndroidアプリケーションIDをNPSのFCMアプリケーションコンテキストに追加します。

アンドロイド上の Webex アプリの場合:xsp_cli/Applications/notificationPushserver/FCM/Applications> com.cisco.wx2.android を追加

アンドロイドのUC-Oneアプリの場合:xsp_cli/Applications/NotificationPushServer/FCM/Applications> com.broadsoft.connectを追加してください

5

(Apple iOS通知用) APNSアプリケーションコンテキストにアプリケーションIDを追加します。認証キーは必ず省略して、空に設定してください。

iOS上のWebexアプリの場合:xsp_cli/Applications/notificationPushserver/APNS/プロダクション/トークン> com.cisco.squaredを追加してください

iOS上のUC-Oneアプリの場合:xsp_cli/Applications/NotificationPushServer/APNS/Production/Tokens> com.cisco.squaredを追加してください

6

次のNPS URLを設定してください。

XSP CLIコンテキスト

パラメーター

価値

XSP_CLI/アプリケーション/通知プッシュサーバー/FCM>

認証URL

https://www.googleapis.com/oauth2/v4/token

プッシュURL

https://fcm.googleapis.com/v1/projects//messages:send

スコープ

https://www.googleapis.com/auth/firebase.messaging

XSP_CLI/アプリケーション/通知プッシュサーバー/APNS/プロダクション>

URL

https://api.push.apple.com/3/device

7

次のNPS接続パラメータを、表示されている推奨値に設定します。

XSP CLIコンテキスト

パラメーター

価値

XSP_CLI/アプリケーション/通知プッシュサーバー/FCM>

トークン・タイム・タイムは秒単位です

3600

接続プールのサイズ

10

接続タイムアウト (ミリ秒)

3000

接続アイドルタイムアウト (秒)

600

XSP_CLI/アプリケーション/通知プッシュサーバー/APNS/プロダクション>

接続タイムアウト

3000

接続プールのサイズ

2

接続アイドルタイムアウト (秒)

600

8

Webexアプリを許可リストに追加する必要があるかもしれないので、アプリケーションサーバーがアプリケーションIDをスクリーニングしているかどうかを確認してください。

  1. as_cli/システム/プッシュ通知を実行して、EnforceAllowedApplicationListの値を取得して確認してください。 それが本当なら、このサブタスクを完了する必要があります。 それ以外の場合は、サブタスクの残りをスキップしてください。

  2. as_cli/システム/プッシュ通知/許可されたアプリケーション > com.cisco.wx2.android「Webex Android」を追加してください

  3. as_cli/システム/プッシュ通知/許可されたアプリケーション > com.cisco.squared「Webex iOS」を追加してください

NPSを再起動し、プッシュ通知をテストします

1

XSPを再起動してください:

バースタート
2

BroadWorksサブスクライバーからAndroidで通話クライアントに電話をかけて、Androidへの通話通知をテストします。 着信通知がAndroidデバイスに表示されることを確認してください。

注:UC-One androidアプリケーションのプッシュ通知が失敗し始めたら、設定が間違っている可能性があります。 このような場合は、次のようにレガシーFCMに戻すことができます。

  1. FCMv1を無効にする:XSP_CLI/アプリケーション/通知プッシュサーバー/FCM> V1を有効に設定 false

  2. SPを再起動:再起動

  3. 設定を確認してください。

  4. FCMv1を再度有効にして、XSPを再起動してください。

  5. テストをやり直してください。

3

iOSへの通話通知をテストするには、BroadWorksサブスクライバーからiOSで発信側クライアントに電話をかけます。 iOSデバイスに通話通知が表示されることを確認してください。

注:UC-One iOSアプリケーションのプッシュ通知が失敗し始めたら、設定が間違っている可能性があります。 このような場合は、http2enabledをfalseに設定して、従来のバイナリインターフェイスに戻すことができます

この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?