ilSoapUserAdministration Class Reference

Inheritance diagram for ilSoapUserAdministration:

Collaboration diagram for ilSoapUserAdministration:

Public Member Functions
	login (string $client, string $username, string $password)
	logout (string $sid)
	lookupUser (string $sid, string $user_name)
	importUsers (string $sid, int $folder_id, string $usr_xml, int $conflict_rule, bool $send_account_mail)
	getUsersForContainer (string $sid, int $ref_id, bool $attachRoles, int $active)
	getUserForRole (string $sid, int $role_id, bool $attachRoles, int $active)
	searchUser (string $sid, array $a_keyfields, string $query_operator, array $a_keyvalues, bool $attach_roles, int $active)
	return user xml following dtd 3.7 More...
	getUserXML (string $sid, array $a_user_ids, bool $attach_roles)
	hasNewMail (string $sid)
	getUserIdBySid (string $sid)
Public Member Functions inherited from ilSoapAdministration
	__construct (bool $use_nusoap=true)
	getMessage ()
	appendMessage (string $a_str)
	setMessageCode (string $a_code)
	getMessageCode ()
	reInitUser ()
	isFault ($object)
	getInstallationInfoXML ()
	getClientInfoXML (string $clientid)

Data Fields
const	USER_FOLDER_ID = 7
Data Fields inherited from ilSoapAdministration
const	NUSOAP = 1
const	PHP5 = 2
int	$error_method
	Defines type of error handling (PHP5 || NUSOAP) More...

Protected Member Functions
	isPermittedRole (int $a_folder, int $a_role)
Protected Member Functions inherited from ilSoapAdministration
	checkSession (string $sid)
	explodeSid (string $sid)
	setMessage (string $a_str)
	initAuth (string $sid)
	initIlias ()
	initAuthenticationObject ()
	raiseError (string $a_message, $a_code)
	checkObjectAccess (int $ref_id, array $expected_type, string $permission, bool $returnObject=false)
	check access for ref id: expected type, permission, return object instance if returnobject is true More...

Private Member Functions
	getImportProtocolAsXML (array $a_array)
	Create XML ResultSet. More...
	getUserMappingAsXML (array $a_array)
	return user mapping as xml More...
	buildSearchQuery (array $a_keyfields, string $queryOperator, array $a_keyvalues)
	create search term according to parameters More...

Additional Inherited Members
Protected Attributes inherited from ilSoapAdministration
bool	$soap_check = true
string	$message = ''
string	$message_code = ''

Detailed Description

Definition at line 26 of file class.ilSoapUserAdministration.php.

Member Function Documentation

buildSearchQuery()

ilSoapUserAdministration::buildSearchQuery ( array  $a_keyfields, string  $queryOperator, array  $a_keyvalues  )

private

create search term according to parameters

Definition at line 722 of file class.ilSoapUserAdministration.php.

                                                                                                    : string
    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        $query = array();
 
        $allowed_fields = array("firstname",
                                "lastname",
                                "email",
                                "login",
                                "matriculation",
                                "institution",
                                "department",
                                "title",
                                "ext_account"
        );
 
        foreach ($a_keyfields as $keyfield) {
            $keyfield = strtolower($keyfield);
 
            if (!in_array($keyfield, $allowed_fields)) {
                continue;
            }
 
            $field_query = array();
            foreach ($a_keyvalues as $keyvalue) {
                if (strlen($keyvalue) >= 3) {
                    $field_query [] = $ilDB->like($ilDB->quoteIdentifier($keyfield), 'text', '%' . $keyvalue . "%");
                }
            }
            if (count($field_query)) {
                $query [] = implode(" " . strtoupper($queryOperator) . " ", $field_query);
            }
        }
 
        return count($query) ? " AND ((" . implode(") OR (", $query) . "))" : "AND 0";
    }

References $DIC, and $ilDB.

Referenced by searchUser().

Here is the caller graph for this function:

getImportProtocolAsXML()

ilSoapUserAdministration::getImportProtocolAsXML ( array  $a_array )

private

Create XML ResultSet.

