2016-05-04 10:09:01 +03:00
|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* @copyright Copyright (c) 2016, ownCloud, Inc.
|
2016-07-21 18:07:57 +03:00
|
|
|
*
|
2020-03-31 11:49:10 +03:00
|
|
|
* @author Christoph Wurst <christoph@winzerhof-wurst.at>
|
2017-11-06 17:56:42 +03:00
|
|
|
* @author Jörn Friedrich Dreyer <jfd@butonic.de>
|
2016-07-21 18:07:57 +03:00
|
|
|
* @author Roeland Jago Douma <roeland@famdouma.nl>
|
|
|
|
*
|
2016-05-04 10:09:01 +03:00
|
|
|
* @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/>
|
2016-05-04 10:09:01 +03:00
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace OC\User;
|
|
|
|
|
2019-11-22 22:52:10 +03:00
|
|
|
use OCP\UserInterface;
|
2016-08-11 10:52:02 +03:00
|
|
|
|
2016-05-04 10:09:01 +03:00
|
|
|
/**
|
|
|
|
* Abstract base class for user management. Provides methods for querying backend
|
|
|
|
* capabilities.
|
|
|
|
*/
|
2016-08-11 10:52:02 +03:00
|
|
|
abstract class Backend implements UserInterface {
|
2016-05-04 10:09:01 +03:00
|
|
|
/**
|
|
|
|
* error code for functions not provided by the user backend
|
|
|
|
*/
|
|
|
|
const NOT_IMPLEMENTED = -501;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* actions that user backends can define
|
|
|
|
*/
|
|
|
|
const CREATE_USER = 1; // 1 << 0
|
|
|
|
const SET_PASSWORD = 16; // 1 << 4
|
|
|
|
const CHECK_PASSWORD = 256; // 1 << 8
|
|
|
|
const GET_HOME = 4096; // 1 << 12
|
|
|
|
const GET_DISPLAYNAME = 65536; // 1 << 16
|
|
|
|
const SET_DISPLAYNAME = 1048576; // 1 << 20
|
|
|
|
const PROVIDE_AVATAR = 16777216; // 1 << 24
|
|
|
|
const COUNT_USERS = 268435456; // 1 << 28
|
|
|
|
|
2020-03-26 11:30:18 +03:00
|
|
|
protected $possibleActions = [
|
2016-05-04 10:09:01 +03:00
|
|
|
self::CREATE_USER => 'createUser',
|
|
|
|
self::SET_PASSWORD => 'setPassword',
|
|
|
|
self::CHECK_PASSWORD => 'checkPassword',
|
|
|
|
self::GET_HOME => 'getHome',
|
|
|
|
self::GET_DISPLAYNAME => 'getDisplayName',
|
|
|
|
self::SET_DISPLAYNAME => 'setDisplayName',
|
|
|
|
self::PROVIDE_AVATAR => 'canChangeAvatar',
|
|
|
|
self::COUNT_USERS => 'countUsers',
|
2020-03-26 11:30:18 +03:00
|
|
|
];
|
2016-05-04 10:09:01 +03:00
|
|
|
|
|
|
|
/**
|
2020-04-08 23:24:54 +03:00
|
|
|
* Get all supported actions
|
|
|
|
* @return int bitwise-or'ed actions
|
|
|
|
*
|
|
|
|
* Returns the supported actions as int to be
|
|
|
|
* compared with self::CREATE_USER etc.
|
|
|
|
*/
|
2016-05-04 10:09:01 +03:00
|
|
|
public function getSupportedActions() {
|
|
|
|
$actions = 0;
|
2020-04-09 15:04:56 +03:00
|
|
|
foreach($this->possibleActions as $action => $methodName) {
|
2016-05-04 10:09:01 +03:00
|
|
|
if(method_exists($this, $methodName)) {
|
|
|
|
$actions |= $action;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return $actions;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-04-08 23:24:54 +03:00
|
|
|
* Check if backend implements actions
|
|
|
|
* @param int $actions bitwise-or'ed actions
|
|
|
|
* @return boolean
|
|
|
|
*
|
|
|
|
* Returns the supported actions as int to be
|
|
|
|
* compared with self::CREATE_USER etc.
|
|
|
|
*/
|
2016-05-04 10:09:01 +03:00
|
|
|
public function implementsActions($actions) {
|
|
|
|
return (bool)($this->getSupportedActions() & $actions);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* delete a user
|
|
|
|
* @param string $uid The username of the user to delete
|
|
|
|
* @return bool
|
|
|
|
*
|
|
|
|
* Deletes a user
|
|
|
|
*/
|
2020-04-09 14:53:40 +03:00
|
|
|
public function deleteUser($uid) {
|
2016-05-04 10:09:01 +03:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get a list of all users
|
|
|
|
*
|
|
|
|
* @param string $search
|
|
|
|
* @param null|int $limit
|
|
|
|
* @param null|int $offset
|
|
|
|
* @return string[] an array of all uids
|
|
|
|
*/
|
|
|
|
public function getUsers($search = '', $limit = null, $offset = null) {
|
2020-03-26 11:30:18 +03:00
|
|
|
return [];
|
2016-05-04 10:09:01 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-04-08 23:24:54 +03:00
|
|
|
* check if a user exists
|
|
|
|
* @param string $uid the username
|
|
|
|
* @return boolean
|
|
|
|
*/
|
2016-05-04 10:09:01 +03:00
|
|
|
public function userExists($uid) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-04-08 23:24:54 +03:00
|
|
|
* get the user's home directory
|
|
|
|
* @param string $uid the username
|
|
|
|
* @return boolean
|
|
|
|
*/
|
2016-05-04 10:09:01 +03:00
|
|
|
public function getHome($uid) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* get display name of the user
|
|
|
|
* @param string $uid user ID of the user
|
|
|
|
* @return string display name
|
|
|
|
*/
|
|
|
|
public function getDisplayName($uid) {
|
|
|
|
return $uid;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get a list of all display names and user ids.
|
|
|
|
*
|
|
|
|
* @param string $search
|
|
|
|
* @param string|null $limit
|
|
|
|
* @param string|null $offset
|
|
|
|
* @return array an array of all displayNames (value) and the corresponding uids (key)
|
|
|
|
*/
|
|
|
|
public function getDisplayNames($search = '', $limit = null, $offset = null) {
|
2020-03-26 11:30:18 +03:00
|
|
|
$displayNames = [];
|
2016-05-04 10:09:01 +03:00
|
|
|
$users = $this->getUsers($search, $limit, $offset);
|
2020-04-09 17:07:47 +03:00
|
|
|
foreach ($users as $user) {
|
2016-05-04 10:09:01 +03:00
|
|
|
$displayNames[$user] = $user;
|
|
|
|
}
|
|
|
|
return $displayNames;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Check if a user list is available or not
|
|
|
|
* @return boolean if users can be listed or not
|
|
|
|
*/
|
|
|
|
public function hasUserListings() {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|