ilSimpleSAMLphpWrapper Class Reference

Class ilSimpleSAMLphpWrapper. More...

Inheritance diagram for ilSimpleSAMLphpWrapper:

Collaboration diagram for ilSimpleSAMLphpWrapper:

Public Member Functions
	__construct ($authSourceName, $configurationPath)
	ilSimpleSAMLphpWrapper constructor. More...
	getAuthId ()
	Returns mixed More...
	protectResource ()
	Protect a script resource with a SAML auth. More...
	storeParam ($key, $value)
	Parameters string $key mixed $value More...
	getParam ($key)
	Parameters string $key Returns mixed More...
	popParam ($key)
	Parameters string $key Returns mixed More...
	isAuthenticated ()
	Returns bool More...
	getAttributes ()
	Returns array More...
	logout ($returnUrl='')
	Parameters string $returnUrl More...
	getIdpDiscovery ()
	Returns ilSamlIdpDiscovery More...
	getAuthDataArray ()
	@inheritDoc More...
	getAuthId ()
	protectResource ()
	Protect a script resource with a SAML auth. More...
	storeParam ($key, $value)
	isAuthenticated ()
	popParam ($key)
	getParam ($key)
	getAttributes ()
	logout ($returnUrl='')
	getIdpDiscovery ()
	getAuthDataArray ()

Protected Member Functions
	initConfigFiles ($configurationPath)

Protected Attributes
	$config
	$authSource

Detailed Description

Class ilSimpleSAMLphpWrapper.

Definition at line 10 of file class.ilSimpleSAMLphpWrapper.php.

Constructor & Destructor Documentation

__construct()

ilSimpleSAMLphpWrapper::__construct	(		$authSourceName,
			$configurationPath
	)

ilSimpleSAMLphpWrapper constructor.

Parameters

string	$authSourceName
string	$configurationPath

Exceptions

Exception

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

    {
        $this->initConfigFiles($configurationPath);
 
        SimpleSAML_Configuration::setConfigDir($configurationPath);
        $this->config = SimpleSAML_Configuration::getInstance();
 
        $sessionHandler = $this->config->getString('session.handler', false);
        $storageType = $this->config->getString('store.type', false);
 
        if (
            $storageType == 'phpsession' || $sessionHandler == 'phpsession' ||
            (empty($storageType) && empty($sessionHandler))
        ) {
            throw new RuntimeException('Invalid SimpleSAMLphp session handler: Must not be phpsession');
        }
 
        $this->authSource = new SimpleSAML\Auth\Simple($authSourceName);
    }

References SimpleSAML_Configuration\getInstance(), initConfigFiles(), and SimpleSAML_Configuration\setConfigDir().

Here is the call graph for this function:

Member Function Documentation

getAttributes()

ilSimpleSAMLphpWrapper::getAttributes

(

)

Returns

array

Implements ilSamlAuth.

Definition at line 131 of file class.ilSimpleSAMLphpWrapper.php.

    {
        return $this->authSource->getAttributes();
    }

getAuthDataArray()

ilSimpleSAMLphpWrapper::getAuthDataArray

(

)

@inheritDoc

Implements ilSamlAuth.

Definition at line 166 of file class.ilSimpleSAMLphpWrapper.php.

    {
        return $this->authSource->getAuthDataArray();
    }

getAuthId()

ilSimpleSAMLphpWrapper::getAuthId

(

)

Returns

mixed

Implements ilSamlAuth.

Definition at line 74 of file class.ilSimpleSAMLphpWrapper.php.

    {
        return $this->authSource->getAuthSource()->getAuthId();
    }

getIdpDiscovery()

ilSimpleSAMLphpWrapper::getIdpDiscovery

(

)

Returns

ilSamlIdpDiscovery

Implements ilSamlAuth.

Definition at line 158 of file class.ilSimpleSAMLphpWrapper.php.

    {
        return new ilSimpleSAMLphplIdpDiscovery();
    }

getParam()

ilSimpleSAMLphpWrapper::getParam

(

$key

)

Parameters

string

$key

Returns

mixed

Implements ilSamlAuth.

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

    {
        $session = SimpleSAML_Session::getSessionFromRequest();
 
        $value = $session->getData('ilias', $key);
 
        return $value;
    }

