仕様書

意味

[3] プッシュメッセージ購読 (push message subscription) は、 利用者エージェントとプッシュサービスの間で確立されたメッセージ配送文脈 (message delivery context) であって、 アプリケーションサーバーと共有されるものです。 プッシュメッセージはすべてあるプッシュメッセージ購読と関連付けられています。 >>2 1.1. プッシュサービス資源により作成されます。

[74] プッシュ購読 (push subscription) は、 利用者エージェントとプッシュサービスの間に、 Webアプリケーションにかわって確立されたメッセージ配送文脈です。 >>73

[4] プッシュメッセージ購読集合の要素です。

[5] RFC 8030 が message subscription、 subscription とだけ言っているものも、 プッシュメッセージ購読を意味すると思われます。

[125] PushSubscription インターフェイスは、 プッシュ購読を表します。 文書環境とワーカー環境に晒されます。 SecureContext のみ利用可能です。 >>123

[134] PushSubscription インターフェイスの getKey メソッド >>123 は、 次のようにしなければなりません。

[159] PushEncryptionKeyName は、 p256dh か auth です。 >>123

[156] 鍵の取得は、 プッシュ購読、名前について、 次のようにします。 >>123

[131] PushSubscription インターフェイスの options 属性の取得器は、 次のようにしなければなりません >>123。

[133] プッシュ購読の作成時に設定されます。

[114] PushSubscriptionOptions インターフェイスは、 文書環境とワーカー環境に晒されています。 SecureContext のみ利用可能です。 >>113 対応する辞書 PushSubscriptionOptionsInit >>118 があります。 PushSubscriptionOptionsInit はプッシュ購読の追加のオプションを表します >>118。 利用者エージェントは、 利用者に express permission を求める時にこれを考慮できます >>118, >>105。 考慮するオプションについては、 プッシュメッセージ受信時にこれを適用するべきです >>118。 プッシュ購読作成後にオプションを変更する方法はなく、 unsubscribe して subscribe しなおすほかありません >>118。

[122] 利用者エージェントのオプションへの対応は任意選択です。 対応しないオプションは晒してはなりません >>118。

[116] PushSubscriptionOptions インターフェイスの userVisibleOnly 属性の取得器 >>113 は、 次のようにしなければなりません。

[119] PushSubscriptionOptionsInit 辞書の userVisibleOnly は、 boolean で、既定値は偽です。 >>118

[120] userVisible が真のとき、 当該プッシュ購読は、 利用者に表示されるプッシュメッセージのみに使われることを表します。 利用者に表示とは、例えば Web Notification のようなものをいいます。 >>118 偽のとき、そうとは限らないことを表します。 プッシュメッセージを表示といっても、 その内容がそのまま Webブラウザーにより自動的に表示されるのではなく、 アプリケーションが適宜処理する必要はあります。

[152] PushSubscription インターフェイスの toJSON メソッドは、 次のようにしなければなりません。 >>123

[32] プッシュメッセージ購読集合 (push message subscription set) は、 利用者エージェントとプッシュサービスの間で確立されるメッセージ配送文脈 (message delivery context) であって、 複数のプッシュメッセージ購読を集めて集合としたものです。 >>2 1.1.

[33] RFC は「subscription set」と省略して表記することもあるようです。

[34] プッシュメッセージ購読を集めて集合化することで、 プッシュサービスと利用者エージェントにとって効率化できます。 >>2 4.1.

[35] プッシュサービス資源を使ったプッシュメッセージ購読作成時に、 利用者エージェントは要求でプッシュメッセージ購読集合を指定し、 そこに作成したプッシュメッセージ購読を所属させることができます。

[36] プッシュサービス資源を使ったプッシュメッセージ購読作成時に、 プッシュサービスは応答でプッシュメッセージ購読集合を示すことができます。

プロトコル

[8] まず、利用者エージェントは、 新しいプッシュメッセージ購読を作成します。 >>2 2. 作成にはプッシュサービス資源を使います。

[13] 作成したプッシュメッセージ購読は、 アプリケーション依存の方法で、 アプリケーションサーバーへ配布します。 >>2 2., 4. 特にプッシュ資源の URL の配布は、 秘密の保護や、アプリケーションサーバーの認証を講じて漏らさないようにしなければなりません。 >>2 4.

[9] アプリケーションサーバーは、 プッシュメッセージ購読に対し、 プッシュ資源を使って、 利用者エージェントに配送するプッシュメッセージを、 プッシュサービスへと送信します。 >>2 2., 2.1., 5.

[10] 利用者エージェントは、 プッシュメッセージ購読を使って、 到着プッシュメッセージがないかプッシュサービスを監視 (monitor) します。 >>2 2.

[11] プッシュメッセージ購読はアプリケーションに、 1対1で配布して使うことが期待されています。 しかしこれはプロトコル上の制約ではなく、 1つのアプリケーションが複数のプッシュメッセージ購読を作ることもできますし、 複数のアプリケーションが1つのプッシュメッセージ購読を共有することもできます。 ただ、共有するとセキュリティーやプライバシーの問題になりかねないことには要注意です。 >>2 2.

作成

[112] アプリケーションは、 subscribe メソッドによって新しいプッシュ購読を作成できます。 既に作成済みの場合、 subscribe メソッドや getSubscription メソッドによって、 プッシュ購読を取得できます。 プッシュ購読の作成

プッシュメッセージ送受信

