ilRbacSystem Class Reference

class ilRbacSystem system function like checkAccess, addActiveRole ... More...

Collaboration diagram for ilRbacSystem:

Public Member Functions
	checkAccess ($a_operations, $a_ref_id, $a_type="")
	checkAccess represents the main method of the RBAC-system in ILIAS3 developers want to use With this method you check the permissions a use may have due to its roles on an specific object.
	checkAccessOfUser ($a_user_id, $a_operations, $a_ref_id, $a_type="")
	checkPermission ($a_ref_id, $a_rol_id, $a_operation)
	check if a specific role has the permission '$a_operation' of an object public
	__filterOwnerPermissions ($a_user_id, $a_operations, $a_ref_id)
	initMemberView ()
	Init member view.

Static Public Member Functions
static	getInstance ()

Data Fields
	$ilias

Protected Member Functions
	ilRbacSystem ()
	Constructor public.

Protected Attributes
	$mem_view

Static Protected Attributes
static	$instance = null
static	$user_role_cache = array()

Private Member Functions
	fetchAssignedRoles ($a_usr_id, $a_ref_id)
	Fetch assigned roles This method caches the assigned roles per user.

Static Private Attributes
static	$_paCache = null
static	$_checkAccessOfUserCache = null

Detailed Description

class ilRbacSystem system function like checkAccess, addActiveRole ...

Supporting system functions are required for session management and in making access control decisions. This class depends on the session since we offer the possiblility to add or delete active roles during one session.

Author

Stefan Meyer smeye.nosp@m.r@da.nosp@m.tabay.nosp@m..de

Version

Id:

class.ilRbacSystem.php 22411 2009-11-25 10:41:22Z smeyer

Definition at line 36 of file class.ilRbacSystem.php.

Member Function Documentation

ilRbacSystem::__filterOwnerPermissions	(		$a_user_id,
			$a_operations,
			$a_ref_id
	)

Definition at line 286 of file class.ilRbacSystem.php.

Referenced by checkAccessOfUser().

        {
                global $ilObjDataCache,$ilUser;

                // member view constraints
                if($this->mem_view['active'] and $a_user_id == $ilUser->getId())
                {
                        if(in_array($a_ref_id, $this->mem_view['items']))
                        {
                                return $a_operations;
                        }
                }

                if($a_user_id != $ilObjDataCache->lookupOwner($ilObjDataCache->lookupObjId($a_ref_id)))
                {
                        return $a_operations;
                }
                // Is owner
                foreach(explode(",",$a_operations) as $operation)
                {
                        if($operation != 'cat_administrate_users' and $operation != 'edit_permission' and !preg_match('/^create/',$operation))
                        {
                                continue;
                        }
                        if(!strlen($new_ops))
                        {
                                $new_ops = $operation;
                        }
                        else
                        {
                                $new_ops .= (','.$operation);
                        }
                }
                return $new_ops;
                
                
        }

Here is the caller graph for this function:

ilRbacSystem::checkAccess	(		$a_operations,
			$a_ref_id,
			$a_type = ""
	)

checkAccess represents the main method of the RBAC-system in ILIAS3 developers want to use With this method you check the permissions a use may have due to its roles on an specific object.

The first parameter are the operation(s) the user must have The second & third parameter specifies the object where the operation(s) may apply to The last parameter is only required, if you ask for the 'create' operation. Here you specify the object type which you want to create.

example: $rbacSystem->checkAccess("visible,read",23); Here you ask if the user is allowed to see ('visible') and access the object by reading it ('read'). The reference_id is 23 in the tree structure.

public

Parameters

string	one or more operations, separated by commas (i.e.: visible,read,join)
integer	the child_id in tree (usually a reference_id, no object_id !!)
string	the type definition abbreviation (i.e.: frm,grp,crs)

Returns

boolean returns true if ALL passed operations are given, otherwise false

Definition at line 103 of file class.ilRbacSystem.php.

References $ilBench, $result, and checkAccessOfUser().

        {
                global $ilUser,$ilBench;
                
                $ilBench->start("RBAC", "system_checkAccess");

                $result = $this->checkAccessOfUser($ilUser->getId(), $a_operations, $a_ref_id, $a_type);

                $ilBench->stop("RBAC", "system_checkAccess");
                
                return $result;
        }

Here is the call graph for this function:

ilRbacSystem::checkAccessOfUser	(		$a_user_id,
			$a_operations,
			$a_ref_id,
			$a_type = ""
	)

Definition at line 116 of file class.ilRbacSystem.php.

References $GLOBALS, $ilDB, $ilLog, $q, $row, __filterOwnerPermissions(), ilRbacReview\_getOperationIdByName(), DB_FETCHMODE_OBJECT, fetchAssignedRoles(), and ilDB\query().

