Collaboration diagram for ilSamlIdp:

Public Member Functions
	__construct (int $a_idp_id=0)

	persist ()

	delete ()
	Deletes an idp with all relevant mapping rules. More...

	toArray ()

	bindDbRecord (array $record)

	getEntityId ()

	setEntityId (string $entity_id)

	isActive ()

	setActive (bool $is_active)

	getIdpId ()

	setIdpId (int $idp_id)

	allowLocalAuthentication ()

	setLocalLocalAuthenticationStatus (bool $status)

	getDefaultRoleId ()

	setDefaultRoleId (int $role_id)

	setUidClaim (string $claim)

	getUidClaim ()

	setLoginClaim (string $claim)

	getLoginClaim ()

	isSynchronizationEnabled ()

	setSynchronizationStatus (bool $sync)

	isAccountMigrationEnabled ()

	setAccountMigrationStatus (bool $status)

Static Public Member Functions
static	getFirstActiveIdp ()

static	getInstanceByIdpId (int $a_idp_id)

static	isAuthModeSaml (string $a_auth_mode)

static	getIdpIdByAuthMode (string $a_auth_mode)

static	geIdpIdByEntityId (string $entityId)

static	getActiveIdpList ()

static	getAllIdps ()

static	getAuthModeByKey (string $a_auth_key)

static	getKeyByAuthMode (string $a_auth_mode)

Protected Attributes
ilDBInterface	$db

int	$idp_id

bool	$is_active = false

bool	$allow_local_auth = false

int	$default_role_id = 0

string	$uid_claim = ''

string	$login_claim = ''

bool	$sync_status = false

string	$entity_id = ''

bool	$account_migration_status = false

Static Protected Attributes
static array	$idp_as_data = []

Private Member Functions
	read ()

Static Private Attributes
static array	$instances = []

Detailed Description

Class ilSamlIdp.

Author: Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de

Definition at line 25 of file class.ilSamlIdp.php.

Constructor & Destructor Documentation

◆ __construct()

ilSamlIdp::__construct ( int $a_idp_id = 0 )

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

    {
        $this->db = $GLOBALS['DIC']->database();
        $this->idp_id = $a_idp_id;
 
        if ($this->idp_id > 0) {
            $this->read();
        }
    }

References $GLOBALS, and read().

Here is the call graph for this function:

Member Function Documentation

◆ allowLocalAuthentication()

ilSamlIdp::allowLocalAuthentication ( )

Definition at line 297 of file class.ilSamlIdp.php.

                                              : bool
    {
        return $this->allow_local_auth;
    }

References $allow_local_auth.

Referenced by persist(), and toArray().

Here is the caller graph for this function:

◆ bindDbRecord()

ilSamlIdp::bindDbRecord ( array $record )

Parameters

array<string,mixed> $record

Definition at line 149 of file class.ilSamlIdp.php.

                                               : void
    {
        $this->setIdpId((int) $record['idp_id']);
        $this->setActive((bool) $record['is_active']);
        $this->setDefaultRoleId((int) $record['default_role_id']);
        $this->setUidClaim((string) $record['uid_claim']);
        $this->setLoginClaim((string) $record['login_claim']);
        $this->setSynchronizationStatus((bool) $record['sync_status']);
        $this->setAccountMigrationStatus((bool) $record['account_migr_status']);
        $this->setLocalLocalAuthenticationStatus((bool) $record['allow_local_auth']);
        $this->setEntityId((string) $record['entity_id']);
    }

References setAccountMigrationStatus(), setActive(), setDefaultRoleId(), setEntityId(), setIdpId(), setLocalLocalAuthenticationStatus(), setLoginClaim(), setSynchronizationStatus(), and setUidClaim().

Referenced by read().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ delete()

ilSamlIdp::delete ( )

Deletes an idp with all relevant mapping rules.

Furthermore, the auth_mode of the relevant user accounts will be switched to 'default'

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

                            : void
    {
        $mapping = new ilExternalAuthUserAttributeMapping('saml', $this->getIdpId());
        $mapping->delete();
 
        $this->db->manipulateF(
            'UPDATE usr_data SET auth_mode = %s WHERE auth_mode = %s',
            array('text', 'text'),
            array('default', ilAuthUtils::AUTH_SAML . '_' . $this->getIdpId())
        );
 
        $this->db->manipulate('DELETE FROM saml_idp_settings WHERE idp_id = ' . $this->db->quote(
            $this->getIdpId(),
            'integer'
        ));
    }