Definition at line 576 of file class.ilSoapUserAdministration.php.

                                                           : string
    {
        $xmlResultSet = new ilXMLResultSet();
        $xmlResultSet->addColumn("userid");
        $xmlResultSet->addColumn("login");
        $xmlResultSet->addColumn("action");
        $xmlResultSet->addColumn("message");
 
        foreach ($a_array as $username => $messages) {
            foreach ($messages as $message) {
                $xmlRow = new ilXMLResultSetRow();
                $xmlRow->setValue(0, 0);
                $xmlRow->setValue(1, $username);
                $xmlRow->setValue(2, "");
                $xmlRow->setValue(3, $message);
 
                $xmlResultSet->addRow($xmlRow);
            }
        }
 
        $xml_writer = new ilXMLResultSetWriter($xmlResultSet);
 
        if ($xml_writer->start()) {
            return $xml_writer->getXML();
        }
 
        return $this->raiseError('Error in __getImportProtocolAsXML', 'Server');
    }

References ilSoapAdministration\$message, and ilSoapAdministration\raiseError().

Referenced by importUsers().

Here is the call graph for this function:

Here is the caller graph for this function:

getUserForRole()

ilSoapUserAdministration::getUserForRole	(	string	$sid,
		int	$role_id,
		bool	$attachRoles,
		int	$active
	)

Returns

soap_fault|SoapFault|string|null

Definition at line 503 of file class.ilSoapUserAdministration.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        $rbacreview = $DIC->rbac()->review();
        $tree = $DIC->repositoryTree();
        $ilUser = $DIC->user();
        $access = $DIC->access();
 
        $global_roles = $rbacreview->getGlobalRoles();
 
        if (in_array($role_id, $global_roles, true)) {
            // global roles
            if ($role_id === SYSTEM_ROLE_ID &&
                !in_array(SYSTEM_ROLE_ID, $rbacreview->assignedRoles($ilUser->getId()), true)) {
                return $this->raiseError("Role access not permitted. ($role_id)", "Server");
            }
        } else {
            // local roles
            $rolfs = $rbacreview->getFoldersAssignedToRole($role_id, true);
            $access_granted = true;
            foreach ($rolfs as $rolf) {
                if ($tree->isDeleted($rolf)) {
                    $access_granted = false;
                }
                $type = \ilObject::_lookupType($rolf, true);
                switch ($type) {
                    case 'crs':
                    case 'grp':
                        if (!$access->checkAccess('manage_members', '', $rolf)) {
                            $access_granted = false;
                        }
                        break;
                    default:
                        if (!$access->checkAccess('edit_permission', '', $rolf)) {
                            $access_granted = false;
                        }
                        break;
                }
            }
            // read user data must be granted
            if (!$access->checkAccess('read_users', '', self::USER_FOLDER_ID)) {
                $access_granted = false;
            }
            if (!$access_granted || !count($rolfs)) {
                return $this->raiseError('Role access not permitted. ' . '(' . $role_id . ')', 'Server');
            }
        }
 
        $data = ilObjUser::_getUsersForRole($role_id, $active);
 
        $xmlWriter = new ilUserXMLWriter();
        $xmlWriter->setAttachRoles($attachRoles);
 
        $xmlWriter->setObjects($data);
 
        if ($xmlWriter->start()) {
            return $xmlWriter->getXML();
        }
        return $this->raiseError('Error in getUsersForRole', 'Server');
    }

References $data, $DIC, $ilDB, ilObjUser\_getUsersForRole(), ilObject\_lookupType(), ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), ilSoapAdministration\raiseError(), SYSTEM_ROLE_ID, and USER_FOLDER_ID.

Here is the call graph for this function:

getUserIdBySid()

ilSoapUserAdministration::getUserIdBySid

(

string

$sid

)

Returns

int|soap_fault|SoapFault|null

Definition at line 825 of file class.ilSoapUserAdministration.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        $parts = explode('::', $sid);
        $query = "SELECT usr_id FROM usr_session "
            . "INNER JOIN usr_data ON usr_id = user_id WHERE session_id = %s";
        $res = $ilDB->queryF($query, array('text'), array($parts[0]));
        $data = $ilDB->fetchAssoc($res);
 
        if (!(int) $data['usr_id']) {
            $this->raiseError('User does not exist', 'Client');
        }
        return (int) $data['usr_id'];
    }

