fscrypt aosp doc: https://source.android.com/security/encryption/file-based kernel fscrypt doc: https://www.kernel.org/doc/html/v4.18/filesystems/fscrypt.html This commit implements the ability for TWRP to use fscrypt to decrypt files on the fscrypt implementation. It has been implemented mostly in a new successor library to e4crypt called libtwrpfscrypt. Most of the code was ported from AOSP vold. Notable updates include: - updated policy storage by libtar - lookup of fbe policies by libtwrpfscrypt - threaded keystore operations Big thanks to Dees_Troy for the initial trailblazing of encryption in TWRP. Change-Id: I69cd2eba3693a9914e00213d4943229635d0cdae
390 lines
14 KiB
C++
Executable File
390 lines
14 KiB
C++
Executable File
/*
|
|
* Copyright (C) 2015 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#include "fscrypt/fscrypt.h"
|
|
|
|
#include <array>
|
|
|
|
#include <asm/ioctl.h>
|
|
#include <dirent.h>
|
|
#include <errno.h>
|
|
#include <fcntl.h>
|
|
#include <linux/fs.h>
|
|
#include <string.h>
|
|
#include <sys/stat.h>
|
|
#include <sys/syscall.h>
|
|
#include <sys/types.h>
|
|
#include <unistd.h>
|
|
|
|
#include <android-base/file.h>
|
|
#include <android-base/logging.h>
|
|
#include <cutils/properties.h>
|
|
#include <logwrap/logwrap.h>
|
|
#include <utils/misc.h>
|
|
|
|
#include "fscrypt_policy.h"
|
|
|
|
static int encryption_mode = FS_ENCRYPTION_MODE_PRIVATE;
|
|
|
|
bool fscrypt_is_native() {
|
|
char value[PROPERTY_VALUE_MAX];
|
|
property_get("ro.crypto.type", value, "none");
|
|
return !strcmp(value, "file");
|
|
}
|
|
|
|
static void log_ls(const char* dirname) {
|
|
std::array<const char*, 3> argv = {"ls", "-laZ", dirname};
|
|
int status = 0;
|
|
auto res =
|
|
android_fork_execvp(argv.size(), const_cast<char**>(argv.data()), &status, false, true);
|
|
if (res != 0) {
|
|
PLOG(ERROR) << argv[0] << " " << argv[1] << " " << argv[2] << "failed";
|
|
return;
|
|
}
|
|
if (!WIFEXITED(status)) {
|
|
LOG(ERROR) << argv[0] << " " << argv[1] << " " << argv[2]
|
|
<< " did not exit normally, status: " << status;
|
|
return;
|
|
}
|
|
if (WEXITSTATUS(status) != 0) {
|
|
LOG(ERROR) << argv[0] << " " << argv[1] << " " << argv[2]
|
|
<< " returned failure: " << WEXITSTATUS(status);
|
|
return;
|
|
}
|
|
}
|
|
|
|
extern "C" void policy_to_hex(const uint8_t* policy, char* hex) {
|
|
for (size_t i = 0, j = 0; i < FS_KEY_DESCRIPTOR_SIZE; i++) {
|
|
hex[j++] = HEX_LOOKUP[(policy[i] & 0xF0) >> 4];
|
|
hex[j++] = HEX_LOOKUP[policy[i] & 0x0F];
|
|
}
|
|
hex[FS_KEY_DESCRIPTOR_SIZE_HEX - 1] = '\0';
|
|
}
|
|
|
|
static bool is_dir_empty(const char *dirname, bool *is_empty)
|
|
{
|
|
int n = 0;
|
|
auto dirp = std::unique_ptr<DIR, int (*)(DIR*)>(opendir(dirname), closedir);
|
|
if (!dirp) {
|
|
PLOG(ERROR) << "Unable to read directory: " << dirname;
|
|
return false;
|
|
}
|
|
for (;;) {
|
|
errno = 0;
|
|
auto entry = readdir(dirp.get());
|
|
if (!entry) {
|
|
if (errno) {
|
|
PLOG(ERROR) << "Unable to read directory: " << dirname;
|
|
return false;
|
|
}
|
|
break;
|
|
}
|
|
if (strcmp(entry->d_name, "lost+found") != 0) { // Skip lost+found
|
|
++n;
|
|
if (n > 2) {
|
|
*is_empty = false;
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
*is_empty = true;
|
|
return true;
|
|
}
|
|
|
|
static uint8_t fscrypt_get_policy_flags(int filenames_encryption_mode) {
|
|
if (filenames_encryption_mode == FS_ENCRYPTION_MODE_AES_256_CTS) {
|
|
// Use legacy padding with our original filenames encryption mode.
|
|
return FS_POLICY_FLAGS_PAD_4;
|
|
} else if (filenames_encryption_mode == FS_ENCRYPTION_MODE_ADIANTUM) {
|
|
// Use DIRECT_KEY for Adiantum, since it's much more efficient but just
|
|
// as secure since Android doesn't reuse the same master key for
|
|
// multiple encryption modes
|
|
return (FS_POLICY_FLAGS_PAD_16 | FS_POLICY_FLAG_DIRECT_KEY);
|
|
}
|
|
// With a new mode we can use the better padding flag without breaking existing devices: pad
|
|
// filenames with zeroes to the next 16-byte boundary. This is more secure (helps hide the
|
|
// length of filenames) and makes the inputs evenly divisible into blocks which is more
|
|
// efficient for encryption and decryption.
|
|
return FS_POLICY_FLAGS_PAD_16;
|
|
}
|
|
|
|
static bool fscrypt_policy_set(const char *directory, uint8_t *policy,
|
|
size_t policy_length,
|
|
int contents_encryption_mode,
|
|
int filenames_encryption_mode) {
|
|
if (policy_length != FS_KEY_DESCRIPTOR_SIZE) {
|
|
LOG(ERROR) << "Policy wrong length: " << policy_length;
|
|
return false;
|
|
}
|
|
char policy_hex[FS_KEY_DESCRIPTOR_SIZE_HEX];
|
|
policy_to_hex(policy, policy_hex);
|
|
|
|
int fd = open(directory, O_DIRECTORY | O_NOFOLLOW | O_CLOEXEC);
|
|
if (fd == -1) {
|
|
PLOG(ERROR) << "Failed to open directory " << directory;
|
|
return false;
|
|
}
|
|
|
|
fscrypt_policy fp;
|
|
fp.version = 0;
|
|
fp.contents_encryption_mode = contents_encryption_mode;
|
|
fp.filenames_encryption_mode = filenames_encryption_mode;
|
|
fp.flags = fscrypt_get_policy_flags(filenames_encryption_mode);
|
|
memcpy(fp.master_key_descriptor, policy, FS_KEY_DESCRIPTOR_SIZE);
|
|
if (ioctl(fd, FS_IOC_SET_ENCRYPTION_POLICY, &fp)) {
|
|
PLOG(ERROR) << "Failed to set encryption policy for " << directory << " to " << policy_hex
|
|
<< " modes " << contents_encryption_mode << "/" << filenames_encryption_mode;
|
|
close(fd);
|
|
return false;
|
|
}
|
|
close(fd);
|
|
|
|
LOG(INFO) << "Policy for " << directory << " set to " << policy_hex
|
|
<< " modes " << contents_encryption_mode << "/" << filenames_encryption_mode;
|
|
return true;
|
|
}
|
|
|
|
static bool fscrypt_policy_get(const char *directory, uint8_t *policy,
|
|
size_t policy_length,
|
|
int contents_encryption_mode,
|
|
int filenames_encryption_mode) {
|
|
if (policy_length != FS_KEY_DESCRIPTOR_SIZE) {
|
|
LOG(ERROR) << "Policy wrong length: " << policy_length;
|
|
return false;
|
|
}
|
|
|
|
int fd = open(directory, O_DIRECTORY | O_NOFOLLOW | O_CLOEXEC);
|
|
if (fd == -1) {
|
|
PLOG(ERROR) << "Failed to open directory " << directory;
|
|
return false;
|
|
}
|
|
|
|
fscrypt_policy fp;
|
|
memset(&fp, 0, sizeof(fscrypt_policy));
|
|
if (ioctl(fd, FS_IOC_GET_ENCRYPTION_POLICY, &fp) != 0) {
|
|
PLOG(ERROR) << "Failed to get encryption policy for " << directory;
|
|
close(fd);
|
|
log_ls(directory);
|
|
return false;
|
|
}
|
|
close(fd);
|
|
|
|
if ((fp.version != 0)
|
|
|| (fp.contents_encryption_mode != contents_encryption_mode)
|
|
|| (fp.filenames_encryption_mode != filenames_encryption_mode)
|
|
|| (fp.flags !=
|
|
fscrypt_get_policy_flags(filenames_encryption_mode))) {
|
|
LOG(ERROR) << "Failed to find matching encryption policy for " << directory;
|
|
return false;
|
|
}
|
|
memcpy(policy, fp.master_key_descriptor, FS_KEY_DESCRIPTOR_SIZE);
|
|
|
|
return true;
|
|
}
|
|
|
|
static bool fscrypt_policy_check(const char *directory, uint8_t *policy,
|
|
size_t policy_length,
|
|
int contents_encryption_mode,
|
|
int filenames_encryption_mode) {
|
|
if (policy_length != FS_KEY_DESCRIPTOR_SIZE) {
|
|
LOG(ERROR) << "Policy wrong length: " << policy_length;
|
|
return false;
|
|
}
|
|
uint8_t existing_policy[FS_KEY_DESCRIPTOR_SIZE];
|
|
if (!fscrypt_policy_get(directory, existing_policy, FS_KEY_DESCRIPTOR_SIZE,
|
|
contents_encryption_mode,
|
|
filenames_encryption_mode)) return false;
|
|
char existing_policy_hex[FS_KEY_DESCRIPTOR_SIZE_HEX];
|
|
|
|
policy_to_hex(existing_policy, existing_policy_hex);
|
|
|
|
if (memcmp(policy, existing_policy, FS_KEY_DESCRIPTOR_SIZE) != 0) {
|
|
char policy_hex[FS_KEY_DESCRIPTOR_SIZE_HEX];
|
|
policy_to_hex(policy, policy_hex);
|
|
LOG(ERROR) << "Found policy " << existing_policy_hex << " at " << directory
|
|
<< " which doesn't match expected value " << policy_hex;
|
|
log_ls(directory);
|
|
return false;
|
|
}
|
|
LOG(INFO) << "Found policy " << existing_policy_hex << " at " << directory
|
|
<< " which matches expected value";
|
|
return true;
|
|
}
|
|
|
|
int fscrypt_policy_ensure(const char *directory, uint8_t *policy,
|
|
size_t policy_length,
|
|
const char *contents_encryption_mode,
|
|
const char *filenames_encryption_mode) {
|
|
int contents_mode = 0;
|
|
int filenames_mode = 0;
|
|
|
|
if (!strcmp(contents_encryption_mode, "software") ||
|
|
!strcmp(contents_encryption_mode, "aes-256-xts")) {
|
|
contents_mode = FS_ENCRYPTION_MODE_AES_256_XTS;
|
|
} else if (!strcmp(contents_encryption_mode, "adiantum")) {
|
|
contents_mode = FS_ENCRYPTION_MODE_ADIANTUM;
|
|
} else if (!strcmp(contents_encryption_mode, "ice")) {
|
|
contents_mode = FS_ENCRYPTION_MODE_PRIVATE;
|
|
} else {
|
|
LOG(ERROR) << "Invalid file contents encryption mode: "
|
|
<< contents_encryption_mode;
|
|
return -1;
|
|
}
|
|
|
|
if (!strcmp(filenames_encryption_mode, "aes-256-cts")) {
|
|
filenames_mode = FS_ENCRYPTION_MODE_AES_256_CTS;
|
|
} else if (!strcmp(filenames_encryption_mode, "aes-256-heh")) {
|
|
filenames_mode = FS_ENCRYPTION_MODE_AES_256_HEH;
|
|
} else if (!strcmp(filenames_encryption_mode, "adiantum")) {
|
|
filenames_mode = FS_ENCRYPTION_MODE_ADIANTUM;
|
|
} else {
|
|
LOG(ERROR) << "Invalid file names encryption mode: "
|
|
<< filenames_encryption_mode;
|
|
return -1;
|
|
}
|
|
|
|
bool is_empty;
|
|
if (!is_dir_empty(directory, &is_empty)) return -1;
|
|
if (is_empty) {
|
|
if (!fscrypt_policy_set(directory, policy, policy_length,
|
|
contents_mode, filenames_mode)) return -1;
|
|
} else {
|
|
if (!fscrypt_policy_check(directory, policy, policy_length,
|
|
contents_mode, filenames_mode)) return -1;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
extern "C" bool fscrypt_set_mode() {
|
|
const char* mode_file = "/data/unencrypted/mode";
|
|
struct stat st;
|
|
if (stat(mode_file, &st) != 0 || st.st_size <= 0) {
|
|
printf("Invalid encryption mode file %s\n", mode_file);
|
|
return false;
|
|
}
|
|
size_t mode_size = st.st_size;
|
|
char contents_encryption_mode[mode_size + 1];
|
|
memset((void*)contents_encryption_mode, 0, mode_size + 1);
|
|
int fd = open(mode_file, O_RDONLY);
|
|
if (fd < 0) {
|
|
printf("error opening '%s': %s\n", mode_file, strerror(errno));
|
|
return false;
|
|
}
|
|
if (read(fd, contents_encryption_mode, mode_size) != mode_size) {
|
|
printf("read error on '%s': %s\n", mode_file, strerror(errno));
|
|
close(fd);
|
|
return false;
|
|
}
|
|
close(fd);
|
|
|
|
std::string contents_encryption_mode_string = std::string(contents_encryption_mode);
|
|
int pos = contents_encryption_mode_string.find(":");
|
|
PLOG(ERROR) << "contents_encryption_mode_string: " << contents_encryption_mode_string.substr(0, pos);
|
|
|
|
// if (!strcmp(contents_encryption_mode, "software")) {
|
|
if (contents_encryption_mode_string.substr(0, pos) == "software") {
|
|
encryption_mode = FS_ENCRYPTION_MODE_AES_256_XTS;
|
|
// } else if (!strcmp(contents_encryption_mode, "ice")) {
|
|
} else if (contents_encryption_mode_string.substr(0, pos) == "ice") {
|
|
encryption_mode = FS_ENCRYPTION_MODE_PRIVATE;
|
|
} else {
|
|
printf("Invalid encryption mode '%s'\n", contents_encryption_mode);
|
|
return false;
|
|
}
|
|
|
|
printf("set encryption mode to %i\n", encryption_mode);
|
|
return true;
|
|
}
|
|
|
|
extern "C" void fscrypt_policy_fill_default_struct(fscrypt_encryption_policy *fep) {
|
|
fep->version = 0;
|
|
fep->contents_encryption_mode = encryption_mode;
|
|
fep->filenames_encryption_mode = FS_ENCRYPTION_MODE_AES_256_CTS;
|
|
fep->flags = 0;
|
|
memset((void*)&fep->master_key_descriptor[0], 0, FS_KEY_DESCRIPTOR_SIZE);
|
|
}
|
|
|
|
extern "C" bool fscrypt_policy_set_struct(const char *directory, const fscrypt_encryption_policy *fep) {
|
|
int fd = open(directory, O_DIRECTORY | O_NOFOLLOW | O_CLOEXEC);
|
|
if (fd == -1) {
|
|
printf("failed to open %s\n", directory);
|
|
PLOG(ERROR) << "Failed to open directory " << directory;
|
|
return false;
|
|
}
|
|
if (ioctl(fd, FS_IOC_SET_ENCRYPTION_POLICY, fep)) {
|
|
printf("failed to set policy for '%s'\n", directory);
|
|
PLOG(ERROR) << "Failed to set encryption policy for " << directory;
|
|
close(fd);
|
|
return false;
|
|
}
|
|
close(fd);
|
|
return true;
|
|
}
|
|
|
|
extern "C" bool fscrypt_policy_get_struct(const char *directory, fscrypt_encryption_policy *fep) {
|
|
int fd = open(directory, O_DIRECTORY | O_NOFOLLOW | O_CLOEXEC);
|
|
if (fd == -1) {
|
|
printf("Failed to open '%s'\n", directory);
|
|
PLOG(ERROR) << "Failed to open directory " << directory;
|
|
return false;
|
|
}
|
|
memset(fep, 0, sizeof(fscrypt_encryption_policy));
|
|
if (ioctl(fd, FS_IOC_GET_ENCRYPTION_POLICY, fep) != 0) {
|
|
PLOG(ERROR) << "Failed to get encryption policy for " << directory;
|
|
close(fd);
|
|
return false;
|
|
}
|
|
printf("fscrypt_policy_get_struct::fep->version::%d\n", fep->version);
|
|
close(fd);
|
|
return true;
|
|
}
|
|
|
|
extern "C" bool fscrypt_policy_set(const char *directory, uint8_t *policy,
|
|
size_t policy_length, int contents_encryption_mode) {
|
|
if (contents_encryption_mode == 0)
|
|
contents_encryption_mode = encryption_mode;
|
|
if (policy_length != FS_KEY_DESCRIPTOR_SIZE) {
|
|
printf("policy wrong length\n");
|
|
LOG(ERROR) << "Policy wrong length: " << policy_length;
|
|
return false;
|
|
}
|
|
int fd = open(directory, O_DIRECTORY | O_NOFOLLOW | O_CLOEXEC);
|
|
if (fd == -1) {
|
|
printf("failed to open %s\n", directory);
|
|
PLOG(ERROR) << "Failed to open directory " << directory;
|
|
return false;
|
|
}
|
|
|
|
fscrypt_encryption_policy fep;
|
|
fep.version = 0;
|
|
fep.contents_encryption_mode = contents_encryption_mode;
|
|
fep.filenames_encryption_mode = FS_ENCRYPTION_MODE_AES_256_CTS;
|
|
fep.flags = 0;
|
|
memcpy(fep.master_key_descriptor, policy, FS_KEY_DESCRIPTOR_SIZE);
|
|
if (ioctl(fd, FS_IOC_SET_ENCRYPTION_POLICY, &fep)) {
|
|
printf("failed to set policy for '%s' '%s'\n", directory, policy);
|
|
PLOG(ERROR) << "Failed to set encryption policy for " << directory;
|
|
close(fd);
|
|
return false;
|
|
}
|
|
close(fd);
|
|
|
|
char policy_hex[FS_KEY_DESCRIPTOR_SIZE_HEX];
|
|
policy_to_hex(policy, policy_hex);
|
|
LOG(INFO) << "Policy for " << directory << " set to " << policy_hex;
|
|
return true;
|
|
}
|