view mod_unified_push/README.md @ 5136:67b2c982bea2

mod_unified_push: Various fixes, now working with Conversations
author Matthew Wild <mwild1@gmail.com>
date Tue, 10 Jan 2023 15:45:03 +0000
parents 7cc0f68b8715
children 4511e90d1d08
line wrap: on
line source

---
labels:
- Stage-Alpha
summary: "Unified Push provider"
---

This module implements a [Unified Push](https://unifiedpush.org/) Provider
that uses XMPP to talk to a Push Distributor (e.g. [Conversations](http://codeberg.org/iNPUTmice/Conversations)).

For a server-independent external component, or details about the protocol,
see [the 'up' project](https://codeberg.org/inputmice/up).

This module and the protocol it implements is at an experimental prototype
stage.

Note that this module is **not related** to XEP-0357 push notifications for
XMPP. It does not send push notifications to disconnected XMPP clients. For
that, see [mod_cloud_notify](https://modules.prosody.im/mod_cloud_notify).

## Configuration

| Name                          | Description                                            | Default               |
|-------------------------------|--------------------------------------------------------|-----------------------|
| unified_push_secret           | A random secret string (32+ bytes), used for auth      |                       |
| unified_push_registration_ttl | Maximum lifetime of a push registration (seconds)      | `86400` (1 day)       |

A random push secret can be generated with the command
`openssl rand -base64 32`. Changing the secret will invalidate all existing
push registrations.

## Compatibility

Requires Prosody trunk (not compatible with 0.12).