class.ilAuthProviderSaml.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2017 ILIAS open source, Extended GPL, see docs/LICENSE */

class ilAuthProviderSaml extends ilAuthProvider implements ilAuthProviderInterface, ilAuthProviderAccountMigrationInterface
{
    protected $uid = '';

    protected $attributes = array();

    protected $return_to = '';

    protected $idp;

    protected $force_new_account = false;

    protected $migration_account = '';

    public function __construct(\ilAuthFrontendCredentials $credentials, $a_idp_id = null)
    {
        parent::__construct($credentials);

        if (null === $a_idp_id) {
            $this->idp = ilSamlIdp::getFirstActiveIdp();
        } else {
            $this->idp = ilSamlIdp::getInstanceByIdpId($a_idp_id);
        }

        if ($credentials instanceof \ilAuthFrontendCredentialsSaml) {
            $this->attributes = $credentials->getAttributes();
            $this->return_to  = $credentials->getReturnTo();
        }
    }

    private function determineUidFromAttributes()
    {
        if (
            !array_key_exists($this->idp->getUidClaim(), $this->attributes) ||
            !is_array($this->attributes[$this->idp->getUidClaim()]) ||
            !array_key_exists(0, $this->attributes[$this->idp->getUidClaim()]) ||
            0 === strlen($this->attributes[$this->idp->getUidClaim()][0])
        ) {
            throw new \ilException(sprintf(
                'Could not find unique SAML attribute for the configured identifier: %s',
                var_export($this->idp->getUidClaim(), 1)
            ));
        }

        $this->uid = $this->attributes[$this->idp->getUidClaim()][0];
    }

    public function doAuthentication(\ilAuthStatus $status)
    {
        if (!is_array($this->attributes) || 0 === count($this->attributes)) {
            $this->getLogger()->warning('Could not parse any attributes from SAML response.');
            $this->handleAuthenticationFail($status, 'err_wrong_login');
            return false;
        }

        try {
            $this->determineUidFromAttributes();

            return $this->handleSamlAuth($status);
        } catch (\ilException $e) {
            $this->getLogger()->warning($e->getMessage());
            $this->handleAuthenticationFail($status, 'err_wrong_login');
            return false;
        }
    }

