Blame view

sources/apps/files_encryption/lib/helper.php 14.1 KB
03e52840d   Kload   Init
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
  <?php
  
  /**
   * ownCloud
   *
   * @author Florin Peter
   * @copyright 2013 Florin Peter <owncloud@florin-peter.de>
   *
   * This library is free software; you can redistribute it and/or
   * modify it under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE
   * License as published by the Free Software Foundation; either
   * version 3 of the License, or any later version.
   *
   * This library 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 library.  If not, see <http://www.gnu.org/licenses/>.
   *
   */
  
  namespace OCA\Encryption;
  
  /**
6d9380f96   Cédric Dupont   Update sources OC...
27
   * Class to manage registration of hooks an various helper methods
03e52840d   Kload   Init
28
29
30
   * @package OCA\Encryption
   */
  class Helper {
837968727   Kload   [enh] Upgrade to ...
31
  	private static $tmpFileMapping; // Map tmp files to files in data/user/files
03e52840d   Kload   Init
32
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
33
  	 * register share related hooks
03e52840d   Kload   Init
34
35
36
37
38
39
40
41
42
43
  	 *
  	 */
  	public static function registerShareHooks() {
  
  		\OCP\Util::connectHook('OCP\Share', 'pre_shared', 'OCA\Encryption\Hooks', 'preShared');
  		\OCP\Util::connectHook('OCP\Share', 'post_shared', 'OCA\Encryption\Hooks', 'postShared');
  		\OCP\Util::connectHook('OCP\Share', 'post_unshare', 'OCA\Encryption\Hooks', 'postUnshare');
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
44
  	 * register user related hooks
03e52840d   Kload   Init
45
46
47
48
49
  	 *
  	 */
  	public static function registerUserHooks() {
  
  		\OCP\Util::connectHook('OC_User', 'post_login', 'OCA\Encryption\Hooks', 'login');
f7d878ff1   kload   [enh] Update to 7...
50
  		\OCP\Util::connectHook('OC_User', 'logout', 'OCA\Encryption\Hooks', 'logout');
03e52840d   Kload   Init
51
52
53
54
55
56
57
  		\OCP\Util::connectHook('OC_User', 'post_setPassword', 'OCA\Encryption\Hooks', 'setPassphrase');
  		\OCP\Util::connectHook('OC_User', 'pre_setPassword', 'OCA\Encryption\Hooks', 'preSetPassphrase');
  		\OCP\Util::connectHook('OC_User', 'post_createUser', 'OCA\Encryption\Hooks', 'postCreateUser');
  		\OCP\Util::connectHook('OC_User', 'post_deleteUser', 'OCA\Encryption\Hooks', 'postDeleteUser');
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
58
  	 * register filesystem related hooks
03e52840d   Kload   Init
59
60
61
  	 *
  	 */
  	public static function registerFilesystemHooks() {
a293d369c   Kload   Update sources to...
62
  		\OCP\Util::connectHook('OC_Filesystem', 'rename', 'OCA\Encryption\Hooks', 'preRename');
6d9380f96   Cédric Dupont   Update sources OC...
63
64
65
  		\OCP\Util::connectHook('OC_Filesystem', 'post_rename', 'OCA\Encryption\Hooks', 'postRenameOrCopy');
  		\OCP\Util::connectHook('OC_Filesystem', 'copy', 'OCA\Encryption\Hooks', 'preCopy');
  		\OCP\Util::connectHook('OC_Filesystem', 'post_copy', 'OCA\Encryption\Hooks', 'postRenameOrCopy');
a293d369c   Kload   Update sources to...
66
67
  		\OCP\Util::connectHook('OC_Filesystem', 'post_delete', 'OCA\Encryption\Hooks', 'postDelete');
  		\OCP\Util::connectHook('OC_Filesystem', 'delete', 'OCA\Encryption\Hooks', 'preDelete');
6d9380f96   Cédric Dupont   Update sources OC...
68
69
  		\OCP\Util::connectHook('OC_Filesystem', 'post_umount', 'OCA\Encryption\Hooks', 'postUmount');
  		\OCP\Util::connectHook('OC_Filesystem', 'umount', 'OCA\Encryption\Hooks', 'preUmount');
03e52840d   Kload   Init
70
71
72
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
73
  	 * register app management related hooks
03e52840d   Kload   Init
74
75
76
77
78
  	 *
  	 */
  	public static function registerAppHooks() {
  
  		\OCP\Util::connectHook('OC_App', 'pre_disable', 'OCA\Encryption\Hooks', 'preDisable');
31b7f2792   Kload   Upgrade to ownclo...
79
  		\OCP\Util::connectHook('OC_App', 'post_disable', 'OCA\Encryption\Hooks', 'postEnable');
03e52840d   Kload   Init
80
81
82
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
83
  	 * setup user for files_encryption
03e52840d   Kload   Init
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
  	 *
  	 * @param Util $util
  	 * @param string $password
  	 * @return bool
  	 */
  	public static function setupUser($util, $password) {
  		// Check files_encryption infrastructure is ready for action
  		if (!$util->ready()) {
  
  			\OCP\Util::writeLog('Encryption library', 'User account "' . $util->getUserId()
  													  . '" is not ready for encryption; configuration started', \OCP\Util::DEBUG);
  
  			if (!$util->setupServerSide($password)) {
  				return false;
  			}
  		}
  
  		return true;
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
105
  	 * enable recovery
03e52840d   Kload   Init
106
  	 *
6d9380f96   Cédric Dupont   Update sources OC...
107
108
  	 * @param string $recoveryKeyId
  	 * @param string $recoveryPassword
03e52840d   Kload   Init
109
110
111
112
113
114
115
  	 * @internal param \OCA\Encryption\Util $util
  	 * @internal param string $password
  	 * @return bool
  	 */
  	public static function adminEnableRecovery($recoveryKeyId, $recoveryPassword) {
  
  		$view = new \OC\Files\View('/');
6d9380f96   Cédric Dupont   Update sources OC...
116
  		$appConfig = \OC::$server->getAppConfig();
03e52840d   Kload   Init
117
118
119
  
  		if ($recoveryKeyId === null) {
  			$recoveryKeyId = 'recovery_' . substr(md5(time()), 0, 8);
6d9380f96   Cédric Dupont   Update sources OC...
120
  			$appConfig->setValue('files_encryption', 'recoveryKeyId', $recoveryKeyId);
03e52840d   Kload   Init
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
  		}
  
  		if (!$view->is_dir('/owncloud_private_key')) {
  			$view->mkdir('/owncloud_private_key');
  		}
  
  		if (
  			(!$view->file_exists("/public-keys/" . $recoveryKeyId . ".public.key")
  			 || !$view->file_exists("/owncloud_private_key/" . $recoveryKeyId . ".private.key"))
  		) {
  
  			$keypair = \OCA\Encryption\Crypt::createKeypair();
  
  			\OC_FileProxy::$enabled = false;
  
  			// Save public key
  
  			if (!$view->is_dir('/public-keys')) {
  				$view->mkdir('/public-keys');
  			}
  
  			$view->file_put_contents('/public-keys/' . $recoveryKeyId . '.public.key', $keypair['publicKey']);
f7d878ff1   kload   [enh] Update to 7...
143
144
145
146
147
148
149
150
  			$cipher = \OCA\Encryption\Helper::getCipher();
  			$encryptedKey = \OCA\Encryption\Crypt::symmetricEncryptFileContent($keypair['privateKey'], $recoveryPassword, $cipher);
  			if ($encryptedKey) {
  				Keymanager::setPrivateSystemKey($encryptedKey, $recoveryKeyId . '.private.key');
  				// Set recoveryAdmin as enabled
  				$appConfig->setValue('files_encryption', 'recoveryAdminEnabled', 1);
  				$return = true;
  			}
03e52840d   Kload   Init
151
152
  
  			\OC_FileProxy::$enabled = true;
03e52840d   Kload   Init
153
  		} else { // get recovery key and check the password
6d9380f96   Cédric Dupont   Update sources OC...
154
  			$util = new \OCA\Encryption\Util(new \OC\Files\View('/'), \OCP\User::getUser());
03e52840d   Kload   Init
155
156
  			$return = $util->checkRecoveryPassword($recoveryPassword);
  			if ($return) {
6d9380f96   Cédric Dupont   Update sources OC...
157
  				$appConfig->setValue('files_encryption', 'recoveryAdminEnabled', 1);
03e52840d   Kload   Init
158
159
160
161
162
  			}
  		}
  
  		return $return;
  	}
31b7f2792   Kload   Upgrade to ownclo...
163
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
164
  	 * Check if a path is a .part file
31b7f2792   Kload   Upgrade to ownclo...
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
  	 * @param string $path Path that may identify a .part file
  	 * @return bool
  	 */
  	public static function isPartialFilePath($path) {
  
  		$extension = pathinfo($path, PATHINFO_EXTENSION);
  		if ( $extension === 'part') {
  			return true;
  		} else {
  			return false;
  		}
  
  	}
  
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
181
  	 * Remove .path extension from a file path
31b7f2792   Kload   Upgrade to ownclo...
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
  	 * @param string $path Path that may identify a .part file
  	 * @return string File path without .part extension
  	 * @note this is needed for reusing keys
  	 */
  	public static function stripPartialFileExtension($path) {
  		$extension = pathinfo($path, PATHINFO_EXTENSION);
  
  		if ( $extension === 'part') {
  
  			$newLength = strlen($path) - 5; // 5 = strlen(".part") = strlen(".etmp")
  			$fPath = substr($path, 0, $newLength);
  
  			// if path also contains a transaction id, we remove it too
  			$extension = pathinfo($fPath, PATHINFO_EXTENSION);
  			if(substr($extension, 0, 12) === 'ocTransferId') { // 12 = strlen("ocTransferId")
  				$newLength = strlen($fPath) - strlen($extension) -1;
  				$fPath = substr($fPath, 0, $newLength);
  			}
  			return $fPath;
  
  		} else {
  			return $path;
  		}
  	}
03e52840d   Kload   Init
206
207
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
208
  	 * disable recovery
03e52840d   Kload   Init
209
  	 *
6d9380f96   Cédric Dupont   Update sources OC...
210
  	 * @param string $recoveryPassword
03e52840d   Kload   Init
211
212
213
  	 * @return bool
  	 */
  	public static function adminDisableRecovery($recoveryPassword) {
6d9380f96   Cédric Dupont   Update sources OC...
214
  		$util = new Util(new \OC\Files\View('/'), \OCP\User::getUser());
03e52840d   Kload   Init
215
216
217
218
  		$return = $util->checkRecoveryPassword($recoveryPassword);
  
  		if ($return) {
  			// Set recoveryAdmin as disabled
6d9380f96   Cédric Dupont   Update sources OC...
219
  			\OC::$server->getAppConfig()->setValue('files_encryption', 'recoveryAdminEnabled', 0);
03e52840d   Kload   Init
220
221
222
223
  		}
  
  		return $return;
  	}
03e52840d   Kload   Init
224
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
225
  	 * checks if access is public/anonymous user
03e52840d   Kload   Init
226
227
228
  	 * @return bool
  	 */
  	public static function isPublicAccess() {
31b7f2792   Kload   Upgrade to ownclo...
229
  		if (\OCP\User::getUser() === false) {
03e52840d   Kload   Init
230
231
232
233
234
235
236
  			return true;
  		} else {
  			return false;
  		}
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
237
  	 * Format a path to be relative to the /user/files/ directory
03e52840d   Kload   Init
238
239
240
241
242
243
  	 * @param string $path the absolute path
  	 * @return string e.g. turns '/admin/files/test.txt' into 'test.txt'
  	 */
  	public static function stripUserFilesPath($path) {
  		$trimmed = ltrim($path, '/');
  		$split = explode('/', $trimmed);
31b7f2792   Kload   Upgrade to ownclo...
244
245
246
247
248
  
  		// it is not a file relative to data/user/files
  		if (count($split) < 3 || $split[1] !== 'files') {
  			return false;
  		}
03e52840d   Kload   Init
249
250
251
252
253
254
255
  		$sliced = array_slice($split, 2);
  		$relPath = implode('/', $sliced);
  
  		return $relPath;
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
256
  	 * try to get the user from the path if no user is logged in
31b7f2792   Kload   Upgrade to ownclo...
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
  	 * @param string $path
  	 * @return mixed user or false if we couldn't determine a user
  	 */
  	public static function getUser($path) {
  
  		$user = \OCP\User::getUser();
  
  
  		// if we are logged in, then we return the userid
  		if ($user) {
  			return $user;
  		}
  
  		// if no user is logged in we try to access a publicly shared files.
  		// In this case we need to try to get the user from the path
  
  		$trimmed = ltrim($path, '/');
  		$split = explode('/', $trimmed);
  
  		// it is not a file relative to data/user/files
a293d369c   Kload   Update sources to...
277
  		if (count($split) < 2 || ($split[1] !== 'files' && $split[1] !== 'cache')) {
31b7f2792   Kload   Upgrade to ownclo...
278
279
280
281
282
283
284
285
286
287
288
289
290
  			return false;
  		}
  
  		$user = $split[0];
  
  		if (\OCP\User::userExists($user)) {
  			return $user;
  		}
  
  		return false;
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
291
  	 * get path to the corresponding file in data/user/files if path points
31b7f2792   Kload   Upgrade to ownclo...
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
  	 *        to a version or to a file in cache
  	 * @param string $path path to a version or a file in the trash
  	 * @return string path to corresponding file relative to data/user/files
  	 */
  	public static function getPathToRealFile($path) {
  		$trimmed = ltrim($path, '/');
  		$split = explode('/', $trimmed);
  		$result = false;
  
  		if (count($split) >= 3 && ($split[1] === "files_versions" || $split[1] === 'cache')) {
  			$sliced = array_slice($split, 2);
  			$result = implode('/', $sliced);
  			if ($split[1] === "files_versions") {
  				// we skip user/files
  				$sliced = array_slice($split, 2);
  				$relPath = implode('/', $sliced);
  				//remove the last .v
  				$result = substr($relPath, 0, strrpos($relPath, '.v'));
  			}
  			if ($split[1] === "cache") {
  				// we skip /user/cache/transactionId
  				$sliced = array_slice($split, 3);
  				$result = implode('/', $sliced);
  				//prepare the folders
  				self::mkdirr($path, new \OC\Files\View('/'));
  			}
  		}
  
  		return $result;
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
324
  	 * create directory recursively
31b7f2792   Kload   Upgrade to ownclo...
325
326
327
328
  	 * @param string $path
  	 * @param \OC\Files\View $view
  	 */
  	public static function mkdirr($path, $view) {
6d9380f96   Cédric Dupont   Update sources OC...
329
  		$dirname = \OC\Files\Filesystem::normalizePath(dirname($path));
31b7f2792   Kload   Upgrade to ownclo...
330
331
332
333
334
335
336
337
338
339
340
  		$dirParts = explode('/', $dirname);
  		$dir = "";
  		foreach ($dirParts as $part) {
  			$dir = $dir . '/' . $part;
  			if (!$view->file_exists($dir)) {
  				$view->mkdir($dir);
  			}
  		}
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
341
342
  	 * redirect to a error page
  	 * @param Session $session
03e52840d   Kload   Init
343
  	 */
31b7f2792   Kload   Upgrade to ownclo...
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
  	public static function redirectToErrorPage($session, $errorCode = null) {
  
  		if ($errorCode === null) {
  			$init = $session->getInitialized();
  			switch ($init) {
  				case \OCA\Encryption\Session::INIT_EXECUTED:
  					$errorCode = \OCA\Encryption\Crypt::ENCRYPTION_PRIVATE_KEY_NOT_VALID_ERROR;
  					break;
  				case \OCA\Encryption\Session::NOT_INITIALIZED:
  					$errorCode = \OCA\Encryption\Crypt::ENCRYPTION_NOT_INITIALIZED_ERROR;
  					break;
  				default:
  					$errorCode = \OCA\Encryption\Crypt::ENCRYPTION_UNKNOWN_ERROR;
  			}
  		}
03e52840d   Kload   Init
359
360
361
362
  		$location = \OC_Helper::linkToAbsolute('apps/files_encryption/files', 'error.php');
  		$post = 0;
  		if(count($_POST) > 0) {
  			$post = 1;
6d9380f96   Cédric Dupont   Update sources OC...
363
364
365
366
367
368
369
370
  		}
  
  		if(defined('PHPUNIT_RUN') and PHPUNIT_RUN) {
  			throw new \Exception("Encryption error: $errorCode");
  		}
  
  		header('Location: ' . $location . '?p=' . $post . '&errorCode=' . $errorCode);
  		exit();
03e52840d   Kload   Init
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
  	}
  
  	/**
  	 * check requirements for encryption app.
  	 * @return bool true if requirements are met
  	 */
  	public static function checkRequirements() {
  		$result = true;
  
  		//openssl extension needs to be loaded
  		$result &= extension_loaded("openssl");
  		// we need php >= 5.3.3
  		$result &= version_compare(phpversion(), '5.3.3', '>=');
  
  		return (bool) $result;
  	}
31b7f2792   Kload   Upgrade to ownclo...
387

03e52840d   Kload   Init
388
389
390
391
392
  	/**
  	 * check some common errors if the server isn't configured properly for encryption
  	 * @return bool true if configuration seems to be OK
  	 */
  	public static function checkConfiguration() {
31b7f2792   Kload   Upgrade to ownclo...
393
  		if(self::getOpenSSLPkey()) {
03e52840d   Kload   Init
394
395
396
397
398
399
400
401
402
403
  			return true;
  		} else {
  			while ($msg = openssl_error_string()) {
  				\OCP\Util::writeLog('Encryption library', 'openssl_pkey_new() fails:  ' . $msg, \OCP\Util::ERROR);
  			}
  			return false;
  		}
  	}
  
  	/**
31b7f2792   Kload   Upgrade to ownclo...
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
  	 * Create an openssl pkey with config-supplied settings
  	 * WARNING: This initializes a new private keypair, which is computationally expensive
  	 * @return resource The pkey resource created
  	 */
  	public static function getOpenSSLPkey() {
  		return openssl_pkey_new(self::getOpenSSLConfig());
  	}
  
  	/**
  	 * Return an array of OpenSSL config options, default + config
  	 * Used for multiple OpenSSL functions
  	 * @return array The combined defaults and config settings
  	 */
  	public static function getOpenSSLConfig() {
  		$config = array('private_key_bits' => 4096);
  		$config = array_merge(\OCP\Config::getSystemValue('openssl', array()), $config);
  		return $config;
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
424
425
426
427
  	 * find all share keys for a given file
  	 * @param string $path to the file
  	 * @param \OC\Files\View $view view, relative to data/
  	 * @return array list of files, path relative to data/
03e52840d   Kload   Init
428
  	 */
6d9380f96   Cédric Dupont   Update sources OC...
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
  	public static function findShareKeys($path, $view) {
  		$result = array();
  		$pathinfo = pathinfo($path);
  		$dirContent = $view->opendir($pathinfo['dirname']);
  
  		if (is_resource($dirContent)) {
  			while (($file = readdir($dirContent)) !== false) {
  				if (!\OC\Files\Filesystem::isIgnoredDir($file)) {
  					if (preg_match("/" . $pathinfo['filename'] . ".(.*).shareKey/", $file)) {
  						$result[] = $pathinfo['dirname'] . '/' . $file;
  					}
  				}
  			}
  			closedir($dirContent);
  		}
  
  		return $result;
03e52840d   Kload   Init
446
  	}
837968727   Kload   [enh] Upgrade to ...
447
448
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
449
  	 * remember from which file the tmp file (getLocalFile() call) was created
837968727   Kload   [enh] Upgrade to ...
450
451
452
453
454
455
456
457
  	 * @param string $tmpFile path of tmp file
  	 * @param string $originalFile path of the original file relative to data/
  	 */
  	public static function addTmpFileToMapper($tmpFile, $originalFile) {
  		self::$tmpFileMapping[$tmpFile] = $originalFile;
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
458
  	 * get the path of the original file
837968727   Kload   [enh] Upgrade to ...
459
  	 * @param string $tmpFile path of the tmp file
6d9380f96   Cédric Dupont   Update sources OC...
460
  	 * @return string|false path of the original file or false
837968727   Kload   [enh] Upgrade to ...
461
462
463
464
465
466
467
468
  	 */
  	public static function getPathFromTmpFile($tmpFile) {
  		if (isset(self::$tmpFileMapping[$tmpFile])) {
  			return self::$tmpFileMapping[$tmpFile];
  		}
  
  		return false;
  	}
f7d878ff1   kload   [enh] Update to 7...
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
  
  	/**
  	 * read the cipher used for encryption from the config.php
  	 *
  	 * @return string
  	 */
  	public static function getCipher() {
  
  		$cipher = \OCP\Config::getSystemValue('cipher', Crypt::DEFAULT_CIPHER);
  
  		if ($cipher !== 'AES-256-CFB' && $cipher !== 'AES-128-CFB') {
  			\OCP\Util::writeLog('files_encryption',
  					'wrong cipher defined in config.php, only AES-128-CFB and AES-256-CFB is supported. Fall back ' . Crypt::DEFAULT_CIPHER,
  					\OCP\Util::WARN);
  
  			$cipher = Crypt::DEFAULT_CIPHER;
  		}
  
  		return $cipher;
  	}
03e52840d   Kload   Init
489
  }