User Management Delegation to Space Administrators

This plugin is outdated, latest version of plugin is available at http://confluence.atlassian.com/display/CONFEXT/Custom+Space+User+Management+Plugin

Description/Features

This module gives Space Administrators a ability to manage users and user groups that are assoicated to their Wiki Space.

Why need of this plugin ?
Right now only Confluence Administrator can create users, modify user groups associated to any wiki space. This is ok if you are managing few spaces. But as volume of spaces and users grows, doing this activity becomes very time intensive. So idea behind this plugin is, let Space Administrators manage this user creation and modify user groups related to their wiki spaces. Delegating this activity to Space Administrator helps them manage their wiki spaces much more time efficient and helps Confluence Administrator to think of other important activities like upgrades etc.

As a Space Administrator you can use this module to:

1. creating new user accounts
2. Add users to user groups that are associated to your wiki space
3. Remove users from user groups that are associated to your wiki space

Using this module you can not do:

1. Delete users (deleting users is not permitted as it's quite possible this user might be associated to other wiki spaces!)
2. Create new user groups
3. Delete existing user groups

Technical details about this User Management Delegation Module

• To start with assumption here is, confluence user management has been delegated to Jira!
• Also if you are using LDAP for user authentication, it will be used to fetch the user details (like email, full name) during new account creation.
• If LDAP is not available new account with just userids will be created. Then later using Bulk User Upload Macro you can enter all other details for each user.
• This module has two pluings 1)Jira xmp-rpc plugin is deployed in Jira which will be used to perform different operations. 2)Confluence plugin provide user interface to space administrators to perform action like Add users to groups or remove users from group. More details about these two plugins is available in section Usage

Requirements

1. Jira 3.3.x is installed and running
2. Confluence 2.1.x is installed and running (user management delegated to Jira!)
3. If LDAP used for user authentication, configuration details will be needed to set this module to fetch user information during new account creation.
4. It has been tested against Oracle 9.x database
5. You need to be Space Administrator to use this module

Installation

Confluence plugin installation

• Download confluence-delegateplugin.zip and expand it in temporary folder
• Copy DelegatePlugin-0.1.jar that is present under delegateplugin directory to WEB-INF/lib directory of your Confluence instance.
• Restart Confluence.

Jira plugin installation

• Download jira-rpc-delegateAdmin-plugin.zip and expand it in temporary folder
• Copy delegateusermgmt-3.5.1-1.jar that is present under jira-rpc-delegateAdmin-plugin directory to WEB-INF/lib directory of your Jira instance
• Restart Jira

Upgrading

Follow the steps for Installations as mentioned above, but before starting you can delete the old plugin jar file from WEB-INF/lib directory of your Confluence and Jira instances.

Using

Once you have restarted Jira and confluence instances do following steps:

1. Before you start using this module, Confluence Administrator needs to configure it. Configuration can be done by pointing your browser at location <confluence_base_url>/admin/plugins/delegateusermgmtconfig/usermgmtconfigure.action
   Make sure correct values are set all properties of this module.
2. To start using this module, point your browser to <confluence_base_url>/plugins/delegateusermgmt/delegateusermgmt.action
3. If Confluence Administrator has yet not configured this plugin then you will see a message -> An administrator must configure "Delegate User Management Module" before you start using it.
4. Else you should be able to see a screen with list of wiki spaces to which you are a Space Administrator.
5. Select a Wiki Space.
6. On next screen you will see all user groups that are currently available to your wiki space.
7. Enter list of users on which you want to act upon and select user groups to which you want them to associate.
8. Select intended action to perform for this set of users.
9. After you clicked on "Process" button, if user is not exists it will be created and associated to given user groups.
10. Result of action will be displayed. List of users that are not able to add is displayed. Also you can see the latest user groups information by clicking on the link that is provided after Operation Status Messages.

That's it! You can manage users and user groups for your wiki space without any dependency on Confluence Administrator.

More detailed information about workings of available plugins in this module is available at how plugins interact

Todo

1. Making this jira rpc plugin available as remote procedure call so that users can call through Java Applicatoins (Right now only api which is available for use, expects secret id to avoid misuse of this plugin and prevents any unauthroized use.)
2. Better naming convention for plugin jars
3. Validation of configuration settings before storing it!
4. Screenshots additions
5. This list can grow up if you find any difficulties in using this tool.
6. Next version will come up soon...