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

Webex BroadWorks の通話プッシュ通知を設定する

list-menuフィードバックがある場合
Android および iOS 用の NPS を使用して、BroadWorks 向け Webex の通話プッシュ通知を設定する方法について説明します。

この文書では、コール通知プッシュ サーバー (CNPS) という用語を使用して、環境で動作する XSP がホストする、または ADP がホストするアプリケーションを説明します。CNPS は BroadWorks システムと機能し、ユーザーへの着信コールを認識し、Google Firebase Cloud Messaging (FCM) または Apple Push Notification Service (APN) 通知サービスに通知をプッシュします。

これらのサービスでは、Cisco BroadWorks 版 Webex のサブスクライバーのモバイル デバイスに Webex での着信通話が通知されます。

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

Webex の同様のメカニズムは、Webex メッセージングとプレゼンス サービスで動作し、Google (FCM) または Apple (APNS) 通知サービスに通知をプッシュします。これらのサービスは、モバイル版の Webex ユーザーに着信メッセージまたはプレゼンス変更を通知します。

このセクションでは、NPS が他のアプリをサポートしていない場合に、認証プロキシ用に NPS を構成する方法について説明します。NPS プロキシを使用するために共有 NPS を移行する必要がある場合は、 NPS プロキシを使用するための Cisco BroadWorks NPS の更新を参照してください。

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 デバイスにプッシュ通知する機能も強化されています。

APNS の考慮事項

Apple は Apple Push Notification サービスでの HTTP/1 ベースのバイナリ プロトコル サポートを 2021 年 3 月 31 日付けで終了します。XSP|ADPを次のように設定することをお勧めします。 HTTP/2-based APNs のインターフェース。この更新では、NPS をホストしている XSP|ADP が R22 以降を実行している必要があります。

Cisco BroadWorks 版 Webex の NPS を準備する

1

専用 XSP (最小バージョン R22)、または Application Delivery Platform (ADP) をインストールおよび構成します。

2

NPS Authentication Proxy パッチをインストールします。

XSP R22 パッチ:

XSP R23 パッチ:

3

通知プッシュサーバーアプリケーションを有効にします。

4

(Android 通知の場合) NPS の FCM v1 API を有効にします。

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Apple iOS 通知) NPS で HTTP/2 を有効にします。

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true

これはリリース22以前のバージョン専用です。リリース23以降のバージョンでは利用できません。 HTTP/2.

6

NPS XSP/ADP から技術サポートに接続します。

7

各ASサーバーでは、 /usr/local/broadworks/bw_base/conf 内のnamedefsファイルに通知プッシュサーバーのSRVレコードとAレコードを設定する必要があります。 (XSP/ADP) 複数の場合は検索 XSP/ADP 必要に応じてそれぞれにエントリを追加します。

例:_pushnotification-クライアント。_tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149

設定が完了したら、変更を反映するには次のいずれかが必要です。

  1. メンテナンス ウィンドウで再起動を実行します。

  2. Cisco BroadWorks CLI 経由:

    R24以上

    AS_CLI/ASDiagnostic/DNS> 再読み込み

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> 再読み込み

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> 再読み込み

次に行うこと

NPS の新規インストールについては、 認証プロキシを使用するように NPS を構成するを参照してください。

既存の Android 展開を FCMv1 に移行するには、 NPS を FCMv1 に移行するに進みます。

認証プロキシを使用するように NPS を構成する

このタスクは Cisco BroadWorks 版 Webex 専用の NPS の新しいインストールに適用されます。

他のモバイル アプリと共有されている NPS で認証プロキシを構成する場合は、 NPS プロキシを使用するための Cisco BroadWorks NPS の更新を参照してください。

1

Cisco BroadWorks 用 Webex の OAuth 資格情報を取得する。

2

NPS のクライアント アカウントを作成します。

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-Step1

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

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

入力した値が与えられた値と一致するかどうかを確認するには、次を実行します： XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI の issuerUrl は、場所に関係なく常に US CI クラスタである必要があり、デフォルトは次のようになります。 

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI> get issuerUrl = https://idbroker.webex.com/idb

3

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

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://nps.uc-one.broadsoft.com/nps/

DNS 解決速度を向上させるには、現在の FQDN nps.uc-one.broadsoft.com の代わりに、地域に基づいて適切な FQDN を使用することをお勧めします。

リージョンベースの FQDN:

米国東部:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-a.wbx2.com/nps/

米国西部:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-r.wbx2.com/nps/

ヨーロッパ：

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

DNS解決の遅延によりプッシュ通知がタイムアウトする場合は、 "/etc/resolv.conf" BroadWorks サーバー上のファイル。

4

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

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.cisco.wx2.android

5

(Apple iOS 通知) アプリケーション ID を APNS アプリケーション コンテキストに追加し、Auth 鍵を省略して空に設定します。

XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

6

以下の NPS URL を構成します。

XSP|ADP CLIコンテキスト

パラメータ

値

  • XSP|ADP_CLI/Applications/NotificationPushServer/FCM>

authURL

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

pushURL

