Abort and print when dependencies not met.
[ganeti_webmgr.git] / docs / source / usage / registration.rst
blobdb4905fbbc9af3ebe716826ed793472a0a9c7088
1 Open Registration
2 =================
4 Ganeti Web Manager versions 0.8 and above allow you to choose whether
5 users can create their own accounts, or need to be added by an
6 administrator.
8 The default setting for registration is open, which means that visitors
9 to your site's login page can follow a link from the login page to
10 create their own accounts.
12 .. figure:: /_static/registration-link.png
13    :align: center
15 The "Not a member?" link takes the user to the registration page:
17 .. figure:: /_static/registration-page-open.png
18    :align: center
20 The user is emailed a password and a confirmation link, then has an
21 account on your site. Users can also be added by a site admin by
22 selecting the users link in the admin toolbar, then using the Add User
23 button to reach the user creation form.
25 Closing Registration
26 --------------------
28 In some contexts, users should not be able to create their own accounts.
29 To implement this, simply change the ALLOW\_OPEN\_REGISTRATION setting
30 in your settings.py file to False:
33     # Whether users should be able to create their own accounts. 
34     # False if accounts can only be created by admins. 
35     ALLOW_OPEN_REGISTRATION = False
37 This setting is currently located near line 203, below the registration
38 email settings.
40 Result of closed registration
41 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
43 The "Not a member?" link is hidden from users on the login page. If they
44 navigate to the <SITE\_ROOT>/accounts/register page, they will see this
45 message instead of the account creation form:
47 .. figure:: /_static/closed-registration.png
48    :align: center