blob: 1c9c3bfe11666919ff7e5ea11f15f012248999a6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
<?php
/**
* Elgg Simple PAM library
* Contains functions for managing authentication.
* This is not a full implementation of PAM. It supports a single facility
* (authentication) and allows multiple policies (user authentication is the
* default). There are two control flags possible for each module: sufficient
* or required. The entire chain for a policy is processed (or until a
* required module fails). A module fails by returning false or throwing an
* exception. The order that modules are processed is determined by the order
* they are registered. For an example of a PAM, see pam_auth_userpass() in
* sessions.php.
*
* For more information on PAMs see:
* http://www.freebsd.org/doc/en/articles/pam/index.html
*
* @see ElggPAM
*
* @package Elgg.Core
* @subpackage Authentication.PAM
*/
global $_PAM_HANDLERS;
$_PAM_HANDLERS = array();
/**
* Register a PAM handler.
*
* A PAM handler should return true if the authentication attempt passed. For a
* failure, return false or throw an exception. Returning nothing indicates that
* the handler wants to be skipped.
*
* Note, $handler must be string callback (not an array/Closure).
*
* @param string $handler Callable global handler function in the format ()
* pam_handler($credentials = NULL);
* @param string $importance The importance - "sufficient" (default) or "required"
* @param string $policy The policy type, default is "user"
*
* @return bool
*/
function register_pam_handler($handler, $importance = "sufficient", $policy = "user") {
global $_PAM_HANDLERS;
// setup array for this type of pam if not already set
if (!isset($_PAM_HANDLERS[$policy])) {
$_PAM_HANDLERS[$policy] = array();
}
// @todo remove requirement that $handle be a global function
if (is_string($handler) && is_callable($handler, true)) {
$_PAM_HANDLERS[$policy][$handler] = new stdClass;
$_PAM_HANDLERS[$policy][$handler]->handler = $handler;
$_PAM_HANDLERS[$policy][$handler]->importance = strtolower($importance);
return true;
}
return false;
}
/**
* Unregisters a PAM handler.
*
* @param string $handler The PAM handler function name
* @param string $policy The policy type, default is "user"
*
* @return void
* @since 1.7.0
*/
function unregister_pam_handler($handler, $policy = "user") {
global $_PAM_HANDLERS;
unset($_PAM_HANDLERS[$policy][$handler]);
}
|
