StudipAuthAbstract Class Reference

Inheritance diagram for StudipAuthAbstract:

Collaboration diagram for StudipAuthAbstract:

Public Member Functions
	__construct ()
	authenticateUser ($username, $password)
	getStudipUser ($username)
	doNewUserInit ($user)
	setUserDomains ($user)
	getUserDomains ()
	doDataMapping ($user)
	isMappedField ($name)
	verifyUsername ($username)
	isUsedUsername ($username)
	isAuthenticated ($username, $password)

Static Public Member Functions
static	getInstance ($plugin_name=false)
static	CheckAuthentication ($username, $password)
static	CheckUsername ($username)
static	CheckField ($field_name, $plugin_name)
static	CheckIPRange ()
static	CheckIPRangeV4 ($ip, $range)
static	CheckIPRangeV6 ($ip, $range)

Data Fields
	$error_msg
	$is_new_user = false
	$user_domains
	$user_data_mapping = null
	$plugin_name
	$error_head

Constructor & Destructor Documentation

__construct()

__construct

(

)

Constructor

the constructor is private, you should use StudipAuthAbstract::GetInstance($plugin_name) to get a reference to a plugin object. Make sure the constructor in the base class is called when deriving your own plugin class, it assigns the settings from local.inc as members of the plugin each key of the $STUDIP_AUTH_CONFIG_<plugin name> array will become a member of the object

@access private

Reimplemented in StudipAuthCAS, StudipAuthLdap, StudipAuthLdapReadAndBind, StudipAuthShib, and StudipAuthStandard.

Member Function Documentation

authenticateUser()

authenticateUser	(		$username,
			$password
	)

authentication method

this method authenticates the passed username, it is used by StudipAuthAbstract::CheckAuthentication() if authentication succeeds it calls StudipAuthAbstract::doDataMapping() to map data fields if the authenticated user logs in for the first time it calls StudipAuthAbstract::doNewUserInit() to initialize the new user @access private

Parameters

string	the username to check
string	the password to check

Returns

string if authentication succeeds the Stud.IP user , else false

Reimplemented in StudipAuthLTI.

Here is the call graph for this function:

CheckAuthentication()

static CheckAuthentication (   $username,   $password  )

static

static method to check authentication in all plugins

if authentication fails in one plugin, the error message is stored and the next plugin is used if authentication succeeds, the uid element in the returned array will contain the Stud.IP user id

@access public

Parameters

string	the username to check
string	the password to check

Returns

array structure: array('uid'=>'string <Stud.IP user id>','error'=>'string <error message>','is_new_user'=>'bool')

Here is the caller graph for this function:

CheckField()

static CheckField (   $field_name,   $plugin_name  )

static

static method to check for a mapped field

this method checks in the plugin with the passed name, if the passed Stud.IP DB field is mapped to an external data source

@access public

Parameters

string	the name of the db field must be in form ' <field name>'
string	the name of the plugin to check

Returns

bool true if the field is mapped, else false

Here is the caller graph for this function:

CheckIPRange()

static CheckIPRange ( )

static

static method to check if ip address belongs to allowed range

Returns

bool true if the client ip address is within the valid range

CheckIPRangeV4()

static CheckIPRangeV4 (   $ip,   $range  )

static

Parameters

$ip	string IPv4 adress
$range	array assoc array with [start] & [end]

Returns

bool

CheckIPRangeV6()

static CheckIPRangeV6 (   $ip,   $range  )

static

Parameters

$ip	string IPv6 address
$range	array assoc array with [start] & [end]

Returns

bool

CheckUsername()

static CheckUsername (   $username )

static

static method to check if passed username is used in external data sources

all plugins are checked, the error messages are stored and returned

@access public

Parameters

string

the username

Returns

array

Here is the caller graph for this function:

doDataMapping()

doDataMapping

(

$user

)

this method handles the data mapping

for each entry in $this->user_data_mapping the according callback will be invoked the return value of the callback method is then written to the db field, which is specified in the key of the array

@access private

Parameters

User	the user object

Returns

bool

Here is the caller graph for this function:

doNewUserInit()

doNewUserInit

(

$user

)

initialize a new user

this method is invoked for one time, if a new user logs in ($this->is_new_user is true) place special treatment of new users here

@access private

Parameters

User	the user object

Returns

bool

Here is the call graph for this function:

Here is the caller graph for this function:

getInstance()

static getInstance (   $plugin_name = false )

static

static method to instantiate and retrieve a reference to an object (singleton)

use always this method to instantiate a plugin object, it will ensure that only one object of each plugin will exist @access public

Parameters

string

name of plugin, if omitted an array with all plugin objects will be returned

Returns

mixed either a reference to the plugin with the passed name, or an array with references to all plugins

getStudipUser()

getStudipUser

(

$username

)

method to retrieve the Stud.IP user id to a given username

@access private

Parameters

string

the username

Returns

User the Stud.IP or false if an error occurs

Here is the call graph for this function:

Here is the caller graph for this function:

getUserDomains()

getUserDomains

(

)

Get the user domains to assign to the current user.

Reimplemented in StudipAuthLTI, and StudipAuthShib.

Here is the caller graph for this function:

isAuthenticated()

isAuthenticated	(		$username,
			$password
	)

method to check the authentication of a given username and a given password

abstract, MUST be realized

@access private

Parameters

string	the username
string	the password

Returns

bool true if authentication succeeds

Reimplemented in StudipAuthIP, StudipAuthLdap, StudipAuthLTI, StudipAuthSSO, and StudipAuthStandard.

Here is the caller graph for this function:

isMappedField()

isMappedField

(

$name

)

method to check, if a given db field is mapped by the plugin

@access private

Parameters

string

the name of the db field (<table_name>.<field_name>)

Returns

bool true if the field is mapped

isUsedUsername()

isUsedUsername

(

$username

)

method to check, if username is used

abstract MUST be realized

@access private

Parameters

string

the username

Returns

bool true if the username exists

Reimplemented in StudipAuthLdap, StudipAuthLdapReadAndBind, StudipAuthSSO, and StudipAuthStandard.

setUserDomains()

setUserDomains

(

$user

)

This method sets the user domains for the current user.

@access private

Parameters

User	the user object

Here is the call graph for this function:

Here is the caller graph for this function:

verifyUsername()

verifyUsername

(

$username

)

method to eliminate bad characters in the given username

@access private

Parameters

string

the username

Returns

string the username

Reimplemented in StudipAuthCAS, StudipAuthLTI, and StudipAuthShib.

Here is the caller graph for this function:

Field Documentation

$error_head

$error_head

$error_msg

$error_msg

$is_new_user

$is_new_user = false

$plugin_name

$plugin_name

$user_data_mapping

array $user_data_mapping = null

associative array with mapping for database fields

associative array with mapping for database fields, should be set in local.inc structure : array("<table name>.<field name>" => array( "callback" => "<name of callback method used for data retrieval>", "map_args" => "<arguments passed to callback method>")) @access public

$user_domains

array $user_domains

array of user domains to assign to each user, can be set in local.inc

@access public

---

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

• lib/classes/auth_plugins/StudipAuthAbstract.class.php