[25] プッシュ購読を使って、 プッシュメッセージを送信したり、 受信したりできます。 プッシュメッセージの送信

削除

[89] プッシュ購読やプッシュメッセージ購読集合は、 無効化されることがあります。 満期 (寿命 (lifetime) 到来) による場合、 利用者エージェントの指示による場合 (>>55)、 その他プッシュサービスの事情による場合があり得ます。 >>2 2., 7.3., 7.3.1.

[56] プッシュメッセージ購読が満期になったり削除されたりした場合、 プッシュメッセージ購読集合からも削除しなければなりません。 >>2 7.3.1.

[57] プッシュメッセージ購読集合が満期になったり削除されたりした場合、 所属するプッシュメッセージ購読もすべて満期・削除しなければなりません。 >>2 7.3.1.

[12] 利用者エージェントやアプリケーションサーバーは、 これに対応する準備が必要です。 >>2 2., 7.3.

[88] プッシュ購読は、 購読満期時刻 (subscription expiration time) を持つことができます。 その場合、 ミリ秒Unix timeであって、 プッシュ購読が非活性化される時刻を表すものでなければなりません。 >>78

[129] PushSubscription の expirationTime 属性の取得器は、 次のようにしなければなりません >>123。

[55] 利用者エージェントは、 プッシュメッセージ購読資源に DELETE 要求を送信して、 削除を要求できます >>2 7.3.。 その場合所属するプッシュメッセージ購読集合からも削除されます。 同様にプッシュメッセージ購読集合資源に DELETE 要求を送信して、 削除を要求できます >>2 7.3.1.。 その場合所属するすべてのプッシュメッセージ購読が同時に削除されます。

[91] 利用者エージェントやプッシュサービスは、 いつでも、例えば一定時間経過後、 プッシュ購読を更新 (refresh) することができます。 >>90

[99] 利用者エージェントは、 プッシュ購読を更新できない場合、 定期的にこれを再試行するべきです。 >>90

[79] 利用者エージェントは、 プッシュ購読の購読満期時刻の到来前に、 プッシュ購読の更新を試みるべきです。 >>78

[92] 利用者エージェントは、旧プッシュ購読の更新時、 次のようにしなければなりません。 >>90

[100] 利用者エージェントは、 満期その他の理由でプッシュ購読プッシュ購読が最早利用できないとき、 次のようにしなければなりません。 >>90

[106] 利用者は permission を失効できます。 permission 利用者エージェントは、 失効時、 当該 permission により作られたプッシュ購読プッシュ購読を次のようにしなければなりません。 >>105

[139] PushSubscription インターフェイスの unsubscribe メソッドは、 次のようにしなければなりません >>123。

[145] 非同期的に、 次のようにしなければなりません >>123。

[102] 利用者エージェントやプッシュサービスは、 プッシュ購読が非活性化 (deactivated) されたとき、 その詳細情報を削除しなければなりません。 >>103 それ以後当該プッシュ購読に対するプッシュメッセージを配送してはなりません。 >>103, >>123

[150] 利用者エージェントは、 プッシュサービスに対するプッシュ購読の非活性化の要求が失敗した時、 十分な時間再試行するべきです。 >>123

[104] サービスワーカー登録が登録解除されたとき、 プッシュ購読は非活性化しなければなりません >>105。 それより早く非活性化しても構いません。 >>103

[31] pushsubscriptionchange イベントは、 プッシュ購読がアプリケーションの預かり知らぬところで変更されたことを示します。 >>160

[163] ServiceWorkerGlobalScope インターフェイスの onpushsubscriptionchange 属性は、 イベントハンドラーIDL属性です。 >>160

[38] pushsubscriptionchangeイベントを発火 (fire the "pushsubscriptionchange" event) するには、 サービスワーカー登録登録、 プッシュ購読または null 旧購読、 プッシュ購読または null 新購読について、 次のようにしなければなりません。 >>160

[40] PushSubscriptionEvent インターフェイスは、 ExtendableEvent インターフェイスを継承したイベントインターフェイスです。 サービスワーカー環境に晒され、 SecureContext でのみ利用可能です。 イベントコンストラクターがあります。 PushSubscriptionEventInit 辞書は、 PushSubscriptionEvent インターフェイスに対応する辞書で、 ExtendableEventInit を継承しています。 >>160

[42] PushSubscriptionEvent インターフェイスの oldSubscription 属性の取得器 >>160 は、 次のようにしなければなりません。

[44] PushSubscriptionEventInit の oldSubscription は、 PushSubscription または null です。 既定値は null です。 >>160

[48] oldSubscription で指定された PushSubscription は、それ以上使うべきではありません。 データベース破損など利用者エージェントが詳細を提供できないとき、 null となることがあります。 >>160

[45] PushSubscriptionEvent インターフェイスの newSubscription 属性の取得器 >>160 は、 次のようにしなければなりません。

[47] PushSubscriptionEventInit の newSubscription は、 PushSubscription または null です。 既定値は null です。 >>160

[82] 利用者エージェントは、 プッシュ購読プッシュ購読について、 何らかの理由で鍵を変更せざるを得ないとき、 次のようにしなければなりません。 >>73

歴史

[1] Define exposure of the Push API interfaces (beverloo著, 2017-05-04 01:32:20 +09:00) https://github.com/w3c/push-api/commit/350ee328178b1635f141412831892b16cb711305