2014-10-31 13:41:07 +03:00
|
|
|
<?php
|
|
|
|
/**
|
2016-01-12 17:02:16 +03:00
|
|
|
* @author Jesús Macias <jmacias@solidgear.es>
|
2015-06-25 12:43:55 +03:00
|
|
|
* @author Lukas Reschke <lukas@owncloud.com>
|
2016-01-12 17:02:16 +03:00
|
|
|
* @author Robin Appelman <icewind@owncloud.com>
|
|
|
|
* @author Robin McCorkell <robin@mccorkell.me.uk>
|
|
|
|
* @author Scrutinizer Auto-Fixer <auto-fixer@scrutinizer-ci.com>
|
2015-03-26 13:44:34 +03:00
|
|
|
* @author Vincent Petry <pvince81@owncloud.com>
|
|
|
|
*
|
2016-01-12 17:02:16 +03:00
|
|
|
* @copyright Copyright (c) 2016, ownCloud, Inc.
|
2015-03-26 13:44:34 +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,
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
|
|
|
*
|
2014-10-31 13:41:07 +03:00
|
|
|
*/
|
|
|
|
|
|
|
|
namespace OCA\Files_external\Service;
|
|
|
|
|
|
|
|
use \OC\Files\Filesystem;
|
|
|
|
use \OCA\Files_external\Lib\StorageConfig;
|
|
|
|
use \OCA\Files_external\NotFoundException;
|
2015-09-23 17:35:17 +03:00
|
|
|
use \OCA\Files_External\Lib\Backend\Backend;
|
|
|
|
use \OCA\Files_External\Lib\Auth\AuthMechanism;
|
2015-11-26 19:51:47 +03:00
|
|
|
use \OCP\Files\StorageNotAvailableException;
|
2014-10-31 13:41:07 +03:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Service class to manage external storages
|
|
|
|
*/
|
|
|
|
abstract class StoragesService {
|
|
|
|
|
2015-08-11 20:45:07 +03:00
|
|
|
/** @var BackendService */
|
|
|
|
protected $backendService;
|
|
|
|
|
|
|
|
/**
|
2015-11-02 15:13:06 +03:00
|
|
|
* @var DBConfigService
|
2015-08-11 20:45:07 +03:00
|
|
|
*/
|
2015-11-02 15:13:06 +03:00
|
|
|
protected $dbConfig;
|
2015-08-11 20:45:07 +03:00
|
|
|
|
2014-10-31 13:41:07 +03:00
|
|
|
/**
|
2015-11-02 15:13:06 +03:00
|
|
|
* @param BackendService $backendService
|
|
|
|
* @param DBConfigService $dbConfigService
|
2014-10-31 13:41:07 +03:00
|
|
|
*/
|
2015-11-02 15:13:06 +03:00
|
|
|
public function __construct(BackendService $backendService, DBConfigService $dbConfigService) {
|
|
|
|
$this->backendService = $backendService;
|
|
|
|
$this->dbConfig = $dbConfigService;
|
2014-10-31 13:41:07 +03:00
|
|
|
}
|
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
protected function readDBConfig() {
|
|
|
|
return $this->dbConfig->getAdminMounts();
|
2015-08-12 16:22:27 +03:00
|
|
|
}
|
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
protected function getStorageConfigFromDBMount(array $mount) {
|
|
|
|
$applicableUsers = array_filter($mount['applicable'], function ($applicable) {
|
|
|
|
return $applicable['type'] === DBConfigService::APPLICABLE_TYPE_USER;
|
|
|
|
});
|
|
|
|
$applicableUsers = array_map(function ($applicable) {
|
|
|
|
return $applicable['value'];
|
|
|
|
}, $applicableUsers);
|
|
|
|
|
|
|
|
$applicableGroups = array_filter($mount['applicable'], function ($applicable) {
|
|
|
|
return $applicable['type'] === DBConfigService::APPLICABLE_TYPE_GROUP;
|
|
|
|
});
|
|
|
|
$applicableGroups = array_map(function ($applicable) {
|
|
|
|
return $applicable['value'];
|
|
|
|
}, $applicableGroups);
|
Authentication mechanisms for external storage backends
A backend can now specify generic authentication schemes that it
supports, instead of specifying the parameters for its authentication
method directly. This allows multiple authentication mechanisms to be
implemented for a single scheme, providing altered functionality.
This commit introduces the backend framework for this feature, and so at
this point the UI will be broken as the frontend does not specify the
required information.
Terminology:
- authentication scheme
Parameter interface for the authentication method. A backend
supporting the 'password' scheme accepts two parameters, 'user' and
'password'.
- authentication mechanism
Specific mechanism implementing a scheme. Basic mechanisms may
forward configuration options directly to the backend, more advanced
ones may lookup parameters or retrieve them from the session
New dropdown selector for external storage configurations to select the
authentication mechanism to be used.
Authentication mechanisms can have visibilities, just like backends.
The API was extended too to make it easier to add/remove visibilities.
In addition, the concept of 'allowed visibility' has been introduced, so
a backend/auth mechanism can force a maximum visibility level (e.g.
Local storage type) that cannot be overridden by configuration in the
web UI.
An authentication mechanism is a fully instantiated implementation. This
allows an implementation to have dependencies injected into it, e.g. an
\OCP\IDB for database operations.
When a StorageConfig is being prepared for mounting, the authentication
mechanism implementation has manipulateStorage() called,
which inserts the relevant authentication method options into the
storage ready for mounting.
2015-08-12 12:54:03 +03:00
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
try {
|
|
|
|
$config = $this->createStorage(
|
|
|
|
$mount['mount_point'],
|
|
|
|
$mount['storage_backend'],
|
|
|
|
$mount['auth_backend'],
|
|
|
|
$mount['config'],
|
|
|
|
$mount['options'],
|
|
|
|
array_values($applicableUsers),
|
|
|
|
array_values($applicableGroups),
|
|
|
|
$mount['priority']
|
|
|
|
);
|
2016-01-05 18:40:34 +03:00
|
|
|
$config->setType($mount['type']);
|
2015-11-02 15:13:06 +03:00
|
|
|
$config->setId((int)$mount['mount_id']);
|
|
|
|
return $config;
|
|
|
|
} catch (\UnexpectedValueException $e) {
|
|
|
|
// dont die if a storage backend doesn't exist
|
|
|
|
\OCP\Util::writeLog(
|
|
|
|
'files_external',
|
|
|
|
'Could not load storage: "' . $e->getMessage() . '"',
|
|
|
|
\OCP\Util::ERROR
|
|
|
|
);
|
|
|
|
return null;
|
2015-03-16 14:18:01 +03:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-10-31 13:41:07 +03:00
|
|
|
/**
|
|
|
|
* Read the external storages config
|
|
|
|
*
|
|
|
|
* @return array map of storage id to storage config
|
|
|
|
*/
|
|
|
|
protected function readConfig() {
|
2015-11-02 15:13:06 +03:00
|
|
|
$mounts = $this->readDBConfig();
|
|
|
|
$configs = array_map([$this, 'getStorageConfigFromDBMount'], $mounts);
|
|
|
|
$configs = array_filter($configs, function ($config) {
|
|
|
|
return $config instanceof StorageConfig;
|
|
|
|
});
|
2015-04-08 14:55:10 +03:00
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
$keys = array_map(function (StorageConfig $config) {
|
|
|
|
return $config->getId();
|
|
|
|
}, $configs);
|
2014-10-31 13:41:07 +03:00
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
return array_combine($keys, $configs);
|
2014-10-31 13:41:07 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get a storage with status
|
|
|
|
*
|
2015-03-17 13:42:52 +03:00
|
|
|
* @param int $id storage id
|
2014-10-31 13:41:07 +03:00
|
|
|
*
|
|
|
|
* @return StorageConfig
|
2015-03-17 13:42:52 +03:00
|
|
|
* @throws NotFoundException if the storage with the given id was not found
|
2014-10-31 13:41:07 +03:00
|
|
|
*/
|
|
|
|
public function getStorage($id) {
|
2015-11-02 15:13:06 +03:00
|
|
|
$mount = $this->dbConfig->getMountById($id);
|
2014-10-31 13:41:07 +03:00
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
if (!is_array($mount)) {
|
2014-10-31 13:41:07 +03:00
|
|
|
throw new NotFoundException('Storage with id "' . $id . '" not found');
|
|
|
|
}
|
|
|
|
|
2016-01-05 18:40:34 +03:00
|
|
|
$config = $this->getStorageConfigFromDBMount($mount);
|
|
|
|
if ($this->isApplicable($config)) {
|
|
|
|
return $config;
|
|
|
|
} else {
|
|
|
|
throw new NotFoundException('Storage with id "' . $id . '" not found');
|
|
|
|
}
|
2014-10-31 13:41:07 +03:00
|
|
|
}
|
|
|
|
|
2016-01-05 18:40:34 +03:00
|
|
|
/**
|
|
|
|
* Check whether this storage service should provide access to a storage
|
|
|
|
*
|
|
|
|
* @param StorageConfig $config
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
abstract protected function isApplicable(StorageConfig $config);
|
|
|
|
|
2015-03-16 14:18:01 +03:00
|
|
|
/**
|
2015-09-23 17:35:17 +03:00
|
|
|
* Gets all storages, valid or not
|
2015-03-16 14:18:01 +03:00
|
|
|
*
|
2015-11-02 15:13:06 +03:00
|
|
|
* @return StorageConfig[] array of storage configs
|
2015-03-16 14:18:01 +03:00
|
|
|
*/
|
|
|
|
public function getAllStorages() {
|
|
|
|
return $this->readConfig();
|
|
|
|
}
|
|
|
|
|
2015-09-23 17:35:17 +03:00
|
|
|
/**
|
|
|
|
* Gets all valid storages
|
|
|
|
*
|
2015-11-02 15:13:06 +03:00
|
|
|
* @return StorageConfig[]
|
2015-09-23 17:35:17 +03:00
|
|
|
*/
|
|
|
|
public function getStorages() {
|
|
|
|
return array_filter($this->getAllStorages(), [$this, 'validateStorage']);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Validate storage
|
|
|
|
* FIXME: De-duplicate with StoragesController::validate()
|
|
|
|
*
|
|
|
|
* @param StorageConfig $storage
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
protected function validateStorage(StorageConfig $storage) {
|
|
|
|
/** @var Backend */
|
|
|
|
$backend = $storage->getBackend();
|
|
|
|
/** @var AuthMechanism */
|
|
|
|
$authMechanism = $storage->getAuthMechanism();
|
|
|
|
|
|
|
|
if (!$backend->isVisibleFor($this->getVisibilityType())) {
|
|
|
|
// not permitted to use backend
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
if (!$authMechanism->isVisibleFor($this->getVisibilityType())) {
|
|
|
|
// not permitted to use auth mechanism
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the visibility type for this controller, used in validation
|
|
|
|
*
|
|
|
|
* @return string BackendService::VISIBILITY_* constants
|
|
|
|
*/
|
|
|
|
abstract public function getVisibilityType();
|
|
|
|
|
2015-12-08 18:01:20 +03:00
|
|
|
/**
|
|
|
|
* @return integer
|
|
|
|
*/
|
2015-11-02 15:13:06 +03:00
|
|
|
protected function getType() {
|
|
|
|
return DBConfigService::MOUNT_TYPE_ADMIN;
|
|
|
|
}
|
|
|
|
|
2014-10-31 13:41:07 +03:00
|
|
|
/**
|
|
|
|
* Add new storage to the configuration
|
|
|
|
*
|
2015-11-02 15:13:06 +03:00
|
|
|
* @param StorageConfig $newStorage storage attributes
|
2014-10-31 13:41:07 +03:00
|
|
|
*
|
|
|
|
* @return StorageConfig storage config, with added id
|
|
|
|
*/
|
|
|
|
public function addStorage(StorageConfig $newStorage) {
|
|
|
|
$allStorages = $this->readConfig();
|
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
$configId = $this->dbConfig->addMount(
|
|
|
|
$newStorage->getMountPoint(),
|
|
|
|
$newStorage->getBackend()->getIdentifier(),
|
|
|
|
$newStorage->getAuthMechanism()->getIdentifier(),
|
|
|
|
$newStorage->getPriority(),
|
|
|
|
$this->getType()
|
|
|
|
);
|
|
|
|
|
2014-10-31 13:41:07 +03:00
|
|
|
$newStorage->setId($configId);
|
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
foreach ($newStorage->getApplicableUsers() as $user) {
|
|
|
|
$this->dbConfig->addApplicable($configId, DBConfigService::APPLICABLE_TYPE_USER, $user);
|
|
|
|
}
|
|
|
|
foreach ($newStorage->getApplicableGroups() as $group) {
|
|
|
|
$this->dbConfig->addApplicable($configId, DBConfigService::APPLICABLE_TYPE_GROUP, $group);
|
|
|
|
}
|
|
|
|
foreach ($newStorage->getBackendOptions() as $key => $value) {
|
|
|
|
$this->dbConfig->setConfig($configId, $key, $value);
|
|
|
|
}
|
|
|
|
foreach ($newStorage->getMountOptions() as $key => $value) {
|
|
|
|
$this->dbConfig->setOption($configId, $key, $value);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (count($newStorage->getApplicableUsers()) === 0 && count($newStorage->getApplicableGroups()) === 0) {
|
|
|
|
$this->dbConfig->addApplicable($configId, DBConfigService::APPLICABLE_TYPE_GLOBAL, null);
|
|
|
|
}
|
|
|
|
|
2014-10-31 13:41:07 +03:00
|
|
|
// add new storage
|
|
|
|
$allStorages[$configId] = $newStorage;
|
|
|
|
|
|
|
|
$this->triggerHooks($newStorage, Filesystem::signal_create_mount);
|
|
|
|
|
2015-11-26 19:51:47 +03:00
|
|
|
$newStorage->setStatus(StorageNotAvailableException::STATUS_SUCCESS);
|
2014-10-31 13:41:07 +03:00
|
|
|
return $newStorage;
|
2015-08-11 20:45:07 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a storage from its parameters
|
|
|
|
*
|
|
|
|
* @param string $mountPoint storage mount point
|
2015-08-12 22:03:11 +03:00
|
|
|
* @param string $backendIdentifier backend identifier
|
|
|
|
* @param string $authMechanismIdentifier authentication mechanism identifier
|
2015-08-11 20:45:07 +03:00
|
|
|
* @param array $backendOptions backend-specific options
|
|
|
|
* @param array|null $mountOptions mount-specific options
|
|
|
|
* @param array|null $applicableUsers users for which to mount the storage
|
|
|
|
* @param array|null $applicableGroups groups for which to mount the storage
|
|
|
|
* @param int|null $priority priority
|
|
|
|
*
|
|
|
|
* @return StorageConfig
|
|
|
|
*/
|
|
|
|
public function createStorage(
|
|
|
|
$mountPoint,
|
2015-08-12 22:03:11 +03:00
|
|
|
$backendIdentifier,
|
|
|
|
$authMechanismIdentifier,
|
2015-08-11 20:45:07 +03:00
|
|
|
$backendOptions,
|
|
|
|
$mountOptions = null,
|
|
|
|
$applicableUsers = null,
|
|
|
|
$applicableGroups = null,
|
|
|
|
$priority = null
|
|
|
|
) {
|
2015-08-12 22:03:11 +03:00
|
|
|
$backend = $this->backendService->getBackend($backendIdentifier);
|
2015-08-11 20:45:07 +03:00
|
|
|
if (!$backend) {
|
2015-11-02 15:13:06 +03:00
|
|
|
throw new \InvalidArgumentException('Unable to get backend for ' . $backendIdentifier);
|
2015-08-11 20:45:07 +03:00
|
|
|
}
|
2015-08-12 22:03:11 +03:00
|
|
|
$authMechanism = $this->backendService->getAuthMechanism($authMechanismIdentifier);
|
Authentication mechanisms for external storage backends
A backend can now specify generic authentication schemes that it
supports, instead of specifying the parameters for its authentication
method directly. This allows multiple authentication mechanisms to be
implemented for a single scheme, providing altered functionality.
This commit introduces the backend framework for this feature, and so at
this point the UI will be broken as the frontend does not specify the
required information.
Terminology:
- authentication scheme
Parameter interface for the authentication method. A backend
supporting the 'password' scheme accepts two parameters, 'user' and
'password'.
- authentication mechanism
Specific mechanism implementing a scheme. Basic mechanisms may
forward configuration options directly to the backend, more advanced
ones may lookup parameters or retrieve them from the session
New dropdown selector for external storage configurations to select the
authentication mechanism to be used.
Authentication mechanisms can have visibilities, just like backends.
The API was extended too to make it easier to add/remove visibilities.
In addition, the concept of 'allowed visibility' has been introduced, so
a backend/auth mechanism can force a maximum visibility level (e.g.
Local storage type) that cannot be overridden by configuration in the
web UI.
An authentication mechanism is a fully instantiated implementation. This
allows an implementation to have dependencies injected into it, e.g. an
\OCP\IDB for database operations.
When a StorageConfig is being prepared for mounting, the authentication
mechanism implementation has manipulateStorage() called,
which inserts the relevant authentication method options into the
storage ready for mounting.
2015-08-12 12:54:03 +03:00
|
|
|
if (!$authMechanism) {
|
2015-11-02 15:13:06 +03:00
|
|
|
throw new \InvalidArgumentException('Unable to get authentication mechanism for ' . $authMechanismIdentifier);
|
Authentication mechanisms for external storage backends
A backend can now specify generic authentication schemes that it
supports, instead of specifying the parameters for its authentication
method directly. This allows multiple authentication mechanisms to be
implemented for a single scheme, providing altered functionality.
This commit introduces the backend framework for this feature, and so at
this point the UI will be broken as the frontend does not specify the
required information.
Terminology:
- authentication scheme
Parameter interface for the authentication method. A backend
supporting the 'password' scheme accepts two parameters, 'user' and
'password'.
- authentication mechanism
Specific mechanism implementing a scheme. Basic mechanisms may
forward configuration options directly to the backend, more advanced
ones may lookup parameters or retrieve them from the session
New dropdown selector for external storage configurations to select the
authentication mechanism to be used.
Authentication mechanisms can have visibilities, just like backends.
The API was extended too to make it easier to add/remove visibilities.
In addition, the concept of 'allowed visibility' has been introduced, so
a backend/auth mechanism can force a maximum visibility level (e.g.
Local storage type) that cannot be overridden by configuration in the
web UI.
An authentication mechanism is a fully instantiated implementation. This
allows an implementation to have dependencies injected into it, e.g. an
\OCP\IDB for database operations.
When a StorageConfig is being prepared for mounting, the authentication
mechanism implementation has manipulateStorage() called,
which inserts the relevant authentication method options into the
storage ready for mounting.
2015-08-12 12:54:03 +03:00
|
|
|
}
|
2015-08-11 20:45:07 +03:00
|
|
|
$newStorage = new StorageConfig();
|
|
|
|
$newStorage->setMountPoint($mountPoint);
|
|
|
|
$newStorage->setBackend($backend);
|
Authentication mechanisms for external storage backends
A backend can now specify generic authentication schemes that it
supports, instead of specifying the parameters for its authentication
method directly. This allows multiple authentication mechanisms to be
implemented for a single scheme, providing altered functionality.
This commit introduces the backend framework for this feature, and so at
this point the UI will be broken as the frontend does not specify the
required information.
Terminology:
- authentication scheme
Parameter interface for the authentication method. A backend
supporting the 'password' scheme accepts two parameters, 'user' and
'password'.
- authentication mechanism
Specific mechanism implementing a scheme. Basic mechanisms may
forward configuration options directly to the backend, more advanced
ones may lookup parameters or retrieve them from the session
New dropdown selector for external storage configurations to select the
authentication mechanism to be used.
Authentication mechanisms can have visibilities, just like backends.
The API was extended too to make it easier to add/remove visibilities.
In addition, the concept of 'allowed visibility' has been introduced, so
a backend/auth mechanism can force a maximum visibility level (e.g.
Local storage type) that cannot be overridden by configuration in the
web UI.
An authentication mechanism is a fully instantiated implementation. This
allows an implementation to have dependencies injected into it, e.g. an
\OCP\IDB for database operations.
When a StorageConfig is being prepared for mounting, the authentication
mechanism implementation has manipulateStorage() called,
which inserts the relevant authentication method options into the
storage ready for mounting.
2015-08-12 12:54:03 +03:00
|
|
|
$newStorage->setAuthMechanism($authMechanism);
|
2015-08-11 20:45:07 +03:00
|
|
|
$newStorage->setBackendOptions($backendOptions);
|
|
|
|
if (isset($mountOptions)) {
|
|
|
|
$newStorage->setMountOptions($mountOptions);
|
|
|
|
}
|
|
|
|
if (isset($applicableUsers)) {
|
|
|
|
$newStorage->setApplicableUsers($applicableUsers);
|
|
|
|
}
|
|
|
|
if (isset($applicableGroups)) {
|
|
|
|
$newStorage->setApplicableGroups($applicableGroups);
|
|
|
|
}
|
|
|
|
if (isset($priority)) {
|
|
|
|
$newStorage->setPriority($priority);
|
|
|
|
}
|
|
|
|
|
|
|
|
return $newStorage;
|
2014-10-31 13:41:07 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Triggers the given hook signal for all the applicables given
|
|
|
|
*
|
|
|
|
* @param string $signal signal
|
|
|
|
* @param string $mountPoint hook mount pount param
|
|
|
|
* @param string $mountType hook mount type param
|
|
|
|
* @param array $applicableArray array of applicable users/groups for which to trigger the hook
|
|
|
|
*/
|
|
|
|
protected function triggerApplicableHooks($signal, $mountPoint, $mountType, $applicableArray) {
|
|
|
|
foreach ($applicableArray as $applicable) {
|
2015-08-19 00:49:29 +03:00
|
|
|
\OCP\Util::emitHook(
|
2014-10-31 13:41:07 +03:00
|
|
|
Filesystem::CLASSNAME,
|
|
|
|
$signal,
|
|
|
|
[
|
|
|
|
Filesystem::signal_param_path => $mountPoint,
|
|
|
|
Filesystem::signal_param_mount_type => $mountType,
|
|
|
|
Filesystem::signal_param_users => $applicable,
|
|
|
|
]
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Triggers $signal for all applicable users of the given
|
|
|
|
* storage
|
|
|
|
*
|
|
|
|
* @param StorageConfig $storage storage data
|
|
|
|
* @param string $signal signal to trigger
|
|
|
|
*/
|
|
|
|
abstract protected function triggerHooks(StorageConfig $storage, $signal);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Triggers signal_create_mount or signal_delete_mount to
|
|
|
|
* accomodate for additions/deletions in applicableUsers
|
|
|
|
* and applicableGroups fields.
|
|
|
|
*
|
|
|
|
* @param StorageConfig $oldStorage old storage data
|
|
|
|
* @param StorageConfig $newStorage new storage data
|
|
|
|
*/
|
|
|
|
abstract protected function triggerChangeHooks(StorageConfig $oldStorage, StorageConfig $newStorage);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Update storage to the configuration
|
|
|
|
*
|
|
|
|
* @param StorageConfig $updatedStorage storage attributes
|
|
|
|
*
|
|
|
|
* @return StorageConfig storage config
|
2015-03-17 13:42:52 +03:00
|
|
|
* @throws NotFoundException if the given storage does not exist in the config
|
2014-10-31 13:41:07 +03:00
|
|
|
*/
|
|
|
|
public function updateStorage(StorageConfig $updatedStorage) {
|
|
|
|
$id = $updatedStorage->getId();
|
2015-11-02 15:13:06 +03:00
|
|
|
|
|
|
|
$existingMount = $this->dbConfig->getMountById($id);
|
|
|
|
|
|
|
|
if (!is_array($existingMount)) {
|
|
|
|
throw new NotFoundException('Storage with id "' . $id . '" not found while updating storage');
|
|
|
|
}
|
|
|
|
|
|
|
|
$oldStorage = $this->getStorageConfigFromDBMount($existingMount);
|
|
|
|
|
|
|
|
$removedUsers = array_diff($oldStorage->getApplicableUsers(), $updatedStorage->getApplicableUsers());
|
|
|
|
$removedGroups = array_diff($oldStorage->getApplicableGroups(), $updatedStorage->getApplicableGroups());
|
|
|
|
$addedUsers = array_diff($updatedStorage->getApplicableUsers(), $oldStorage->getApplicableUsers());
|
|
|
|
$addedGroups = array_diff($updatedStorage->getApplicableGroups(), $oldStorage->getApplicableGroups());
|
|
|
|
|
|
|
|
$oldUserCount = count($oldStorage->getApplicableUsers());
|
|
|
|
$oldGroupCount = count($oldStorage->getApplicableGroups());
|
2016-01-13 17:31:26 +03:00
|
|
|
$newUserCount = count($updatedStorage->getApplicableUsers());
|
|
|
|
$newGroupCount = count($updatedStorage->getApplicableGroups());
|
2015-11-02 15:13:06 +03:00
|
|
|
$wasGlobal = ($oldUserCount + $oldGroupCount) === 0;
|
|
|
|
$isGlobal = ($newUserCount + $newGroupCount) === 0;
|
|
|
|
|
|
|
|
foreach ($removedUsers as $user) {
|
|
|
|
$this->dbConfig->removeApplicable($id, DBConfigService::APPLICABLE_TYPE_USER, $user);
|
|
|
|
}
|
|
|
|
foreach ($removedGroups as $group) {
|
|
|
|
$this->dbConfig->removeApplicable($id, DBConfigService::APPLICABLE_TYPE_GROUP, $group);
|
|
|
|
}
|
|
|
|
foreach ($addedUsers as $user) {
|
|
|
|
$this->dbConfig->addApplicable($id, DBConfigService::APPLICABLE_TYPE_USER, $user);
|
|
|
|
}
|
|
|
|
foreach ($addedGroups as $group) {
|
|
|
|
$this->dbConfig->addApplicable($id, DBConfigService::APPLICABLE_TYPE_GROUP, $group);
|
2014-10-31 13:41:07 +03:00
|
|
|
}
|
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
if ($wasGlobal && !$isGlobal) {
|
|
|
|
$this->dbConfig->removeApplicable($id, DBConfigService::APPLICABLE_TYPE_GLOBAL, null);
|
|
|
|
} else if (!$wasGlobal && $isGlobal) {
|
|
|
|
$this->dbConfig->addApplicable($id, DBConfigService::APPLICABLE_TYPE_GLOBAL, null);
|
2015-08-25 16:51:47 +03:00
|
|
|
}
|
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
$changedConfig = array_diff_assoc($updatedStorage->getBackendOptions(), $oldStorage->getBackendOptions());
|
|
|
|
$changedOptions = array_diff_assoc($updatedStorage->getMountOptions(), $oldStorage->getMountOptions());
|
|
|
|
|
|
|
|
foreach ($changedConfig as $key => $value) {
|
|
|
|
$this->dbConfig->setConfig($id, $key, $value);
|
|
|
|
}
|
|
|
|
foreach ($changedOptions as $key => $value) {
|
|
|
|
$this->dbConfig->setOption($id, $key, $value);
|
|
|
|
}
|
2014-10-31 13:41:07 +03:00
|
|
|
|
2015-12-15 15:24:30 +03:00
|
|
|
if ($updatedStorage->getMountPoint() !== $oldStorage->getMountPoint()) {
|
|
|
|
$this->dbConfig->setMountPoint($id, $updatedStorage->getMountPoint());
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($updatedStorage->getAuthMechanism()->getIdentifier() !== $oldStorage->getAuthMechanism()->getIdentifier()) {
|
|
|
|
$this->dbConfig->setAuthBackend($id, $updatedStorage->getAuthMechanism()->getIdentifier());
|
|
|
|
}
|
|
|
|
|
2014-10-31 13:41:07 +03:00
|
|
|
$this->triggerChangeHooks($oldStorage, $updatedStorage);
|
|
|
|
|
|
|
|
return $this->getStorage($id);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Delete the storage with the given id.
|
|
|
|
*
|
|
|
|
* @param int $id storage id
|
|
|
|
*
|
2015-03-17 13:42:52 +03:00
|
|
|
* @throws NotFoundException if no storage was found with the given id
|
2014-10-31 13:41:07 +03:00
|
|
|
*/
|
|
|
|
public function removeStorage($id) {
|
2015-11-02 15:13:06 +03:00
|
|
|
$existingMount = $this->dbConfig->getMountById($id);
|
2014-10-31 13:41:07 +03:00
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
if (!is_array($existingMount)) {
|
2014-10-31 13:41:07 +03:00
|
|
|
throw new NotFoundException('Storage with id "' . $id . '" not found');
|
|
|
|
}
|
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
$this->dbConfig->removeMount($id);
|
2014-10-31 13:41:07 +03:00
|
|
|
|
2015-11-02 15:13:06 +03:00
|
|
|
$deletedStorage = $this->getStorageConfigFromDBMount($existingMount);
|
2014-10-31 13:41:07 +03:00
|
|
|
$this->triggerHooks($deletedStorage, Filesystem::signal_delete_mount);
|
2015-10-06 17:47:59 +03:00
|
|
|
|
|
|
|
// delete oc_storages entries and oc_filecache
|
|
|
|
try {
|
|
|
|
$rustyStorageId = $this->getRustyStorageIdFromConfig($deletedStorage);
|
|
|
|
\OC\Files\Cache\Storage::remove($rustyStorageId);
|
|
|
|
} catch (\Exception $e) {
|
|
|
|
// can happen either for invalid configs where the storage could not
|
|
|
|
// be instantiated or whenever $user vars where used, in which case
|
|
|
|
// the storage id could not be computed
|
|
|
|
\OCP\Util::writeLog(
|
|
|
|
'files_external',
|
|
|
|
'Exception: "' . $e->getMessage() . '"',
|
|
|
|
\OCP\Util::ERROR
|
|
|
|
);
|
|
|
|
}
|
2014-10-31 13:41:07 +03:00
|
|
|
}
|
|
|
|
|
2015-10-06 17:47:59 +03:00
|
|
|
/**
|
|
|
|
* Returns the rusty storage id from oc_storages from the given storage config.
|
|
|
|
*
|
|
|
|
* @param StorageConfig $storageConfig
|
|
|
|
* @return string rusty storage id
|
|
|
|
*/
|
|
|
|
private function getRustyStorageIdFromConfig(StorageConfig $storageConfig) {
|
|
|
|
// if any of the storage options contains $user, it is not possible
|
|
|
|
// to compute the possible storage id as we don't know which users
|
|
|
|
// mounted it already (and we certainly don't want to iterate over ALL users)
|
|
|
|
foreach ($storageConfig->getBackendOptions() as $value) {
|
|
|
|
if (strpos($value, '$user') !== false) {
|
|
|
|
throw new \Exception('Cannot compute storage id for deletion due to $user vars in the configuration');
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// note: similar to ConfigAdapter->prepateStorageConfig()
|
|
|
|
$storageConfig->getAuthMechanism()->manipulateStorageConfig($storageConfig);
|
|
|
|
$storageConfig->getBackend()->manipulateStorageConfig($storageConfig);
|
|
|
|
|
|
|
|
$class = $storageConfig->getBackend()->getStorageClass();
|
|
|
|
$storageImpl = new $class($storageConfig->getBackendOptions());
|
|
|
|
|
|
|
|
return $storageImpl->getId();
|
|
|
|
}
|
|
|
|
|
2014-10-31 13:41:07 +03:00
|
|
|
}
|