UnifiedPush via XMPP einrichten

Einleitung

Um UnifiedPush auf einem Endgerät wie Smartphone oder Tablet nutzen zu könnnen, muss ein sogenannter UnifiedPush Distributor (eine App, die die Nachrichten entgegennimmt und an die jeweiligen Client Apps ausliefert) installiert sein.

Unter Android gibt es die Möglichkeit, hierfür die (sowie schon vorhandenen) XMPP-Clients wie z. B. Conversations, Snikket oder Monocles Chat zu nutzen. Die Einrichtung ist unkompliziert und soll im Nachfolgenden beschrieben werden.

Es gibt insgesamt 4 Komponenten, die zum erfolgreichen Übermitteln und Anzeigen der UnifiedPush Nachrichten erforderlich sind:

1. die Quelle, wo die Nachricht erzeugt wird, diese kann man im Normalfall nicht ändern und wird hier nur zum besseren Verständnis aufgeführt.
2. einen UnifiedPush Server, welcher zum ersten einen http Endpunkt für die Quelle bereitstellt und zum zweiten die Nachrichten an die verschiedenen Distributoren weiterverteilt. Da da in diesem Beispiel über XMPP erfolgen soll, kann so ein UnifiedPush Server als Modul eines Prosody-Servers oder eines ejabberd Servers bereitgestellt sein. Fragt im Zweifel bei Eurem XMPP Provider nach, ob er diesen Dienst anbietet.
3. der UnifiedPush Distributor (= Verteiler) übernimmt auf dem jeweiligen Endgerät die Entgegennahme der Nachricht vom UnifiedPush Server und verteilt diese auf die Clients, wo sie dann verarbeitet (angezeigt) werden
4. die Clients: UnifiedPush funktioniert z. B. zusammen mit DAVx5 (zum Synchronisieren von Terminen und Kontakten), mit FOSS Warn (Warnapp zur Anzeige von weltweiten Katastrohphen- oder Warnmeldungen), Fedilab (Client für Mastodon) und einigen mehr. Die Liste mit unterstützenden Apps findet ihr hier

Aktivierung

1. Als erstes richtet Ihr Euch den Distributor ein. Bei den Android XMPP Clients findet Ihr das in den Einstellungen ziemlich unten unter dem Punkt "Unified Push Verteiler". Dort wählt Ihr als nächstes den Push-Server aus. WICHTIG: Das muss der Server sein, auf dem Euer XMPP-Konto liegt, über welches Ihr UnifiedPush Nachrichten empfangen wollt. Hier wird nur die XMPP-Domain akzeptiert, keine komplette http-Adresse. Danach unter dem Punkt XMPP-Konto Euer XMPP-Konto auswählen, welches Ihr für die Push-Nachrichten verwenden wollt. Ob ein separates Konto dafür sinnvoll ist, vermag ich an dieser Stelle nicht zu sagen.
2. Jetzt folgen die Clients: In der Regel werden die Clients den eingerichteten Distributor selbstständig erkennen: Entweder wird dieser direkt benannt oder mit seiner "Kennung" (z. B. eu.siacs.conversations). Bei mehreren Distributoren ist der richtige auszuwählen.
3. Fertig zum Empfang. Solltet Ihr nicht sicher sein, ob das jetzt auch funktioniert, gibt es noch eine Test-App von UnfiedPush. Diese nennt sich UP-App und kann zum Testen des Setups benutzt werden.

Specials - good to know

1. Die Push Nachrichten werden auf ihrem Weg verschlüsselt
2. Die HTTP Endpunkt Adresse des UnifiedPush Servers sieht in der Regel sehr kryptisch aus (z. B. https://xmpp-server.exmple.net/push/v3.local.LwEXbb4......). Diese ist z. B. in der UP-App sichtbar.
3. Bei DAVx5 ist zuerst in den Einstellungen der letzte Punkt Integration - UnifiedPush auszuwählen. Dort wird der Distributor eingetragen. Danach klickt man weiter bis in die Eigenschaften eines Kalenders oder der Kontakte. Bei korrekter Einrichtung muss hier ein Eintrag "Push-Unterstützung: Server bietet Push-Unterstützung" zu finden sein. Falls nicht, einmal den roten Punkt "Liste aktualisieren" anwenden und nochmals in den Details dann kontrollieren.

Viel Spaß beim Pushen!