References $key, $session, and SimpleSAML_Session\getSessionFromRequest().

Referenced by popParam().

Here is the call graph for this function:

Here is the caller graph for this function:

initConfigFiles()

ilSimpleSAMLphpWrapper::initConfigFiles (   $configurationPath )

protected

Parameters

string

$configurationPath

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

    {
        global $DIC;
 
        $templateHandler = new ilSimpleSAMLphpConfigTemplateHandler($DIC->filesystem()->storage());
        $templateHandler->copy('./Services/Saml/lib/config.php.dist', 'auth/saml/config/config.php', [
            'DB_PATH' => rtrim($configurationPath, '/') . '/ssphp.sq3',
            'SQL_INITIAL_PASSWORD' => function () {
                require_once 'Services/Password/classes/class.ilPasswordUtils.php';
                return substr(str_replace('+', '.', base64_encode(ilPasswordUtils::getBytes(20))), 0, 10);
            },
            'COOKIE_PATH' => IL_COOKIE_PATH,
            'LOG_DIRECTORY' => ilLoggingDBSettings::getInstance()->getLogDir()
        ]);
        $templateHandler->copy('./Services/Saml/lib/authsources.php.dist', 'auth/saml/config/authsources.php', [
            'RELAY_STATE' => rtrim(ILIAS_HTTP_PATH, '/') . '/saml.php',
            'SP_ENTITY_ID' => rtrim(ILIAS_HTTP_PATH, '/') . '/Services/Saml/lib/metadata.php'
        ]);
    }

References $DIC, ilPasswordUtils\getBytes(), ilLoggingDBSettings\getInstance(), and IL_COOKIE_PATH.

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

isAuthenticated()

ilSimpleSAMLphpWrapper::isAuthenticated

(

)

Returns

bool

Implements ilSamlAuth.

Definition at line 123 of file class.ilSimpleSAMLphpWrapper.php.

    {
        return $this->authSource->isAuthenticated();
    }

logout()

ilSimpleSAMLphpWrapper::logout

(

$returnUrl = ''

)

Parameters

string

$returnUrl

Implements ilSamlAuth.

Definition at line 139 of file class.ilSimpleSAMLphpWrapper.php.

    {
        ilSession::set('used_external_auth', false);
 
        $params = array(
            'ReturnStateParam' => 'LogoutState',
            'ReturnStateStage' => 'ilLogoutState'
        );
 
        if (strlen($returnUrl) > 0) {
            $params['ReturnTo'] = $returnUrl;
        }
 
        $this->authSource->logout($params);
    }

References PHPMailer\PHPMailer\$params, and ilSession\set().

Here is the call graph for this function:

popParam()

ilSimpleSAMLphpWrapper::popParam

(

$key

)

Parameters

string

$key

Returns

mixed

Implements ilSamlAuth.

Definition at line 111 of file class.ilSimpleSAMLphpWrapper.php.

    {
        $session = SimpleSAML_Session::getSessionFromRequest();
        $value = $this->getParam($key);
        $session->deleteData('ilias', $key);
 
        return $value;
    }

References $key, $session, getParam(), and SimpleSAML_Session\getSessionFromRequest().

Here is the call graph for this function:

protectResource()

ilSimpleSAMLphpWrapper::protectResource

(

)

Protect a script resource with a SAML auth.

Implements ilSamlAuth.

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

    {
        $this->authSource->requireAuth();
    }

storeParam()

ilSimpleSAMLphpWrapper::storeParam	(		$key,
			$value
	)

Parameters

string	$key
mixed	$value

Implements ilSamlAuth.

Definition at line 90 of file class.ilSimpleSAMLphpWrapper.php.

    {
        $session = SimpleSAML_Session::getSessionFromRequest();
        $session->setData('ilias', $key, $value);
    }

References $key, $session, and SimpleSAML_Session\getSessionFromRequest().

Here is the call graph for this function:

Field Documentation

$authSource

ilSimpleSAMLphpWrapper::$authSource

protected

Definition at line 20 of file class.ilSimpleSAMLphpWrapper.php.

$config

ilSimpleSAMLphpWrapper::$config

protected

Definition at line 15 of file class.ilSimpleSAMLphpWrapper.php.

---

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

• Services/Saml/classes/class.ilSimpleSAMLphpWrapper.php