    public function handleSamlAuth(\ilAuthStatus $status)
    {
        $update_auth_mode = false;

        ilLoggerFactory::getLogger('auth')->debug(sprintf('Login observer called for SAML authentication request of ext_account "%s" and auth_mode "%s".', $this->uid, $this->getUserAuthModeName()));
        ilLoggerFactory::getLogger('auth')->debug(sprintf('Target set to: %s', var_export($this->return_to, 1)));
        ilLoggerFactory::getLogger('auth')->debug(sprintf('Trying to find ext_account "%s" for auth_mode "%s".', $this->uid, $this->getUserAuthModeName()));

        $internal_account = ilObjUser::_checkExternalAuthAccount(
            $this->getUserAuthModeName(),
            $this->uid,
            false
        );

        if (strlen($internal_account) == 0) {
            $update_auth_mode = true;

            ilLoggerFactory::getLogger('auth')->debug(sprintf('Could not find ext_account "%s" for auth_mode "%s".', $this->uid, $this->getUserAuthModeName()));

            $fallback_auth_mode = 'local';
            ilLoggerFactory::getLogger('auth')->debug(sprintf('Trying to find ext_account "%s" for auth_mode "%s".', $this->uid, $fallback_auth_mode));
            $internal_account = ilObjUser::_checkExternalAuthAccount($fallback_auth_mode, $this->uid, false);

            if (!defined('AUTH_DEFAULT')) {
                define('AUTH_DEFAULT', $GLOBALS['DIC']['ilSetting']->get('auth_mode') ? $GLOBALS['DIC']['ilSetting']->get('auth_mode') : AUTH_LOCAL);
            }

            if (strlen($internal_account) == 0 && (AUTH_DEFAULT == AUTH_LOCAL || AUTH_DEFAULT == $this->getTriggerAuthMode())) {
                ilLoggerFactory::getLogger('auth')->debug(sprintf('Could not find ext_account "%s" for auth_mode "%s".', $this->uid, $fallback_auth_mode));

                $fallback_auth_mode = 'default';
                ilLoggerFactory::getLogger('auth')->debug(sprintf('Trying to find ext_account "%s" for auth_mode "%s".', $this->uid, $fallback_auth_mode));
                $internal_account = ilObjUser::_checkExternalAuthAccount($fallback_auth_mode, $this->uid, false);
            }
        }

        if (strlen($internal_account) > 0) {
            ilLoggerFactory::getLogger('auth')->debug(sprintf('Found user "%s" for ext_account "%s" in ILIAS database.', $internal_account, $this->uid));

            if ($this->idp->isSynchronizationEnabled()) {
                ilLoggerFactory::getLogger('auth')->debug(sprintf('SAML user synchronisation is enabled, so update existing user "%s" with ext_account "%s".', $internal_account, $this->uid));
                $internal_account = $this->importUser($internal_account, $this->uid, $this->attributes);
            }

            if ($update_auth_mode) {
                $usr_id = ilObjUser::_loginExists($internal_account);
                if ($usr_id > 0) {
                    ilObjUser::_writeAuthMode($usr_id, $this->getUserAuthModeName());
                    ilLoggerFactory::getLogger('auth')->debug(sprintf('SAML Switched auth_mode of user with login "%s" and ext_account "%s" to "%s".', $internal_account, $this->uid, $this->getUserAuthModeName()));
                } else {
                    ilLoggerFactory::getLogger('auth')->debug(sprintf('SAML Could not switch auth_mode of user with login "%s" and ext_account "%s" to "%s".', $internal_account, $this->uid, $this->getUserAuthModeName()));
                }
            }

            ilLoggerFactory::getLogger('auth')->debug(sprintf('Authentication succeeded: Found internal login "%s for ext_account "%s" and auth_mode "%s".', $internal_account, $this->uid, $this->getUserAuthModeName()));

            $status->setStatus(ilAuthStatus::STATUS_AUTHENTICATED);
            $status->setAuthenticatedUserId(ilObjUser::_lookupId($internal_account));
            ilSession::set('used_external_auth', true);
            return true;
        } else {
            ilLoggerFactory::getLogger('auth')->debug(sprintf('Could not find an existing user for ext_account "%s" for any relevant auth_mode.', $this->uid));
            if ($this->idp->isSynchronizationEnabled()) {
                ilLoggerFactory::getLogger('auth')->debug(sprintf('SAML user synchronisation is enabled, so determine action for ext_account "%s" and auth_mode "%s".', $this->uid, $this->getUserAuthModeName()));
                if ($this->idp->isAccountMigrationEnabled() && !$this->force_new_account) {
                    ilSession::set('tmp_attributes', $this->attributes);
                    ilSession::set('tmp_return_to', $this->return_to);

                    ilLoggerFactory::getLogger('auth')->debug(sprintf('Account migration is enabled, so redirecting ext_account "%s" to account migration screen.', $this->uid));

                    $this->setExternalAccountName($this->uid);
                    $status->setStatus(ilAuthStatus::STATUS_ACCOUNT_MIGRATION_REQUIRED);
                    return false;
                }

                $new_name = $this->importUser(null, $this->uid, $this->attributes);
                ilLoggerFactory::getLogger('auth')->debug(sprintf('Created new user account with login "%s" and ext_account "%s".', $new_name, $this->uid));

                ilSession::set('tmp_attributes', null);
                ilSession::set('tmp_return_to', null);
                ilSession::set('used_external_auth', true);

                if (strlen($this->return_to)) {
                    $_GET['target'] = $this->return_to;
                }

                $status->setStatus(ilAuthStatus::STATUS_AUTHENTICATED);
                $status->setAuthenticatedUserId(ilObjUser::_lookupId($new_name));
                return true;
            } else {
                ilLoggerFactory::getLogger('auth')->debug("SAML user synchronisation is not enabled, auth failed.");
                $this->handleAuthenticationFail($status, 'err_auth_saml_no_ilias_user');
                return false;
            }
        }
    }

