readme.html 3.7 KB
Newer Older
Ryan Graham's avatar
Ryan Graham committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Subscription Plugin Readme</title>
	<style type="text/css">
	  BODY {
	     font-size : 100%;
	  }

	  BODY, TD, TH {
	     font-family : tahoma, verdana, arial, helvetica, sans-serif;
	     font-size : 0.8em;
	  }

	  H2 {
	     font-size : 10pt;
	     font-weight : bold;
	  }

     A:hover {
	     text-decoration : none;
	  }
     
	  H1 {
	     font-family : tahoma, arial, helvetica, sans-serif;
	     font-size : 1.4em;
	     font-weight: bold;
	     border-bottom : 1px #ccc solid;
	     padding-bottom : 2px;
	  }

	  TT {
	     font-family : courier new;
	     font-weight : bold;
	     color : #060;
	  }
     
	  PRE {
	     font-family : courier new;
	     font-size : 100%;
	  }
	</style>
</head>
<body>

<h1>
Subscription Plugin Readme
</h1>

<h2>Overview</h2>
<p>
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.
</p>

<h2>Installation</h2>
<p>
61
Copy the file, subscription.jar into the plugins directory of your Openfire installation. The plugin will
Ryan Graham's avatar
Ryan Graham committed
62 63
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) 
64
copy the new subscription.jar into the plugins directory of your Openfire installation.
Ryan Graham's avatar
Ryan Graham committed
65 66 67 68 69
</p>

<h2>Configuration</h2>
<p>
The subscription plugin is configured via Subscription Properties sidebar item which can found under the 
70
Sever tab in Openfire Admin Console. The subscription plugin can be configured in the following ways:
Ryan Graham's avatar
Ryan Graham committed
71 72 73 74 75 76 77
<ul>
<p>
<li>Disabled (Default setting) - Subscription requests will not be intercepted.</li>
</p>
<p>
<li>Accept - Subscription requests will be intercepted and accepted.</li>
<ul>
78
<li>Local - Only subscription requests sent by users <u>who have</u> an account on the Openfire server on which
Ryan Graham's avatar
Ryan Graham committed
79 80
the plugin is installed, will be intercepted and accepted.</li>
<li>All - All subscription requests, regardless of which server the user account resides on, will be 
81
intercepted and accepted. Selecting this level can make Openfire vulnerable to spIM*.</li>
Ryan Graham's avatar
Ryan Graham committed
82 83 84 85
</ul>
</p>
<p>
<li>Reject - Subscription requests will be intercepted and rejected. NOTE: At the time of this writing the latest
86
release of Spark (v1.1.4) has an <a href="http://www.igniterealtime.org/issues/browse/SPARK-300">issue</a> where 
Ryan Graham's avatar
Ryan Graham committed
87 88 89 90
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".</li>
<ul>
91
<li>Local - Only subscription requests sent by users <u>who do not have</u> an account on the Openfire server on which
Ryan Graham's avatar
Ryan Graham committed
92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112
the plugin is installed, will be intercepted and rejected.</li>
<li>All - All subscription requests, regardless of which server the user account resides on, will be 
intercepted and rejected.</li>
</ul>
</p>
</ul>
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.
</p>

<h2>Using the Plugin</h2>
<p>
Once the plugin has been installed and configured there is no additional steps are required to use the plugin.
</p>

<br>
<p>
* spIM is unsolicited messages sent via an instant messaging system; similiar in nature to email SPAM.
</p>
</body>
</html>