StudipAuthAbstract Class Reference

Inheritance diagram for StudipAuthAbstract:

Public Member Functions
	__construct ($config=[])
	authenticateUser ($username, $password)
	getStudipUser ($username)
	doNewUserInit ($user)
	setUserDomains ($user)
	getUserDomains ()
	doDataMapping ($user)
	isMappedField ($name)
	verifyUsername ($username)
	isUsedUsername ($username)
	isAuthenticated ($username, $password)
	__isset ($offset)
	__set ($offset, $value)
	__get ($offset)
	__unset ($offset)

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

(

$config = []

)

Constructor

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

Parameters

array

$config

Member Function Documentation

__get

(

$offset

)

__isset

(

$offset

)

__set	(		$offset,
			$value
	)

__unset

(

$offset

)

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

Parameters

string	$username	the username to check
string	$password	the password to check

Returns

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

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

Parameters

string	$username	the username to check
string	$password	the password to check

Returns

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

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

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

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

static CheckIPRangeV4 (   $ip,   $range  )

static

Parameters

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

Returns

bool

static CheckIPRangeV6 (   $ip,   $range  )

static

Parameters

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

Returns

bool

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

Parameters

string

$username

the username

Returns

array

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

private

Parameters

User	the user object

Returns

bool

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

private

Parameters

User

$user

the user object

static getInstance (   $plugin_name = false )

static

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

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

Parameters

string

$plugin_name

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

(

$username

)

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

private

Parameters

string

the username

Returns

User the Stud.IP or false if an error occurs

getUserDomains

(

)

Get the user domains to assign to the current user.

isAuthenticated	(		$username,
			$password
	)

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

abstract, MUST be realized

private

Parameters

string	the username
string	the password

Returns

bool true if authentication succeeds

isMappedField

(

$name

)

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

private

Parameters

string

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

Returns

bool true if the field is mapped

isUsedUsername

(

$username

)

method to check, if username is used

abstract MUST be realized

private

Parameters

string

the username

Returns

bool true if the username exists

setUserDomains

(

$user

)

This method sets the user domains for the current user.

private

Parameters

User	the user object

verifyUsername

(

$username

)

method to eliminate bad characters in the given username

private

Parameters

string

the username

Returns

string the username

Field Documentation

string $error_head

text, which precedes error message for the plugin

string $error_msg

contains error message, if authentication fails

bool $is_new_user = false

indicates whether the authenticated user logs in for the first time

string $plugin_name

name of the plugin

name of the plugin (last part of class name) is set in the constructor

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('

<field name>="">' => array( 'callback' => '<name of="" callback="" method="" used="" for="" data="" retrieval>="">', 'map_args' => '<arguments passed="" to="" callback="" method>="">'))

array $user_domains

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

public

---

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

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