Below is a list of versions that are available for the pushserver plugin.
To find other plugins, please review this listing of most recent releases of all plugins.
Plugins extend and enhance the functionality of Openfire. To install plugins, copy the .jar
file into the plugins directory of your Openfire installation.
Openfire Push Server Plugin
Overview
An XEP-0357: Push Notifications app server that relays push messages between the user's server and FCM (Firebase Cloud Messaging) or APNS (Apple Push Notification Service).
Building
This project is using the Maven-based Openfire build process, as introduced in Openfire 4.2.0. To build this plugin locally, ensure that the following are available on your local host:
- A Java Development Kit, version 7 or (preferably) 8
- Apache Maven 3
To build this project, invoke on a command shell:
$ mvn clean package
Upon completion, the openfire plugin will be available in target/pushserver-openfire-plugin-assembly.jar
. This file should be renamed to pushserver.jar
Installation
Copy pushserver.jar
into the plugins directory of your Openfire server, or use the Openfire Admin Console to upload the plugin. The plugin will then be automatically deployed.
To upgrade to a new version, copy the new pushserver.jar
file over the existing file.
Configuration
After installing plugin, you should fill the fields under the page Server -> Server Settings -> Push Server Properties
.
Note: After filling and saving values, you should restart the plugin.
-
iOS
-
Push Server Plugin uses token-based authentication to communicate with Apple Push Notification service. (For more information, see Establishing a Token-Based Connection to APNs)
-
* Bundle Id (Bundle IDs)
-
* Team Id (Locate your Team ID)
-
* Key Id
-
* Encryption Key
-
Android
-
Push Server Plugin uses Firebase Cloud Messaging to send push notifications to Android clients. In order to activate sending push notifications to Android clients, you should create a Firebase project and add Firebase to your Android application. (For more information, see Add Firebase to your Android project)
-
* FCM Project Id
-
* Google Cloud Service Account Key (Service Account Key Json File)
-
Both of these can be found in your Firebase console, under Project Settings:
-
* The ID is found in the General tab
-
* The Service Account JSON file can be created and downloaded from the Service Account tab. (or Create service account key using Google Console)
Client Configuration
Registering Devices
Clients need to register with push server and get node and secret information
iOS
<iq from="user@example.com/mobile" id="x20" to="push.example.com" type="set" <command xmlns="http://jabber.org/protocol/commands" action="execute" node="register-push-apns"> <x xmlns="jabber:x:data" type="submit"> <field var="token"> <value>243CA5F2A4EE00B66E3208CD05C962A30EFA80B2D9F8DD508CE8182E04EAB695</value> </field> <field var="device-id"> <value>0523AD60-ADD0-45A4-8D05-DC1AC59BB1CA</value> </field> </x> </command> </iq> <iq from="push.example.com" id="x20" to="user@example.com/mobile" type="result"> <command xmlns="http://jabber.org/protocol/commands" action="complete" node="register-push-apns"> <x xmlns="jabber:x:data" type="form"> <field type="text-single" var="node"> <value>37Ni514izxHG</value> </field> <field type="text-single" var="secret"> <value>Zt9z9wOtAUOSYCtYC7a5OORa</value> </field> </x> </command> </iq>
Android
<iq from="user@example.com/mobile" id="x20" to="push.example.com" type="set"> <command xmlns="http://jabber.org/protocol/commands" action="execute" node="register-push-fcm"> <x xmlns="jabber:x:data" type="submit"> <field var="token"> <value>dPrh685pTdGns_MHsu1I-b:APA91bGwfwGthGPxE2aUJ5o-pyn1eMzV0WPqFulpyYo20xOEy7efh8soyJpcCuibleBGjCaRDRgjl6vSYNwDDE7pq0lfKOzubfUvCrvKvLMN4uRLEY373L11sCKqHeOf-_Qn3eooeOge</value> </field> <field var="device-id"> <value>0ab43fb78f92ba10</value> </field> </x> </command> </iq> <iq from="push.example.com" id="x20" to="user@example.com/mobile" type="result"> <command xmlns="http://jabber.org/protocol/commands" action="complete" node="register-push-fcm"> <x xmlns="jabber:x:data" type="form"> <field type="text-single" var="node"> <value>KmDtdKoUTiGr</value> </field> <field type="text-single" var="secret"> <value>FBfIl4qflMTDKn6CYPxXJHyH</value> </field> </x> </command> </iq>
Enabling Notifications
After registering with the push server, Client sends the node ID and the jid of the app server (push.example.com) to the user's server.
<iq type='set' id='x42'> <enable xmlns='urn:xmpp:push:0' jid='push.example.com' node='KmDtdKoUTiGr'> <x xmlns='jabber:x:data' type='submit'> <field var='FORM_TYPE'><value>http://jabber.org/protocol/pubsub#publish-options</value></field> <field var='secret'><value>FBfIl4qflMTDKn6CYPxXJHyH</value></field> </x> </enable> </iq>
Note: To support sandbox devices in iOS, you should provide the <field var="sandbox"><value>true</value></field>
in publish options.
Example:
<iq type='set' id='x42'> <enable xmlns='urn:xmpp:push:0' jid='push.example.com' node='37Ni514izxHG'> <x xmlns='jabber:x:data' type='submit'> <field var='FORM_TYPE'><value>http://jabber.org/protocol/pubsub#publish-options</value></field> <field var='secret'><value>Zt9z9wOtAUOSYCtYC7a5OORa</value></field> <field var="sandbox"><value>true</value></field> </x> </enable> </iq>
More info can be found in XEP-0357 Section 5
Disabling Notifications
<iq type='set' id='x97'> <disable xmlns='urn:xmpp:push:0' jid='push.example.com' node='37Ni514izxHG' /> </iq>
More info can be found in XEP-0357 Section 6
Publishing Notifications
It can be found in XEP-0357 Section 7
|
Push Server
|
Send push notifications to mobile devices through FCM or APNS
|
|
|
Download
|
1.1.0
|
Sep 12, 2024
|
4.8.0
+
|
|
Push Server
|
Send push notifications to mobile devices through FCM or APNS
|
|
|
Download
|
1.0.0
|
Sep 2, 2021
|
4.3.0
+
|
The plugins below, so-called SNAPSHOTS, are build automatically by the continuous integration
system. They represent the latest development, but are untested.
|
Push Server
|
|
|
Download
|
1.1.1-SNAPSHOT
|
Sep 12, 2024
|
4.8.0
+
|
|
Push Server
|
|
|
Download
|
1.1.0-SNAPSHOT
|
Sep 11, 2024
|
4.8.0
+
|
|
Push Server
|
|
|
Download
|
1.0.1-SNAPSHOT
|
Sep 11, 2024
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.1-SNAPSHOT
|
Jun 26, 2024
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.1-SNAPSHOT
|
May 3, 2023
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.1-SNAPSHOT
|
Sep 16, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.1-SNAPSHOT
|
Sep 16, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.1-SNAPSHOT
|
Sep 16, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
Sep 16, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
Sep 16, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
Sep 16, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
Jul 18, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
Jul 5, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
Jul 5, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
Jul 5, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
Jun 22, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
Jun 22, 2022
|
4.3.0
+
|
|
Push Server
|
|
|
Download
|
1.0.0-SNAPSHOT
|
May 27, 2022
|
4.3.0
+
|