ブログに戻る

プッシュ通知の仕組み:APNs と FCM の解説

プッシュ通知の仕組み:APNs と FCM の解説

外から見たプッシュ通知はシンプルです。サーバーで何かが起きると、少し遅れてスマホの画面が光ります。その間には、Apple と Google がそれぞれ運営する 2 つの配信網があり、どのプッシュ通知もそのどちらかを必ず経由してスマホに届きます。

  • APNs(Apple Push Notification service)は、iPhone、iPad、Mac、Apple Watch へのすべてのプッシュ通知を配信します。
  • FCM(Firebase Cloud Messaging)は、Google Play services を搭載した Android デバイスに配信します。また、メッセージを APNs に渡すことで iOS 向けに送信することもできます。

このガイドでは、1 件の通知がサーバーから両方のプラットフォームのロック画面まで届くまでの流れを追います。本番環境で実際に動かして初めてわかる細かい点も扱います。私たちは Pocket Alert の裏側で両方のパイプラインを運用しているため、ここで挙げる例は実際に出荷しているものからとっています。

関係する 4 つの主体

  1. あなたのサーバー。Apple はこれを「プロバイダ」と呼びます。何を送るべきかを決めます。
  2. プッシュサービス(APNs または FCM)。リクエストを受け付け、配送先へ振り分けます。
  3. デバイス。OS は Apple または Google との間で 1 本の長寿命な暗号化接続を保ち、すべてのアプリ宛てのプッシュをその接続経由で受け取ります。
  4. アプリ。通知の登録を行い、プッシュの宛先となるトークンを管理しています。

3 つ目の点が、プッシュ通知がバッテリーに優しい理由です。スマホがサーバーに問い合わせを繰り返すことはありません。すべてのアプリで共有される 1 本の接続が開いたままになっており、配信すべきものがあるときにプッシュサービスがその接続を通じて送ってきます。

ステップ 1:デバイスがトークンを受け取る

アプリがリモート通知に登録すると、OS は「このデバイス上のこのアプリ」を指す不透明なアドレスであるトークンを渡します。アプリはそのトークンをサーバーに送り、サーバーは保存します。

  • APNs デバイストークンは、アプリとデバイスの組み合わせごとに一意です。Apple はアプリ内にキャッシュしないよう推奨しています。バックアップから復元したとき、新しいデバイスに移行したとき、OS を再インストールしたときに値が変わるためです。
  • FCM 登録トークンは Android で同じ役割を果たします。FCM は独自のスケジュールでこのトークンを更新します。

トークンは頻繁に無効になります。保存しているトークンを常に最新の状態に保つことは、プッシュ通知の運用において大きな部分を占めます。

ステップ 2:サーバーが身元を証明する

APNs

APNs は TLS 1.2 以降の上で HTTP/2 を使います。本番環境は api.push.apple.com、開発用ビルドは api.sandbox.push.apple.com で、ポートは 443 または 2197 です。認証方式は 2 つあります。

  • トークンベース。Apple Developer アカウントで .p8 の署名キーを作成し、Team ID とキー ID を含む短命な JWT を ES256 で署名します。Apple は、この JWT を 20 分に 1 回より頻繁ではなく、60 分に 1 回より間隔を空けずに更新することを求めています。古い JWT を送ると 403 ExpiredProviderToken が返り、更新が頻繁すぎると 429 TooManyProviderTokenUpdates が返ります。
  • 証明書ベース。アプリごとに 1 つの TLS クライアント証明書を使います。有効期間は 1 年で、その後は更新が必要です。

使うべきはトークンベースの認証です。1 つのキーで全アプリを扱え、毎年期限切れになることもありません。

FCM

FCM の HTTP v1 API は、Google のサービスアカウントから取得した短命な OAuth 2.0 アクセストークンを受け取ります。スコープは firebase.messaging です。サーバーキーを使う従来の「レガシー」API は 2023 年に非推奨となり、2024 年 7 月からは停止されています。そのため、今も Authorization: key=... を送っているコードは動作しません。

ステップ 3:リクエスト

APNs への送信

各プッシュ通知は /3/device/<device token> への HTTP/2 POST です。処理の仕方を変えるヘッダーがいくつか付きます。

