* @author Morris Jobke * @author Tom Needham * * @copyright Copyright (c) 2015, ownCloud, Inc. * @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, * along with this program. If not, see * */ namespace OCA\Provisioning_API; use \OC_OCS_Result; use \OC_Group; use \OC_SubAdmin; class Groups{ /** * returns a list of groups */ public static function getGroups($parameters){ $search = !empty($_GET['search']) ? $_GET['search'] : ''; $limit = !empty($_GET['limit']) ? $_GET['limit'] : null; $offset = !empty($_GET['offset']) ? $_GET['offset'] : null; return new OC_OCS_Result(array('groups' => OC_Group::getGroups($search, $limit, $offset))); } /** * returns an array of users in the group specified */ public static function getGroup($parameters){ // Check the group exists if(!OC_Group::groupExists($parameters['groupid'])){ return new OC_OCS_Result(null, \OCP\API::RESPOND_NOT_FOUND, 'The requested group could not be found'); } // Check subadmin has access to this group if(\OC_User::isAdminUser(\OC_User::getUser()) || in_array($parameters['groupid'], \OC_SubAdmin::getSubAdminsGroups(\OC_User::getUser()))){ return new OC_OCS_Result(array('users' => OC_Group::usersInGroup($parameters['groupid']))); } else { return new OC_OCS_Result(null, \OCP\API::RESPOND_UNAUTHORISED, 'User does not have access to specified group'); } } /** * creates a new group */ public static function addGroup($parameters){ // Validate name $groupid = isset($_POST['groupid']) ? $_POST['groupid'] : ''; if( preg_match( '/[^a-zA-Z0-9 _\.@\-]/', $groupid ) || empty($groupid)){ \OCP\Util::writeLog('provisioning_api', 'Attempt made to create group using invalid characters.', \OCP\Util::ERROR); return new OC_OCS_Result(null, 101, 'Invalid group name'); } // Check if it exists if(OC_Group::groupExists($groupid)){ return new OC_OCS_Result(null, 102); } if(OC_Group::createGroup($groupid)){ return new OC_OCS_Result(null, 100); } else { return new OC_OCS_Result(null, 103); } } public static function deleteGroup($parameters){ // Check it exists if(!OC_Group::groupExists($parameters['groupid'])){ return new OC_OCS_Result(null, 101); } else if($parameters['groupid'] == 'admin' || !OC_Group::deleteGroup($parameters['groupid'])){ // Cannot delete admin group return new OC_OCS_Result(null, 102); } else { return new OC_OCS_Result(null, 100); } } public static function getSubAdminsOfGroup($parameters) { $group = $parameters['groupid']; // Check group exists if(!OC_Group::groupExists($group)) { return new OC_OCS_Result(null, 101, 'Group does not exist'); } // Go if(!$subadmins = OC_Subadmin::getGroupsSubAdmins($group)) { return new OC_OCS_Result(null, 102, 'Unknown error occured'); } else { return new OC_OCS_Result($subadmins); } } }