User Admin Plugin Readme

Overview

The User Admin Plugin provides the ability to add,edit,delete users by sending an http request to the server. It was written with the assumption that http access to the Jive Messenger service was only available to trusted machines. In the case of the plugin's author, a web application running on the same server as Jive messenger makes the request.

Installation

Copy useradmin.jar into the plugins directory of your Jive Messenger installation. The plugin will then be automatically deployed. To upgrade to a new version, copy the new useradmin.jar file over the existing file.

Configuration

There are no configuration options and hence nothing new will be visible in the Jive Admin Console.

Using the Plugin

To administer users, submit HTTP requests to the useradmin service. The service address is [hostname]plugins/userAdmin/admin. For example, if your server name is "example.com", the URL is http://example.com/plugins/userAdmin/admin.

The following parameters can be passed into the request:

NameDescription
typeRequiredThe admin service required. Possible values are add, delete, update
jidrequired for delete and update operations The bare JID (address) of the user to be administered(oooh er).
usernamerequired for add operation The username of the new user. ie the part before the @ symbol.
passwordrequired for add operation The password of the new user or the user being updated.
nameoptional The display name of the new user or the user being updated.
emailoptional The email address of the new user or the user being updated.

Sample HTML

The following example adds a user

The following example deletes a user This example updates a user