References $data, $DIC, $ilDB, $parts, $res, ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), and ilSoapAdministration\raiseError().

Here is the call graph for this function:

getUserMappingAsXML()

ilSoapUserAdministration::getUserMappingAsXML ( array  $a_array )

private

return user mapping as xml

Parameters

array

(user_id => login) $a_array

Definition at line 609 of file class.ilSoapUserAdministration.php.

    {
        $xmlResultSet = new ilXMLResultSet();
        $xmlResultSet->addColumn("userid");
        $xmlResultSet->addColumn("login");
        $xmlResultSet->addColumn("action");
        $xmlResultSet->addColumn("message");
 
        if (count($a_array)) {
            foreach ($a_array as $username => $message) {
                $xmlRow = new ilXMLResultSetRow();
                $xmlRow->setValue(0, $username);
                $xmlRow->setValue(1, $message["login"]);
                $xmlRow->setValue(2, $message["action"]);
                $xmlRow->setValue(3, $message["message"]);
 
                $xmlResultSet->addRow($xmlRow);
            }
        }
 
        $xml_writer = new ilXMLResultSetWriter($xmlResultSet);
 
        if ($xml_writer->start()) {
            return $xml_writer->getXML();
        }
 
        return $this->raiseError('Error in __getUserMappingAsXML', 'Server');
    }

References ilSoapAdministration\$message, and ilSoapAdministration\raiseError().

Referenced by importUsers().

Here is the call graph for this function:

Here is the caller graph for this function:

getUsersForContainer()

ilSoapUserAdministration::getUsersForContainer	(	string	$sid,
		int	$ref_id,
		bool	$attachRoles,
		int	$active
	)

Returns

ilObject|mixed|soap_fault|SoapFault|string|null

Definition at line 420 of file class.ilSoapUserAdministration.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        $tree = $DIC['tree'];
        $rbacreview = $DIC['rbacreview'];
        $rbacsystem = $DIC['rbacsystem'];
        $access = $DIC->access();
 
        if ($ref_id === -1) {
            $ref_id = self::USER_FOLDER_ID;
        }
 
        if (
            $ref_id === self::USER_FOLDER_ID &&
            !$access->checkAccess('read_users', '', self::USER_FOLDER_ID)
        ) {
            return $this->raiseError('Access denied', "Client");
        }
 
        $object = $this->checkObjectAccess($ref_id, array("crs", "cat", "grp", "usrf", "sess"), "read", true);
        if ($this->isFault($object)) {
            return $object;
        }
 
        $data = [];
        switch ($object->getType()) {
            case "usrf":
                $data = ilObjUser::_getUsersForFolder(self::USER_FOLDER_ID, $active);
                break;
            case "cat":
                $data = ilObjUser::_getUsersForFolder($ref_id, $active);
                break;
            case "crs":
                {
                    // GET ALL MEMBERS
                    $roles = $object->__getLocalRoles();
 
                    foreach ($roles as $role_id) {
                        $data = array_merge($rbacreview->assignedUsers($role_id), $data);
                    }
 
                    break;
                }
            case "grp":
                $member_ids = $object->getGroupMemberIds();
                $data = ilObjUser::_getUsersForGroup($member_ids, $active);
                break;
            case "sess":
                $course_ref_id = $tree->checkForParentType($ref_id, 'crs');
                if (!$course_ref_id) {
                    return $this->raiseError("No course for session", "Client");
                }
 
                $event_obj_id = ilObject::_lookupObjId($ref_id);
                $event_part = new ilEventParticipants($event_obj_id);
                $member_ids = array_keys($event_part->getParticipants());
                $data = ilObjUser::_getUsersForIds($member_ids, $active);
                break;
        }
 
        $xmlWriter = new ilUserXMLWriter();
        $xmlWriter->setObjects($data);
        $xmlWriter->setAttachRoles($attachRoles);
 
        if ($xmlWriter->start()) {
            return $xmlWriter->getXML();
        }
        // @todo for backward compatibility
        return '';
    }

References $data, $DIC, $ilDB, $ref_id, ilObjUser\_getUsersForFolder(), ilObjUser\_getUsersForGroup(), ilObjUser\_getUsersForIds(), ilObject\_lookupObjId(), ilSoapAdministration\checkObjectAccess(), ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), ilSoapAdministration\isFault(), ilSoapAdministration\raiseError(), USER_FOLDER_ID, and USER_FOLDER_ID.