Referenced by checkAccess().

        {
                global $ilUser, $rbacreview,$ilObjDataCache,$ilDB,$ilLog;

                // Create the user cache key
                $cacheKey = $a_user_id.':'.$a_operations.':'.$a_ref_id.':'.$a_type;

                // Create the cache if it does not yet exist
                if (! is_array(self::$_checkAccessOfUserCache)) {
                        self::$_checkAccessOfUserCache = array();
                }
                
                // Try to return result from cache
                if (array_key_exists($cacheKey, self::$_checkAccessOfUserCache)) {
                        return self::$_checkAccessOfUserCache[$cacheKey];
                }

                #echo ++$counter;

                // DISABLED 
                // Check For owner
                // Owners do always have full access to their objects
                // Excluded are the permissions create and perm
                // This method call return all operations that are NOT granted by the owner status 
                if(!$a_operations = $this->__filterOwnerPermissions($a_user_id,$a_operations,$a_ref_id))
                {
                        // Store positive outcome in cache.
                        // Note: we only cache up to 1000 results to avoid memory overflows
                        if (count(self::$_checkAccessOfUserCache) < 1000) {
                                self::$_checkAccessOfUserCache[$cacheKey] = true;
                        }
                        return true;
                }

                
                // get roles using role cache
                $roles = $this->fetchAssignedRoles($a_user_id,$a_ref_id);
                
                // exclude system role from rbac
                if (in_array(SYSTEM_ROLE_ID, $roles))
                {
                        // Store positive outcome in cache.
                        // Note: we only cache up to 1000 results to avoid memory overflows
                        if (count(self::$_checkAccessOfUserCache) < 1000) {
                                self::$_checkAccessOfUserCache[$cacheKey] = true;
                        }
                        return true;            
                }

                if (!isset($a_operations) or !isset($a_ref_id))
                {
                        $GLOBALS['ilLog']->logStack();
                        $this->ilErr->raiseError(get_class($this)."::checkAccess(): Missing parameter! ".
                                                        "ref_id: ".$a_ref_id." operations: ".$a_operations,$this->ilErr->WARNING);
                }

                if (!is_string($a_operations))
                {
                        $GLOBALS['ilLog']->logStack();
                        $this->ilErr->raiseError(get_class($this)."::checkAccess(): Wrong datatype for operations!",$this->ilErr->WARNING);
                }

                // Create the PA cache if it does not exist yet
                $paCacheKey = $a_user_id.':'.$a_ref_id;
                if (! is_array(self::$_paCache)) {
            self::$_paCache = array();
        }

        if (array_key_exists($paCacheKey, self::$_paCache)) {
                        // Return result from PA cache
            $ops = self::$_paCache[$paCacheKey];
        } 
                else 
                {
                        // Data is not in PA cache, perform database query
                        $q = "SELECT * FROM rbac_pa ".
                                         "WHERE ref_id = ".$ilDB->quote($a_ref_id, 'integer');

                        $r = $this->ilDB->query($q);

                        $ops = array();

                        while ($row = $r->fetchRow(DB_FETCHMODE_OBJECT))
                        {
                                if (in_array($row->rol_id, $roles))
                                {
                                        $ops = array_merge($ops,unserialize(stripslashes($row->ops_id)));
                                }
                        }
                        // Cache up to 1000 entries in the PA cache
                        if (count(self::$_paCache) < 1000) 
                        {
                                self::$_paCache[$paCacheKey] = $ops;
                        }
        }

                $operations = explode(",",$a_operations);
                foreach ($operations as $operation)
                {
                        if ($operation == "create")
                        {
                                if (empty($a_type))
                                {
                                        $this->ilErr->raiseError(get_class($this)."::CheckAccess(): Expect a type definition for checking a 'create' permission",
                                                                                         $this->ilErr->WARNING);
                                }

                                $ops_id = ilRbacReview::_getOperationIdByName($operation."_".$a_type);
                        }
                        else
                        {
                                $ops_id = ilRbacReview::_getOperationIdByName($operation);
                        }
                        if (! in_array($ops_id,$ops)) 
                        {
                                //$ilLog->write('PERMISSION: '.$a_ref_id.' -> '.$a_ops_id.' failed');
                                // Store negative outcome in cache.
                                // Note: we only cache up to 1000 results to avoid memory overflows
                                if (count(self::$_checkAccessOfUserCache) < 1000) 
                                {
                                        self::$_checkAccessOfUserCache[$cacheKey] = false;
                                }
                                return false;
                        }
                }

                // Store positive outcome in cache.
                // Note: we only cache up to 1000 results to avoid memory overflows
                if (count(self::$_checkAccessOfUserCache) < 1000) 
                {
                        //$ilLog->write('PERMISSION: '.$a_ref_id.' -> '.$ops_id.' granted');
                        self::$_checkAccessOfUserCache[$cacheKey] = true;
                }
                return true;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilRbacSystem::checkPermission	(		$a_ref_id,
			$a_rol_id,
			$a_operation
	)

check if a specific role has the permission '$a_operation' of an object public

Parameters

integer	reference id of object
integer	role id
string	the permission to check

Returns

boolean

Definition at line 260 of file class.ilRbacSystem.php.

References $ilDB, $query, $res, and $row.

        {
                global $ilDB;
                
                $ops = array();

                $query = 'SELECT ops_id FROM rbac_operations '.
                        'WHERE operation = '.$ilDB->quote($a_operation,'text');
                $res = $ilDB->query($query);            
                while($row = $ilDB->fetchObject($res))
                {
                        $ops_id = $row->ops_id;
                }
        
                $query = "SELECT * FROM rbac_pa ".
                         "WHERE rol_id = ".$ilDB->quote($a_rol_id,'integer')." ".
                         "AND ref_id = ".$ilDB->quote($a_ref_id,'integer')." ";
                $res = $ilDB->query($query);            

                while($row = $ilDB->fetchObject($res))
                {
                        $ops = array_merge($ops,unserialize($row->ops_id));
                }
                return in_array($ops_id,$ops);
        }

ilRbacSystem::fetchAssignedRoles (   $a_usr_id,   $a_ref_id  )

private

Fetch assigned roles This method caches the assigned roles per user.

private

Parameters

int

user id

Definition at line 332 of file class.ilRbacSystem.php.

Referenced by checkAccessOfUser().

        {
                global $ilUser,$rbacreview;
                
                // Member view constraints
                if($this->mem_view['active'] and $a_usr_id == $ilUser->getId())
                {
                        // check if current ref_id is subitem of active container
                        if(in_array($a_ref_id, $this->mem_view['items']) and $this->mem_view['role'])
                        {
                                // Return default member role
                                return array($this->mem_view['role']);
                        }
                }

                if(isset(self::$user_role_cache[$a_usr_id]) and is_array(self::$user_role_cache))
                {
                        return self::$user_role_cache[$a_usr_id];
                }



                return self::$user_role_cache[$a_usr_id] = $rbacreview->assignedRoles($a_usr_id);
        }

Here is the caller graph for this function:

static ilRbacSystem::getInstance ( )

static

Definition at line 75 of file class.ilRbacSystem.php.

References $instance, and ilRbacSystem().

Referenced by ilInitialisation\initAccessHandling(), and initMemberView().

        {
                if(self::$instance)
                {
                        return self::$instance;
                }
                return self::$instance = new ilRbacSystem();
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilRbacSystem::ilRbacSystem ( )

protected

Constructor public.

Definition at line 55 of file class.ilRbacSystem.php.

References $ilDB, $ilErr, $ilias, and PEAR_ERROR_CALLBACK.

Referenced by getInstance().

        {
                global $ilDB,$ilErr,$ilias;

                $this->ilias =& $ilias;

                // set db & error handler
                (isset($ilDB)) ? $this->ilDB =& $ilDB : $this->ilDB =& $ilias->db;
                
                if (!isset($ilErr))
                {
                        $ilErr = new ilErrorHandling();
                        $ilErr->setErrorHandling(PEAR_ERROR_CALLBACK,array($ilErr,'errorHandler'));
                }
                else
                {
                        $this->ilErr =& $ilErr;
                }
        }

Here is the caller graph for this function:

ilRbacSystem::initMemberView

(

)

Init member view.

Returns

Definition at line 361 of file class.ilRbacSystem.php.

References $_GET, ilParticipants\getDefaultMemberRole(), and getInstance().

        {
                include_once './Services/Container/classes/class.ilMemberViewSettings.php';
                $settings = ilMemberViewSettings::getInstance();
                if($settings->isEnabled() and isset($_GET['mv']))
                {
                        $settings->toggleActivation((int) $_GET['ref_id'], (int) $_GET['mv']);
                }
                
                if(!$settings->isActive())
                {
                        $this->mem_view['active'] = false;
                        $this->mem_view['items'] = array();
                        $this->mem_view['role'] = 0;
                }
                else
                {
                        global $tree;
                        
                        $this->mem_view['active'] = true;
                        $this->mem_view['items'] = $tree->getSubTreeIds($settings->getContainer());
                        $this->mem_view['items'] = array_merge($this->mem_view['items'],array($settings->getContainer()));
                        include_once './Services/Membership/classes/class.ilParticipants.php';
                        $this->mem_view['role'] = ilParticipants::getDefaultMemberRole($settings->getContainer());
                        
                }
                return true;
        }

Here is the call graph for this function:

Field Documentation

ilRbacSystem::$_checkAccessOfUserCache = null

staticprivate

Definition at line 49 of file class.ilRbacSystem.php.

ilRbacSystem::$_paCache = null

staticprivate

Definition at line 46 of file class.ilRbacSystem.php.

ilRbacSystem::$ilias

Definition at line 43 of file class.ilRbacSystem.php.

Referenced by ilRbacSystem().

ilRbacSystem::$instance = null

staticprotected

Definition at line 38 of file class.ilRbacSystem.php.

Referenced by getInstance().

ilRbacSystem::$mem_view

protected

Definition at line 40 of file class.ilRbacSystem.php.

ilRbacSystem::$user_role_cache = array()

staticprotected

Definition at line 42 of file class.ilRbacSystem.php.

---

The documentation for this class was generated from the following file:

• Services/AccessControl/classes/class.ilRbacSystem.php