2014-11-05 15:05:07 +03:00
|
|
|
<?php
|
|
|
|
/**
|
2016-07-21 17:49:16 +03:00
|
|
|
* @copyright Copyright (c) 2016, ownCloud, Inc.
|
|
|
|
*
|
|
|
|
* @author Aaron Wood <aaronjwood@gmail.com>
|
2016-05-26 20:56:05 +03:00
|
|
|
* @author Arthur Schiwon <blizzz@arthur-schiwon.de>
|
2020-03-31 11:49:10 +03:00
|
|
|
* @author Christoph Wurst <christoph@winzerhof-wurst.at>
|
2019-12-03 21:57:53 +03:00
|
|
|
* @author Joas Schilling <coding@schilljs.com>
|
2015-03-26 13:44:34 +03:00
|
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
|
|
|
*
|
|
|
|
* @license AGPL-3.0
|
|
|
|
*
|
|
|
|
* This code is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License, version 3,
|
|
|
|
* as published by the Free Software Foundation.
|
|
|
|
*
|
|
|
|
* This program 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, version 3,
|
2019-12-03 21:57:53 +03:00
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
2015-03-26 13:44:34 +03:00
|
|
|
*
|
|
|
|
*/
|
2015-02-26 13:37:37 +03:00
|
|
|
|
2014-11-05 15:05:07 +03:00
|
|
|
namespace OCA\User_LDAP\Mapping;
|
|
|
|
|
|
|
|
/**
|
2020-04-08 23:24:54 +03:00
|
|
|
* Class AbstractMapping
|
|
|
|
* @package OCA\User_LDAP\Mapping
|
|
|
|
*/
|
2014-11-05 15:05:07 +03:00
|
|
|
abstract class AbstractMapping {
|
|
|
|
/**
|
|
|
|
* @var \OCP\IDBConnection $dbc
|
|
|
|
*/
|
|
|
|
protected $dbc;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* returns the DB table name which holds the mappings
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
abstract protected function getTableName();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param \OCP\IDBConnection $dbc
|
|
|
|
*/
|
|
|
|
public function __construct(\OCP\IDBConnection $dbc) {
|
|
|
|
$this->dbc = $dbc;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2015-01-08 16:21:40 +03:00
|
|
|
* checks whether a provided string represents an existing table col
|
2014-11-05 15:05:07 +03:00
|
|
|
* @param string $col
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function isColNameValid($col) {
|
|
|
|
switch($col) {
|
|
|
|
case 'ldap_dn':
|
|
|
|
case 'owncloud_name':
|
|
|
|
case 'directory_uuid':
|
|
|
|
return true;
|
|
|
|
default:
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets the value of one column based on a provided value of another column
|
|
|
|
* @param string $fetchCol
|
|
|
|
* @param string $compareCol
|
|
|
|
* @param string $search
|
|
|
|
* @throws \Exception
|
|
|
|
* @return string|false
|
|
|
|
*/
|
|
|
|
protected function getXbyY($fetchCol, $compareCol, $search) {
|
|
|
|
if(!$this->isColNameValid($fetchCol)) {
|
|
|
|
//this is used internally only, but we don't want to risk
|
|
|
|
//having SQL injection at all.
|
|
|
|
throw new \Exception('Invalid Column Name');
|
|
|
|
}
|
|
|
|
$query = $this->dbc->prepare('
|
|
|
|
SELECT `' . $fetchCol . '`
|
|
|
|
FROM `'. $this->getTableName() .'`
|
|
|
|
WHERE `' . $compareCol . '` = ?
|
|
|
|
');
|
|
|
|
|
2020-03-26 11:30:18 +03:00
|
|
|
$res = $query->execute([$search]);
|
2014-11-05 15:05:07 +03:00
|
|
|
if($res !== false) {
|
|
|
|
return $query->fetchColumn();
|
|
|
|
}
|
|
|
|
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Performs a DELETE or UPDATE query to the database.
|
|
|
|
* @param \Doctrine\DBAL\Driver\Statement $query
|
|
|
|
* @param array $parameters
|
|
|
|
* @return bool true if at least one row was modified, false otherwise
|
|
|
|
*/
|
|
|
|
protected function modify($query, $parameters) {
|
|
|
|
$result = $query->execute($parameters);
|
|
|
|
return ($result === true && $query->rowCount() > 0);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets the LDAP DN based on the provided name.
|
|
|
|
* Replaces Access::ocname2dn
|
|
|
|
* @param string $name
|
|
|
|
* @return string|false
|
|
|
|
*/
|
|
|
|
public function getDNByName($name) {
|
|
|
|
return $this->getXbyY('ldap_dn', 'owncloud_name', $name);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Updates the DN based on the given UUID
|
|
|
|
* @param string $fdn
|
|
|
|
* @param string $uuid
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function setDNbyUUID($fdn, $uuid) {
|
|
|
|
$query = $this->dbc->prepare('
|
|
|
|
UPDATE `' . $this->getTableName() . '`
|
|
|
|
SET `ldap_dn` = ?
|
|
|
|
WHERE `directory_uuid` = ?
|
|
|
|
');
|
|
|
|
|
2020-03-26 11:30:18 +03:00
|
|
|
return $this->modify($query, [$fdn, $uuid]);
|
2014-11-05 15:05:07 +03:00
|
|
|
}
|
|
|
|
|
2017-02-17 20:45:33 +03:00
|
|
|
/**
|
|
|
|
* Updates the UUID based on the given DN
|
|
|
|
*
|
|
|
|
* required by Migration/UUIDFix
|
|
|
|
*
|
|
|
|
* @param $uuid
|
|
|
|
* @param $fdn
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function setUUIDbyDN($uuid, $fdn) {
|
|
|
|
$query = $this->dbc->prepare('
|
|
|
|
UPDATE `' . $this->getTableName() . '`
|
|
|
|
SET `directory_uuid` = ?
|
|
|
|
WHERE `ldap_dn` = ?
|
|
|
|
');
|
|
|
|
|
|
|
|
return $this->modify($query, [$uuid, $fdn]);
|
|
|
|
}
|
|
|
|
|
2014-11-05 15:05:07 +03:00
|
|
|
/**
|
|
|
|
* Gets the name based on the provided LDAP DN.
|
|
|
|
* @param string $fdn
|
|
|
|
* @return string|false
|
|
|
|
*/
|
|
|
|
public function getNameByDN($fdn) {
|
|
|
|
return $this->getXbyY('owncloud_name', 'ldap_dn', $fdn);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Searches mapped names by the giving string in the name column
|
|
|
|
* @param string $search
|
2016-07-20 15:20:45 +03:00
|
|
|
* @param string $prefixMatch
|
|
|
|
* @param string $postfixMatch
|
2014-11-05 15:05:07 +03:00
|
|
|
* @return string[]
|
|
|
|
*/
|
2016-07-20 15:20:45 +03:00
|
|
|
public function getNamesBySearch($search, $prefixMatch = "", $postfixMatch = "") {
|
2014-11-05 15:05:07 +03:00
|
|
|
$query = $this->dbc->prepare('
|
|
|
|
SELECT `owncloud_name`
|
|
|
|
FROM `'. $this->getTableName() .'`
|
|
|
|
WHERE `owncloud_name` LIKE ?
|
|
|
|
');
|
|
|
|
|
2020-03-26 11:30:18 +03:00
|
|
|
$res = $query->execute([$prefixMatch.$this->dbc->escapeLikeParameter($search).$postfixMatch]);
|
|
|
|
$names = [];
|
2014-11-05 15:05:07 +03:00
|
|
|
if($res !== false) {
|
|
|
|
while($row = $query->fetch()) {
|
|
|
|
$names[] = $row['owncloud_name'];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return $names;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2015-12-11 03:56:53 +03:00
|
|
|
* Gets the name based on the provided LDAP UUID.
|
2014-11-05 15:05:07 +03:00
|
|
|
* @param string $uuid
|
|
|
|
* @return string|false
|
|
|
|
*/
|
|
|
|
public function getNameByUUID($uuid) {
|
|
|
|
return $this->getXbyY('owncloud_name', 'directory_uuid', $uuid);
|
|
|
|
}
|
|
|
|
|
2015-12-11 03:56:53 +03:00
|
|
|
/**
|
|
|
|
* Gets the UUID based on the provided LDAP DN
|
|
|
|
* @param string $dn
|
|
|
|
* @return false|string
|
|
|
|
* @throws \Exception
|
|
|
|
*/
|
|
|
|
public function getUUIDByDN($dn) {
|
|
|
|
return $this->getXbyY('directory_uuid', 'ldap_dn', $dn);
|
|
|
|
}
|
|
|
|
|
2014-12-20 19:08:26 +03:00
|
|
|
/**
|
|
|
|
* gets a piece of the mapping list
|
|
|
|
* @param int $offset
|
|
|
|
* @param int $limit
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
public function getList($offset = null, $limit = null) {
|
|
|
|
$query = $this->dbc->prepare('
|
|
|
|
SELECT
|
|
|
|
`ldap_dn` AS `dn`,
|
|
|
|
`owncloud_name` AS `name`,
|
|
|
|
`directory_uuid` AS `uuid`
|
2015-01-08 16:21:40 +03:00
|
|
|
FROM `' . $this->getTableName() . '`',
|
2014-12-20 19:08:26 +03:00
|
|
|
$limit,
|
|
|
|
$offset
|
|
|
|
);
|
|
|
|
|
|
|
|
$query->execute();
|
|
|
|
return $query->fetchAll();
|
|
|
|
}
|
|
|
|
|
2014-11-05 15:05:07 +03:00
|
|
|
/**
|
|
|
|
* attempts to map the given entry
|
|
|
|
* @param string $fdn fully distinguished name (from LDAP)
|
|
|
|
* @param string $name
|
|
|
|
* @param string $uuid a unique identifier as used in LDAP
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function map($fdn, $name, $uuid) {
|
2017-01-25 19:10:51 +03:00
|
|
|
if(mb_strlen($fdn) > 255) {
|
|
|
|
\OC::$server->getLogger()->error(
|
|
|
|
'Cannot map, because the DN exceeds 255 characters: {dn}',
|
|
|
|
[
|
|
|
|
'app' => 'user_ldap',
|
|
|
|
'dn' => $fdn,
|
|
|
|
]
|
|
|
|
);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2020-03-26 11:30:18 +03:00
|
|
|
$row = [
|
2014-11-05 15:05:07 +03:00
|
|
|
'ldap_dn' => $fdn,
|
|
|
|
'owncloud_name' => $name,
|
|
|
|
'directory_uuid' => $uuid
|
2020-03-26 11:30:18 +03:00
|
|
|
];
|
2014-11-05 15:05:07 +03:00
|
|
|
|
|
|
|
try {
|
|
|
|
$result = $this->dbc->insertIfNotExist($this->getTableName(), $row);
|
|
|
|
// insertIfNotExist returns values as int
|
|
|
|
return (bool)$result;
|
|
|
|
} catch (\Exception $e) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* removes a mapping based on the owncloud_name of the entry
|
|
|
|
* @param string $name
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function unmap($name) {
|
|
|
|
$query = $this->dbc->prepare('
|
|
|
|
DELETE FROM `'. $this->getTableName() .'`
|
|
|
|
WHERE `owncloud_name` = ?');
|
|
|
|
|
2020-03-26 11:30:18 +03:00
|
|
|
return $this->modify($query, [$name]);
|
2014-11-05 15:05:07 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Truncate's the mapping table
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function clear() {
|
|
|
|
$sql = $this->dbc
|
|
|
|
->getDatabasePlatform()
|
|
|
|
->getTruncateTableSQL('`' . $this->getTableName() . '`');
|
|
|
|
return $this->dbc->prepare($sql)->execute();
|
|
|
|
}
|
2017-10-31 21:42:17 +03:00
|
|
|
|
2018-03-15 16:16:43 +03:00
|
|
|
/**
|
|
|
|
* clears the mapping table one by one and executing a callback with
|
|
|
|
* each row's id (=owncloud_name col)
|
|
|
|
*
|
|
|
|
* @param callable $preCallback
|
|
|
|
* @param callable $postCallback
|
|
|
|
* @return bool true on success, false when at least one row was not
|
|
|
|
* deleted
|
|
|
|
*/
|
|
|
|
public function clearCb(Callable $preCallback, Callable $postCallback): bool {
|
|
|
|
$picker = $this->dbc->getQueryBuilder();
|
|
|
|
$picker->select('owncloud_name')
|
|
|
|
->from($this->getTableName());
|
|
|
|
$cursor = $picker->execute();
|
|
|
|
$result = true;
|
|
|
|
while($id = $cursor->fetchColumn(0)) {
|
|
|
|
$preCallback($id);
|
|
|
|
if($isUnmapped = $this->unmap($id)) {
|
|
|
|
$postCallback($id);
|
|
|
|
}
|
|
|
|
$result &= $isUnmapped;
|
|
|
|
}
|
|
|
|
$cursor->closeCursor();
|
|
|
|
return $result;
|
|
|
|
}
|
|
|
|
|
2017-10-31 21:42:17 +03:00
|
|
|
/**
|
|
|
|
* returns the number of entries in the mappings table
|
|
|
|
*
|
|
|
|
* @return int
|
|
|
|
*/
|
|
|
|
public function count() {
|
|
|
|
$qb = $this->dbc->getQueryBuilder();
|
2018-10-19 17:44:28 +03:00
|
|
|
$query = $qb->select($qb->func()->count('ldap_dn'))
|
2017-10-31 21:42:17 +03:00
|
|
|
->from($this->getTableName());
|
|
|
|
$res = $query->execute();
|
|
|
|
$count = $res->fetchColumn();
|
|
|
|
$res->closeCursor();
|
|
|
|
return (int)$count;
|
|
|
|
}
|
2014-11-05 15:05:07 +03:00
|
|
|
}
|