Here is the call graph for this function:

getUserXML()

ilSoapUserAdministration::getUserXML	(	string	$sid,
		array	$a_user_ids,
		bool	$attach_roles
	)

Returns

soap_fault|SoapFault|string|null

Definition at line 764 of file class.ilSoapUserAdministration.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        global $DIC;
 
        $rbacsystem = $DIC['rbacsystem'];
        $access = $DIC->access();
        $ilUser = $DIC['ilUser'];
        $ilDB = $DIC['ilDB'];
 
        // check if own account
        $is_self = false;
        if (count($a_user_ids) === 1) {
            $usr_id = (int) end($a_user_ids);
            if ($usr_id === $ilUser->getId()) {
                $is_self = true;
            }
        }
 
        if (!$is_self && !$access->checkAccess('read_users', '', self::USER_FOLDER_ID)) {
            return $this->raiseError('Check access failed.', 'Server');
        }
 
        $data = ilObjUser::_getUserData($a_user_ids);
 
        $xmlWriter = new ilUserXMLWriter();
        $xmlWriter->setAttachRoles($attach_roles);
        $xmlWriter->setObjects($data);
 
        if ($xmlWriter->start()) {
            return $xmlWriter->getXML();
        }
 
        return $this->raiseError('User does not exist', 'Client');
    }

References $data, $DIC, $ilDB, ilObjUser\_getUserData(), ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), ILIAS\Repository\int(), ilSoapAdministration\raiseError(), and USER_FOLDER_ID.

Here is the call graph for this function:

hasNewMail()

ilSoapUserAdministration::hasNewMail

(

string

$sid

)

Definition at line 806 of file class.ilSoapUserAdministration.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        global $DIC;
 
        $ilUser = $DIC['ilUser'];
 
        return ilMailGlobalServices::getNewMailsData($ilUser)['count'] > 0;
    }

References $DIC, ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilMailGlobalServices\getNewMailsData(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), and ilSoapAdministration\raiseError().

Here is the call graph for this function:

importUsers()

ilSoapUserAdministration::importUsers	(	string	$sid,
		int	$folder_id,
		string	$usr_xml,
		int	$conflict_rule,
		bool	$send_account_mail
	)

Returns

soap_fault|SoapFault|string|null

