Custom PEAR Auth Container for ECS auth checks. More...

Inheritance diagram for ilAuthContainerECS:

Collaboration diagram for ilAuthContainerECS:

Public Member Functions
	__construct ($a_params=array())
	Constructor. More...

	getAbreviation ()
	get abbreviation More...

	getMID ()
	get mid More...

	setMID ($a_mid)

	setCurrentServer (ilECSSetting $server=null)
	Set current server. More...

	getCurrentServer ()
	Get current server. More...

	getServerSettings ()
	Get server settings. More...

	fetchData ($a_username, $a_pass)
	Check for valid ecs_hash. More...

	validateHash ()
	Validate ECS hash. More...

	loginObserver ($a_username, $a_auth)
	Called from base class after successful login. More...

	failedLoginObserver ()
	Called from base class after failed login. More...

Protected Member Functions
	createUser (ilECSUser $user)
	create new user More...

	updateUser (ilECSUser $user, $a_local_user_id)
	update existing user More...

	resetMailOptions ($a_usr_id)
	Reset mail options to "local only". More...

Protected Attributes
	$mid = null

	$abreviation = null

	$currentServer = null

	$servers = null

	$log

Private Member Functions
	initECSServices ()
	Init ECS Services private. More...

	sendNotification ($user_obj)
	Send notification. More...

Detailed Description

Custom PEAR Auth Container for ECS auth checks.

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version: $Id$

Definition at line 34 of file class.ilAuthContainerECS.php.

Constructor & Destructor Documentation

◆ __construct()

ilAuthContainerECS::__construct ( $a_params = array() )

Constructor.

public

Parameters

Definition at line 51 of file class.ilAuthContainerECS.php.

References $GLOBALS, and initECSServices().

     {
         parent::__construct($a_params);
 
         $this->initECSServices();
         
         $this->log = $GLOBALS['ilLog'];
     }

Here is the call graph for this function:

Member Function Documentation

◆ createUser()

ilAuthContainerECS::createUser ( ilECSUser $user )

protected

create new user

protected

Definition at line 277 of file class.ilAuthContainerECS.php.

References $ilLog, $ilSetting, ilAuthUtils\_generateLogin(), ilObject\_writeImportId(), getAbreviation(), getCurrentServer(), ilECSUser\getEmail(), ilECSUser\getFirstname(), ilECSUser\getImportId(), ilECSUser\getInstitution(), ilECSUser\getLastname(), ilECSUser\getLogin(), IL_PASSWD_CRYPTED, resetMailOptions(), and time.

