# UnifiedPush over XMPP [UnifiedPush](https://unifiedpush.org/) is an specification how push notifications delivered between application server and application. This is an implementation of the UnifiedPush specifications to delivere push notification over XMPP. In this project has following components: - **Gateway** (also called an Push Provider or [Server](https://unifiedpush.org/spec/server/)) which could be registered as an XMPP Component on an Server - **Distributor** for Linux using the [D-Bus Specification](https://unifiedpush.org/spec/dbus/) which implement an very small XMPP-Client to recieve the push notifications ## XMPP Messages ### Register Request for Register ```xml token-from-distributer-regisration ``` **Responses** on success: ```xml https://an-endpoint-for-application-server.localhost/UP?token=public-token ``` on failure: ```xml a reason of failure ``` ### Unregister TODO ### Notification For the push notification it-self the origin `` is used with following Position of Token and Content. ```xml token-from-distributer-regisration Here is the Notification content ``` The message sender `from` should be validated from distributor, for not recieving invalid or manipulated push Messages. ## Wordings We are using over the complete system three kind of **tokens**: - **Public Token** which is part of the *Endpoint* and is for using between Gateway and Application-Server - **External Token** which is used between Gateway and Distributor - **Internal Token** which is used between Distributor and Application