Definition at line 138 of file class.ilSoapUserAdministration.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        global $DIC;
 
        $rbacreview = $DIC['rbacreview'];
        $rbacsystem = $DIC['rbacsystem'];
        $access = $DIC->access();
        $tree = $DIC['tree'];
        $lng = $DIC['lng'];
        $ilUser = $DIC['ilUser'];
        $ilLog = $DIC['ilLog'];
 
        // validate to prevent wrong XMLs
        $usr_xml = ltrim($usr_xml); // Remove leading whitespace (including BOM if needed)
 
        $doc = new DOMDocument();
        libxml_use_internal_errors(true); // Capture parsing errors
 
        $is_loadable = $doc->loadXML($usr_xml);
        $errors = libxml_get_errors();
        libxml_clear_errors();
 
        if (!$is_loadable) {
            $msg = [];
            foreach ($errors as $err) {
                $msg[] = "(" . $err->line . "," . $err->column . "): " . trim($err->message);
            }
            libxml_clear_errors();
            $msg = implode("\n", $msg);
            return $this->raiseError($msg, "Client");
        }
 
        switch ($conflict_rule) {
            case 2:
                $conflict_rule = ilUserImportParser::IL_UPDATE_ON_CONFLICT;
                break;
            case 3:
                $conflict_rule = ilUserImportParser::IL_IGNORE_ON_CONFLICT;
                break;
            default:
                $conflict_rule = ilUserImportParser::IL_FAIL_ON_CONFLICT;
        }
        if ($folder_id === 0 && !$access->checkAccess('create_usr', '', self::USER_FOLDER_ID)) {
            return $this->raiseError(
                'Missing permission for creating/modifying users accounts' . self::USER_FOLDER_ID . ' ' . $ilUser->getId(),
                'Server'
            );
        }
 
        // folder id 0, means to check permission on user basis!
        // must have create user right in time_limit_owner property (which is ref_id of container)
        if ($folder_id !== 0) {
            // determine where to import
            if ($folder_id === -1) {
                $folder_id = self::USER_FOLDER_ID;
            }
 
            // get folder
            $import_folder = ilObjectFactory::getInstanceByRefId($folder_id, false);
            // id does not exist
            if (!$import_folder) {
                return $this->raiseError('Wrong reference id.', 'Server');
            }
 
            // folder is not a folder, can also be a category
            if ($import_folder->getType() !== "usrf" && $import_folder->getType() !== "cat") {
                return $this->raiseError('Folder must be a usr folder or a category.', 'Server');
            }
 
            // check access to folder
            if (!$rbacsystem->checkAccess('create_usr', $folder_id)) {
                return $this->raiseError(
                    'Missing permission for creating users within ' . $import_folder->getTitle(),
                    'Server'
                );
            }
        }
 
        // first verify
        $importParser = new ilUserImportParser("", ilUserImportParser::IL_VERIFY, $conflict_rule);
        $importParser->setUserMappingMode(ilUserImportParser::IL_USER_MAPPING_ID);
        $importParser->setXMLContent($usr_xml);
        $importParser->startParsing();
 
        switch ($importParser->getErrorLevel()) {
            case ilUserImportParser::IL_IMPORT_SUCCESS:
                break;
            case ilUserImportParser::IL_IMPORT_WARNING:
                return $this->getImportProtocolAsXML($importParser->getProtocol());
                break;
            case ilUserImportParser::IL_IMPORT_FAILURE:
                return $this->getImportProtocolAsXML($importParser->getProtocol());
        }
 
        // verify is ok, so get role assignments
 
        $importParser = new ilUserImportParser("", ilUserImportParser::IL_EXTRACT_ROLES, $conflict_rule);
        $importParser->setXMLContent($usr_xml);
        $importParser->setUserMappingMode(ilUserImportParser::IL_USER_MAPPING_ID);
        $importParser->startParsing();
 
        $roles = $importParser->getCollectedRoles();
 
        //print_r($roles);
 
        // roles to be assigned, skip if one is not allowed!
        $permitted_roles = array();
        foreach ($roles as $role_id => $role) {
            if (!is_numeric($role_id)) {
                // check if internal id
                $internalId = ilUtil::__extractId($role_id, IL_INST_ID);
 
                if (is_numeric($internalId) && $internalId > 0) {
                    $role_id = $internalId;
                    $role_name = $role_id;
                }
            }
 
            if ($this->isPermittedRole($folder_id, $role_id)) {
                $permitted_roles[$role_id] = $role_id;
            } else {
                $role_name = ilObject::_lookupTitle($role_id);
                return $this->raiseError(
                    "Could not find role " . $role_name . ". Either you use an invalid/deleted role " .
                    "or you try to assign a local role into the non-standard user folder and this role is not in its subtree.",
                    'Server'
                );
            }
        }
 
        $global_roles = $rbacreview->getGlobalRoles();
 
        //print_r ($global_roles);
 
        foreach ($permitted_roles as $role_id => $role_name) {
            if ($role_id != "") {
                if (in_array($role_id, $global_roles)) {
                    if (
                        (
                            $folder_id !== 0 &&
                            $folder_id !== self::USER_FOLDER_ID &&
                            !ilObjRole::_getAssignUsersStatus($role_id)
                        ) ||
                        (
                            $role_id == SYSTEM_ROLE_ID &&
                            !in_array(SYSTEM_ROLE_ID, $rbacreview->assignedRoles($ilUser->getId()), true)
                        )
                    ) {
                        return $this->raiseError(
                            $lng->txt("usrimport_with_specified_role_not_permitted") . " $role_name ($role_id)",
                            'Server'
                        );
                    }
                } else {
                    $rolf = $rbacreview->getFoldersAssignedToRole($role_id, true);
                    if ($rbacreview->isDeleted($rolf[0])
                        || !$rbacsystem->checkAccess('write', $rolf[0])) {
                        return $this->raiseError(
                            $lng->txt("usrimport_with_specified_role_not_permitted") . " $role_name ($role_id)",
                            "Server"
                        );
                    }
                }
            }
        }
 
        //print_r ($permitted_roles);
 
        $importParser = new ilUserImportParser("", ilUserImportParser::IL_USER_IMPORT, $conflict_rule);
        $importParser->setSendMail($send_account_mail);
        $importParser->setUserMappingMode(ilUserImportParser::IL_USER_MAPPING_ID);
        $importParser->setFolderId($folder_id);
        $importParser->setXMLContent($usr_xml);
 
        $importParser->setRoleAssignment($permitted_roles);
 
        $importParser->startParsing();
 
        if ($importParser->getErrorLevel() !== ilUserImportParser::IL_IMPORT_FAILURE) {
            return $this->getUserMappingAsXML($importParser->getUserMapping());
        }
        return $this->getImportProtocolAsXML($importParser->getProtocol());
    }

