* * @author Arthur Schiwon * * @license GNU AGPL version 3 or any later version * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * 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 * along with this program. If not, see . * */ namespace OCA\User_LDAP\Controller; use OC\CapabilitiesManager; use OC\Core\Controller\OCSController; use OC\Security\Bruteforce\Throttler; use OC\Security\IdentityProof\Manager; use OCA\User_LDAP\Configuration; use OCA\User_LDAP\Helper; use OCP\AppFramework\Http\DataResponse; use OCP\AppFramework\OCS\OCSBadRequestException; use OCP\AppFramework\OCS\OCSException; use OCP\AppFramework\OCS\OCSNotFoundException; use OCP\ILogger; use OCP\IRequest; use OCP\IUserManager; use OCP\IUserSession; class ConfigAPIController extends OCSController { /** @var Helper */ private $ldapHelper; /** @var ILogger */ private $logger; public function __construct( $appName, IRequest $request, CapabilitiesManager $capabilitiesManager, IUserSession $userSession, IUserManager $userManager, Throttler $throttler, Manager $keyManager, Helper $ldapHelper, ILogger $logger ) { parent::__construct( $appName, $request, $capabilitiesManager, $userSession, $userManager, $throttler, $keyManager ); $this->ldapHelper = $ldapHelper; $this->logger = $logger; } /** * creates a new (empty) configuration and returns the resulting prefix * * Example: curl -X POST -H "OCS-APIREQUEST: true" -u $admin:$password \ * https://nextcloud.server/ocs/v2.php/apps/user_ldap/api/v1/config * * results in: * * * * * ok * 200 * OK * * * s40 * * * * Failing example: if an exception is thrown (e.g. Database connection lost) * the detailed error will be logged. The output will then look like: * * * * * failure * 999 * An issue occurred when creating the new config. * * * * * For JSON output provide the format=json parameter * * @return DataResponse * @throws OCSException */ public function create() { try { $configPrefix = $this->ldapHelper->getNextServerConfigurationPrefix(); $configHolder = new Configuration($configPrefix); $configHolder->saveConfiguration(); } catch (\Exception $e) { $this->logger->logException($e); throw new OCSException('An issue occurred when creating the new config.'); } return new DataResponse(['configID' => $configPrefix]); } /** * Deletes a LDAP configuration, if present. * * Example: * curl -X DELETE -H "OCS-APIREQUEST: true" -u $admin:$password \ * https://nextcloud.server/ocs/v2.php/apps/user_ldap/api/v1/config/s60 * * * * * ok * 100 * OK * * * * * @param string $configID * @return DataResponse * @throws OCSBadRequestException * @throws OCSException */ public function delete($configID) { $initial = substr($configID, 0, 1); $number = substr($configID, 1); if($initial !== 's' || $number !== strval(intval($number))) { throw new OCSBadRequestException('Not a valid config ID'); } try { $this->ensureConfigIDExists($configID); if(!$this->ldapHelper->deleteServerConfiguration($configID)) { throw new OCSException('Could not delete configuration'); } } catch(OCSException $e) { throw $e; } catch(\Exception $e) { $this->logger->logException($e); throw new OCSException('An issue occurred when deleting the config.'); } return new DataResponse(); } /** * modifies a configuration * * Example: * curl -X PUT -d "key=ldapHost&value=ldaps://my.ldap.server" \ * -H "OCS-APIREQUEST: true" -u $admin:$password \ * https://nextcloud.server/ocs/v2.php/apps/user_ldap/api/v1/config/s60 * * * * * ok * 100 * OK * * * * * @param string $configID * @param string $key * @param string $value * @return DataResponse * @throws OCSException */ public function modify($configID, $key, $value) { $this->ensureConfigIDExists($configID); try { $config = new Configuration($configID); $configKeys = $config->getConfigTranslationArray(); if(!isset($configKeys[$key]) && !in_array($key, $configKeys, true)) { throw new OCSBadRequestException('Invalid config key'); } $config->$key = $value; $config->saveConfiguration(); } catch(OCSException $e) { throw $e; } catch (\Exception $e) { $this->logger->logException($e); throw new OCSException('An issue occurred when modifying the config.'); } return new DataResponse(); } /** * if the given config ID is not available, an exception is thrown * * @param string $configID * @throws OCSNotFoundException */ private function ensureConfigIDExists($configID) { $prefixes = $this->ldapHelper->getServerConfigurationPrefixes(); if(!in_array($configID, $prefixes)) { throw new OCSNotFoundException('Config ID not found'); } } }