References ilAuthUtils\AUTH_SAML, and getIdpId().

Here is the call graph for this function:

◆ geIdpIdByEntityId()

static ilSamlIdp::geIdpIdByEntityId ( string $entityId )

static

Definition at line 200 of file class.ilSamlIdp.php.

                                                              : int
    {
        foreach (self::getAllIdps() as $idp) {
            if ($idp->isActive() && $idp->getEntityId() === $entityId) {
                return $idp->getIdpId();
            }
        }
 
        return 0;
    }

References $entityId.

Referenced by ilStartUpGUI\doSamlAuthentication().

Here is the caller graph for this function:

◆ getActiveIdpList()

static ilSamlIdp::getActiveIdpList ( )

static

Returns: self[]

Definition at line 214 of file class.ilSamlIdp.php.

                                             : array
    {
        $idps = [];
 
        foreach (self::getAllIdps() as $idp) {
            if ($idp->isActive()) {
                $idps[] = $idp;
            }
        }
 
        return $idps;
    }

Referenced by ilAuthUtils\_getActiveAuthModes(), ilAuthUtils\_isExternalAccountEnabled(), ilStartUpGUI\doSamlAuthentication(), getFirstActiveIdp(), ilUserImportParser\importBeginTag(), ilStartUpGUI\showSamlLoginForm(), and ilUserImportParser\verifyBeginTag().

Here is the caller graph for this function:

◆ getAllIdps()

static ilSamlIdp::getAllIdps ( )

static

Returns: self[]

Definition at line 230 of file class.ilSamlIdp.php.

                                       : array
    {
        global $DIC;
 
        $res = $DIC->database()->query('SELECT * FROM saml_idp_settings');
 
        $idps = [];
        while ($row = $DIC->database()->fetchAssoc($res)) {
            $idp = new self();
            $idp->bindDbRecord($row);
 
            $idps[] = $idp;
        }
 
        return $idps;
    }

References $DIC, and $res.

Referenced by ilAuthUtils\_getAllAuthModes(), and ilSamlIdpTableGUI\getItems().

Here is the caller graph for this function:

◆ getAuthModeByKey()

static ilSamlIdp::getAuthModeByKey ( string $a_auth_key )

static

Definition at line 247 of file class.ilSamlIdp.php.

                                                               : string
    {
        $auth_arr = explode('_', $a_auth_key);
        if (count((array) $auth_arr) > 1) {
            return 'saml_' . $auth_arr[1];
        }
 
        return 'saml';
    }

Referenced by ilAuthUtils\_getAuthModeName().

Here is the caller graph for this function:

◆ getDefaultRoleId()

ilSamlIdp::getDefaultRoleId ( )

Definition at line 307 of file class.ilSamlIdp.php.

                                      : int
    {
        return $this->default_role_id;
    }

References $default_role_id.

Referenced by persist(), and toArray().

Here is the caller graph for this function:

◆ getEntityId()

ilSamlIdp::getEntityId ( )

Definition at line 267 of file class.ilSamlIdp.php.

                                 : string
    {
        return $this->entity_id;
    }

References $entity_id.

Referenced by persist(), and toArray().

Here is the caller graph for this function:

◆ getFirstActiveIdp()

static ilSamlIdp::getFirstActiveIdp ( )

static

Definition at line 52 of file class.ilSamlIdp.php.

                                              : self
    {
        $idps = self::getActiveIdpList();
        if (count($idps) > 0) {
            return current($idps);
        }
 
        throw new ilSamlException('No active SAML IDP found');
    }

References getActiveIdpList().

Referenced by ilAuthProviderSaml\__construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getIdpId()

ilSamlIdp::getIdpId ( )

Definition at line 287 of file class.ilSamlIdp.php.

                              : int
    {
        return $this->idp_id;
    }

References $idp_id.

Referenced by delete(), persist(), ilSamlSettingsGUI\populateWithMetadata(), read(), ilSamlSettingsGUI\saveNewIdp(), ilSamlSettingsGUI\storeMetadata(), and toArray().

Here is the caller graph for this function:

◆ getIdpIdByAuthMode()

