# 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**:
- **Endpoint Token** which is part of the *Endpoint* and is for using between Gateway and Application-Server
- **Public Token** which is used between Gateway and Distributor
- **App Token** which is used between Distributor and Application