クイック スタート:通知ハブのプッシュ通知を設定する

Azure Notification Hubs には、使いやすくスケールアウトにも対応したプッシュ エンジンが用意されています。Notification Hubs を使用すると、あらゆるプラットフォーム (iOS、Android、Windows、Baidu) にあらゆるバックエンド (クラウドまたはオンプレミス) から通知を送信することができます。 詳細については、「Azure Notification Hubs とは」を参照してください。

このクイック スタートでは、Notification Hubs におけるプラットフォーム通知システム (PNS) の設定を使用して、複数のプラットフォームに対するプッシュ通知を設定します。 このクイック スタートでは、Azure portal での手順を紹介します。 Azure CLI を使用した場合の手順については、「Google Firebase Cloud Messaging」に記載されています。

Note

Firebase Cloud Messaging の非推奨と移行の手順については、「Google Firebase Cloud Messaging の移行」を参照してください。

通知ハブを作成していない場合は、ここで作成します。 詳細については、「Azure portal 内で Azure 通知ハブを作成する」または「Azure CLI を使用して Azure 通知ハブを作成する」を参照してください。

Apple Push Notification Service

Apple Push Notification Service (APNS) を設定するには、次の手順に従います。

1. Azure portal の [通知ハブ] ページで、左側のメニューの [Apple (APNS)] を選択します。

2. [認証モード] で [証明書] または [トークン] を選択します。

   a. [証明書] を選択した場合:

   • ファイル アイコンを選択し、アップロードする .p12 ファイルを選択します。

   • パスワードを入力します。

   • [サンドボックス] モードを選択します。 または、ストアからアプリを購入したユーザーにプッシュ通知を送信する場合は、 [Production](運用) モードを選択します。

     

     b. [トークン] を選択した場合:

   • [キー ID] 、 [バンドル ID] 、 [チーム ID] 、 [トークン] に値を入力します。

   • [サンドボックス] モードを選択します。 または、ストアからアプリを購入したユーザーにプッシュ通知を送信する場合は、 [Production](運用) モードを選択します。

     

詳細については、Azure Notification Hubs を使用して iOS アプリにプッシュ通知を送信する方法に関するページを参照してください。

Google Firebase Cloud Messaging V1 (FCMv1)

Google FCMv1 のプッシュ通知を設定するには、次の手順に従います。

1. Azure portal の [通知ハブ] ページで、左側のメニューの [Google (FCMv1)] を選択します。
2. Firebase コンソールから取得したサービス アカウントの JSON ファイルから、秘密キー、プロジェクト ID、クライアント メールアドレスの値を更新します。
3. [保存] を選択します。

これらの手順が完了すると、通知ハブが正常に更新されたことをアラートで確認できます。 [Save](保存) ボタンが無効になります。

Google Firebase Cloud Messaging (FCM)

Note

Firebase Cloud Messaging (FCM) は非推奨となり、サポートされなくなりました。

ポータル

Google FCM のプッシュ通知を設定するには、次の手順に従います。

1. Azure portal の [通知ハブ] ページで、左側のメニューの [Google (GCM/FCM)] を選択します。

2. 前に保存した Google FCM プロジェクトの API キーを貼り付けます。

3. [保存] を選択します。

   

これらの手順が完了すると、通知ハブが正常に更新されたことをアラートで確認できます。 [Save](保存) ボタンが無効になります。

Azure CLI

Google Firebase Cloud Messaging (FCM) プロジェクトの API キーが必要となります。

Azure CLI の環境を準備する

• Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。

  

• CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。

  • ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、Azure CLI でのサインインに関するページを参照してください。

  • 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。

  • az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。

• この記事では、Azure CLI のバージョン 2.0.67 以降が必要です。 Azure Cloud Shell を使用している場合は、最新バージョンが既にインストールされています。

Google FCM のプッシュ通知を設定する

1. az notification-hub credential gcm update コマンドを使用して、Google API キーを通知ハブに追加します。

   az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey
   

2. Android アプリが通知ハブと接続するためには接続文字列が必要です。 使用できるアクセス ポリシーを一覧表示するには、az notification-hub authorization-rule list コマンドを使用します。 アクセス ポリシーの接続文字列を取得するには、az notification-hub authorization-rule list-keys コマンドを使用します。 プライマリ接続文字列を直接取得するには、--query パラメーターに primaryConnectionString または secondaryConnectionString を指定します。

   #list access policies for a notification hub
   az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table
   
   #list keys and connection strings for a notification hub access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json
   
   #get the primaryConnectionString for an access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString
   

3. az notification-hub test-send コマンドを使用して、Android アプリに対するメッセージ送信をテストします。

   #test with message body
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"
   
   #test with JSON string
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"
   

その他のプラットフォーム向けの Azure CLI リファレンスは、az notification-hub credential コマンドで入手してください。

Android アプリケーションへの通知の送信に関する詳細については、「Firebase を使用して Android デバイスにプッシュ通知を送信する」を参照してください。

Windows プッシュ通知サービス

Windows プッシュ通知サービス (WNS) を設定するには、次の手順に従います。

1. Azure portal の [通知ハブ] ページで、左側のメニューの [Windows (WNS)] を選択します。

2. [パッケージ SID] と [セキュリティ キー] に値を入力します。

3. [保存] を選択します。

   

詳細については、Azure Notification Hubs を使用して UWP アプリに通知を送信する方法に関するページを参照してください。

Baidu (Android China)

Baidu のプッシュ通知を設定するには、次の手順に従います。

1. Azure portal の [通知ハブ] ページで、左側のメニューの [Baidu (Android China)] を選択します。

2. Baidu コンソールから取得した、Baidu クラウド プッシュ プロジェクトの API キーを入力します。

3. Baidu コンソールから取得した、Baidu クラウド プッシュ プロジェクトの秘密鍵を入力します。

4. [保存] を選択します。

   

これらの手順が完了すると、通知ハブが正常に更新されたことをアラートで確認できます。 [Save](保存) ボタンが無効になります。

詳細については、Baidu での Notification Hubs の使用に関するページを参照してください。

次のステップ

このクイック スタートでは、Azure portal 内で通知ハブに対してプラットフォーム通知システムの設定を構成する方法について説明しました。

さまざまなプラットフォームに対してプッシュ通知を送信する方法について詳しくは、以下のチュートリアルを参照してください。

• Azure Notification Hubs を使用して iOS アプリにプッシュ通知を送信する
• Notification Hubs と Google FCM を使用して Android デバイスに通知を送信する
• Windows デバイス上で動作する UWP アプリに通知を送信する
• Notification Hubs と Baidu クラウド プッシュを使用して通知を送信する