SimpleSAML\Utils\Auth Class Reference

Collaboration diagram for SimpleSAML\Utils\Auth:

Static Public Member Functions
static	getAdminLoginURL ($returnTo=null)
	Retrieve a admin login URL. More...
static	isAdmin ()
	Check whether the current user is admin. More...
static	requireAdmin ()
	Require admin access to the current page. More...

Detailed Description

Definition at line 11 of file Auth.php.

Member Function Documentation

getAdminLoginURL()

static SimpleSAML\Utils\Auth::getAdminLoginURL (   $returnTo = null )

static

Retrieve a admin login URL.

Parameters

string | NULL

$returnTo

The URL the user should arrive on after admin authentication. Defaults to null.

Returns

string A URL which can be used for admin authentication.

Exceptions

InvalidArgumentException If $returnTo is neither a string nor null.

Definition at line 22 of file Auth.php.

    {
        if (!(is_string($returnTo) || is_null($returnTo))) {
            throw new \InvalidArgumentException('Invalid input parameters.');
        }
 
        if ($returnTo === null) {
            $returnTo = HTTP::getSelfURL();
        }
 
        return Module::getModuleURL('core/login-admin.php', array('ReturnTo' => $returnTo));
    }

References $returnTo, and SimpleSAML\Module\getModuleURL().

Referenced by SimpleSAML_Utilities\getAdminLoginURL().

Here is the call graph for this function:

Here is the caller graph for this function:

isAdmin()

static SimpleSAML\Utils\Auth::isAdmin ( )

static

Check whether the current user is admin.

Returns

boolean True if the current user is an admin user, false otherwise.

Author

Olav Morken, UNINETT AS olav..nosp@m.mork.nosp@m.en@un.nosp@m.inet.nosp@m.t.no

Definition at line 42 of file Auth.php.

    {
        $session = \SimpleSAML_Session::getSessionFromRequest();
        return $session->isValid('admin') || $session->isValid('login-admin');
    }

References $session, and SimpleSAML_Session\getSessionFromRequest().

Referenced by SimpleSAML_Utilities\isAdmin().

Here is the call graph for this function:

Here is the caller graph for this function:

requireAdmin()

static SimpleSAML\Utils\Auth::requireAdmin ( )

static

Require admin access to the current page.

This is a helper function for limiting a page to those with administrative access. It will redirect the user to a login page if the current user doesn't have admin access.

Returns

void This function will only return if the user is admin.

Exceptions

SimpleSAML_Error_Exception If no "admin" authentication source was configured.

Author

Olav Morken, UNINETT AS olav..nosp@m.mork.nosp@m.en@un.nosp@m.inet.nosp@m.t.no

Jaime Perez, UNINETT AS jaime.nosp@m..per.nosp@m.ez@un.nosp@m.inet.nosp@m.t.no

Definition at line 60 of file Auth.php.

    {
        if (self::isAdmin()) {
            return;
        }
 
        // not authenticated as admin user, start authentication
        if (\SimpleSAML_Auth_Source::getById('admin') !== null) {
            $as = new \SimpleSAML\Auth\Simple('admin');
            $as->login();
        } else {
            throw new \SimpleSAML_Error_Exception(
                'Cannot find "admin" auth source, and admin privileges are required.'
            );
        }
    }

References $as, and SimpleSAML_Auth_Source\getById().

Referenced by sspmod_statistics_AccessCheck\checkAccess(), and SimpleSAML_Utilities\requireAdmin().

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• libs/composer/vendor/simplesamlphp/simplesamlphp/lib/SimpleSAML/Utils/Auth.php