References $DIC, $lng, ilUtil\__extractId(), ilObjRole\_getAssignUsersStatus(), ilObject\_lookupTitle(), ilSoapAdministration\checkSession(), getImportProtocolAsXML(), ilObjectFactory\getInstanceByRefId(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), getUserMappingAsXML(), ilUserImportParser\IL_EXTRACT_ROLES, ilUserImportParser\IL_FAIL_ON_CONFLICT, ilUserImportParser\IL_IGNORE_ON_CONFLICT, ilUserImportParser\IL_IMPORT_FAILURE, ilUserImportParser\IL_IMPORT_SUCCESS, ilUserImportParser\IL_IMPORT_WARNING, IL_INST_ID, ilUserImportParser\IL_UPDATE_ON_CONFLICT, ilUserImportParser\IL_USER_IMPORT, ilUserImportParser\IL_USER_MAPPING_ID, ilUserImportParser\IL_VERIFY, ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), isPermittedRole(), ilSoapAdministration\raiseError(), SYSTEM_ROLE_ID, USER_FOLDER_ID, and USER_FOLDER_ID.

Here is the call graph for this function:

isPermittedRole()

ilSoapUserAdministration::isPermittedRole ( int  $a_folder, int  $a_role  )

protected

Definition at line 329 of file class.ilSoapUserAdministration.php.

    {
        static $checked_roles = array();
        static $global_roles = null;
 
        if (isset($checked_roles[$a_role])) {
            return $checked_roles[$a_role];
        }
 
        global $DIC;
 
        $rbacsystem = $DIC['rbacsystem'];
        $rbacreview = $DIC['rbacreview'];
        $ilUser = $DIC['ilUser'];
        $tree = $DIC['tree'];
        $ilLog = $DIC['ilLog'];
 
        $locations = $rbacreview->getFoldersAssignedToRole($a_role, true);
        $location = $locations[0];
 
        // global role
        if ($location == ROLE_FOLDER_ID) {
            $ilLog->write(__METHOD__ . ': Check global role');
            // check assignment permission if called from local admin
 
            if ($a_folder !== self::USER_FOLDER_ID && $a_folder !== 0) {
                $ilLog->write(__METHOD__ . ': ' . $a_folder);
                if (!ilObjRole::_getAssignUsersStatus($a_role)) {
                    $ilLog->write(__METHOD__ . ': No assignment allowed');
                    $checked_roles[$a_role] = false;
                    return false;
                }
            }
            // exclude anonymous role from list
            if ($a_role === ANONYMOUS_ROLE_ID) {
                $ilLog->write(__METHOD__ . ': Anonymous role chosen.');
                $checked_roles[$a_role] = false;
                return false;
            }
            // do not allow to assign users to administrator role if current user does not has SYSTEM_ROLE_ID
            if ($a_role === SYSTEM_ROLE_ID &&
                !in_array(SYSTEM_ROLE_ID, $rbacreview->assignedRoles($ilUser->getId()), true)) {
                $ilLog->write(__METHOD__ . ': System role assignment forbidden.');
                $checked_roles[$a_role] = false;
                return false;
            }
 
            // Global role assignment ok
            $ilLog->write(__METHOD__ . ': Assignment allowed.');
            $checked_roles[$a_role] = true;
            return true;
        } elseif ($location) {
            $ilLog->write(__METHOD__ . ': Check local role.');
 
            // It's a local role
            $rolfs = $rbacreview->getFoldersAssignedToRole($a_role, true);
            $rolf = $rolfs[0];
 
            // only process role folders that are not set to status "deleted"
            // and for which the user has write permissions.
            // We also don't show the roles which are in the ROLE_FOLDER_ID folder.
            // (The ROLE_FOLDER_ID folder contains the global roles).
            if ($rbacreview->isDeleted($rolf)
                || !$rbacsystem->checkAccess('edit_permission', $rolf)) {
                $ilLog->write(__METHOD__ . ': Role deleted or no permission.');
                $checked_roles[$a_role] = false;
                return false;
            }
            // A local role is only displayed, if it is contained in the subtree of
            // the localy administrated category. If the import function has been
            // invoked from the user folder object, we show all local roles, because
            // the user folder object is considered the parent of all local roles.
            // Thus, if we start from the user folder object, we initializ$isInSubtree = $folder_id == USER_FOLDER_ID || $folder_id == 0;e the
            // isInSubtree variable with true. In all other cases it is initialized
            // with false, and only set to true if we find the object id of the
            // locally administrated category in the tree path to the local role.
            if ($a_folder !== self::USER_FOLDER_ID && $a_folder !== 0 && !$tree->isGrandChild($a_folder, $rolf)) {
                $ilLog->write(__METHOD__ . ': Not in path of category.');
                $checked_roles[$a_role] = false;
                return false;
            }
            $ilLog->write(__METHOD__ . ': Assignment allowed.');
            $checked_roles[$a_role] = true;
            return true;
        }
        return false;
    }

