nextcloud/apps/files_encryption/lib/crypt.php

584 lines
15 KiB
PHP
Raw Normal View History

<?php
/**
* ownCloud
*
* @author Sam Tuke, Frank Karlitschek, Robin Appelman
2013-05-20 03:24:36 +04:00
* @copyright 2012 Sam Tuke samtuke@owncloud.com,
* Robin Appelman icewind@owncloud.com, Frank Karlitschek
* frank@owncloud.org
*
* 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;
require_once __DIR__ . '/../3rdparty/Crypt_Blowfish/Blowfish.php';
/**
* Class for common cryptography functionality
*/
2013-05-27 19:26:58 +04:00
class Crypt {
const ENCRYPTION_UNKNOWN_ERROR = -1;
const ENCRYPTION_NOT_INITIALIZED_ERROR = 1;
const ENCRYPTION_PRIVATE_KEY_NOT_VALID_ERROR = 2;
const ENCRYPTION_NO_SHARE_KEY_FOUND = 3;
/**
* @brief return encryption mode client or server side encryption
2013-05-20 03:24:36 +04:00
* @param string $user name (use system wide setting if name=null)
* @return string 'client' or 'server'
*/
2013-05-27 19:26:58 +04:00
public static function mode($user = null) {
return 'server';
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Create a new encryption keypair
* @return array publicKey, privatekey
*/
2013-05-24 01:56:31 +04:00
public static function createKeypair() {
2013-05-20 03:24:36 +04:00
2013-06-19 18:55:31 +04:00
$return = false;
$res = Helper::getOpenSSLPkey();
if ($res === false) {
\OCP\Util::writeLog('Encryption library', 'couldn\'t generate users key-pair for ' . \OCP\User::getUser(), \OCP\Util::ERROR);
while ($msg = openssl_error_string()) {
\OCP\Util::writeLog('Encryption library', 'openssl_pkey_new() fails: ' . $msg, \OCP\Util::ERROR);
}
} elseif (openssl_pkey_export($res, $privateKey, null, Helper::getOpenSSLConfig())) {
// Get public key
$keyDetails = openssl_pkey_get_details($res);
$publicKey = $keyDetails['key'];
2013-05-20 03:24:36 +04:00
2013-06-19 18:55:31 +04:00
$return = array(
'publicKey' => $publicKey,
'privateKey' => $privateKey
);
2013-06-19 17:58:34 +04:00
} else {
\OCP\Util::writeLog('Encryption library', 'couldn\'t export users private key, please check your servers openSSL configuration.' . \OCP\User::getUser(), \OCP\Util::ERROR);
while($errMsg = openssl_error_string()) {
\OCP\Util::writeLog('Encryption library', $errMsg, \OCP\Util::ERROR);
}
}
2013-05-20 03:24:36 +04:00
2013-06-19 18:55:31 +04:00
return $return;
}
2013-05-20 03:24:36 +04:00
/**
* @brief Add arbitrary padding to encrypted data
* @param string $data data to be padded
* @return string padded data
* @note In order to end up with data exactly 8192 bytes long we must
* add two letters. It is impossible to achieve exactly 8192 length
* blocks with encryption alone, hence padding is added to achieve the
* required length.
*/
private static function addPadding($data) {
2013-05-20 03:24:36 +04:00
$padded = $data . 'xx';
2013-05-20 03:24:36 +04:00
return $padded;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Remove arbitrary padding to encrypted data
* @param string $padded padded data to remove padding from
* @return string unpadded data on success, false on error
*/
private static function removePadding($padded) {
2013-05-20 03:24:36 +04:00
if (substr($padded, -2) === 'xx') {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
$data = substr($padded, 0, -2);
2013-05-20 03:24:36 +04:00
return $data;
2013-05-20 03:24:36 +04:00
} else {
2013-05-20 03:24:36 +04:00
// TODO: log the fact that unpadded data was submitted for removal of padding
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Check if a file's contents contains an IV and is symmetrically encrypted
* @param $content
* @return boolean
* @note see also OCA\Encryption\Util->isEncryptedPath()
*/
2013-05-27 19:26:58 +04:00
public static function isCatfileContent($content) {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if (!$content) {
2013-05-20 03:24:36 +04:00
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
$noPadding = self::removePadding($content);
2013-05-20 03:24:36 +04:00
// Fetch encryption metadata from end of file
2013-05-27 19:26:58 +04:00
$meta = substr($noPadding, -22);
2013-05-20 03:24:36 +04:00
// Fetch IV from end of file
2013-05-27 19:26:58 +04:00
$iv = substr($meta, -16);
2013-05-20 03:24:36 +04:00
// Fetch identifier from start of metadata
2013-05-27 19:26:58 +04:00
$identifier = substr($meta, 0, 6);
2013-05-20 03:24:36 +04:00
if ($identifier === '00iv00') {
2013-05-20 03:24:36 +04:00
return true;
2013-05-20 03:24:36 +04:00
} else {
2013-05-20 03:24:36 +04:00
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
2012-11-22 18:08:19 +04:00
/**
* Check if a file is encrypted according to database file cache
* @param string $path
* @return bool
*/
2013-05-27 19:26:58 +04:00
public static function isEncryptedMeta($path) {
2013-05-20 03:24:36 +04:00
// TODO: Use DI to get \OC\Files\Filesystem out of here
2013-05-20 03:24:36 +04:00
2012-11-22 18:08:19 +04:00
// Fetch all file metadata from DB
2013-05-27 19:26:58 +04:00
$metadata = \OC\Files\Filesystem::getFileInfo($path);
2013-05-20 03:24:36 +04:00
2012-11-22 18:08:19 +04:00
// Return encryption status
return isset($metadata['encrypted']) && ( bool )$metadata['encrypted'];
2013-05-20 03:24:36 +04:00
2012-11-22 18:08:19 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Check if a file is encrypted via legacy system
* @param $data
* @param string $relPath The path of the file, relative to user/data;
* e.g. filename or /Docs/filename, NOT admin/files/filename
* @param boolean $isCatFileContent
2013-05-20 03:24:36 +04:00
* @return boolean
*/
public static function isLegacyEncryptedContent($isCatFileContent, $relPath) {
2013-05-17 19:29:32 +04:00
// Fetch all file metadata from DB
2013-05-27 19:26:58 +04:00
$metadata = \OC\Files\Filesystem::getFileInfo($relPath, '');
2013-05-20 03:24:36 +04:00
// If a file is flagged with encryption in DB, but isn't a
// valid content + IV combination, it's probably using the
// legacy encryption system
if (isset($metadata['encrypted'])
&& $metadata['encrypted'] === true
&& $isCatFileContent === false
) {
2013-05-20 03:24:36 +04:00
return true;
2013-05-20 03:24:36 +04:00
} else {
2013-05-20 03:24:36 +04:00
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Symmetrically encrypt a string
* @param string $plainContent
* @param string $iv
2013-05-24 01:56:31 +04:00
* @param string $passphrase
2013-05-20 03:24:36 +04:00
* @return string encrypted file content
*/
private static function encrypt($plainContent, $iv, $passphrase = '') {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if ($encryptedContent = openssl_encrypt($plainContent, 'AES-128-CFB', $passphrase, false, $iv)) {
return $encryptedContent;
} else {
2013-05-27 22:51:52 +04:00
\OCP\Util::writeLog('Encryption library', 'Encryption (symmetric) of content failed', \OCP\Util::ERROR);
\OCP\Util::writeLog('Encryption library', openssl_error_string(), \OCP\Util::ERROR);
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Symmetrically decrypt a string
* @param string $encryptedContent
* @param string $iv
* @param string $passphrase
2013-05-24 01:56:31 +04:00
* @throws \Exception
2013-05-20 03:24:36 +04:00
* @return string decrypted file content
*/
private static function decrypt($encryptedContent, $iv, $passphrase) {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if ($plainContent = openssl_decrypt($encryptedContent, 'AES-128-CFB', $passphrase, false, $iv)) {
return $plainContent;
2013-05-20 03:24:36 +04:00
} else {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
throw new \Exception('Encryption library: Decryption (symmetric) of content failed');
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Concatenate encrypted data with its IV and padding
* @param string $content content to be concatenated
* @param string $iv IV to be concatenated
* @returns string concatenated content
*/
private static function concatIv($content, $iv) {
2013-05-20 03:24:36 +04:00
$combined = $content . '00iv00' . $iv;
2013-05-20 03:24:36 +04:00
return $combined;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Split concatenated data and IV into respective parts
* @param string $catFile concatenated data to be split
* @returns array keys: encrypted, iv
*/
private static function splitIv($catFile) {
2013-05-20 03:24:36 +04:00
// Fetch encryption metadata from end of file
2013-05-27 19:26:58 +04:00
$meta = substr($catFile, -22);
2013-05-20 03:24:36 +04:00
// Fetch IV from end of file
2013-05-27 19:26:58 +04:00
$iv = substr($meta, -16);
2013-05-20 03:24:36 +04:00
// Remove IV and IV identifier text to expose encrypted content
2013-05-27 19:26:58 +04:00
$encrypted = substr($catFile, 0, -22);
2013-05-20 03:24:36 +04:00
$split = array(
'encrypted' => $encrypted,
2013-05-27 19:26:58 +04:00
'iv' => $iv
);
2013-05-20 03:24:36 +04:00
return $split;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Symmetrically encrypts a string and returns keyfile content
* @param string $plainContent content to be encrypted in keyfile
* @param string $passphrase
* @return false|string encrypted content combined with IV
2013-05-20 03:24:36 +04:00
* @note IV need not be specified, as it will be stored in the returned keyfile
* and remain accessible therein.
*/
2013-05-27 19:26:58 +04:00
public static function symmetricEncryptFileContent($plainContent, $passphrase = '') {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if (!$plainContent) {
\OCP\Util::writeLog('Encryption library', 'symmetrically encryption failed, no content given.', \OCP\Util::ERROR);
return false;
}
2013-05-20 03:24:36 +04:00
$iv = self::generateIv();
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if ($encryptedContent = self::encrypt($plainContent, $iv, $passphrase)) {
2013-05-20 03:24:36 +04:00
// Combine content to encrypt with IV identifier and actual IV
2013-05-27 19:26:58 +04:00
$catfile = self::concatIv($encryptedContent, $iv);
$padded = self::addPadding($catfile);
2013-05-20 03:24:36 +04:00
return $padded;
} else {
2013-05-27 22:51:52 +04:00
\OCP\Util::writeLog('Encryption library', 'Encryption (symmetric) of keyfile content failed', \OCP\Util::ERROR);
return false;
}
2013-05-20 03:24:36 +04:00
}
/**
2013-05-20 03:24:36 +04:00
* @brief Symmetrically decrypts keyfile content
* @param $keyfileContent
* @param string $passphrase
* @throws \Exception
* @return string|false
2013-05-20 03:24:36 +04:00
* @internal param string $source
* @internal param string $target
* @internal param string $key the decryption key
* @returns string decrypted content
*
* This function decrypts a file
*/
2013-05-27 19:26:58 +04:00
public static function symmetricDecryptFileContent($keyfileContent, $passphrase = '') {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if (!$keyfileContent) {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
throw new \Exception('Encryption library: no data provided for decryption');
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
// Remove padding
2013-05-27 19:26:58 +04:00
$noPadding = self::removePadding($keyfileContent);
2013-05-20 03:24:36 +04:00
// Split into enc data and catfile
2013-05-27 19:26:58 +04:00
$catfile = self::splitIv($noPadding);
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if ($plainContent = self::decrypt($catfile['encrypted'], $catfile['iv'], $passphrase)) {
2013-05-20 03:24:36 +04:00
return $plainContent;
2013-05-20 03:24:36 +04:00
2013-05-24 01:56:31 +04:00
} else {
return false;
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
* @brief Decrypt private key and check if the result is a valid keyfile
* @param string $encryptedKey encrypted keyfile
* @param string $passphrase to decrypt keyfile
* @returns encrypted private key or false
*
* This function decrypts a file
*/
public static function decryptPrivateKey($encryptedKey, $passphrase) {
$plainKey = self::symmetricDecryptFileContent($encryptedKey, $passphrase);
// check if this a valid private key
$res = openssl_pkey_get_private($plainKey);
2013-06-03 20:42:13 +04:00
if (is_resource($res)) {
$sslInfo = openssl_pkey_get_details($res);
2013-06-03 20:42:13 +04:00
if (!isset($sslInfo['key'])) {
$plainKey = false;
}
} else {
$plainKey = false;
}
return $plainKey;
}
/**
2013-05-20 03:24:36 +04:00
* @brief Create asymmetrically encrypted keyfile content using a generated key
* @param string $plainContent content to be encrypted
* @param array $publicKeys array keys must be the userId of corresponding user
* @returns array keys: keys (array, key = userId), data
* @note symmetricDecryptFileContent() can decrypt files created using this method
*/
2013-05-27 19:26:58 +04:00
public static function multiKeyEncrypt($plainContent, array $publicKeys) {
2013-05-20 03:24:36 +04:00
// openssl_seal returns false without errors if $plainContent
// is empty, so trigger our own error
2013-05-27 19:26:58 +04:00
if (empty($plainContent)) {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
throw new \Exception('Cannot mutliKeyEncrypt empty plain content');
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
// Set empty vars to be set by openssl by reference
$sealed = '';
$shareKeys = array();
2013-05-24 01:56:31 +04:00
$mappedShareKeys = array();
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if (openssl_seal($plainContent, $sealed, $shareKeys, $publicKeys)) {
2013-05-20 03:24:36 +04:00
$i = 0;
2013-05-20 03:24:36 +04:00
// Ensure each shareKey is labelled with its
// corresponding userId
2013-05-27 19:26:58 +04:00
foreach ($publicKeys as $userId => $publicKey) {
2013-05-20 03:24:36 +04:00
$mappedShareKeys[$userId] = $shareKeys[$i];
$i++;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
return array(
2013-05-24 01:56:31 +04:00
'keys' => $mappedShareKeys,
'data' => $sealed
);
2013-05-20 03:24:36 +04:00
} else {
2013-05-20 03:24:36 +04:00
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
2013-05-20 03:24:36 +04:00
* @brief Asymmetrically encrypt a file using multiple public keys
* @param $encryptedContent
* @param $shareKey
* @param $privateKey
* @return false|string
2013-05-20 03:24:36 +04:00
* @internal param string $plainContent content to be encrypted
* @returns string $plainContent decrypted string
* @note symmetricDecryptFileContent() can be used to decrypt files created using this method
*
* This function decrypts a file
*/
2013-05-27 19:26:58 +04:00
public static function multiKeyDecrypt($encryptedContent, $shareKey, $privateKey) {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if (!$encryptedContent) {
2013-05-20 03:24:36 +04:00
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if (openssl_open($encryptedContent, $plainContent, $shareKey, $privateKey)) {
2013-05-20 03:24:36 +04:00
return $plainContent;
2013-05-20 03:24:36 +04:00
} else {
2013-05-20 03:24:36 +04:00
\OCP\Util::writeLog('Encryption library', 'Decryption (asymmetric) of sealed content with share-key "'.$shareKey.'" failed', \OCP\Util::ERROR);
2013-05-20 03:24:36 +04:00
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
2013-05-18 00:44:45 +04:00
* @brief Generates a pseudo random initialisation vector
* @return String $iv generated IV
*/
private static function generateIv() {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if ($random = openssl_random_pseudo_bytes(12, $strong)) {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if (!$strong) {
2013-05-20 03:24:36 +04:00
// If OpenSSL indicates randomness is insecure, log error
2013-05-27 22:51:52 +04:00
\OCP\Util::writeLog('Encryption library', 'Insecure symmetric key was generated using openssl_random_pseudo_bytes()', \OCP\Util::WARN);
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
// We encode the iv purely for string manipulation
// purposes - it gets decoded before use
2013-05-27 19:26:58 +04:00
$iv = base64_encode($random);
2013-05-20 03:24:36 +04:00
return $iv;
2013-05-20 03:24:36 +04:00
} else {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
throw new \Exception('Generating IV failed');
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
2013-05-18 00:44:45 +04:00
/**
* @brief Generate a pseudo random 2048-bit ASCII key, used as file key
2013-05-18 00:44:45 +04:00
* @returns $key Generated key
*/
2013-05-24 01:56:31 +04:00
public static function generateKey() {
2013-05-20 03:24:36 +04:00
// Generate key
if ($key = base64_encode(openssl_random_pseudo_bytes(256, $strong))) {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if (!$strong) {
2013-05-20 03:24:36 +04:00
// If OpenSSL indicates randomness is insecure, log error
2013-05-27 19:26:58 +04:00
throw new \Exception('Encryption library, Insecure symmetric key was generated using openssl_random_pseudo_bytes()');
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
return $key;
2013-05-20 03:24:36 +04:00
} else {
2013-05-20 03:24:36 +04:00
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
/**
2013-08-08 17:08:58 +04:00
* @brief Get the blowfish encryption handler for a key
* @param $key string (optional)
* @return \Crypt_Blowfish blowfish object
*
2013-08-08 17:08:58 +04:00
* if the key is left out, the default handler will be used
*/
private static function getBlowfish($key = '') {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
if ($key) {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
return new \Crypt_Blowfish($key);
2013-05-20 03:24:36 +04:00
} else {
2013-05-20 03:24:36 +04:00
return false;
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
}
2013-05-20 03:24:36 +04:00
/**
2013-05-20 03:24:36 +04:00
* @brief decrypts content using legacy blowfish system
* @param string $content the cleartext message you want to decrypt
* @param string $passphrase
* @return string cleartext content
*
* This function decrypts an content
*/
public static function legacyDecrypt($content, $passphrase = '') {
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
$bf = self::getBlowfish($passphrase);
2013-05-20 03:24:36 +04:00
2013-05-27 19:26:58 +04:00
$decrypted = $bf->decrypt($content);
2013-05-20 03:24:36 +04:00
return $decrypted;
}
2013-05-17 19:29:32 +04:00
2013-05-20 03:24:36 +04:00
/**
* @param $data
* @param string $key
* @param int $maxLength
* @return string
*/
public static function legacyBlockDecrypt($data, $key = '', $maxLength = 0) {
2013-05-17 19:29:32 +04:00
$result = '';
2013-05-27 19:26:58 +04:00
while (strlen($data)) {
$result .= self::legacyDecrypt(substr($data, 0, 8192), $key);
$data = substr($data, 8192);
2013-05-17 19:29:32 +04:00
}
2013-05-27 19:26:58 +04:00
if ($maxLength > 0) {
return substr($result, 0, $maxLength);
2013-05-17 19:29:32 +04:00
} else {
2013-05-27 19:26:58 +04:00
return rtrim($result, "\0");
2013-05-17 19:29:32 +04:00
}
}
2013-05-20 03:24:36 +04:00
2013-08-08 17:08:58 +04:00
}