Subscription Plugin Readme
Overview
This plugin can be configuured to automatically accept or reject subscription requests. When set to accept
subscription requests users will be able to add someone to their roster (aka "Buddy List" or "Contacts")
without having to wait for a manual subscription acceptance from the requested user. Conversely, when the
plugin is set to reject subscription requests users will not be able to add people to their roster.
Installation
Copy the file, subscription.jar into the plugins directory of your Openfire installation. The plugin will
then be automatically deployed. To upgrade to a new version: 1) go to the plugin screen of the Admin
Console, 2) click on the delete icon on the same row as the currently installed subscription plugin, 3)
copy the new subscription.jar into the plugins directory of your Openfire installation.
Configuration
The subscription plugin is configured via Subscription Properties sidebar item which can found under the
Sever tab in Openfire Admin Console. The subscription plugin can be configured in the following ways:
- Disabled (Default setting) - Subscription requests will not be intercepted.
- Accept - Subscription requests will be intercepted and accepted.
- Local - Only subscription requests sent by users who have an account on the Openfire server on which
the plugin is installed, will be intercepted and accepted.
- All - All subscription requests, regardless of which server the user account resides on, will be
intercepted and accepted. Selecting this level can make Openfire vulnerable to spIM*.
- Reject - Subscription requests will be intercepted and rejected. NOTE: At the time of this writing the latest
release of Spark (v1.1.4) has an issue where
subscription rejection packets are not processed properly so this feature will not work correctly with Spark. To have
the plugin attempt to work around this issue create a "plugin.subscription.sparkCheck" system property and set its
value to "true".
- Local - Only subscription requests sent by users who do not have an account on the Openfire server on which
the plugin is installed, will be intercepted and rejected.
- All - All subscription requests, regardless of which server the user account resides on, will be
intercepted and rejected.
It is also possible to create a "white list" of users. The users in the list still maintain full control over accepting
and rejecting subscription requests.
Using the Plugin
Once the plugin has been installed and configured there is no additional steps are required to use the plugin.
* spIM is unsolicited messages sent via an instant messaging system; similiar in nature to email SPAM.