Abstract: This specification defines XMPP protocol extension allowing XMPP clients to order XMPP server to NOT SEND push notifications from unknown senders.
- 1. Introduction
- 2. Scope
- 3. Requirements
- 4. Filtering notifications from unknown senders
XEP-0357: Push Notifications defines a way for the XMPP server to generate push notifications by publishing them to the application specific XMPP Push Notification Component. However, that extension does not specify any rules for generating push notifications, nor any rules for filtering them forcing XMPP servers to publish notifications about any incoming messages while XMPP client is not connected.
This extension was created to provide those rules for filtering notifications, which SHOULD reduce load on the XMPP clients (ie. on mobile devices) by reduced number of push notifications sent to them.
This documents specifies way of informing XMPP server to NOT publish push notifications for stanzas sent from jids not added to the roster. This rule is an extension to the payload send to enable push notifications as specified in XEP-0357: Push Notifications.
The XMPP server MUST support XEP-0357: Push Notifications as this specification is the extension to push notifications.
In may cases, users want to receive Push Notifications only from the senders with which they have exchanged messages before. In most cases, this means receiving push notifications from senders which are already in the users roster.
Before enabling this feature, a client SHOULD determine whether user’s server supports filtering push notifications based on sender being part of a user’s roster; to do so, it MUST send a Service Discovery (XEP-0030)  information query to the user’s bare JID:
Example 1. Client queries server regarding protocol support
<iq email@example.com/mobile' firstname.lastname@example.org' id='x13' type='get'> <query xmlns='http://jabber.org/protocol/disco#info'/> </iq>
Example 2. Server communicates protocol support
<iq email@example.com' firstname.lastname@example.org/balcony' id='disco1' type='result'> <query xmlns='http://jabber.org/protocol/disco#info'> <identity category='account' type='registered'/> <feature var='tigase:push:filter:ignore-unknown:0'/> ... </query> </iq>
To enable this filter, XMPP client SHOULD send enable request with
<ignore-unknown /> element qualified by
Example 3. Enabling filter
<iq type='set' id='x42'> <enable xmlns='urn:xmpp:push:0' jid='push-5.client.example' node='yxs32uqsflafdk3iuqo'> <ignore-unknown xmlns='tigase:push:filter:ignore-unknown:0'/> </enable> </iq>