Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Accessing CSUM App Configuration

There should be a link to configure the add-on in the Manage add-ons UI in Confluence after you install it.  Click this to open the main CSUM configuration page.

...

Configuration

You should now see the main configuration screen for CSUM (shown here, v3.0.16)

...

Initially, if no previous configuration for CSUM is found, you may see a messages regarding settings needing attention.

Group 

...

Setting

...

Description

...

Group Actions Permitted

...

Options are Yes or No. Choose whether you want to allow Space Administrators the ability to perform add/remove operations on groups specified via group matching (see below)

...

Delegated Group Actions Permitted

...

Options are Yes or No. Choose whether you want to allow Administrators the ability to delegate management of a group to other groups/users, or Space Administrators the ability to add/remove users from said delegated groups in the space view.

...

Space group pattern

...

Specify a group name prefix and/or suffix for all groups that are to be manageable by Space Administrators.  These fields should include spacekey somewhere, which is a special term replaced with the contextually available Space key when admins use CSUM.  Changing this key will be immediate, and will prevent admins from finding and managing any group matching the old format.

...

Max Number of UserIds to Act On at One Time

...

Sets the limit of how many users a Space Administrator can create at one time.

...

Max Number of GroupIds to Act On at One Time

...

Sets the limit of how many groups a Space Administrator can create at one time.

User

...

Setting

...

Description

...

Auto join groups

...

possibly refer groups here that any user who is added to a CSUM group should be also added to

...

User Search Enabled

...

Options are Yes or No.  Setting this to Yes allows Space Administrators to perform user searches when defining users for an operation (adding to a group for example).  This is useful as it means Space Administrators do not have to rely on knowing the exact details of the users they are looking for.  However, you may want this set to No if there may be security measures in place meaning that you do not want Space Administrators to see all users in Confluence.

...

Personal Space User/Group Administration Allowed

...

Options are Yes or No.  Choose whether or not you want users that have personal spaces to be allowed to administer users/groups for their space.  This is not recommended, so if you are unsure choose NO.

...

Customize User Search Directories

...

By default, CSUM will use Confluence default search for users that includes all configured User Directories.  Its possible that a broken directory (intentional or other) will cause the search to fail.  New in 3.0.16 is the ability to select from defined User Directories, those which should be queried for users.  If a custom search is set, at least one User Directory needs to be set, otherwise default search behaviour will result.

General

...

Setting

...

Description

...

Personal Space User/Group Administration Allowed

...

Options are Yes or No.  Choose whether or not you want users that have personal spaces to be allowed to administer users/groups for their space.  This is not recommended, so if you are unsure choose NO.

...

Use Redirects to Refresh Group Membership

...

Options are Yes or No.  Choose whether redirects occur when refreshing group membership views in your browser.

...

Add-on Deactivated

...

Prevents usage of the add-on.  While this may sound like an unnecessary duplication of the standard way of disabling the add-on, it can be useful as this way allows you to specify a downtime message which is not currently possible through normal disabling.

...

Add-on Downtime Message

...

The message that is shown when the add-on has been disabled using the Plugin Deactivated setting mentioned above.  If left blank, a default message will be used.  The field does not currently support wiki syntax.

Once you are happy with the configuration, click the Update button located at the bottom of the configuration page to saveAnother option is to select Confluence Space User Management from the side Navigation bar in the Confluence Administrator section.

Image Added

Image Added

Documentation

We have a page per section:

Page Tree
rootSystem Admin App Configuration
spacesCSUM
startDepth1

Warning

Confluence 7.13.1 and 7.14.0 issue:

  • fails to load/edit and save configurations under the System Admin Configuration page. Also, affects the LDAP section.

  • To fix this issue, you will need to upgrade the confluence to the fix versions of 7.13.2 or 7.14.1.

Relates to -

https://jira.atlassian.com/browse/CONFSERVER-73757

https://jira.atlassian.com/browse/CONFSERVER-73758

CSUM for Jira ?

Info

See also Project User Management for Jira, which is a literal port of CSUM replacing Spaces with Projects.