archive
/
matrix-spec-proposals
mirror of https://github.com/matrix-org/matrix-spec-proposals
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

format

Browse Source
kerry/remote-push-toggle
Kerry Archibald 2 years ago
parent ae4ec9f577
commit 8492d15067
1 changed files with 9 additions and 7 deletions
Show Stats Download Patch File Download Diff File

16
proposals/3881-remote-push-notification-toggling.md
Unescape Escape View File

@ -30,8 +30,9 @@ the value is optional and if omitted, defaults to `true`.
In [GET /_matrix/client/v3/pushers](https://spec.matrix.org/v1.3/client-server-api/#get_matrixclientv3pushers) the value In [GET /_matrix/client/v3/pushers](https://spec.matrix.org/v1.3/client-server-api/#get_matrixclientv3pushers) the value
is always returned. is always returned.
Pushers that are not enabled do not send Pushers that are not enabled do not produce push notifications of any kind, either by sending
[`/notify`](https://spec.matrix.org/v1.3/push-gateway-api/#post_matrixpushv1notify) requests to push providers. [`/notify`](https://spec.matrix.org/v1.3/push-gateway-api/#post_matrixpushv1notify) requests to push providers for
`http` pushers or otherwise.
#### Explicitly linking device and pusher #### Explicitly linking device and pusher
A new field `device_id` is added to the `Pusher` model as returned from [GET A new field `device_id` is added to the `Pusher` model as returned from [GET
@ -44,8 +45,8 @@ A new field `device_id` is added to the `Pusher` model as returned from [GET
To be able to remove Pushers when sessions are deleted home servers must have some existing way to link a session to To be able to remove Pushers when sessions are deleted home servers must have some existing way to link a session to
pusher, so exposing the `device_id` on http pushers should be trivial. (Synapse, for instance, stores the [access pusher, so exposing the `device_id` on http pushers should be trivial. (Synapse, for instance, stores the [access
token](https://github.com/matrix-org/synapse/blob/3d201151152ca8ba9b9aae8da5b76a26044cc85f/synapse/storage/databases/main/pusher.py#L487) when adding a token](https://github.com/matrix-org/synapse/blob/3d201151152ca8ba9b9aae8da5b76a26044cc85f/synapse/storage/databases/main/pusher.py#L487)
pusher) when adding a pusher)
In [GET /_matrix/client/v3/pushers](https://spec.matrix.org/v1.3/client-server-api/#get_matrixclientv3pushers) the value In [GET /_matrix/client/v3/pushers](https://spec.matrix.org/v1.3/client-server-api/#get_matrixclientv3pushers) the value
is required when `kind` is `http`. If `kind` is _not_ `http`, the `device_id` field is null. is required when `kind` is `http`. If `kind` is _not_ `http`, the `device_id` field is null.
@ -56,12 +57,13 @@ In [POST /_matrix/client/v3/pushers/set](https://spec.matrix.org/v1.3/client-ser
### Pusher-less clients ### Pusher-less clients
Pausing notifications for clients that create notifications outside of the Push Gateway will not be addressed in this MSC. Pausing notifications for clients that create notifications outside of the Push Gateway will not be addressed in this
MSC.
## Migration ## Migration
Clients that connect to a home server that doesn't yet support this proposal should interpret a missing `enabled` Clients that connect to a home server that doesn't yet support this proposal should interpret a missing `enabled` value
value as `true`. as `true`.
Home servers should migrate pushers that were registered before this proposal so that `enabled` is `true` Home servers should migrate pushers that were registered before this proposal so that `enabled` is `true`

Write Preview
Loading…
Cancel
Save