https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send

scope

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

  • XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production>

url

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

7

以下に示す推奨値に、以下の NPS 接続パラメータを構成します。

XSP|ADP CLIコンテキスト

パラメータ

値

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Webex アプリを許可リストに追加するために必要な可能性があるため、アプリケーション サーバーがアプリケーション ID を審査中か確認してください。

  1. AS_CLI/System/PushNotification> get を実行し、 enforceAllowedApplicationListの値を確認します。 trueの場合は、このサブタスクを完了する必要があります。それ以外の場合は、残りのサブ タスクをスキップします。

  2. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”

  3. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

9

XSP|ADPを再起動します。 bwrestart

10

BroadWorks のサブスクライバから 2 名の Webex モバイルユーザーに発信し、コール通知をテストします。iOS および Android デバイスに通話通知が表示されることを確認します。

NPS から FCMv1 に移行

このトピックでは、既存の NPS 展開があり、FCMv1 に移行する必要がある場合に、任意で Google FCM コンソールに使用できる手順について説明します。次の 3 つの手順があります。

UC-OneクライアントをFCMv1に移行する

UC-One クライアントを Google FCM HTTPv1 に移行するには、Google FCM コンソールで以下の手順を実行します。

クライアントにブランディングを適用中の場合、クライアントには送信者 ID が必要です。FCM コンソールで、[Project Settings (プロジェクト設定)] > [Cloud Messaging (クラウド メッセージング)] の順に確認します。プロジェクトの資格情報一覧表に設定が表示されます。

詳細については、 Connect Mobile ブランディング ガイド ( https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?)を参照してください。ブランディング キットのリソース フォルダーにある branding.xml ファイルにある gcm_defaultSenderId パラメーターを以下の構文で参照します。

xxxxxxxxxxxxx

  1. http://console.firebase.google.com で [FCM Admin SDK (FCM 管理 SDK にログイン)] にログインします。

  2. 適切な Android アプリケーションを選択します。

  3. [General (全般)] タブを開き、プロジェクト ID を記録します

  4. [Service Accounts (サービス アカウント)] タブにナビゲートして、サービス アカウントを設定します。新しいサービス アカウントを作成するか、既存のサービス アカウントを設定することができます。

    新しいサービス アカウントを作成するには:

    1. 新しいサービス アカウントを作成するには、青いボタンをクリックします

    2. 新しいプライベート キーを生成するには、青いボタンをクリックします

    3. キーを安全な場所にダウンロードします

    既存のサービス アカウントを再使用するには:

    1. 既存のサービス アカウントを表示するには、この青いテキストをクリックします。

    2. 使用するサービス アカウントを特定します。サービス アカウントに firebaseadmin-sdk のアクセス許可が必要です。

    3. 右端のハンバーガー メニューをクリックして、新しいプライベート キーを作成します。

    4. キーを含む json ファイルをダウンロードし、安全な場所に保存します。

  5. json ファイルを XSP|ADP にコピーします。

  6. プロジェクト ID を構成すると、次のようになります。

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add

  7. アプリケーションを設定すると、次のようになります。

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add  projectId 
...Done

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
  Application ID    Project ID
==============================
          my_app    my_project

  8. 次のとおり FCMv1 を有効にします。

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

  9. bwrestart コマンドを実行して XSP|ADP を再起動します。

SaaS クライアントを FCMv1 に移行

Google FCM コンソールで以下の手順を使用し、SaaS クライアントを FCMv1 に移行します。

「認証プロキシを使用するために NPS を構成する」手順を完了している必要があります。

  1. 次のとおり FCMv1 を無効にします。

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
...Done

  2. bwrestart コマンドを実行して XSP|ADP を再起動します。

  3. 次のとおり FCM を有効にします。

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

  4. bwrestart コマンドを実行して XSP|ADP を再起動します。

ADP サーバーをアップデート

NPS を移行して ADP サーバーを使用しようとする場合、Google FCM コンソールで以下の手順を実行します。

  1. 次のとおり Google Cloud Console から JSON ファイルを取得します。

    1. [Google Cloud Console] で [Service Accounts (サービス アカウント)] ページに移動します。

    2. [Select a project (プロジェクトを選択)] をクリックして目的のプロジェクトを選択し、[Open (開く)] をクリックします。

    3. キーを作成するサービス アカウントの行を見つけて、 その他 垂直ボタンをクリックし、 キーの作成をクリックします。

    4. キー タイプを選択し、 作成をクリックします。

      ファイルがダウンロードされます。

  2. ADP サーバーに FCM を追加します。

    1. /bw/install コマンドを使用して JSON ファイルを ADP サーバーにインポートします。

    2. 次のとおり ADP CLI にログインし、Project と API のキーを追加します。

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :

    3. 次に、アプリケーションとキーを追加します。

      ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done

    4. 次の設定を確認します。

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g
Project ID Accountkey
========================
connect-ucaas ********

ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas
この投稿記事は役に立ちましたか？
この投稿記事は役に立ちましたか？
価格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.
利用規約プライバシーステートメントクッキー商標