    public function migrateAccount(ilAuthStatus $status)
    {
    }

    public function createNewAccount(\ilAuthStatus $status)
    {
        if (
            0 === strlen($this->getCredentials()->getUsername()) ||
            !is_array(ilSession::get('tmp_attributes')) ||
            0 === count(ilSession::get('tmp_attributes'))
        ) {
            $this->getLogger()->warning('Cannot find user id for external account: ' . $this->getCredentials()->getUsername());
            $this->handleAuthenticationFail($status, 'err_wrong_login');
            return false;
        }

        $this->uid        = $this->getCredentials()->getUsername();
        $this->attributes = ilSession::get('tmp_attributes');
        $this->return_to  = ilSession::get('tmp_return_to');

        $this->force_new_account = true;
        return $this->handleSamlAuth($status);
    }

    public function setExternalAccountName($a_name)
    {
        $this->migration_account = $a_name;
    }

    public function getExternalAccountName()
    {
        return $this->migration_account;
    }

    public function getTriggerAuthMode()
    {
        return AUTH_SAML . '_' . $this->idp->getIdpId();
    }

    public function getUserAuthModeName()
    {
        return 'saml_' . $this->idp->getIdpId();
    }

    public function importUser($a_internal_login, $a_external_account, $a_user_data = array())
    {
        $mapping = new ilExternalAuthUserAttributeMapping('saml', $this->idp->getIdpId());

        $xml_writer = new ilXmlWriter();
        $xml_writer->xmlStartTag('Users');
        if (null === $a_internal_login) {
            $login = $a_user_data[$this->idp->getLoginClaim()][0];
            $login = ilAuthUtils::_generateLogin($login);

            $xml_writer->xmlStartTag('User', array('Action' => 'Insert'));
            $xml_writer->xmlElement('Login', array(), $login);

            $xml_writer->xmlElement('Role', array(
                'Id'     => $this->idp->getDefaultRoleId(),
                'Type'   => 'Global',
                'Action' => 'Assign'
            ));

            $xml_writer->xmlElement('Active', array(), "true");
            $xml_writer->xmlElement('TimeLimitOwner', array(), USER_FOLDER_ID);
            $xml_writer->xmlElement('TimeLimitUnlimited', array(), 1);
            $xml_writer->xmlElement('TimeLimitFrom', array(), time());
            $xml_writer->xmlElement('TimeLimitUntil', array(), time());
            $xml_writer->xmlElement('AuthMode', array('type' => $this->getUserAuthModeName()), $this->getUserAuthModeName());
            $xml_writer->xmlElement('ExternalAccount', array(), $a_external_account);

            $mapping = new ilExternalAuthUserCreationAttributeMappingFilter($mapping);
        } else {
            $login  = $a_internal_login;
            $usr_id = ilObjUser::_lookupId($a_internal_login);

            $xml_writer->xmlStartTag('User', array('Action' => 'Update', 'Id' => $usr_id));

            $loginClaim = $a_user_data[$this->idp->getLoginClaim()][0];
            if ($login != $loginClaim) {
                $login = ilAuthUtils::_generateLogin($loginClaim);
                $xml_writer->xmlElement('Login', array(), $login);
            }

            $mapping = new ilExternalAuthUserUpdateAttributeMappingFilter($mapping);
        }

        foreach ($mapping as $rule) {
            try {
                $attributeValueParser = new ilSamlMappedUserAttributeValueParser($rule, $a_user_data);
                $value = $attributeValueParser->parse();
                $this->buildUserAttributeXml($xml_writer, $rule, $value);
            } catch (\ilSamlException $e) {
                $this->getLogger()->warning($e->getMessage());
                continue;
            }
        }

        $xml_writer->xmlEndTag('User');
        $xml_writer->xmlEndTag('Users');

        ilLoggerFactory::getLogger('auth')->debug(sprintf('Started import of user "%s" with ext_account "%s" and auth_mode "%s".', $login, $a_external_account, $this->getUserAuthModeName()));
        include_once './Services/User/classes/class.ilUserImportParser.php';
        $importParser = new ilUserImportParser();
        $importParser->setXMLContent($xml_writer->xmlDumpMem(false));
        $importParser->setRoleAssignment(array(
            $this->idp->getDefaultRoleId() => $this->idp->getDefaultRoleId()
        ));
        $importParser->setFolderId(USER_FOLDER_ID);
        $importParser->setUserMappingMode(IL_USER_MAPPING_ID);
        $importParser->startParsing();

        return $login;
    }