static ilSamlIdp::getIdpIdByAuthMode ( string $a_auth_mode )

static

Definition at line 190 of file class.ilSamlIdp.php.

                                                                  : ?int
    {
        if (self::isAuthModeSaml($a_auth_mode)) {
            $auth_arr = explode('_', $a_auth_mode);
            return (int) $auth_arr[1];
        }
 
        return null;
    }

Referenced by ilObjAuthSettingsGUI\authSettingsObject(), ilAuthUtils\getAuthModeTranslation(), ilAuthProviderFactory\getProviderByAuthMode(), and ilAuthUtils\isLocalPasswordEnabledForAuthMode().

Here is the caller graph for this function:

◆ getInstanceByIdpId()

static ilSamlIdp::getInstanceByIdpId ( int $a_idp_id )

static

Definition at line 62 of file class.ilSamlIdp.php.

                                                            : self
    {
        if (!isset(self::$instances[$a_idp_id]) || !(self::$instances[$a_idp_id] instanceof self)) {
            self::$instances[$a_idp_id] = new self($a_idp_id);
        }
 
        return self::$instances[$a_idp_id];
    }

Referenced by ilAuthProviderSaml\__construct(), ilObjAuthSettingsGUI\authSettingsObject(), ilAuthUtils\getAuthModeTranslation(), ilSamlSettingsGUI\initIdp(), and ilAuthUtils\isLocalPasswordEnabledForAuthMode().

Here is the caller graph for this function:

◆ getKeyByAuthMode()

static ilSamlIdp::getKeyByAuthMode ( string $a_auth_mode )

static

Definition at line 257 of file class.ilSamlIdp.php.

                                                                : string
    {
        $auth_arr = explode('_', $a_auth_mode);
        if (count((array) $auth_arr) > 1) {
            return ilAuthUtils::AUTH_SAML . '_' . $auth_arr[1];
        }
 
        return (string) ilAuthUtils::AUTH_SAML;
    }

References ilAuthUtils\AUTH_SAML.

Referenced by ilAuthUtils\_getAuthMode().

Here is the caller graph for this function:

◆ getLoginClaim()

ilSamlIdp::getLoginClaim ( )

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

                                   : string
    {
        return $this->login_claim;
    }

References $login_claim.

Referenced by persist(), and toArray().

Here is the caller graph for this function:

◆ getUidClaim()

ilSamlIdp::getUidClaim ( )

Definition at line 322 of file class.ilSamlIdp.php.

                                 : string
    {
        return $this->uid_claim;
    }

References $uid_claim.

Referenced by persist(), and toArray().

Here is the caller graph for this function:

◆ isAccountMigrationEnabled()

ilSamlIdp::isAccountMigrationEnabled ( )

Definition at line 347 of file class.ilSamlIdp.php.

                                               : bool
    {
        return $this->account_migration_status;
    }

References $account_migration_status.

Referenced by persist(), and toArray().

Here is the caller graph for this function:

◆ isActive()

ilSamlIdp::isActive ( )

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

                              : bool
    {
        return $this->is_active;
    }

References $is_active.

Referenced by persist(), and toArray().

Here is the caller graph for this function:

◆ isAuthModeSaml()

static ilSamlIdp::isAuthModeSaml ( string $a_auth_mode )

static

Definition at line 176 of file class.ilSamlIdp.php.

                                                              : bool
    {
        if ('' === $a_auth_mode) {
            return false;
        }
 
        $auth_arr = explode('_', $a_auth_mode);
        return (
            count($auth_arr) === 2 &&
            (int) $auth_arr[0] === ilAuthUtils::AUTH_SAML &&
            is_string($auth_arr[1]) && $auth_arr[1] !== ''
        );
    }

References ilAuthUtils\AUTH_SAML.

Referenced by ilObjAuthSettingsGUI\authSettingsObject().

Here is the caller graph for this function:

◆ isSynchronizationEnabled()

ilSamlIdp::isSynchronizationEnabled ( )

Definition at line 337 of file class.ilSamlIdp.php.

                                              : bool
    {
        return $this->sync_status;
    }

References $sync_status.

Referenced by persist(), and toArray().

Here is the caller graph for this function:

◆ persist()

ilSamlIdp::persist ( )