References $DIC, $location, ilObjRole\_getAssignUsersStatus(), ANONYMOUS_ROLE_ID, ROLE_FOLDER_ID, SYSTEM_ROLE_ID, and USER_FOLDER_ID.

Referenced by importUsers().

Here is the call graph for this function:

Here is the caller graph for this function:

login()

ilSoapUserAdministration::login	(	string	$client,
		string	$username,
		string	$password
	)

Returns

soap_fault|SoapFault|string|null

Definition at line 33 of file class.ilSoapUserAdministration.php.

    {
        unset($_COOKIE[session_name()]);
        $_COOKIE['ilClientId'] = $client;
 
        try {
            $this->initIlias();
        } catch (Exception $e) {
            return $this->raiseError($e->getMessage(), 'Server');
        }
 
        // now try authentication
        $credentials = new ilAuthFrontendCredentials();
        $credentials->setUsername($username);
        $credentials->setPassword($password);
 
        $provider_factory = new ilAuthProviderFactory();
        $providers = $provider_factory->getProviders($credentials);
 
        $status = ilAuthStatus::getInstance();
 
        $frontend_factory = new ilAuthFrontendFactory();
        $frontend_factory->setContext(ilAuthFrontendFactory::CONTEXT_WS);
        $frontend = $frontend_factory->getFrontend(
            $GLOBALS['DIC']['ilAuthSession'],
            $status,
            $credentials,
            $providers
        );
 
        $frontend->authenticate();
 
        switch ($status->getStatus()) {
            case ilAuthStatus::STATUS_AUTHENTICATED:
                ilLoggerFactory::getLogger('auth')->debug('Authentication successful.');
                return $GLOBALS['DIC']['ilAuthSession']->getId() . '::' . $client;
 
            default:
            case ilAuthStatus::STATUS_AUTHENTICATION_FAILED:
                return $this->raiseError(
                    $status->getReason(),
                    'Server'
                );
        }
    }

References $_COOKIE, $client, Vendor\Package\$e, $GLOBALS, ilAuthFrontendFactory\CONTEXT_WS, ilAuthStatus\getInstance(), ilLoggerFactory\getLogger(), ilSoapAdministration\initIlias(), ilSoapAdministration\raiseError(), ilAuthStatus\STATUS_AUTHENTICATED, and ilAuthStatus\STATUS_AUTHENTICATION_FAILED.

Here is the call graph for this function:

logout()

ilSoapUserAdministration::logout

(

string

$sid

)

Returns

bool|soap_fault|SoapFault|null

Definition at line 82 of file class.ilSoapUserAdministration.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        ilSession::setClosingContext(ilSession::SESSION_CLOSE_USER);
        $GLOBALS['DIC']['ilAuthSession']->logout();
        return true;
    }

