User Tools

Site Tools


en:user:authentication
This version is outdated by a newer approved version.DiffThis version (2018/08/27 01:00) is a draft.
Approvals: 0/1

This is an old revision of the document!


Authentication in Greenstone

The Greenstone software comes equipped with an authentication system. Users can "Register" in the system, and can then access protected parts of the library, such as remote collection editing, online document editing (greenstone 3) and protected collections.

A special type of user called an "administrator" is able to manage users. Anyone can register as a user, but only administrators can assign groups to that user. Groups control which collections/activities a user is allowed access to.

<TABAREA tabs="Greenstone3,Greenstone2"> <TAB> To access this facility, click the Login button in the upper right corner of the interface and enter your username and password (the default is "admin" and "admin").

For more information on security in Greenstone 3, refer to Security in Greenstone Collections </TAB> <TAB> To access this facility, click the appropriate link on the front page.

The entry page gives information about each of the collections offered by the system. Note that all collections are included—for there may be “private” ones that do not appear on the Greenstone home page. With each is given its short name, full name, whether it is publicly displayed, and whether or not it is running. Clicking a particular collection's abbreviation brings up information about that collection, gathered from its collection configuration file and from other internal structures created for that collection. If the collection is both public and running, clicking the collection's full name (the second link) takes you to the collection itself.

The administrative facility also presents configuration information about the installation and allows it to be modified. It facilitates examination of the error logs that record internal errors, and the user logs that record usage. It enables a specified user (or users) to authorize others to build collections and add new material to existing ones.

<!-- id:599 -->User management

Greenstone incorporates an authentication scheme which can be used to control access to certain facilities. This is used to restrict the people who are allowed to access certain administration pages and allow for private collections/documents.

Authentication is done by requesting a user name and password.

From the administration page users can be listed, new ones added, and old ones deleted. The ability to do this is of course also protected: only users who have administrative privileges can add new users. It is also possible for each user to belong to different “groups”. At present, the only extant groups are “administrator” and “colbuilder”. Members of the first group can add and remove users, and change their groups. Members of the second can access the facilities described above to build new collections and alter (and delete) existing ones.

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 did not set a password during installation, the admin login will default to username = admin, password = admin). This user can create new names and passwords for users who belong just to the colbuilder group, which is the recommended way of giving other users the ability to build collections. User information is recorded in two databases that are placed in the Greenstone file structure (see the Greenstone Digital Library Developer's Guide).

Additional features

Once you have authenticated users, you can use features such as:

  • User Comments - if this is enabled for a collection, logged in users can add comments to a document.
  • Online Document Editing - In greenstone 3 you can enable web editing for documents. Here authenticated users (with collection editing privileges) can modify the metadata or text content of a document.

Usage information

You can enable usage logging by setting the logcgiargs option to true in greenstone/etc/main.cfg. This saves a log in greenstone/etc/usage.txt. The log entry is basically a list of cgi arguments. One entry is generated for each page request to the library.

You can find out what the cgi arguments mean by going to the Administration page of your Greenstone installation, or from this page.

Additional Resources

</TAB></TABAREA>

en/user/authentication.1535331600.txt.gz · Last modified: 2018/08/27 01:00 (external edit)