Definition at line 83 of file class.ilSamlIdp.php.

                             : void
    {
        if (!$this->getIdpId()) {
            $this->setIdpId($this->db->nextId('saml_idp_settings'));
        }
 
        $this->db->replace(
            'saml_idp_settings',
            [
                'idp_id' => ['integer', $this->getIdpId()]
            ],
            [
                'is_active' => ['integer', (int) $this->isActive()],
                'default_role_id' => ['integer', $this->getDefaultRoleId()],
                'uid_claim' => ['text', $this->getUidClaim()],
                'login_claim' => ['text', $this->getLoginClaim()],
                'entity_id' => ['text', $this->getEntityId()],
                'sync_status' => ['integer', (int) $this->isSynchronizationEnabled()],
                'allow_local_auth' => ['integer', (int) $this->allowLocalAuthentication()],
                'account_migr_status' => ['integer', (int) $this->isAccountMigrationEnabled()]
            ]
        );
    }

References allowLocalAuthentication(), getDefaultRoleId(), getEntityId(), getIdpId(), getLoginClaim(), getUidClaim(), isAccountMigrationEnabled(), isActive(), isSynchronizationEnabled(), and setIdpId().

Referenced by ilSamlSettingsGUI\saveNewIdp().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ read()

ilSamlIdp::read ( )

private

Definition at line 71 of file class.ilSamlIdp.php.

                           : void
    {
        $query = 'SELECT * FROM saml_idp_settings WHERE idp_id = ' . $this->db->quote($this->getIdpId(), 'integer');
        $res = $this->db->query($query);
        while ($record = $this->db->fetchAssoc($res)) {
            $this->bindDbRecord($record);
            return;
        }
 
        throw new ilException('Could not find idp');
    }

References $query, $res, bindDbRecord(), and getIdpId().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setAccountMigrationStatus()

ilSamlIdp::setAccountMigrationStatus ( bool $status )

Definition at line 352 of file class.ilSamlIdp.php.

                                                           : void
    {
        $this->account_migration_status = $status;
    }

Referenced by bindDbRecord().

Here is the caller graph for this function:

◆ setActive()

ilSamlIdp::setActive ( bool $is_active )

Definition at line 282 of file class.ilSamlIdp.php.

                                              : void
    {
        $this->is_active = $is_active;
    }

References $is_active.

Referenced by bindDbRecord().

Here is the caller graph for this function:

◆ setDefaultRoleId()

ilSamlIdp::setDefaultRoleId ( int $role_id )

Definition at line 312 of file class.ilSamlIdp.php.

                                                  : void
    {
        $this->default_role_id = $role_id;
    }

Referenced by bindDbRecord().

Here is the caller graph for this function:

◆ setEntityId()

ilSamlIdp::setEntityId ( string $entity_id )

Definition at line 272 of file class.ilSamlIdp.php.

                                                  : void
    {
        $this->entity_id = $entity_id;
    }

References $entity_id.

Referenced by bindDbRecord().

Here is the caller graph for this function:

◆ setIdpId()

ilSamlIdp::setIdpId ( int $idp_id )

Definition at line 292 of file class.ilSamlIdp.php.

                                         : void
    {
        $this->idp_id = $idp_id;
    }

References $idp_id.

Referenced by bindDbRecord(), and persist().

Here is the caller graph for this function:

◆ setLocalLocalAuthenticationStatus()

ilSamlIdp::setLocalLocalAuthenticationStatus ( bool $status )

Definition at line 302 of file class.ilSamlIdp.php.

                                                                   : void
    {
        $this->allow_local_auth = $status;
    }

Referenced by bindDbRecord().

Here is the caller graph for this function:

◆ setLoginClaim()

ilSamlIdp::setLoginClaim ( string $claim )

Definition at line 327 of file class.ilSamlIdp.php.

                                                : void
    {
        $this->login_claim = $claim;
    }

Referenced by bindDbRecord().

Here is the caller graph for this function:

◆ setSynchronizationStatus()

ilSamlIdp::setSynchronizationStatus ( bool $sync )

Definition at line 342 of file class.ilSamlIdp.php.

                                                        : void
    {
        $this->sync_status = $sync;
    }

Referenced by bindDbRecord().

Here is the caller graph for this function:

◆ setUidClaim()

ilSamlIdp::setUidClaim ( string $claim )