curl --http2 \
  -H "authorization: bearer $APNS_JWT" \
  -H "apns-topic: com.example.alerts" \
  -H "apns-push-type: alert" \
  -H "apns-priority: 10" \
  -d '{"aps": {"alert": {"title": "Backup failed", "body": "db-01: pg_dump exited with code 1"}, "sound": "default", "interruption-level": "time-sensitive"}}' \
  "https://api.push.apple.com/3/device/$DEVICE_TOKEN"
  • apns-topic はアプリの bundle ID です。
  • apns-push-type はプッシュの種類を指定します。画面に表示する通知は alert、サイレントなデータプッシュは background、その他にもいくつかあります。
  • apns-priority は、今すぐ配信する場合は 10、デバイスの電源状態に判断を任せる場合は 5、電力を優先して端末を起こさない場合は 1 です。
  • apns-expiration は APNs が再試行を続ける期間を指定します。0 は 1 回だけ試行し、保存しないという意味です。
  • apns-collapse-id を使うと、同じ ID の古い通知を新しい通知で置き換えられます。

ペイロードは aps 辞書を含む JSON で、サイズの上限は 4 KB(VoIP は 5 KB)です。

FCM への送信

FCM は 1 リクエストにつき 1 つの JSON メッセージを受け取ります。

curl -X POST "https://fcm.googleapis.com/v1/projects/$PROJECT_ID/messages:send" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "message": {
      "token": "DEVICE_REGISTRATION_TOKEN",
      "notification": { "title": "Backup failed", "body": "db-01: pg_dump exited with code 1" },
      "android": { "priority": "high", "notification": { "channel_id": "alerts_high" } }
    }
  }'

notification メッセージは、アプリがバックグラウンドにあるときにシステムが表示します。data メッセージはアプリに渡され、アプリ側で処理されます。どちらの場合も、ペイロードの上限は 4,096 バイトです。

ステップ 4:配信、または配信までの待ち時間

スマホがオンラインであれば、プッシュ通知は開いている接続を通って届き、すぐに表示されます。オフラインの場合は次のとおりです。

  • APNs は apns-expiration の設定に応じて最長 30 日間通知を保存しますが、保存するのはデバイスごとにアプリにつき 1 件だけです。スマホが機内モードのときに 5 件送ると、通常は最後の 1 件だけが届きます。Apple は、それが最新の通知であることすら保証していません。
  • FCM はメッセージを有効期限(TTL)の間保存します。デフォルトは 4 週間で、最長は 28 日です。まとめて置き換えられるメッセージは、デバイスごとに最大 4 つのコレクトキーで管理されます。

優先度はタイミングにも影響します。iOS では、優先度 5 と 1 のプッシュ通知はまとめられたり、速度を制限されたり、破棄されたりすることがあります。Android では、normal 優先度のメッセージはデバイスが Doze から抜けるまで待たされることがあり、high 優先度のメッセージは即座に配信されます。FCM は、この特権の使われ方も監視しています。表示される通知につながらない高優先度のメッセージは、時間の経過とともに静かに通常優先度へ下げられることがあります。

通知の音量:割り込みレベルとチャンネル

配信されることと、スマホが音を鳴らすことは別の問題です。2 つのプラットフォームはこの点を異なる方法で扱います。

iOS(15 以降)では、通知ごとに割り込みレベルを設定します。

  • passive は、画面を点灯させず音も鳴らさずに通知リストへ追加します。
  • active がデフォルトです。
  • time-sensitive は集中モードや通知の要約を突破できます。ユーザーはアプリごとにこの動作をオフにできます。
  • critical は、おやすみモードでもミュートスイッチがオンでも常に音を鳴らします。ただし、Apple が審査後に許可するエンタイトルメントが必要です。

Android(8 以降)では、すべての通知がチャンネルに属し、そのチャンネルが重要度を決めます。音、振動、ヘッドアップ表示、おやすみモードの動作などです。アプリはチャンネルを作成しますが、いったん作成されたチャンネルの動作はユーザーのものになります。アプリがあとから変更することはできません。

この最後のルールには実際の影響があります。Pocket Alert のクリティカルアラートをサイレントモードでも鳴らすようにしたとき、既存のクリティカルチャンネルを後からアラート音に切り替えることはできませんでした。解決策は、新しい ID を持つ 2 つ目のチャンネルを作ることでした。サーバーは、そのチャンネルを作成したアプリのビルドに対してのみ、そのチャンネルを指定します。アプリが作成していないチャンネルに送ると、通知がまったく表示されないためです。

