User Management (XWiki.org)

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.

50

51

52

53

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.

54

55

= Editing an existing user =

56

57

1. Log in as an administrator

58

1. Hover over "Wiki" and click on "Administer Wiki"

59

1. Click on the "Users" link to bring up an overview of all the users

60

1. You have two options:

61

11. Click the user name for the user you want to edit

62

11*. On the user's profile page click on the small yellow pencil corresponding to the information you want to edit (profile or preferences)

63

11*. Click "Save and View" to save the changes you have made

64

11. 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)

65

11*. Make your modifications and click "Save"(((

66

67

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

)))

= Disabling a user =

== From the administration ==

76

77

[[image:user_administration_disable_account.png||height="271"]]

78

79

1. Log in as an administrator

80

1. Go to the User section of the Wiki administration

81

1. Click on the closed lock to disable a user

82

83

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

84

85

== From a user profile ==

86

87

[[image:user_profile_enabled_account.png||height="415" width="960"]]

88

89

1. Login an an administrator

90

1. Visit a user profile

91

1. Click on the "Disable this account" action.

92

93

[[image:user_profile_disabled_account.png||height="387" width="960"]]

94

95

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

= Deleting a user =

1. Log in as an administrator

100

1. Go to the User section of the Wiki administration

101

1. 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)(((

102

103

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.

104

105

106

[[image:user_administration_disable_account.png||height="271" width="960"]]

107

)))

108

109

= Modify the number of users displayed in the list =

110

111

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

112

113

114

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

Replace it with:

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

121

122

123

where ##100## is the number of items displayed per page.

124

125

= Customizing the Registration page =

126

127

Customizing the registration page is done by the "Verified Registration" Page, part of the [[Administration Application>>extensions:Extension.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>>extensions:Extension.Administration Application]].

128

129

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

130

131

1. Log in as an administrator

132

1. Click on the right drawer icon, then click on "Administer Wiki"

133

1. Go to "Users & Rights" > "Registration"

134

1. Make your modifications and click "Save":(((

)))

= Enable/Disable User Account =

139

140

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.

141

142

143

image:disable-account.png

144

image:enable-account.png

145

image:account-disabled-warning.png

= 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>>extensions:Extension.Administration Application]]).

151

152

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>>Documentation.AdminGuide.Configuration#HAllowedPagesforInactiveUsers]]. 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.

Wiki source code of User Management

Quick Links

Navigation

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected

author	version	line-number	content
		1	{{box cssClass="floatinginfobox" title="Contents"}}
		2	{{toc/}}
		3	{{/box}}
		4
		5	= Adding users to your wiki =
		6
		7	1. Log in as an administrator
		8	1. Hover over "Wiki" and click on "Administer Wiki"
		9	1. Click on the "Users" link to bring up an overview of all the users
		10	1. Click on the "Add new user" button to open a registration page as shown on the image below
		11	1. Fill in the user information
		12	1. Click "Save":(((
		13	{{image reference="AddUser.png"/}}
		14	)))
		15
		16	= Changing a user's password =
		17
		18	== Changing the password for any user ==
		19
		20	1. Log in as an administrator
		21	1. Hover over "Wiki" and click on "Administer Wiki"
		22	1. Click on the "Users" link to bring up an overview of all the users
		23	1. 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)
		24	1. Click on the "Preferences" tab
		25	1. Click on the "Change Password" button
		26	1. Enter the new password twice
		27	1. Click on the "Update" button(((
		28	{{image reference="ChangePassword.png"/}}
		29
		30	{{warning}}
		31	Don't forget to notify the user!
		32	{{/warning}}
		33	)))
		34
		35	== Changing the password for the logged in user ==
		36
		37	To change your own password follow these steps:
		38
		39	1. Click on your user name in the top right corner of the screen (this will redirect you to your profile)
		40	1. Click on the "Preferences" tab
		41	1. Click on the "Change password" button
		42	1. Enter your current password (only needed since XWiki 5.1) and the new password twice
		43	1. Click on the "Save" button(((
		44	{{image reference="ChangeOwnPassword.png"/}}
		45	)))
		46
		47	== Changing the password security policy ==
		48
		49	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.
		50
		51	{{image reference="password-policy-fields.png"/}}
		52
		53	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.
		54
		55	= Editing an existing user =
		56
		57	1. Log in as an administrator
		58	1. Hover over "Wiki" and click on "Administer Wiki"
		59	1. Click on the "Users" link to bring up an overview of all the users
		60	1. You have two options:
		61	11. Click the user name for the user you want to edit
		62	11*. On the user's profile page click on the small yellow pencil corresponding to the information you want to edit (profile or preferences)
		63	11*. Click "Save and View" to save the changes you have made
		64	11. 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)
		65	11*. Make your modifications and click "Save"(((
		66	{{info}}
		67	There is also a link to the complete user profile, where you can proceed as above (first option).
		68	{{/info}}
		69
		70	{{image reference="EditUserProfile.png" width="580px"/}}
		71	)))
		72
		73	= Disabling a user =
		74
		75	== From the administration ==
		76
		77	[[image:user_administration_disable_account.png\|\|height="271"]]
		78
		79	1. Log in as an administrator
		80	1. Go to the User section of the Wiki administration
		81	1. Click on the closed lock to disable a user
		82
		83	To enable a user, follow the same steps but click on the opened lock.
		84
		85	== From a user profile ==
		86
		87	[[image:user_profile_enabled_account.png\|\|height="415" width="960"]]
		88
		89	1. Login an an administrator
		90	1. Visit a user profile
		91	1. Click on the "Disable this account" action.
		92
		93	[[image:user_profile_disabled_account.png\|\|height="387" width="960"]]
		94
		95	To enable a user, follow the same step but click on the "Enable this account" action.
		96
		97	= Deleting a user =
		98
		99	1. Log in as an administrator
		100	1. Go to the User section of the Wiki administration
		101	1. 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)(((
		102	{{info}}
		103	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.
		104	{{/info}}
		105
		106	[[image:user_administration_disable_account.png\|\|height="271" width="960"]]
		107	)))
		108
		109	= Modify the number of users displayed in the list =
		110
		111	Edit the ##XWiki.AdminUsersSheet## page. It contains a line like this:
		112
		113	{{code}}
		114	var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback);
		115	{{/code}}
		116
		117	Replace it with:
		118
		119	{{code}}
		120	var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback, {limit: 100});
		121	{{/code}}
		122
		123	where ##100## is the number of items displayed per page.
		124
		125	= Customizing the Registration page =
		126
		127	Customizing the registration page is done by the "Verified Registration" Page, part of the [[Administration Application>>extensions:Extension.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>>extensions:Extension.Administration Application]].
		128
		129	In order to customize the registration page you must follow these steps:
		130
		131	1. Log in as an administrator
		132	1. Click on the right drawer icon, then click on "Administer Wiki"
		133	1. Go to "Users & Rights" > "Registration"
		134	1. Make your modifications and click "Save":(((
		135	{{image reference="Registration.png" width="960px"/}}
		136	)))
		137
		138	= Enable/Disable User Account =
		139
		140	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.
		141
		142	{{gallery}}
		143	image:disable-account.png
		144	image:enable-account.png
		145	image:account-disabled-warning.png
		146	{{/gallery}}
		147
		148	= Inactive Users =
		149
		150	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>>extensions:Extension.Administration Application]]).
		151
		152	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>>Documentation.AdminGuide.Configuration#HAllowedPagesforInactiveUsers]]. Prior to that, the ##Authentication Active Check## must be enabled in order for inactive users to get access to the wiki.
		153
		154	= User Storage =
		155
		156	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.