476 lines
17 KiB
PHP
476 lines
17 KiB
PHP
<?php
|
||
|
||
/**
|
||
* ownCloud – LDAP Access
|
||
*
|
||
* @author Arthur Schiwon
|
||
* @copyright 2012, 2013 Arthur Schiwon blizzz@owncloud.com
|
||
*
|
||
* This library is free software; you can redistribute it and/or
|
||
* modify it under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE
|
||
* License as published by the Free Software Foundation; either
|
||
* version 3 of the License, or any later version.
|
||
*
|
||
* This library is distributed in the hope that it will be useful,
|
||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
* GNU AFFERO GENERAL PUBLIC LICENSE for more details.
|
||
*
|
||
* You should have received a copy of the GNU Affero General Public
|
||
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
||
*
|
||
*/
|
||
|
||
namespace OCA\user_ldap\lib;
|
||
|
||
class Connection {
|
||
private $ldapConnectionRes = null;
|
||
private $configPrefix;
|
||
private $configID;
|
||
private $configured = false;
|
||
|
||
//cache handler
|
||
protected $cache;
|
||
|
||
//settings
|
||
protected $config = array(
|
||
'ldapHost' => null,
|
||
'ldapPort' => null,
|
||
'ldapBackupHost' => null,
|
||
'ldapBackupPort' => null,
|
||
'ldapBase' => null,
|
||
'ldapBaseUsers' => null,
|
||
'ldapBaseGroups' => null,
|
||
'ldapAgentName' => null,
|
||
'ldapAgentPassword' => null,
|
||
'ldapTLS' => null,
|
||
'ldapNoCase' => null,
|
||
'turnOffCertCheck' => null,
|
||
'ldapIgnoreNamingRules' => null,
|
||
'ldapUserDisplayName' => null,
|
||
'ldapUserFilter' => null,
|
||
'ldapGroupFilter' => null,
|
||
'ldapGroupDisplayName' => null,
|
||
'ldapLoginFilter' => null,
|
||
'ldapQuotaAttribute' => null,
|
||
'ldapQuotaDefault' => null,
|
||
'ldapEmailAttribute' => null,
|
||
'ldapCacheTTL' => null,
|
||
'ldapUuidAttribute' => null,
|
||
'ldapOverrideUuidAttribute' => null,
|
||
'ldapOverrideMainServer' => false,
|
||
'homeFolderNamingRule' => null,
|
||
'hasPagedResultSupport' => false,
|
||
);
|
||
|
||
/**
|
||
* @brief Constructor
|
||
* @param $configPrefix a string with the prefix for the configkey column (appconfig table)
|
||
* @param $configID a string with the value for the appid column (appconfig table) or null for on-the-fly connections
|
||
*/
|
||
public function __construct($configPrefix = '', $configID = 'user_ldap') {
|
||
$this->configPrefix = $configPrefix;
|
||
$this->configID = $configID;
|
||
$this->cache = \OC_Cache::getGlobalCache();
|
||
$this->config['hasPagedResultSupport'] = (function_exists('ldap_control_paged_result') && function_exists('ldap_control_paged_result_response'));
|
||
}
|
||
|
||
public function __destruct() {
|
||
if(is_resource($this->ldapConnectionRes)) {
|
||
@ldap_unbind($this->ldapConnectionRes);
|
||
};
|
||
}
|
||
|
||
public function __get($name) {
|
||
if(!$this->configured) {
|
||
$this->readConfiguration();
|
||
}
|
||
|
||
if(isset($this->config[$name])) {
|
||
return $this->config[$name];
|
||
}
|
||
}
|
||
|
||
public function __set($name, $value) {
|
||
$changed = false;
|
||
//omly few options are writable
|
||
if($name == 'ldapUuidAttribute') {
|
||
\OCP\Util::writeLog('user_ldap', 'Set config ldapUuidAttribute to '.$value, \OCP\Util::DEBUG);
|
||
$this->config[$name] = $value;
|
||
if(!empty($this->configID)) {
|
||
\OCP\Config::setAppValue($this->configID, $this->configPrefix.'ldap_uuid_attribute', $value);
|
||
}
|
||
$changed = true;
|
||
}
|
||
if($changed) {
|
||
$this->validateConfiguration();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @brief initializes the LDAP backend
|
||
* @param $force read the config settings no matter what
|
||
*
|
||
* initializes the LDAP backend
|
||
*/
|
||
public function init($force = false) {
|
||
$this->readConfiguration($force);
|
||
$this->establishConnection();
|
||
}
|
||
|
||
/**
|
||
* Returns the LDAP handler
|
||
*/
|
||
public function getConnectionResource() {
|
||
if(!$this->ldapConnectionRes) {
|
||
$this->init();
|
||
} else if(!is_resource($this->ldapConnectionRes)) {
|
||
$this->ldapConnectionRes = null;
|
||
$this->establishConnection();
|
||
}
|
||
if(is_null($this->ldapConnectionRes)) {
|
||
\OCP\Util::writeLog('user_ldap', 'Connection could not be established', \OCP\Util::ERROR);
|
||
}
|
||
return $this->ldapConnectionRes;
|
||
}
|
||
|
||
private function getCacheKey($key) {
|
||
$prefix = 'LDAP-'.$this->configID.'-'.$this->configPrefix.'-';
|
||
if(is_null($key)) {
|
||
return $prefix;
|
||
}
|
||
return $prefix.md5($key);
|
||
}
|
||
|
||
public function getFromCache($key) {
|
||
if(!$this->configured) {
|
||
$this->readConfiguration();
|
||
}
|
||
if(!$this->config['ldapCacheTTL']) {
|
||
return null;
|
||
}
|
||
if(!$this->isCached($key)) {
|
||
return null;
|
||
|
||
}
|
||
$key = $this->getCacheKey($key);
|
||
|
||
return unserialize(base64_decode($this->cache->get($key)));
|
||
}
|
||
|
||
public function isCached($key) {
|
||
if(!$this->configured) {
|
||
$this->readConfiguration();
|
||
}
|
||
if(!$this->config['ldapCacheTTL']) {
|
||
return false;
|
||
}
|
||
$key = $this->getCacheKey($key);
|
||
return $this->cache->hasKey($key);
|
||
}
|
||
|
||
public function writeToCache($key, $value) {
|
||
if(!$this->configured) {
|
||
$this->readConfiguration();
|
||
}
|
||
if(!$this->config['ldapCacheTTL']) {
|
||
return null;
|
||
}
|
||
$key = $this->getCacheKey($key);
|
||
$value = base64_encode(serialize($value));
|
||
$this->cache->set($key, $value, $this->config['ldapCacheTTL']);
|
||
}
|
||
|
||
public function clearCache() {
|
||
$this->cache->clear($this->getCacheKey(null));
|
||
}
|
||
|
||
private function getValue($varname) {
|
||
static $defaults;
|
||
if(is_null($defaults)){
|
||
$defaults = $this->getDefaults();
|
||
}
|
||
return \OCP\Config::getAppValue($this->configID,
|
||
$this->configPrefix.$varname,
|
||
$defaults[$varname]);
|
||
}
|
||
|
||
/**
|
||
* Caches the general LDAP configuration.
|
||
*/
|
||
private function readConfiguration($force = false) {
|
||
if((!$this->configured || $force) && !is_null($this->configID)) {
|
||
$defaults = $this->getDefaults();
|
||
$v = 'getValue';
|
||
$this->config['ldapHost'] = $this->$v('ldap_host');
|
||
$this->config['ldapBackupHost'] = $this->$v('ldap_backup_host');
|
||
$this->config['ldapPort'] = $this->$v('ldap_port');
|
||
$this->config['ldapBackupPort'] = $this->$v('ldapPort');
|
||
$this->config['ldapOverrideMainServer']
|
||
= $this->$v('ldap_override_main_server');
|
||
$this->config['ldapAgentName'] = $this->$v('ldap_dn');
|
||
$this->config['ldapAgentPassword']
|
||
= base64_decode($this->$v('ldap_agent_password'));
|
||
$rawLdapBase = $this->$v('ldap_base');
|
||
$this->config['ldapBase']
|
||
= preg_split('/\r\n|\r|\n/', $rawLdapBase);
|
||
$this->config['ldapBaseUsers']
|
||
= preg_split('/\r\n|\r|\n/', ($this->$v('ldap_base_users')));
|
||
$this->config['ldapBaseGroups']
|
||
= preg_split('/\r\n|\r|\n/', $this->$v('ldap_base_groups'));
|
||
unset($rawLdapBase);
|
||
$this->config['ldapTLS'] = $this->$v('ldap_tls');
|
||
$this->config['ldapNoCase'] = $this->$v('ldap_nocase');
|
||
$this->config['turnOffCertCheck']
|
||
= $this->$v('ldap_turn_off_cert_check');
|
||
$this->config['ldapUserDisplayName']
|
||
= mb_strtolower($this->$v('ldap_display_name'),'UTF-8');
|
||
$this->config['ldapUserFilter']
|
||
= $this->$v('ldap_userlist_filter');
|
||
$this->config['ldapGroupFilter'] = $this->$v('ldap_group_filter');
|
||
$this->config['ldapLoginFilter'] = $this->$v('ldap_login_filter');
|
||
$this->config['ldapGroupDisplayName']
|
||
= mb_strtolower($this->$v('ldap_group_display_name'), 'UTF-8');
|
||
$this->config['ldapQuotaAttribute']
|
||
= $this->$v('ldap_quota_attr');
|
||
$this->config['ldapQuotaDefault']
|
||
= $this->$v('ldap_quota_def');
|
||
$this->config['ldapEmailAttribute']
|
||
= $this->$v('ldap_email_attr');
|
||
$this->config['ldapGroupMemberAssocAttr']
|
||
= $this->$v('ldap_group_member_assoc_attribute');
|
||
$this->config['ldapIgnoreNamingRules']
|
||
= \OCP\Config::getSystemValue('ldapIgnoreNamingRules', false);
|
||
$this->config['ldapCacheTTL'] = $this->$v('ldap_cache_ttl');
|
||
$this->config['ldapUuidAttribute']
|
||
= $this->$v('ldap_uuid_attribute');
|
||
$this->config['ldapOverrideUuidAttribute']
|
||
= $this->$v('ldap_override_uuid_attribute');
|
||
$this->config['homeFolderNamingRule']
|
||
= $this->$v('home_folder_naming_rule');
|
||
|
||
$this->configured = $this->validateConfiguration();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @brief set LDAP configuration with values delivered by an array, not read from configuration
|
||
* @param $config array that holds the config parameters in an associated array
|
||
* @param &$setParameters optional; array where the set fields will be given to
|
||
* @return true if config validates, false otherwise. Check with $setParameters for detailed success on single parameters
|
||
*/
|
||
public function setConfiguration($config, &$setParameters = null) {
|
||
if(!is_array($config)) {
|
||
return false;
|
||
}
|
||
|
||
$params = array('ldap_host'=>'ldapHost', 'ldap_port'=>'ldapPort', 'ldap_backup_host'=>'ldapBackupHost', 'ldap_backup_port'=>'ldapBackupPort', 'ldap_override_main_server' => 'ldapOverrideMainServer', 'ldap_dn'=>'ldapAgentName', 'ldap_agent_password'=>'ldapAgentPassword', 'ldap_base'=>'ldapBase', 'ldap_base_users'=>'ldapBaseUsers', 'ldap_base_groups'=>'ldapBaseGroups', 'ldap_userlist_filter'=>'ldapUserFilter', 'ldap_login_filter'=>'ldapLoginFilter', 'ldap_group_filter'=>'ldapGroupFilter', 'ldap_display_name'=>'ldapUserDisplayName', 'ldap_group_display_name'=>'ldapGroupDisplayName',
|
||
|
||
'ldap_tls'=>'ldapTLS', 'ldap_nocase'=>'ldapNoCase', 'ldap_quota_def'=>'ldapQuotaDefault', 'ldap_quota_attr'=>'ldapQuotaAttribute', 'ldap_email_attr'=>'ldapEmailAttribute', 'ldap_group_member_assoc_attribute'=>'ldapGroupMemberAssocAttr', 'ldap_cache_ttl'=>'ldapCacheTTL', 'home_folder_naming_rule' => 'homeFolderNamingRule');
|
||
|
||
foreach($config as $parameter => $value) {
|
||
if(isset($this->config[$parameter])) {
|
||
$this->config[$parameter] = $value;
|
||
if(is_array($setParameters)) {
|
||
$setParameters[] = $parameter;
|
||
}
|
||
} else if(isset($params[$parameter])) {
|
||
$this->config[$params[$parameter]] = $value;
|
||
if(is_array($setParameters)) {
|
||
$setParameters[] = $params[$parameter];
|
||
}
|
||
}
|
||
}
|
||
|
||
$this->configured = $this->validateConfiguration();
|
||
|
||
return $this->configured;
|
||
}
|
||
|
||
/**
|
||
* @brief get the current LDAP configuration
|
||
* @return array
|
||
*/
|
||
public function getConfiguration() {
|
||
return $this->config;
|
||
}
|
||
|
||
/**
|
||
* @brief Validates the user specified configuration
|
||
* @returns true if configuration seems OK, false otherwise
|
||
*/
|
||
private function validateConfiguration() {
|
||
//first step: "soft" checks: settings that are not really necessary, but advisable. If left empty, give an info message
|
||
if(empty($this->config['ldapBaseUsers'])) {
|
||
\OCP\Util::writeLog('user_ldap', 'Base tree for Users is empty, using Base DN', \OCP\Util::INFO);
|
||
$this->config['ldapBaseUsers'] = $this->config['ldapBase'];
|
||
}
|
||
if(empty($this->config['ldapBaseGroups'])) {
|
||
\OCP\Util::writeLog('user_ldap', 'Base tree for Groups is empty, using Base DN', \OCP\Util::INFO);
|
||
$this->config['ldapBaseGroups'] = $this->config['ldapBase'];
|
||
}
|
||
if(empty($this->config['ldapGroupFilter']) && empty($this->config['ldapGroupMemberAssocAttr'])) {
|
||
\OCP\Util::writeLog('user_ldap', 'No group filter is specified, LDAP group feature will not be used.', \OCP\Util::INFO);
|
||
}
|
||
if(!in_array($this->config['ldapUuidAttribute'], array('auto', 'entryuuid', 'nsuniqueid', 'objectguid')) && (!is_null($this->configID))) {
|
||
\OCP\Config::setAppValue($this->configID, $this->configPrefix.'ldap_uuid_attribute', 'auto');
|
||
\OCP\Util::writeLog('user_ldap', 'Illegal value for the UUID Attribute, reset to autodetect.', \OCP\Util::INFO);
|
||
}
|
||
if(empty($this->config['ldapBackupPort'])) {
|
||
//force default
|
||
$this->config['ldapBackupPort'] = $this->config['ldapPort'];
|
||
}
|
||
|
||
|
||
//second step: critical checks. If left empty or filled wrong, set as unconfigured and give a warning.
|
||
$configurationOK = true;
|
||
if(empty($this->config['ldapHost'])) {
|
||
\OCP\Util::writeLog('user_ldap', 'No LDAP host given, won`t connect.', \OCP\Util::WARN);
|
||
$configurationOK = false;
|
||
}
|
||
if(empty($this->config['ldapPort'])) {
|
||
\OCP\Util::writeLog('user_ldap', 'No LDAP Port given, won`t connect.', \OCP\Util::WARN);
|
||
$configurationOK = false;
|
||
}
|
||
if((empty($this->config['ldapAgentName']) && !empty($this->config['ldapAgentPassword']))
|
||
|| (!empty($this->config['ldapAgentName']) && empty($this->config['ldapAgentPassword']))) {
|
||
\OCP\Util::writeLog('user_ldap', 'Either no password given for the user agent or a password is given, but no LDAP agent; won`t connect.', \OCP\Util::WARN);
|
||
$configurationOK = false;
|
||
}
|
||
//TODO: check if ldapAgentName is in DN form
|
||
if(empty($this->config['ldapBase']) && (empty($this->config['ldapBaseUsers']) && empty($this->config['ldapBaseGroups']))) {
|
||
\OCP\Util::writeLog('user_ldap', 'No Base DN given, won`t connect.', \OCP\Util::WARN);
|
||
$configurationOK = false;
|
||
}
|
||
if(empty($this->config['ldapUserDisplayName'])) {
|
||
\OCP\Util::writeLog('user_ldap', 'No user display name attribute specified, won`t connect.', \OCP\Util::WARN);
|
||
$configurationOK = false;
|
||
}
|
||
if(empty($this->config['ldapGroupDisplayName'])) {
|
||
\OCP\Util::writeLog('user_ldap', 'No group display name attribute specified, won`t connect.', \OCP\Util::WARN);
|
||
$configurationOK = false;
|
||
}
|
||
if(empty($this->config['ldapLoginFilter'])) {
|
||
\OCP\Util::writeLog('user_ldap', 'No login filter specified, won`t connect.', \OCP\Util::WARN);
|
||
$configurationOK = false;
|
||
}
|
||
if(mb_strpos($this->config['ldapLoginFilter'], '%uid', 0, 'UTF-8') === false) {
|
||
\OCP\Util::writeLog('user_ldap', 'Login filter does not contain %uid place holder, won`t connect.', \OCP\Util::WARN);
|
||
\OCP\Util::writeLog('user_ldap', 'Login filter was ' . $this->config['ldapLoginFilter'], \OCP\Util::DEBUG);
|
||
$configurationOK = false;
|
||
}
|
||
|
||
return $configurationOK;
|
||
}
|
||
|
||
/**
|
||
* @returns an associted array with the default values. Keys are correspond
|
||
* to configvalue entries in the database table
|
||
*/
|
||
public function getDefaults() {
|
||
return array(
|
||
'ldap_host' => '',
|
||
'ldap_port' => '389',
|
||
'ldap_backup_host' => '',
|
||
'ldap_backup_port' => '',
|
||
'ldap_override_main_server' => '',
|
||
'ldap_dn' => '',
|
||
'ldap_agent_password' => '',
|
||
'ldap_base' => '',
|
||
'ldap_base_users' => '',
|
||
'ldap_base_groups' => '',
|
||
'ldap_userlist_filter' => 'objectClass=person',
|
||
'ldap_login_filter' => 'uid=%uid',
|
||
'ldap_group_filter' => 'objectClass=posixGroup',
|
||
'ldap_display_name' => 'cn',
|
||
'ldap_group_display_name' => 'cn',
|
||
'ldap_tls' => 1,
|
||
'ldap_nocase' => 0,
|
||
'ldap_quota_def' => '',
|
||
'ldap_quota_attr' => '',
|
||
'ldap_email_attr' => '',
|
||
'ldap_group_member_assoc_attribute' => 'uniqueMember',
|
||
'ldap_cache_ttl' => 600,
|
||
'ldap_uuid_attribute' => 'auto',
|
||
'ldap_override_uuid_attribute' => 0,
|
||
'home_folder_naming_rule' => '',
|
||
);
|
||
}
|
||
|
||
/**
|
||
* Connects and Binds to LDAP
|
||
*/
|
||
private function establishConnection() {
|
||
static $phpLDAPinstalled = true;
|
||
if(!$phpLDAPinstalled) {
|
||
return false;
|
||
}
|
||
if(!$this->configured) {
|
||
\OCP\Util::writeLog('user_ldap', 'Configuration is invalid, cannot connect', \OCP\Util::WARN);
|
||
return false;
|
||
}
|
||
if(!$this->ldapConnectionRes) {
|
||
if(!function_exists('ldap_connect')) {
|
||
$phpLDAPinstalled = false;
|
||
\OCP\Util::writeLog('user_ldap', 'function ldap_connect is not available. Make sure that the PHP ldap module is installed.', \OCP\Util::ERROR);
|
||
|
||
return false;
|
||
}
|
||
if($this->config['turnOffCertCheck']) {
|
||
if(putenv('LDAPTLS_REQCERT=never')) {
|
||
\OCP\Util::writeLog('user_ldap', 'Turned off SSL certificate validation successfully.', \OCP\Util::WARN);
|
||
} else {
|
||
\OCP\Util::writeLog('user_ldap', 'Could not turn off SSL certificate validation.', \OCP\Util::WARN);
|
||
}
|
||
}
|
||
if(!$this->config['ldapOverrideMainServer'] && !$this->getFromCache('overrideMainServer')) {
|
||
$this->doConnect($this->config['ldapHost'], $this->config['ldapPort']);
|
||
$bindStatus = $this->bind();
|
||
$error = ldap_errno($this->ldapConnectionRes);
|
||
} else {
|
||
$bindStatus = false;
|
||
$error = null;
|
||
}
|
||
|
||
$error = null;
|
||
//if LDAP server is not reachable, try the Backup (Replica!) Server
|
||
if((!$bindStatus && ($error == -1))
|
||
|| $this->config['ldapOverrideMainServer']
|
||
|| $this->getFromCache('overrideMainServer')) {
|
||
$this->doConnect($this->config['ldapBackupHost'], $this->config['ldapBackupPort']);
|
||
$bindStatus = $this->bind();
|
||
if($bindStatus && $error == -1) {
|
||
//when bind to backup server succeeded and failed to main server,
|
||
//skip contacting him until next cache refresh
|
||
$this->writeToCache('overrideMainServer', true);
|
||
}
|
||
}
|
||
return $bindStatus;
|
||
}
|
||
}
|
||
|
||
private function doConnect($host, $port) {
|
||
$this->ldapConnectionRes = ldap_connect($host, $port);
|
||
if(ldap_set_option($this->ldapConnectionRes, LDAP_OPT_PROTOCOL_VERSION, 3)) {
|
||
if(ldap_set_option($this->ldapConnectionRes, LDAP_OPT_REFERRALS, 0)) {
|
||
if($this->config['ldapTLS']) {
|
||
ldap_start_tls($this->ldapConnectionRes);
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Binds to LDAP
|
||
*/
|
||
public function bind() {
|
||
$ldapLogin = @ldap_bind($this->getConnectionResource(), $this->config['ldapAgentName'], $this->config['ldapAgentPassword']);
|
||
if(!$ldapLogin) {
|
||
\OCP\Util::writeLog('user_ldap', 'Bind failed: ' . ldap_errno($this->ldapConnectionRes) . ': ' . ldap_error($this->ldapConnectionRes), \OCP\Util::ERROR);
|
||
$this->ldapConnectionRes = null;
|
||
return false;
|
||
}
|
||
return true;
|
||
}
|
||
|
||
}
|