=begin options

write = root

=end

=head1 PodWiki Authentication System

PodWiki supports basic authentication using cookies,
which are expiring after one day.

Each page can be protected separately for either reading
and/or writing. Permissions can be granted to one or more groups
of users or to one single user.

Each user can be a member of one or more groups.

The administrator can configure users and groups from the
B<SiteAdmin> page which appears if you are logged in as B<root>.

Users can also register themselfes from the login page.

Passwords are stored in encrypted form. So, if a user forgets
his password, you (root) have to change/reset it.

The user can also change his own password if he knows the
current password.

=head2 WRITE access

You can protect a page for writing which makes it possible to
have read-only pages. In this case just add an B<options> block
of the following form to the page to be protected:

 =begin options
 
 write = sales, orderadmin
 
 =end

In this example members of the groups 'sales' and 'orderadmin'
are able to modify the page in question.

You can also write protect a page for a single user:

 =begin options
 
 write = user:max
 
 =end

This allows the user 'max' to write the page only.


=head2 READ access

You can also restrict read access to a page, which makes it
possible to have "private" pages which are not visible to the
public.

You can configure this using this example:

 =begin options
 
 read = noc, support
 
 =end

In this case the protected page is only visible by 'noc' and
'support' members.

You can also read protect a page for a single user:

 =begin options
 
 read = user:max
 
 =end

This allows the user 'max' to read the page only.

=cut