References $GLOBALS, ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), ilSoapAdministration\raiseError(), ilSession\SESSION_CLOSE_USER, and ilSession\setClosingContext().

Here is the call graph for this function:

lookupUser()

ilSoapUserAdministration::lookupUser	(	string	$sid,
		string	$user_name
	)

Returns

int|soap_fault|SoapFault|null

Definition at line 99 of file class.ilSoapUserAdministration.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        $user_name = trim($user_name);
 
        if ($user_name === '') {
            return $this->raiseError('No username given. Aborting', 'Client');
        }
 
        global $DIC;
 
        $ilUser = $DIC->user();
        $access = $DIC->access();
 
        if (
            strcasecmp($ilUser->getLogin(), $user_name) !== 0 &&
            !$access->checkAccess(
                'read_users',
                '',
                self::USER_FOLDER_ID
            )
        ) {
            return $this->raiseError('Check access failed. ' . self::USER_FOLDER_ID, 'Server');
        }
 
        $user_id = ilObjUser::getUserIdByLogin($user_name);
 
        return $user_id;
    }

References $DIC, $user_id, ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilObjUser\getUserIdByLogin(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), ilSoapAdministration\raiseError(), and USER_FOLDER_ID.

Here is the call graph for this function:

searchUser()

ilSoapUserAdministration::searchUser	(	string	$sid,
		array	$a_keyfields,
		string	$query_operator,
		array	$a_keyvalues,
		bool	$attach_roles,
		int	$active
	)

return user xml following dtd 3.7

Parameters

string	$sid	session id
array	$a_keyfields	array of user fieldname, following dtd 3.7
string	$queryOperator	any logical operator
array	$a_keyValues	values separated by space, at least 3 chars per search term
	bool
	int

Returns

soap_fault|SoapFault|null|string

Definition at line 648 of file class.ilSoapUserAdministration.php.

      {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        $access = $DIC->access();
 
        if (!$access->checkAccess('read_users', '', self::USER_FOLDER_ID)) {
            return $this->raiseError('Check access failed.', 'Server');
        }
        if (!count($a_keyfields)) {
            $this->raiseError('At least one keyfield is needed', 'Client');
        }
 
        if (!count($a_keyvalues)) {
            $this->raiseError('At least one keyvalue is needed', 'Client');
        }
 
        if (strcasecmp($query_operator, "and") !== 0 || strcasecmp($query_operator, "or") !== 0) {
            $this->raiseError('Query operator must be either \'and\' or \'or\'', 'Client');
        }
 
        $query = $this->buildSearchQuery($a_keyfields, $query_operator, $a_keyvalues);
 
        $query = "SELECT usr_data.*, usr_pref.value AS language
                          FROM usr_data
                          LEFT JOIN usr_pref
                          ON usr_pref.usr_id = usr_data.usr_id AND usr_pref.keyword = " .
            $ilDB->quote("language", "text") .
            "  WHERE 1 = 1 " . $query;
 
        if ($active > -1) {
            $query .= " AND active = " . $ilDB->quote($active);
        }
 
        $query .= " ORDER BY usr_data.lastname, usr_data.firstname ";
 
        //echo $query;
 
        $r = $ilDB->query($query);
 
        $data = array();
 
        while ($row = $ilDB->fetchAssoc($r)) {
            $data[] = $row;
        }
 
        $xmlWriter = new ilUserXMLWriter();
        $xmlWriter->setAttachRoles($attach_roles);
 
        $xmlWriter->setObjects($data);
 
        if ($xmlWriter->start()) {
            return $xmlWriter->getXML();
        }
        return $this->raiseError('Error in searchUser', 'Server');
    }

References $data, $DIC, $ilDB, buildSearchQuery(), ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), ilSoapAdministration\raiseError(), and USER_FOLDER_ID.

Here is the call graph for this function:

Field Documentation

USER_FOLDER_ID

const ilSoapUserAdministration::USER_FOLDER_ID = 7

Definition at line 28 of file class.ilSoapUserAdministration.php.

Referenced by getUsersForContainer(), and importUsers().

---

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

• components/ILIAS/soap/classes/class.ilSoapUserAdministration.php