NAME

Apache::lonroles - User Roles Screen


SYNOPSIS

Invoked by /etc/httpd/conf/srm.conf:

 <Location /adm/roles>
 PerlAccessHandler       Apache::lonacc
 SetHandler perl-script
 PerlHandler Apache::lonroles
 ErrorDocument     403 /adm/login
 ErrorDocument    500 /adm/errorhandler
 </Location>


OVERVIEW

Choosing Roles

lonroles is a handler that allows a user to switch roles in mid-session. LON-CAPA attempts to work with ``No Role Specified'', the default role that a user has before selecting a role, as widely as possible, but certain handlers for example need specification which course they should act on, etc. Both in this scenario, and when the handler determines via lonnet's &allowed function that a certain action is not allowed, lonroles is used as error handler. This allows the user to select another role which may have permission to do what they were trying to do. lonroles can also be accessed via the CRS button in the Remote Control.

Role Initialization

The privileges for a user are established at login time and stored in the session environment. As a consequence, a new role does not become active till the next login. Handlers are able to query for privileges using lonnet's &allowed function. When a user first logs in, their role is the ``common'' role, which means that they have the sum of all of their privileges. During a session it might become necessary to choose a particular role, which as a consequence also limits the user to only the privileges in that particular role.


INTRODUCTION

This module enables a user to select what role he wishes to operate under (instructor, student, teaching assistant, course coordinator, etc). These roles are pre-established by the actions of upper-level users.

This is part of the LearningOnline Network with CAPA project described at http://www.lon-capa.org.


HANDLER SUBROUTINE

This routine is called by Apache and mod_perl.


NAME

Apache::lonroles - User Roles Screen


SYNOPSIS

Invoked by /etc/httpd/conf/srm.conf:

 <Location /adm/roles>
 PerlAccessHandler       Apache::lonacc
 SetHandler perl-script
 PerlHandler Apache::lonroles
 ErrorDocument     403 /adm/login
 ErrorDocument    500 /adm/errorhandler
 </Location>


OVERVIEW

Choosing Roles

lonroles is a handler that allows a user to switch roles in mid-session. LON-CAPA attempts to work with ``No Role Specified'', the default role that a user has before selecting a role, as widely as possible, but certain handlers for example need specification which course they should act on, etc. Both in this scenario, and when the handler determines via lonnet's &allowed function that a certain action is not allowed, lonroles is used as error handler. This allows the user to select another role which may have permission to do what they were trying to do. lonroles can also be accessed via the CRS button in the Remote Control.

Role Initialization

The privileges for a user are established at login time and stored in the session environment. As a consequence, a new role does not become active till the next login. Handlers are able to query for privileges using lonnet's &allowed function. When a user first logs in, their role is the ``common'' role, which means that they have the sum of all of their privileges. During a session it might become necessary to choose a particular role, which as a consequence also limits the user to only the privileges in that particular role.


INTRODUCTION

This module enables a user to select what role he wishes to operate under (instructor, student, teaching assistant, course coordinator, etc). These roles are pre-established by the actions of upper-level users.

This is part of the LearningOnline Network with CAPA project described at http://www.lon-capa.org.


HANDLER SUBROUTINE

This routine is called by Apache and mod_perl.