Blame view

sources/apps/files_encryption/lib/helper.php 13.6 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
50
51
52
53
54
55
56
  	 *
  	 */
  	public static function registerUserHooks() {
  
  		\OCP\Util::connectHook('OC_User', 'post_login', 'OCA\Encryption\Hooks', 'login');
  		\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...
57
  	 * register filesystem related hooks
03e52840d   Kload   Init
58
59
60
  	 *
  	 */
  	public static function registerFilesystemHooks() {
a293d369c   Kload   Update sources to...
61
  		\OCP\Util::connectHook('OC_Filesystem', 'rename', 'OCA\Encryption\Hooks', 'preRename');
6d9380f96   Cédric Dupont   Update sources OC...
62
63
64
  		\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...
65
66
  		\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...
67
68
  		\OCP\Util::connectHook('OC_Filesystem', 'post_umount', 'OCA\Encryption\Hooks', 'postUmount');
  		\OCP\Util::connectHook('OC_Filesystem', 'umount', 'OCA\Encryption\Hooks', 'preUmount');
03e52840d   Kload   Init
69
70
71
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
72
  	 * register app management related hooks
03e52840d   Kload   Init
73
74
75
76
77
  	 *
  	 */
  	public static function registerAppHooks() {
  
  		\OCP\Util::connectHook('OC_App', 'pre_disable', 'OCA\Encryption\Hooks', 'preDisable');
31b7f2792   Kload   Upgrade to ownclo...
78
  		\OCP\Util::connectHook('OC_App', 'post_disable', 'OCA\Encryption\Hooks', 'postEnable');
03e52840d   Kload   Init
79
80
81
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
82
  	 * setup user for files_encryption
03e52840d   Kload   Init
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
  	 *
  	 * @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...
104
  	 * enable recovery
03e52840d   Kload   Init
105
  	 *
6d9380f96   Cédric Dupont   Update sources OC...
106
107
  	 * @param string $recoveryKeyId
  	 * @param string $recoveryPassword
03e52840d   Kload   Init
108
109
110
111
112
113
114
  	 * @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...
115
  		$appConfig = \OC::$server->getAppConfig();
03e52840d   Kload   Init
116
117
118
  
  		if ($recoveryKeyId === null) {
  			$recoveryKeyId = 'recovery_' . substr(md5(time()), 0, 8);
6d9380f96   Cédric Dupont   Update sources OC...
119
  			$appConfig->setValue('files_encryption', 'recoveryKeyId', $recoveryKeyId);
03e52840d   Kload   Init
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
  		}
  
  		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']);
  
  			// Encrypt private key empty passphrase
  			$encryptedPrivateKey = \OCA\Encryption\Crypt::symmetricEncryptFileContent($keypair['privateKey'], $recoveryPassword);
  
  			// Save private key
  			$view->file_put_contents('/owncloud_private_key/' . $recoveryKeyId . '.private.key', $encryptedPrivateKey);
  
  			\OC_FileProxy::$enabled = true;
  
  			// Set recoveryAdmin as enabled
6d9380f96   Cédric Dupont   Update sources OC...
152
  			$appConfig->setValue('files_encryption', 'recoveryAdminEnabled', 1);
03e52840d   Kload   Init
153
154
155
156
  
  			$return = true;
  
  		} else { // get recovery key and check the password
6d9380f96   Cédric Dupont   Update sources OC...
157
  			$util = new \OCA\Encryption\Util(new \OC\Files\View('/'), \OCP\User::getUser());
03e52840d   Kload   Init
158
159
  			$return = $util->checkRecoveryPassword($recoveryPassword);
  			if ($return) {
6d9380f96   Cédric Dupont   Update sources OC...
160
  				$appConfig->setValue('files_encryption', 'recoveryAdminEnabled', 1);
03e52840d   Kload   Init
161
162
163
164
165
  			}
  		}
  
  		return $return;
  	}
31b7f2792   Kload   Upgrade to ownclo...
166
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
167
  	 * Check if a path is a .part file
31b7f2792   Kload   Upgrade to ownclo...
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
  	 * @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...
184
  	 * Remove .path extension from a file path
31b7f2792   Kload   Upgrade to ownclo...
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
  	 * @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
209
210
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
211
  	 * disable recovery
03e52840d   Kload   Init
212
  	 *
6d9380f96   Cédric Dupont   Update sources OC...
213
  	 * @param string $recoveryPassword
03e52840d   Kload   Init
214
215
216
  	 * @return bool
  	 */
  	public static function adminDisableRecovery($recoveryPassword) {
6d9380f96   Cédric Dupont   Update sources OC...
217
  		$util = new Util(new \OC\Files\View('/'), \OCP\User::getUser());
03e52840d   Kload   Init
218
219
220
221
  		$return = $util->checkRecoveryPassword($recoveryPassword);
  
  		if ($return) {
  			// Set recoveryAdmin as disabled
6d9380f96   Cédric Dupont   Update sources OC...
222
  			\OC::$server->getAppConfig()->setValue('files_encryption', 'recoveryAdminEnabled', 0);
03e52840d   Kload   Init
223
224
225
226
227
228
229
  		}
  
  		return $return;
  	}
  
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
230
  	 * checks if access is public/anonymous user
03e52840d   Kload   Init
231
232
233
  	 * @return bool
  	 */
  	public static function isPublicAccess() {
31b7f2792   Kload   Upgrade to ownclo...
234
  		if (\OCP\User::getUser() === false) {
03e52840d   Kload   Init
235
236
237
238
239
240
241
  			return true;
  		} else {
  			return false;
  		}
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
242
  	 * Format a path to be relative to the /user/files/ directory
03e52840d   Kload   Init
243
244
245
246
247
248
  	 * @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...
249
250
251
252
253
  
  		// it is not a file relative to data/user/files
  		if (count($split) < 3 || $split[1] !== 'files') {
  			return false;
  		}
03e52840d   Kload   Init
254
255
256
257
258
259
260
  		$sliced = array_slice($split, 2);
  		$relPath = implode('/', $sliced);
  
  		return $relPath;
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
261
  	 * try to get the user from the path if no user is logged in
31b7f2792   Kload   Upgrade to ownclo...
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
  	 * @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...
282
  		if (count($split) < 2 || ($split[1] !== 'files' && $split[1] !== 'cache')) {
31b7f2792   Kload   Upgrade to ownclo...
283
284
285
286
287
288
289
290
291
292
293
294
295
  			return false;
  		}
  
  		$user = $split[0];
  
  		if (\OCP\User::userExists($user)) {
  			return $user;
  		}
  
  		return false;
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
296
  	 * get path to the corresponding file in data/user/files if path points
31b7f2792   Kload   Upgrade to ownclo...
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
324
325
326
327
328
  	 *        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...
329
  	 * create directory recursively
31b7f2792   Kload   Upgrade to ownclo...
330
331
332
333
  	 * @param string $path
  	 * @param \OC\Files\View $view
  	 */
  	public static function mkdirr($path, $view) {
6d9380f96   Cédric Dupont   Update sources OC...
334
  		$dirname = \OC\Files\Filesystem::normalizePath(dirname($path));
31b7f2792   Kload   Upgrade to ownclo...
335
336
337
338
339
340
341
342
343
344
345
  		$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...
346
347
  	 * redirect to a error page
  	 * @param Session $session
03e52840d   Kload   Init
348
  	 */
31b7f2792   Kload   Upgrade to ownclo...
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
  	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
364
365
366
367
  		$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...
368
369
370
371
372
373
374
375
  		}
  
  		if(defined('PHPUNIT_RUN') and PHPUNIT_RUN) {
  			throw new \Exception("Encryption error: $errorCode");
  		}
  
  		header('Location: ' . $location . '?p=' . $post . '&errorCode=' . $errorCode);
  		exit();
03e52840d   Kload   Init
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
  	}
  
  	/**
  	 * 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...
392

03e52840d   Kload   Init
393
394
395
396
397
  	/**
  	 * 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...
398
  		if(self::getOpenSSLPkey()) {
03e52840d   Kload   Init
399
400
401
402
403
404
405
406
407
408
  			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...
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
  	 * 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...
429
430
431
432
  	 * 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
433
  	 */
6d9380f96   Cédric Dupont   Update sources OC...
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
  	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
451
  	}
837968727   Kload   [enh] Upgrade to ...
452
453
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
454
  	 * remember from which file the tmp file (getLocalFile() call) was created
837968727   Kload   [enh] Upgrade to ...
455
456
457
458
459
460
461
462
  	 * @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...
463
  	 * get the path of the original file
837968727   Kload   [enh] Upgrade to ...
464
  	 * @param string $tmpFile path of the tmp file
6d9380f96   Cédric Dupont   Update sources OC...
465
  	 * @return string|false path of the original file or false
837968727   Kload   [enh] Upgrade to ...
466
467
468
469
470
471
472
473
  	 */
  	public static function getPathFromTmpFile($tmpFile) {
  		if (isset(self::$tmpFileMapping[$tmpFile])) {
  			return self::$tmpFileMapping[$tmpFile];
  		}
  
  		return false;
  	}
03e52840d   Kload   Init
474
  }