Definition at line 317 of file class.ilSamlIdp.php.

                                              : void
    {
        $this->uid_claim = $claim;
    }

Referenced by bindDbRecord().

Here is the caller graph for this function:

◆ toArray()

ilSamlIdp::toArray ( )

Returns: array<string, mixed>

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

                             : array
    {
        return [
            'idp_id' => $this->getIdpId(),
            'is_active' => $this->isActive(),
            'default_role_id' => $this->getDefaultRoleId(),
            'uid_claim' => $this->getUidClaim(),
            'login_claim' => $this->getLoginClaim(),
            'sync_status' => $this->isSynchronizationEnabled(),
            'account_migr_status' => $this->isAccountMigrationEnabled(),
            'allow_local_auth' => $this->allowLocalAuthentication(),
            'entity_id' => $this->getEntityId()
        ];
    }

References allowLocalAuthentication(), getDefaultRoleId(), getEntityId(), getIdpId(), getLoginClaim(), getUidClaim(), isAccountMigrationEnabled(), isActive(), and isSynchronizationEnabled().

Here is the call graph for this function:

Field Documentation

◆ $account_migration_status

bool ilSamlIdp::$account_migration_status = false

protected

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

Referenced by isAccountMigrationEnabled().

◆ $allow_local_auth

bool ilSamlIdp::$allow_local_auth = false

protected

Definition at line 32 of file class.ilSamlIdp.php.

Referenced by allowLocalAuthentication().

◆ $db

ilDBInterface ilSamlIdp::$db

protected

Definition at line 27 of file class.ilSamlIdp.php.

◆ $default_role_id

int ilSamlIdp::$default_role_id = 0

protected

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

Referenced by getDefaultRoleId().

◆ $entity_id

string ilSamlIdp::$entity_id = ''

protected

Definition at line 37 of file class.ilSamlIdp.php.

Referenced by getEntityId(), and setEntityId().

◆ $idp_as_data

array ilSamlIdp::$idp_as_data = []

staticprotected

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

◆ $idp_id

int ilSamlIdp::$idp_id

protected

Definition at line 30 of file class.ilSamlIdp.php.

Referenced by getIdpId(), and setIdpId().

◆ $instances

array ilSamlIdp::$instances = []

staticprivate

Definition at line 29 of file class.ilSamlIdp.php.

◆ $is_active

bool ilSamlIdp::$is_active = false

protected

Definition at line 31 of file class.ilSamlIdp.php.

Referenced by isActive(), and setActive().

◆ $login_claim

string ilSamlIdp::$login_claim = ''

protected

Definition at line 35 of file class.ilSamlIdp.php.

Referenced by getLoginClaim().

◆ $sync_status

bool ilSamlIdp::$sync_status = false

protected

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

Referenced by isSynchronizationEnabled().

◆ $uid_claim

string ilSamlIdp::$uid_claim = ''

protected

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

Referenced by getUidClaim().

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

Services/Saml/classes/class.ilSamlIdp.php

Public Member Functions

Static Public Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ allowLocalAuthentication()

◆ bindDbRecord()

◆ delete()

◆ geIdpIdByEntityId()

◆ getActiveIdpList()

◆ getAllIdps()

◆ getAuthModeByKey()

◆ getDefaultRoleId()

◆ getEntityId()

◆ getFirstActiveIdp()

◆ getIdpId()

◆ getIdpIdByAuthMode()

◆ getInstanceByIdpId()

◆ getKeyByAuthMode()

◆ getLoginClaim()

◆ getUidClaim()

◆ isAccountMigrationEnabled()

◆ isActive()

◆ isAuthModeSaml()

◆ isSynchronizationEnabled()

◆ persist()

◆ read()

◆ setAccountMigrationStatus()

◆ setActive()

◆ setDefaultRoleId()

◆ setEntityId()

◆ setIdpId()

◆ setLocalLocalAuthenticationStatus()

◆ setLoginClaim()

◆ setSynchronizationStatus()

◆ setUidClaim()

◆ toArray()

Field Documentation

◆ $account_migration_status

◆ $allow_local_auth

◆ $db

◆ $default_role_id

◆ $entity_id

◆ $idp_as_data

◆ $idp_id

◆ $instances

◆ $is_active

◆ $login_claim

◆ $sync_status

◆ $uid_claim