    protected function buildUserAttributeXml(\ilXmlWriter $xml_writer, \ilExternalAuthUserAttributeMappingRule $rule, $value)
    {
        switch (strtolower($rule->getAttribute())) {
            case 'gender':
                switch (strtolower($value)) {
                    case 'n':
                    case 'neutral':
                        $xml_writer->xmlElement('Gender', array(), 'n');
                        break;

                    case 'm':
                    case 'male':
                        $xml_writer->xmlElement('Gender', array(), 'm');
                        break;

                    case 'f':
                    case 'female':
                    default:
                        $xml_writer->xmlElement('Gender', array(), 'f');
                        break;
                }
                break;

            case 'firstname':
                $xml_writer->xmlElement('Firstname', array(), $value);
                break;

            case 'lastname':
                $xml_writer->xmlElement('Lastname', array(), $value);
                break;

            case 'email':
                $xml_writer->xmlElement('Email', array(), $value);
                break;

            case 'institution':
                $xml_writer->xmlElement('Institution', array(), $value);
                break;

            case 'department':
                $xml_writer->xmlElement('Department', array(), $value);
                break;

            case 'hobby':
                $xml_writer->xmlElement('Hobby', array(), $value);
                break;

            case 'title':
                $xml_writer->xmlElement('Title', array(), $value);
                break;

            case 'street':
                $xml_writer->xmlElement('Street', array(), $value);
                break;

            case 'city':
                $xml_writer->xmlElement('City', array(), $value);
                break;

            case 'zipcode':
                $xml_writer->xmlElement('PostalCode', array(), $value);
                break;

            case 'country':
                $xml_writer->xmlElement('Country', array(), $value);
                break;

            case 'phone_office':
                $xml_writer->xmlElement('PhoneOffice', array(), $value);
                break;

            case 'phone_home':
                $xml_writer->xmlElement('PhoneHome', array(), $value);
                break;

            case 'phone_mobile':
                $xml_writer->xmlElement('PhoneMobile', array(), $value);
                break;

            case 'fax':
                $xml_writer->xmlElement('Fax', array(), $value);
                break;

            case 'referral_comment':
                $xml_writer->xmlElement('Comment', array(), $value);
                break;

            case 'matriculation':
                $xml_writer->xmlElement('Matriculation', array(), $value);
                break;

            case 'birthday':
                $xml_writer->xmlElement('Birthday', array(), $value);
                break;

            default:
                if (substr($rule->getAttribute(), 0, 4) != 'udf_') {
                    break;
                }

                $udf_data = explode('_', $rule->getAttribute());
                if (!isset($udf_data[1])) {
                    break;
                }

                $definition = ilUserDefinedFields::_getInstance()->getDefinition($udf_data[1]);
                $xml_writer->xmlElement(
                    'UserDefinedField',
                    array('Id' => $definition['il_id'], 'Name' => $definition['field_name']),
                    $value
                );
                break;
        }
    }
}