User Management

Last modified by Lucas Charpentier (Sereza7) on 2024/11/07

Adding users to your wiki

  1. Log in as an administrator
  2. Hover over "Wiki" and click on "Administer Wiki"
  3. Click on the "Users" link to bring up an overview of all the users
  4. Click on the "Add new user" button to open a registration page as shown on the image below
  5. Fill in the user information 
  6. Click "Save":

    AddUser.png

Changing a user's password

Changing the password for any user

  1. Log in as an administrator
  2. Open the drawer and click on "User Index"
  3. Click on the name of the user for which you want to change the password (this will take you to the user's profile page)
  4. Click on the "Preferences" tab
  5. Click on the "Change Password" button
  6. Enter the new password twice
  7. Click on the "Update" button

    ChangePassword.png

    Don't forget to notify the user!

Changing the password for the logged in user

To change your own password follow these steps:

  1. Click on your user avatar in the top right corner of the screen (this will redirect you to your profile) 
  2. Click on the "Preferences" tab 
  3. Click on the "Change password" button
  4. XWiki 5.1+ Enter your current password
  5. Enter the new password twice
  6. Click on the "Save" button

    ChangeOwnPassword.png

Changing the password security policy

You can define the password security for all the users of the wiki. The policy is defined by some rules available in the Administration > Users & Rights > Registration page. You can specify the minimum length of the password, and if it must contain numbers, lower/upper case characters, and symbol.

password-policy-fields.png

Please note that when the rules are changed, all further password changes must comply with the new rules, but the older password are still all valid.

Editing an existing user

  1. Log in as an administrator
  2. Hover over "Wiki" and click on "Administer Wiki"
  3. Click on the "Users" link to bring up an overview of all the users
  4. You have two options:
    1. Click the user name for the user you want to edit
      • On the user's profile page click on the small yellow pencil corresponding to the information you want to edit (profile or preferences)
      • Click "Save and View" to save the changes you have made
    2. Click on the small yellow pencil near the user you want to edit (this will open up a lightbox with the main information of that user)
      • Make your modifications and click "Save"

        There is also a link to the complete user profile, where you can proceed as above (first option).

        EditUserProfile.png

Deleting a user

  1. Log in as an administrator
  2. Go to the User section of the Wiki administration
  3. Delete the user by clicking the red "X" corresponding to the user you want to delete (the user will be automatically removed from all the groups it belonged to)

    You won't be able to delete the currently logged in user and you'll need to log-in using other credentials. This is done in order to prevent mistakes.

    user_administration_disable_account.png

Modify the number of users displayed in the list

Edit the XWiki.AdminUsersSheet page. It contains a line like this:

var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback);

Replace it with:

var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback, {limit: 100});

where 100 is the number of items displayed per page.

Customizing the Registration page

Customizing the registration page is done by the "Verified Registration" Page, part of the Administration Application. This provides more features such as captcha and client side validation of user input. For more information about how to configure it, visit the application page.

In order to customize the registration page you must follow these steps:

  1. Log in as an administrator
  2. Click on the right drawer icon, then click on "Administer Wiki"
  3. Go to "Users & Rights" > "Registration"
  4. Make your modifications and click "Save":

    Registration.png

Enable/Disable User Account

It is possible to disable a user account and to enable it back from his/her profile. A disabled user is able to login but cannot perform any action once logged-in.
account-disabled-warning.png

From the administration

user_administration_disable_account.png

  1. Log in as an administrator
  2. Go to the User section of the Wiki administration
  3. Click on the closed lock to disable a user

To enable a user, follow the same steps but click on the opened lock.

From a user profile

disable-account.png

  1. Login an an administrator
  2. Visit a user profile
  3. Click on the "Disable this account" action.

enable-account.png

To enable a user, follow the same step but click on the "Enable this account" action.

Inactive Users

If you configured the registration page to enable the Use Email Verification, then new registered users are by default inactive. The user account is activated by a link on the email. (See more information in Administration Application).

Inactive users are prevented to get access to most pages of the wiki by default. The pages they can get access to can be configured in the configuration. Prior to that, the Authentication Active Check must be enabled in order for inactive users to get access to the wiki.

User Storage

Users are stored inside wiki pages containing an XObject of the XWiki.XWikiUsers XClass. To see all the user metadata, you can navigate to the profile page of a user and edit it using the Object editor.

Get Connected