* @copyright Maxime Delorme * @license http://gnu.org/copyleft/gpl.html GNU GPL v2 or later */ require_once("auth-functions.php"); class ldapDrivers { /**#@+ * @access private */ /** * Holds the LDAP connection parameters */ var $connect; /**#@-*/ /** * Constructor. * @param array $config The configuration data */ function ldapDrivers($config){ $this->__construct($config); } /** * Initializes the LDAP connection * * @param array $config The configuration data */ function __construct($config) { global $c; $host=$config['host']; $port=$config['port']; if(!function_exists('ldap_connect')){ $c->messages[] = i18n("drivers_ldap : function ldap_connect not defined, check your php_ldap module"); $this->valid=false; return ; } //Set LDAP protocol version if (isset($config['protocolVersion'])) ldap_set_option($this->connect, LDAP_OPT_PROTOCOL_VERSION, $config['protocolVersion']); if (isset($config['optReferrals'])) ldap_set_option($this->connect, LDAP_OPT_REFERRALS, $config['optReferrals']); if ($port) $this->connect=ldap_connect($host, $port); else $this->connect=ldap_connect($host); if (! $this->connect){ $c->messages[] = sprintf(translate( 'drivers_ldap : Unable to connect to LDAP with port %s on host %s'), $port, $host ); $this->valid=false; return ; } dbg_error_log( "LDAP", "drivers_ldap : Connected to LDAP server %s",$host ); // Start TLS if desired (requires protocol version 3) if (isset($config['startTLS'])) { if (!ldap_set_option($this->connect, LDAP_OPT_PROTOCOL_VERSION, 3)) { $c->messages[] = i18n('drivers_ldap : Failed to set LDAP to use protocol version 3, TLS not supported'); $this->valid=false; return; } if (!ldap_start_tls($this->connect)) { $c->messages[] = i18n('drivers_ldap : Could not start TLS: ldap_start_tls() failed'); $this->valid=false; return; } } //Set the search scope to be used, default to subtree. This sets the functions to be called later. if (!isset($config['scope'])) $config['scope'] = 'subtree'; switch (strtolower($config['scope'])) { case "base": $this->ldap_query_one = 'ldap_read'; $this->ldap_query_all = 'ldap_read'; break; case "onelevel": $this->ldap_query_one = 'ldap_list'; $this->ldap_query_all = 'ldap_search'; break; default: $this->ldap_query_one = 'ldap_search'; $this->ldap_query_all = 'ldap_search'; break; } //connect as root if (!ldap_bind($this->connect, (isset($config['bindDN']) ? $config['bindDN'] : null), (isset($config['passDN']) ? $config['passDN'] : null) ) ){ $bindDN = isset($config['bindDN']) ? $config['bindDN'] : 'anonymous'; $passDN = isset($config['passDN']) ? $config['passDN'] : 'anonymous'; dbg_error_log( "LDAP", i18n('drivers_ldap : Failed to bind to host %1$s on port %2$s with bindDN of %3$s'), $host, $port, $bindDN ); $c->messages[] = i18n( 'drivers_ldap : Unable to bind to LDAP - check your configuration for bindDN and passDN, and that your LDAP server is reachable'); $this->valid=false; return ; } $this->valid = true; //root to start search $this->baseDNUsers = is_string($config['baseDNUsers']) ? array($config['baseDNUsers']) : $config['baseDNUsers']; $this->filterUsers = (isset($config['filterUsers']) ? $config['filterUsers'] : null); $this->baseDNGroups = (isset($config['baseDNGroups']) ? $config['baseDNGroups'] : null); $this->filterGroups = (isset($config['filterGroups']) ? $config['filterGroups'] : null); } /** * Retrieve all users from the LDAP directory */ function getAllUsers($attributes){ global $c; $query = $this->ldap_query_all; foreach($this->baseDNUsers as $baseDNUsers) { $entry = $query($this->connect,$baseDNUsers,$this->filterUsers,$attributes); if (!ldap_first_entry($this->connect,$entry)) { $c->messages[] = sprintf(translate('Error NoUserFound with filter >%s<, attributes >%s< , dn >%s<'), $this->filterUsers, join(', ', $attributes), $baseDNUsers); } $row = array(); for($i = ldap_first_entry($this->connect,$entry); $i && $arr = ldap_get_attributes($this->connect,$i); $i = ldap_next_entry($this->connect,$i) ) { for ($j=0; $j < $arr['count']; $j++) { $row[$arr[$j]] = $arr[$arr[$j]][0]; } $ret[]=$row; } } return $ret; } /** * Returns the result of the LDAP query * * @param string $filter The filter used to search entries * @param array $attributes Attributes to be returned * @param string $passwd password to check * @return array Contains selected attributes from all entries corresponding to the given filter */ function requestUser( $filter, $attributes=NULL, $username, $passwd) { global $c; $entry=NULL; // We get the DN of the USER $query = $this->ldap_query_one; foreach($this->baseDNUsers as $baseDNUsers) { $entry = $query($this->connect, $baseDNUsers, $filter, $attributes); if (ldap_first_entry($this->connect,$entry) ) break; dbg_error_log( "LDAP", "drivers_ldap : Failed to find user with baseDN: %s", $baseDNUsers ); } if ( !ldap_first_entry($this->connect, $entry) ){ dbg_error_log( "ERROR", "drivers_ldap : Unable to find the user with filter %s",$filter ); return false; } else { dbg_error_log( "LDAP", "drivers_ldap : Found a user using filter %s",$filter ); } $dnUser = ldap_get_dn($this->connect, ldap_first_entry($this->connect,$entry)); if ($c->authenticate_hook['config']['i_use_mode_kerberos'] == "i_know_what_i_am_doing") { dbg_error_log( "LOG", "drivers_ldap : Skipping password Check for user %s which should be the same as %s",$username , $_SERVER["REMOTE_USER"]); if ($username != $_SERVER["REMOTE_USER"]) { return false; } } else { if ( !@ldap_bind($this->connect, $dnUser, $passwd) ) { dbg_error_log( "LDAP", "drivers_ldap : Failed to bind to user %s using password %s", $dnUser, $passwd ); return false; } } dbg_error_log( "LDAP", "drivers_ldap : Bound to user %s using password %s", $dnUser, $passwd ); $i = ldap_first_entry($this->connect,$entry); $arr = ldap_get_attributes($this->connect,$i); for( $i=0; $i<$arr['count']; $i++ ) { $ret[$arr[$i]]=$arr[$arr[$i]][0]; } return $ret; } } /** * A generic function to create and fetch static objects */ function getStaticLdap() { global $c; // Declare a static variable to hold the object instance static $instance; // If the instance is not there, create one if(!isset($instance)) { $ldapDrivers =& new ldapDrivers($c->authenticate_hook['config']); } return $ldapDrivers; } /** * Synchronise a cached user with one from LDAP * @param object $usr A user record to be updated (or created) */ function sync_user_from_LDAP( &$usr, $mapping, $ldap_values ) { global $c; dbg_error_log( "LDAP", "Going to sync the user from LDAP" ); $validUserFields = get_fields('usr'); if ( isset($c->authenticate_hook['config']['default_value']) && is_array($c->authenticate_hook['config']['default_value']) ) { foreach ( $c->authenticate_hook['config']['default_value'] as $field => $value ) { if ( isset($validUserFields[$field]) ) { $usr->{$field} = $value; dbg_error_log( "LDAP", "Setting usr->%s to %s from configured defaults", $field, $value ); } } } foreach ( $mapping as $field => $value ) { dbg_error_log( "LDAP", "Considering copying %s", $field ); if ( isset($validUserFields[$field]) ) { $usr->{$field} = $ldap_values[$value]; dbg_error_log( "LDAP", "Setting usr->%s to %s from LDAP field %s", $field, $ldap_values[$value], $value ); } } UpdateUserFromExternal( $usr ); } /** * Check the username / password against the LDAP server */ function LDAP_check($username, $password ){ global $c; $ldapDriver = getStaticLdap(); if ( !$ldapDriver->valid ) { dbg_error_log( "ERROR", "Couldn't contact LDAP server for authentication" ); return false; } $mapping = $c->authenticate_hook['config']['mapping_field']; $attributes = array_values($mapping); /** * If the config contains a filter that starts with a ( then believe * them and don't modify it, otherwise wrap the filter. */ $filter_munge = ""; if ( preg_match( '/^\(/', $ldapDriver->filterUsers ) ) { $filter_munge = $ldapDriver->filterUsers; } else if ( isset($ldapDriver->filterUsers) && $ldapDriver->filterUsers != '' ) { $filter_munge = "($ldapDriver->filterUsers)"; } $filter = "(&$filter_munge(".$mapping["username"]."=$username))"; $valid = $ldapDriver->requestUser( $filter, $attributes, $username, $password ); // is a valid user or not if ( !$valid ) { dbg_error_log( "LDAP", "user %s is not a valid user",$username ); return false; } $ldap_timestamp = $valid[$mapping["updated"]]; /** * This splits the LDAP timestamp apart and assigns values to $Y $m $d $H $M and $S */ foreach($c->authenticate_hook['config']['format_updated'] as $k => $v) $$k = substr($ldap_timestamp,$v[0],$v[1]); $ldap_timestamp = "$Y"."$m"."$d"."$H"."$M"."$S"; $valid[$mapping["updated"]] = "$Y-$m-$d $H:$M:$S"; if ( $usr = getUserByName($username) ) { // should we update it ? $db_timestamp = $usr->updated; $db_timestamp = substr(strtr($db_timestamp, array(':' => '',' '=>'','-'=>'')),0,14); if($ldap_timestamp <= $db_timestamp) { return $usr; // no need to update } // we will need to update the user record } else { dbg_error_log( "LDAP", "user %s doesn't exist in local DB, we need to create it",$username ); $usr = (object) array( 'user_no' => 0 ); } // The local cached user doesn't exist, or is older, so we create/update their details sync_user_from_LDAP($usr, $mapping, $valid ); return $usr; } /** * sync LDAP against the DB */ function sync_LDAP(){ global $c; $ldapDriver = getStaticLdap(); if($ldapDriver->valid){ $mapping = $c->authenticate_hook['config']['mapping_field']; $attributes = array_values($mapping); $ldap_users_tmp = $ldapDriver->getAllUsers($attributes); if ( sizeof($ldap_users_tmp) == 0 ) return; foreach($ldap_users_tmp as $key => $ldap_user){ $ldap_users_info[$ldap_user[$mapping["username"]]] = $ldap_user; unset($ldap_users_tmp[$key]); } $qry = new AwlQuery( "SELECT username, user_no, updated FROM usr "); $qry->Exec('sync_LDAP',__LINE__,__FILE__); while($db_user = $qry->Fetch()) { $db_users[] = $db_user->username; $db_users_info[$db_user->username] = array('user_no' => $db_user->user_no, 'updated' => $db_user->updated); } $ldap_users = array_keys($ldap_users_info); // users only in ldap $users_to_create = array_diff($ldap_users,$db_users); // users only in db $users_to_deactivate = array_diff($db_users,$ldap_users); // users present in ldap and in the db $users_to_update = array_intersect($db_users,$ldap_users); // creation of all users; if ( sizeof($users_to_create) ) { $c->messages[] = sprintf(i18n('- creating record for users : %s'),join(', ',$users_to_create)); foreach( $users_to_create as $username ) { $user = (object) array( 'user_no' => 0, 'username' => $username ); $valid = $ldap_users_info[$username]; $ldap_timestamp = $valid[$mapping["updated"]]; /** * This splits the LDAP timestamp apart and assigns values to $Y $m $d $H $M and $S */ foreach($c->authenticate_hook['config']['format_updated'] as $k => $v) $$k = substr($ldap_timestamp,$v[0],$v[1]); $ldap_timestamp = "$Y"."$m"."$d"."$H"."$M"."$S"; $valid[$mapping["updated"]] = "$Y-$m-$d $H:$M:$S"; sync_user_from_LDAP( $user, $mapping, $valid ); } } // deactivating all users $params = array(); $i = 0; foreach( $users_to_deactivate AS $v ) { if ( isset($c->do_not_sync_from_ldap) && isset($c->do_not_sync_from_ldap[$v]) ) continue; $params[':u'.$i++] = strtolower($v); } if ( $usr_in != '' ) { $c->messages[] = sprintf(i18n('- deactivating users : %s'),join(', ',$users_to_deactivate)); $qry = new AwlQuery( 'UPDATE usr SET active = FALSE WHERE lower(username) IN ('.implode(',',array_keys($params)).')', $params); $qry->Exec('sync_LDAP',__LINE__,__FILE__); } // updating all users if ( sizeof($users_to_update) ) { foreach ( $users_to_update as $key=> $username ) { $valid=$ldap_users_info[$username]; $ldap_timestamp = $valid[$mapping["updated"]]; $valid["user_no"] = $db_users_info[$username]["user_no"]; $mapping["user_no"] = "user_no"; /** * This splits the LDAP timestamp apart and assigns values to $Y $m $d $H $M and $S */ foreach($c->authenticate_hook['config']['format_updated'] as $k => $v) $$k = substr($ldap_timestamp,$v[0],$v[1]); $ldap_timestamp = "$Y"."$m"."$d"."$H"."$M"."$S"; $valid[$mapping["updated"]] = "$Y-$m-$d $H:$M:$S"; $db_timestamp = substr(strtr($db_users_info[$username]['updated'], array(':' => '',' '=>'','-'=>'')),0,14); if ( $ldap_timestamp > $db_timestamp ) { sync_user_from_LDAP($usr, $mapping, $valid ); } else { unset($users_to_update[$key]); $users_nothing_done[] = $username; } } if ( sizeof($users_to_update) ) $c->messages[] = sprintf(i18n('- updating user records : %s'),join(', ',$users_to_update)); if ( sizeof($users_nothing_done) ) $c->messages[] = sprintf(i18n('- nothing done on : %s'),join(', ', $users_nothing_done)); } } }