en:user:authentication
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
en:user:authentication [2018/08/27 00:14] – [Authentication in Greenstone] kjdon | en:user:authentication [2018/08/27 01:02] – kjdon | ||
---|---|---|---|
Line 3: | Line 3: | ||
A special type of user called an " | A special type of user called an " | ||
+ | |||
<TABAREA tabs=" | <TABAREA tabs=" | ||
Line 17: | Line 18: | ||
<TAB> | <TAB> | ||
<!-- id:582 -->To access this facility, click the appropriate link on the front page. | <!-- id:582 -->To access this facility, click the appropriate link on the front page. | ||
+ | |||
+ | </ | ||
<!-- id:583 -->The entry page gives information about each of the collections offered by the system. | <!-- id:583 -->The entry page gives information about each of the collections offered by the system. | ||
Line 33: | Line 36: | ||
- | ===== <!-- id:599 -->User management ===== | + | =====User management ===== |
- | <!-- id:600 -->Greenstone incorporates an authentication scheme which can be used to control | + | Greenstone incorporates an authentication scheme which can be used to control |
access to certain facilities. This is used to restrict the people | access to certain facilities. This is used to restrict the people | ||
who are allowed to access certain administration pages and allow for private collections/ | who are allowed to access certain administration pages and allow for private collections/ | ||
Line 41: | Line 44: | ||
Authentication is done by requesting a user name and password. | Authentication is done by requesting a user name and password. | ||
- | <!-- id:601 -->From the administration page users can be listed, | + | From the administration page users can be listed, |
new ones added, and old ones deleted. | new ones added, and old ones deleted. | ||
The ability to do this is of course also protected: | The ability to do this is of course also protected: | ||
Line 51: | Line 54: | ||
collections and alter (and delete) existing ones. | collections and alter (and delete) existing ones. | ||
- | <!-- id:602 -->When Greenstone is installed, there is one user called //admin// who belongs | + | When Greenstone is installed, there is one user called //admin// who belongs |
to both groups. The password for this user is set during the installation process (If you | to both groups. The password for this user is set during the installation process (If you | ||
did not set a password during installation, | did not set a password during installation, | ||
Line 60: | Line 63: | ||
the Greenstone file structure (see the // | the Greenstone file structure (see the // | ||
- | =====Forgotten Password===== | + | * [[en: |
- | (With instructions by Diego Spano.) | + | * [[en: |
+ | * | ||
+ | ===== Additional features | ||
- | User account details are stored | + | Once you have authenticated users, you can use features such as: |
+ | * [[en: | ||
+ | * [[en: | ||
- | There are several ways in which to reset your admin account' | ||
- | |||
- | **Option 1** | ||
- | |||
- | In greenstone/ | ||
- | |||
- | Do the following: | ||
- | |||
- | 1. Create a text file named myusers.csv and add the following line inside: | ||
- | < | ||
- | |||
- | 2. open a terminal | ||
- | |||
- | 3. move to Greenstone root folder. | ||
- | |||
- | 4. Run setup.bat (Windows) or setup.bash | ||
- | |||
- | 5. Run "perl -S csv-usernames-to-db.pl / | ||
- | |||
- | With this script you will create a user named Tom, with password " | ||
- | |||
- | **Option 2** | ||
- | |||
- | 1. If you're admin, then open a terminal. To set the admin password on Linux, you can run: | ||
- | < | ||
- | and on Windows: | ||
- | < | ||
- | |||
- | 2. If your admin account is working fine, then make sure you've enabled the Administration pages. You can do this by opening etc/ | ||
- | < | ||
- | to | ||
- | < | ||
- | |||
- | 3. Go to your Greenstone home page, click on the // | ||
- | |||
- | 4. Login with the admin account. Then select the user whose password you want to reset by pressing the Edit button and filling in the new details. | ||
- | |||
- | **Option 3** | ||
- | |||
- | Delete the file greenstone/ | ||
- | |||
- | |||
- | =====Password Protection===== | ||
- | |||
- | ==== Private Collections ==== | ||
- | This feature is not currently available through the Librarian Interface. Please close the collection if it is open in the Librarian Interface. Edit the GSDLHOME/ | ||
- | |||
- | | ||
- | | ||
- | |||
- | You may have to restart the Greenstone server for the changes to take effect. | ||
- | |||
- | The **auth_groups** line specifies the user group(s) which have access to the documents. To access a protected collection, a person must have a user name and password, and this user name must belong to one of the specified groups. See below for how to add new users and set their groups. | ||
- | |||
- | **IMPORTANT NOTE:** In Greenstone 2.82 and earlier, use **auth_group** instead of auth_groups (both will still be recognised in later Greenstone versions). | ||
- | ==== Private Documents ==== | ||
- | |||
- | It is possible to password-protect specific documents in your collection. | ||
- | This feature is not currently available through the Librarian Interface. Please close the collection if it is open in the Librarian Interface. Edit the GSDLHOME/ | ||
- | |||
- | | ||
- | | ||
- | |||
- | The **auth_groups** line specifies the user group(s) which have access to the documents. To access a protected collection, a person must have a user name and password, and this user name must belong to one of the specified groups. See below for how to add new users and set their groups. | ||
- | |||
- | **IMPORTANT NOTE:** In Greenstone 2.82 and earlier, use **auth_group** instead of auth_groups (both will still be recognised in later Greenstone versions). | ||
- | |||
- | Then add **either** of the following two lines: | ||
- | | ||
- | | ||
- | |||
- | These two lines specify a list of document identifiers (ex.Identifier in the Enrich pane). Using **private_documents**, | ||
- | |||
- | |||
- | =====Creating a new user===== | ||
- | |||
- | You need to use the administration facility. You can access the administration page by clicking the **Administration Page** button on the home page of your Greenstone installation. If this is not present, enable it by setting **status** to **enabled** in the GSDLHOME/ | ||
- | |||
- | From the administration page you can list users and add new users by clicking the links down the left hand side of the page. You will need to use the admin account that was set up when you installed Greenstone. | ||
- | |||
- | You can change the properties of an existing user by clicking the edit link from the list users page. | ||
- | |||
- | If you are adding users to access a protected collection, make sure you add the required group into the groups field. | ||
Line 157: | Line 81: | ||
You can find out what the cgi arguments mean by going to the Administration page of your Greenstone installation, | You can find out what the cgi arguments mean by going to the Administration page of your Greenstone installation, | ||
- | ===== User Comments ===== | ||
- | |||
- | If you enable comments for your library, library users with accounts are able to add comments | ||
- | to the document pages of collections. | ||
- | |||
- | To allow users to view and add comments to documents: | ||
- | - In the Format Features section of the Format pane of GLI, go to the Choose Feature dropdown and select AllowUserComments. | ||
- | - Press the Add Format button to add this to the list of active Format Features for your collection. | ||
- | - Select the AllowUserComments option that is now in the list and then tick its Enabled button to activate it. | ||
- | - Press the Preview button and visit a document of your collection. | ||
- | It should now provide a small "Add comment" | ||
Line 174: | Line 87: | ||
* The [[http:// | * The [[http:// | ||
- | </ | ||
en/user/authentication.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1