Referenced by loginObserver().

     {
         global $ilClientIniFile, $ilSetting, $rbacadmin, $ilLog;
 
         $userObj = new ilObjUser();
         $userObj->setOwner(SYSTEM_USER_ID);
 
         include_once('./Services/Authentication/classes/class.ilAuthUtils.php');
         $local_user = ilAuthUtils::_generateLogin($this->getAbreviation() . '_' . $user->getLogin());
 
         $newUser["login"] = $local_user;
         $newUser["firstname"] = $user->getFirstname();
         $newUser["lastname"] = $user->getLastname();
         $newUser['email'] = $user->getEmail();
         $newUser['institution'] = $user->getInstitution();
 
         // set "plain md5" password (= no valid password)
         $newUser["passwd"] = "";
         $newUser["passwd_type"] = IL_PASSWD_CRYPTED;
 
         $newUser["auth_mode"] = "ecs";
         $newUser["profile_incomplete"] = 0;
 
         // system data
         $userObj->assignData($newUser);
         $userObj->setTitle($userObj->getFullname());
         $userObj->setDescription($userObj->getEmail());
 
         // set user language to system language
         $userObj->setLanguage($ilSetting->get("language"));
 
         // Time limit
         $userObj->setTimeLimitOwner(7);
         $userObj->setTimeLimitUnlimited(0);
         $userObj->setTimeLimitFrom(time() - 5);
         $userObj->setTimeLimitUntil(time() + $ilClientIniFile->readVariable("session", "expire"));
 
         #$now = new ilDateTime(time(), IL_CAL_UNIX);
         #$userObj->setAgreeDate($now->get(IL_CAL_DATETIME));
 
         // Create user in DB
         $userObj->setOwner(6);
         $userObj->create();
         $userObj->setActive(1);
         $userObj->updateOwner();
         $userObj->saveAsNew();
         $userObj->writePrefs();
 
         if ($global_role = $this->getCurrentServer()->getGlobalRole()) {
             $rbacadmin->assignUser($this->getCurrentServer()->getGlobalRole(), $userObj->getId(), true);
         }
         ilObject::_writeImportId($userObj->getId(), $user->getImportId());
 
         $ilLog->write(__METHOD__ . ': Created new remote user with usr_id: ' . $user->getImportId());
 
         // Send Mail
         #$this->sendNotification($userObj);
         $this->resetMailOptions($userObj->getId());
         
         return $userObj->getLogin();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ failedLoginObserver()

ilAuthContainerECS::failedLoginObserver ( )

Called from base class after failed login.

Parameters

string username

Definition at line 264 of file class.ilAuthContainerECS.php.

     {
         $this->log->write(__METHOD__ . ': Login failed');
         return false;
     }

◆ fetchData()

ilAuthContainerECS::fetchData	(	$a_username,
		$a_pass
	)

Check for valid ecs_hash.

Parameters

string	$a_username
string	$a_pass

Definition at line 119 of file class.ilAuthContainerECS.php.

References $GLOBALS, $ilLog, $server, getServerSettings(), setCurrentServer(), and validateHash().

     {
         global $ilLog;
 
         $ilLog->write(__METHOD__ . ': Starting ECS authentication.');
 
         if (!$this->getServerSettings()->activeServerExists()) {
             $GLOBALS['ilLog']->write(__METHOD__ . ': no active ecs server found. Aborting');
             return false;
         }
 
         // Iterate through all active ecs instances
         include_once './Services/WebServices/ECS/classes/class.ilECSServerSettings.php';
         foreach ($this->getServerSettings()->getServers() as $server) {
             $this->setCurrentServer($server);
             if ($this->validateHash()) {
                 return true;
             }
         }
         $GLOBALS['ilLog']->write(__METHOD__ . ': Could not validate ecs hash for any server');
         return false;
     }

Here is the call graph for this function:

◆ getAbreviation()

ilAuthContainerECS::getAbreviation ( )

get abbreviation

public

Parameters

Definition at line 67 of file class.ilAuthContainerECS.php.

References $abreviation.

Referenced by createUser().

     {
         return $this->abreviation;
     }

Here is the caller graph for this function:

◆ getCurrentServer()

ilAuthContainerECS::getCurrentServer ( )

Get current server.

Returns: ilECSSetting

Definition at line 100 of file class.ilAuthContainerECS.php.

References $currentServer.

Referenced by createUser(), loginObserver(), sendNotification(), updateUser(), and validateHash().

     {
         return $this->currentServer;
     }

Here is the caller graph for this function:

◆ getMID()

ilAuthContainerECS::getMID ( )

get mid

public

Definition at line 77 of file class.ilAuthContainerECS.php.

References $mid.

Referenced by loginObserver().

     {
         return $this->mid;
     }

Here is the caller graph for this function:

◆ getServerSettings()

ilAuthContainerECS::getServerSettings ( )

Get server settings.

Returns: ilECSServerSettings

Definition at line 109 of file class.ilAuthContainerECS.php.

References $servers.

Referenced by fetchData().

     {
         return $this->servers;
     }

Here is the caller graph for this function:

◆ initECSServices()

ilAuthContainerECS::initECSServices ( )

private

Init ECS Services private.

Parameters

Definition at line 397 of file class.ilAuthContainerECS.php.

References ilECSServerSettings\getInstance().

Referenced by __construct().

     {
         include_once './Services/WebServices/ECS/classes/class.ilECSServerSettings.php';
         $this->servers = ilECSServerSettings::getInstance();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loginObserver()

ilAuthContainerECS::loginObserver	(	$a_username,
		$a_auth
	)

Called from base class after successful login.

Parameters

string username

Definition at line 223 of file class.ilAuthContainerECS.php.

References $_GET, $GLOBALS, ilObjUser\_lookupId(), ilObject\_lookupObjIdByImportId(), createUser(), getCurrentServer(), getMID(), and updateUser().

     {
         include_once('./Services/WebServices/ECS/classes/class.ilECSUser.php');
         
         $user = new ilECSUser($_GET);
         
         if (!$usr_id = ilObject::_lookupObjIdByImportId($user->getImportId())) {
             $username = $this->createUser($user);
         } else {
             $username = $this->updateUser($user, $usr_id);
         }
         
         // set user imported
         include_once './Services/WebServices/ECS/classes/class.ilECSImport.php';
         $import = new ilECSImport($this->getCurrentServer()->getServerId(), $usr_id);
         $import->save();
         
         // Store remote user data
         include_once './Services/WebServices/ECS/classes/class.ilECSRemoteUser.php';
         $remote = new ilECSRemoteUser();
         $remote->setServerId($this->getCurrentServer()->getServerId());
         $remote->setMid($this->getMID());
         $remote->setRemoteUserId($user->getImportId());
         $remote->setUserId(ilObjUser::_lookupId($username));
         
         $GLOBALS['ilLog']->write(__METHOD__ . ': Current username ' . $username);
         
         if (!$remote->exists()) {
             $remote->create();
         }
         
         $a_auth->setAuth($username);
         $this->log->write(__METHOD__ . ': Login succesesful');
         return true;
     }

Here is the call graph for this function:

◆ resetMailOptions()

ilAuthContainerECS::resetMailOptions ( $a_usr_id )

protected

Reset mail options to "local only".

Definition at line 382 of file class.ilAuthContainerECS.php.

References $options, and ilMailOptions\INCOMING_LOCAL.

Referenced by createUser(), and updateUser().

     {
         include_once './Services/Mail/classes/class.ilMailOptions.php';
         $options = new ilMailOptions($a_usr_id);
         $options->setIncomingType(ilMailOptions::INCOMING_LOCAL);
         $options->updateOptions();
     }

Here is the caller graph for this function:

◆ sendNotification()

ilAuthContainerECS::sendNotification ( $user_obj )

private

Send notification.

private

Parameters

Definition at line 410 of file class.ilAuthContainerECS.php.

References $GLOBALS, $lang, ilMail\_getAutoGeneratedMessageString(), ilLanguageFactory\_getLanguage(), array, and getCurrentServer().

     {
         if (!count($this->getCurrentServer()->getUserRecipients())) {
             return true;
         }
 
         include_once('./Services/Language/classes/class.ilLanguageFactory.php');
         include_once './Services/Language/classes/class.ilLanguage.php';
         $lang = ilLanguageFactory::_getLanguage();
         $GLOBALS['lng'] = $lang;
         $GLOBALS['ilUser'] = $user_obj;
         $lang->loadLanguageModule('ecs');
 
         include_once('./Services/Mail/classes/class.ilMail.php');
         $mail = new ilMail(6);
         $mail->enableSoap(false);
         $subject = $lang->txt('ecs_new_user_subject');
 
         // build body
         $body = $lang->txt('ecs_new_user_body') . "\n\n";
         $body .= $lang->txt('ecs_new_user_profile') . "\n\n";
         $body .= $user_obj->getProfileAsString($lang) . "\n\n";
         $body .= ilMail::_getAutoGeneratedMessageString($lang);
         
         $mail->sendMail(
             $this->getCurrentServer()->getUserRecipientsAsString(),
             "",
             "",
             $subject,
             $body,
             array(),
             array("normal")
         );
     }

Here is the call graph for this function:

◆ setCurrentServer()

ilAuthContainerECS::setCurrentServer ( ilECSSetting $server = null )

Set current server.

Parameters

ilECSSetting $server

Definition at line 91 of file class.ilAuthContainerECS.php.

References $server.

Referenced by fetchData().

     {
         $this->currentServer = $server;
     }

Here is the caller graph for this function:

◆ setMID()

ilAuthContainerECS::setMID ( $a_mid )

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

Referenced by validateHash().

     {
         $this->mid = $a_mid;
     }

Here is the caller graph for this function:

◆ updateUser()

ilAuthContainerECS::updateUser	(	ilECSUser	$user,
			$a_local_user_id
	)

protected

update existing user

protected

Definition at line 344 of file class.ilAuthContainerECS.php.

References $ilLog, getCurrentServer(), ilECSUser\getEmail(), ilECSUser\getFirstname(), ilECSUser\getImportId(), ilECSUser\getInstitution(), ilECSUser\getLastname(), resetMailOptions(), and time.

Referenced by loginObserver().

     {
         global $ilClientIniFile,$ilLog,$rbacadmin;
         
         $user_obj = new ilObjUser($a_local_user_id);
         $user_obj->setFirstname($user->getFirstname());
         $user_obj->setLastname($user->getLastname());
         $user_obj->setEmail($user->getEmail());
         $user_obj->setInstitution($user->getInstitution());
         $user_obj->setActive(true);
         
         $until = $user_obj->getTimeLimitUntil();
 
         if ($until < (time() + $ilClientIniFile->readVariable('session', 'expire'))) {
             $user_obj->setTimeLimitFrom(time() - 60);
             $user_obj->setTimeLimitUntil(time() + $ilClientIniFile->readVariable("session", "expire"));
         }
         $user_obj->update();
         $user_obj->refreshLogin();
         
         if ($global_role = $this->getCurrentServer()->getGlobalRole()) {
             $rbacadmin->assignUser(
                 $this->getCurrentServer()->getGlobalRole(),
                 $user_obj->getId(),
                 true
             );
         }
         
         $this->resetMailOptions($a_local_user_id);
 
         $ilLog->write(__METHOD__ . ': Finished update of remote user with usr_id: ' . $user->getImportId());
         return $user_obj->getLogin();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ validateHash()

ilAuthContainerECS::validateHash ( )

Validate ECS hash.

public

Parameters

string	username
string	pass

Definition at line 151 of file class.ilAuthContainerECS.php.

References $_GET, $GLOBALS, $ilLog, $reader, $res, getCurrentServer(), ilECSCommunityReader\getInstanceByServerId(), and setMID().

Referenced by fetchData().

     {
         global $ilLog;
         
         // fetch hash
         if (isset($_GET['ecs_hash']) and strlen($_GET['ecs_hash'])) {
             $hash = $_GET['ecs_hash'];
         }
         if (isset($_GET['ecs_hash_url'])) {
             $hashurl = urldecode($_GET['ecs_hash_url']);
             $hash = basename(parse_url($hashurl, PHP_URL_PATH));
             //$hash = urldecode($_GET['ecs_hash_url']);
         }
         
         $GLOBALS['ilLog']->write(__METHOD__ . ': Using ecs hash ' . $hash);
 
         // Check if hash is valid ...
         try {
             include_once('./Services/WebServices/ECS/classes/class.ilECSConnector.php');
             $connector = new ilECSConnector($this->getCurrentServer());
             $res = $connector->getAuth($hash);
             $auths = $res->getResult();
             
             $GLOBALS['ilLog']->write(__METHOD__ . ': Auths: ' . print_r($auths, true));
             
             if ($auths->pid) {
                 try {
                     include_once './Services/WebServices/ECS/classes/class.ilECSCommunityReader.php';
                     $reader = ilECSCommunityReader::getInstanceByServerId($this->getCurrentServer()->getServerId());
                     $part = $reader->getParticipantByMID($auths->pid);
                     
                     if (is_object($part) and is_object($part->getOrganisation())) {
                         $this->abreviation = $part->getOrganisation()->getAbbreviation();
                     } else {
                         $this->abreviation = $auths->abbr;
                     }
                 } catch (Exception $e) {
                     $ilLog->write(__METHOD__ . ': Authentication failed with message: ' . $e->getMessage());
                     return false;
                 }
             } else {
                 $this->abreviation = $auths->abbr;
             }
             
             $ilLog->write(__METHOD__ . ': Got abr: ' . $this->abreviation);
         } catch (ilECSConnectorException $e) {
             $ilLog->write(__METHOD__ . ': Authentication failed with message: ' . $e->getMessage());
             return false;
         }
         
         // read current mid
         try {
             include_once('./Services/WebServices/ECS/classes/class.ilECSConnector.php');
             $connector = new ilECSConnector($this->getCurrentServer());
             $details = $connector->getAuth($hash, true);
             
             $GLOBALS['ilLog']->write(__METHOD__ . ': ' . print_r($details, true));
             $GLOBALS['ilLog']->write(__METHOD__ . ': Token created for mid ' . $details->getFirstSender());
             
             $this->setMID($details->getFirstSender());
         } catch (ilECSConnectorException $e) {
             $ilLog->write(__METHOD__ . ': Receiving mid failed with message: ' . $e->getMessage());
             return false;
         }
         return true;
     }