Android 13 以降では、さらにもう 1 つの関門があります。アプリには POST_NOTIFICATIONS のランタイム権限が必要で、新規インストール直後は、ユーザーが許可するまで通知はオフのままです。

本番環境で起きがちな問題

  • 古いトークン。APNs は、もう有効でないトークンに対して 410 Unregistered を返します。そのトークンへの送信をやめ、削除してください。
  • 環境の取り違え。開発用ビルドのトークンを本番のホストに送ると、400 BadDeviceToken で失敗します。
  • サイズ超過のペイロード。4 KB を超えると 413 PayloadTooLarge が返ります。アラート本文に長いログ行を入れると、たいていこれが原因です。
  • 優先度の降格。何も表示されない高優先度の Android メッセージは、優先度を失います。
  • 通知がオフになっている。権限が拒否されていたり、チャンネルがミュートされていたりすると、プッシュ通知は配信されてもユーザーは気づきません。

近道

これらすべてを自前で構築する価値があるのは、アプリがあなたのプロダクトであり、そのユーザーに送る場合です。自分自身やチームへのアラートであれば、インフラの負担が大きすぎます。各プラットフォームの開発者アカウント、署名キー、トークンの保存、2 種類のリクエスト形式、2 つの優先度モデルを管理することになるからです。

プッシュ通知サービスを使えば、これらのパイプラインを代わりに運用してくれます。Pocket Alert なら、自分でトークンや証明書を用意せずに、1 回のリクエストで送信できます。

curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title": "Backup failed", "message": "db-01: pg_dump exited with code 1", "level": "high"}'

level フィールドは、各プラットフォーム向けに次のように変換されます。

  • silent は、iPhone では音の鳴らないパッシブな通知になり、Android ではサイレントチャンネルに送られます。
  • low は、iPhone ではパッシブ、Android では低い重要度になります。
  • default は、両方で通常の通知になります。
  • high は、iPhone では time-sensitive、Android では高優先度になります。
  • critical は、Android ではおやすみモードを無視します。iPhone では time-sensitive として届き、Apple が権限を許可するにつれて、完全なクリティカルアラートの音が順次提供されます。

詳しくは クリティカルアラート を、API 自体については プッシュ通知 API とは をご覧ください。

FAQ

APNs は配信を保証しますか?

いいえ。APNs も FCM もベストエフォートです。APNs はオフラインのデバイスに対して最新の通知を 1 件だけ保存し、どちらのサービスもメッセージがいつ届くかを保証しません。Google のドキュメントはさらに踏み込んで、生命に関わる緊急アラートに FCM を使うべきではないとしています。オンコールのページング用途では、プッシュ通知を最速の経路として扱い、唯一の経路とはしないでください。

APNs と FCM の両方が必要なのはなぜですか?

iPhone は APNs 経由のプッシュ通知しか受け付けません。Google Play services を搭載した Android デバイスは FCM 経由で受け取ります。ユーザーが両方のプラットフォームを使っている場合、サーバーは両方と通信する必要があります。直接通信するか、FCM 経由で通信します。FCM は APNs への転送を代行できます。

FCM で iPhone に通知を送れますか?

はい。APNs の認証キーを Firebase にアップロードすると、FCM がメッセージを APNs に渡して iOS へ配信します。Apple デバイス宛てのデータメッセージは、通常の優先度で送る必要があります。

プッシュ通知のサイズはどのくらいまで大きくできますか?

APNs のペイロードは 4 KB まで(VoIP プッシュは 5 KB まで)、FCM のメッセージは 4,096 バイトまでです。長い文章はプッシュ通知に入れず、アプリ内に置くかリンクにしてください。

デバイストークンとは何ですか?

Apple または Google が発行する、1 台のデバイス上の 1 つのアプリを指すアドレスです。サーバーはこれに宛ててプッシュ通知を送ります。トークンはいつでも変わる可能性があるため、サーバーは更新されたトークンを受け入れ、APNs や FCM が無効と報告したトークンを削除する必要があります。

Pocket Alert の無料アカウントを作成 すれば、キーやトークンの管理を省けます。ほかのサービスとの比較は 代替サービス でご覧いただけます。

この記事をシェア