blob: 457bb66776e2ab389e5615403081132656cffa70 [file] [log] [blame]
Paul Crowley1ef25582016-01-21 20:26:12 +00001/*
2 * Copyright (C) 2016 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#include "KeyStorage.h"
18
Daniel Rosenbergd2906b82019-06-07 14:18:14 -070019#include "Checkpoint.h"
Paul Crowley1ef25582016-01-21 20:26:12 +000020#include "Keymaster.h"
Paul Crowley63c18d32016-02-10 14:02:47 +000021#include "ScryptParameters.h"
Paul Crowley1ef25582016-01-21 20:26:12 +000022#include "Utils.h"
23
Eric Biggersf74373b2020-11-05 19:58:26 -080024#include <algorithm>
Seth Moore5a43d612021-01-19 17:51:51 +000025#include <memory>
26#include <mutex>
Daniel Rosenberga48730a2019-06-06 20:38:38 -070027#include <thread>
Paul Crowley1ef25582016-01-21 20:26:12 +000028#include <vector>
29
30#include <errno.h>
Paul Crowleydff8c722016-05-16 08:14:56 -070031#include <stdio.h>
Paul Crowley1ef25582016-01-21 20:26:12 +000032#include <sys/stat.h>
33#include <sys/types.h>
34#include <sys/wait.h>
35#include <unistd.h>
36
Paul Crowley6ab2cab2017-01-04 22:32:40 -080037#include <openssl/err.h>
38#include <openssl/evp.h>
Paul Crowley1ef25582016-01-21 20:26:12 +000039#include <openssl/sha.h>
40
41#include <android-base/file.h>
42#include <android-base/logging.h>
Daniel Rosenberga48730a2019-06-06 20:38:38 -070043#include <android-base/properties.h>
Daniel Rosenbergd2906b82019-06-07 14:18:14 -070044#include <android-base/unique_fd.h>
Paul Crowley1ef25582016-01-21 20:26:12 +000045
Paul Crowley63c18d32016-02-10 14:02:47 +000046#include <cutils/properties.h>
47
Paul Crowley320e5e12016-03-04 14:07:05 -080048#include <hardware/hw_auth_token.h>
Shawn Willden35f0f222020-01-16 13:21:42 -070049#include <keymasterV4_1/authorization_set.h>
50#include <keymasterV4_1/keymaster_utils.h>
Paul Crowley320e5e12016-03-04 14:07:05 -080051
Paul Crowley63c18d32016-02-10 14:02:47 +000052extern "C" {
53
54#include "crypto_scrypt.h"
Paul Crowley63c18d32016-02-10 14:02:47 +000055}
56
Paul Crowley1ef25582016-01-21 20:26:12 +000057namespace android {
58namespace vold {
59
Paul Crowleydf528a72016-03-09 09:31:37 -080060const KeyAuthentication kEmptyAuthentication{"", ""};
Paul Crowley05720802016-02-08 15:55:41 +000061
Paul Crowley1ef25582016-01-21 20:26:12 +000062static constexpr size_t AES_KEY_BYTES = 32;
63static constexpr size_t GCM_NONCE_BYTES = 12;
64static constexpr size_t GCM_MAC_BYTES = 16;
Paul Crowleydf528a72016-03-09 09:31:37 -080065static constexpr size_t SALT_BYTES = 1 << 4;
66static constexpr size_t SECDISCARDABLE_BYTES = 1 << 14;
67static constexpr size_t STRETCHED_BYTES = 1 << 6;
Paul Crowley1ef25582016-01-21 20:26:12 +000068
Shawn Willden785365b2018-01-20 09:37:36 -070069static constexpr uint32_t AUTH_TIMEOUT = 30; // Seconds
Paul Crowleyb3de3372016-04-27 12:58:41 -070070
Paul Crowley05720802016-02-08 15:55:41 +000071static const char* kCurrentVersion = "1";
Paul Crowley1ef25582016-01-21 20:26:12 +000072static const char* kRmPath = "/system/bin/rm";
73static const char* kSecdiscardPath = "/system/bin/secdiscard";
Paul Crowley63c18d32016-02-10 14:02:47 +000074static const char* kStretch_none = "none";
75static const char* kStretch_nopassword = "nopassword";
76static const std::string kStretchPrefix_scrypt = "scrypt ";
Paul Crowley6ab2cab2017-01-04 22:32:40 -080077static const char* kHashPrefix_secdiscardable = "Android secdiscardable SHA512";
78static const char* kHashPrefix_keygen = "Android key wrapping key generation SHA512";
Paul Crowley1ef25582016-01-21 20:26:12 +000079static const char* kFn_encrypted_key = "encrypted_key";
Paul Crowley05720802016-02-08 15:55:41 +000080static const char* kFn_keymaster_key_blob = "keymaster_key_blob";
Paul Crowleydff8c722016-05-16 08:14:56 -070081static const char* kFn_keymaster_key_blob_upgraded = "keymaster_key_blob_upgraded";
Paul Crowley63c18d32016-02-10 14:02:47 +000082static const char* kFn_salt = "salt";
Paul Crowley1ef25582016-01-21 20:26:12 +000083static const char* kFn_secdiscardable = "secdiscardable";
Paul Crowley05720802016-02-08 15:55:41 +000084static const char* kFn_stretching = "stretching";
85static const char* kFn_version = "version";
Paul Crowley1ef25582016-01-21 20:26:12 +000086
Seth Moore5a43d612021-01-19 17:51:51 +000087namespace {
88
89// Storage binding info for ensuring key encryption keys include a
90// platform-provided seed in their derivation.
91struct StorageBindingInfo {
92 enum class State {
93 UNINITIALIZED,
94 IN_USE, // key storage keys are bound to seed
95 NOT_USED, // key storage keys are NOT bound to seed
96 };
97
98 // Binding seed mixed into all key storage keys.
99 std::vector<uint8_t> seed;
100
101 // State tracker for the key storage key binding.
102 State state = State::UNINITIALIZED;
103
104 std::mutex guard;
105};
106
107// Never freed as the dtor is non-trivial.
108StorageBindingInfo& storage_binding_info = *new StorageBindingInfo;
109
110} // namespace
111
Paul Crowley13ffd8e2016-01-27 14:30:22 +0000112static bool checkSize(const std::string& kind, size_t actual, size_t expected) {
Paul Crowley1ef25582016-01-21 20:26:12 +0000113 if (actual != expected) {
Paul Crowleydf528a72016-03-09 09:31:37 -0800114 LOG(ERROR) << "Wrong number of bytes in " << kind << ", expected " << expected << " got "
115 << actual;
Paul Crowley1ef25582016-01-21 20:26:12 +0000116 return false;
117 }
118 return true;
119}
120
Paul Crowley26a53882017-10-26 11:16:39 -0700121static void hashWithPrefix(char const* prefix, const std::string& tohash, std::string* res) {
Paul Crowley1ef25582016-01-21 20:26:12 +0000122 SHA512_CTX c;
123
124 SHA512_Init(&c);
125 // Personalise the hashing by introducing a fixed prefix.
126 // Hashing applications should use personalization except when there is a
127 // specific reason not to; see section 4.11 of https://www.schneier.com/skein1.3.pdf
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800128 std::string hashingPrefix = prefix;
129 hashingPrefix.resize(SHA512_CBLOCK);
130 SHA512_Update(&c, hashingPrefix.data(), hashingPrefix.size());
131 SHA512_Update(&c, tohash.data(), tohash.size());
Paul Crowley26a53882017-10-26 11:16:39 -0700132 res->assign(SHA512_DIGEST_LENGTH, '\0');
133 SHA512_Final(reinterpret_cast<uint8_t*>(&(*res)[0]), &c);
Paul Crowley1ef25582016-01-21 20:26:12 +0000134}
135
Paul Crowleydf528a72016-03-09 09:31:37 -0800136static bool generateKeymasterKey(Keymaster& keymaster, const KeyAuthentication& auth,
137 const std::string& appId, std::string* key) {
Shawn Willden35351812018-01-22 09:08:32 -0700138 auto paramBuilder = km::AuthorizationSetBuilder()
Paul Crowleydf528a72016-03-09 09:31:37 -0800139 .AesEncryptionKey(AES_KEY_BYTES * 8)
Shawn Willden35351812018-01-22 09:08:32 -0700140 .GcmModeMinMacLen(GCM_MAC_BYTES * 8)
141 .Authorization(km::TAG_APPLICATION_ID, km::support::blob2hidlVec(appId));
Paul Crowley320e5e12016-03-04 14:07:05 -0800142 if (auth.token.empty()) {
143 LOG(DEBUG) << "Creating key that doesn't need auth token";
Shawn Willden35351812018-01-22 09:08:32 -0700144 paramBuilder.Authorization(km::TAG_NO_AUTH_REQUIRED);
Paul Crowley320e5e12016-03-04 14:07:05 -0800145 } else {
146 LOG(DEBUG) << "Auth token required for key";
147 if (auth.token.size() != sizeof(hw_auth_token_t)) {
148 LOG(ERROR) << "Auth token should be " << sizeof(hw_auth_token_t) << " bytes, was "
Paul Crowleydf528a72016-03-09 09:31:37 -0800149 << auth.token.size() << " bytes";
Paul Crowley320e5e12016-03-04 14:07:05 -0800150 return false;
151 }
Paul Crowleydf528a72016-03-09 09:31:37 -0800152 const hw_auth_token_t* at = reinterpret_cast<const hw_auth_token_t*>(auth.token.data());
Paul Crowleyd281de72018-08-30 15:25:19 -0700153 auto user_id = at->user_id; // Make a copy because at->user_id is unaligned.
154 paramBuilder.Authorization(km::TAG_USER_SECURE_ID, user_id);
Shawn Willden35351812018-01-22 09:08:32 -0700155 paramBuilder.Authorization(km::TAG_USER_AUTH_TYPE, km::HardwareAuthenticatorType::PASSWORD);
156 paramBuilder.Authorization(km::TAG_AUTH_TIMEOUT, AUTH_TIMEOUT);
Paul Crowley320e5e12016-03-04 14:07:05 -0800157 }
Shawn Willden8431fe22018-12-06 07:45:02 -0700158
159 auto paramsWithRollback = paramBuilder;
160 paramsWithRollback.Authorization(km::TAG_ROLLBACK_RESISTANCE);
161
162 // Generate rollback-resistant key if possible.
163 return keymaster.generateKey(paramsWithRollback, key) ||
164 keymaster.generateKey(paramBuilder, key);
Paul Crowley320e5e12016-03-04 14:07:05 -0800165}
166
Barani Muthukumaran3dfb0942020-02-03 13:06:45 -0800167bool generateWrappedStorageKey(KeyBuffer* key) {
168 Keymaster keymaster;
169 if (!keymaster) return false;
170 std::string key_temp;
171 auto paramBuilder = km::AuthorizationSetBuilder().AesEncryptionKey(AES_KEY_BYTES * 8);
Barani Muthukumaran3dfb0942020-02-03 13:06:45 -0800172 paramBuilder.Authorization(km::TAG_STORAGE_KEY);
Gaurav Kashyap75736a82020-09-11 15:24:01 -0700173 auto paramsWithRollback = paramBuilder;
174 paramsWithRollback.Authorization(km::TAG_ROLLBACK_RESISTANCE);
175 if (!keymaster.generateKey(paramsWithRollback, &key_temp)) {
176 if (!keymaster.generateKey(paramBuilder, &key_temp)) return false;
177 }
Barani Muthukumaran3dfb0942020-02-03 13:06:45 -0800178 *key = KeyBuffer(key_temp.size());
179 memcpy(reinterpret_cast<void*>(key->data()), key_temp.c_str(), key->size());
180 return true;
181}
182
183bool exportWrappedStorageKey(const KeyBuffer& kmKey, KeyBuffer* key) {
184 Keymaster keymaster;
185 if (!keymaster) return false;
186 std::string key_temp;
187
188 if (!keymaster.exportKey(kmKey, &key_temp)) return false;
189 *key = KeyBuffer(key_temp.size());
190 memcpy(reinterpret_cast<void*>(key->data()), key_temp.c_str(), key->size());
191 return true;
192}
193
Shawn Willden35351812018-01-22 09:08:32 -0700194static std::pair<km::AuthorizationSet, km::HardwareAuthToken> beginParams(
195 const KeyAuthentication& auth, const std::string& appId) {
196 auto paramBuilder = km::AuthorizationSetBuilder()
197 .GcmModeMacLen(GCM_MAC_BYTES * 8)
198 .Authorization(km::TAG_APPLICATION_ID, km::support::blob2hidlVec(appId));
199 km::HardwareAuthToken authToken;
Paul Crowley320e5e12016-03-04 14:07:05 -0800200 if (!auth.token.empty()) {
201 LOG(DEBUG) << "Supplying auth token to Keymaster";
Shawn Willden35351812018-01-22 09:08:32 -0700202 authToken = km::support::hidlVec2AuthToken(km::support::blob2hidlVec(auth.token));
Paul Crowley320e5e12016-03-04 14:07:05 -0800203 }
Shawn Willden35351812018-01-22 09:08:32 -0700204 return {paramBuilder, authToken};
Paul Crowley1ef25582016-01-21 20:26:12 +0000205}
206
Paul Crowleydf528a72016-03-09 09:31:37 -0800207static bool readFileToString(const std::string& filename, std::string* result) {
Paul Crowleya051eb72016-03-08 16:08:32 -0800208 if (!android::base::ReadFileToString(filename, result)) {
Paul Crowleydf528a72016-03-09 09:31:37 -0800209 PLOG(ERROR) << "Failed to read from " << filename;
210 return false;
Paul Crowley13ffd8e2016-01-27 14:30:22 +0000211 }
212 return true;
213}
214
Paul Crowley26a53882017-10-26 11:16:39 -0700215static bool readRandomBytesOrLog(size_t count, std::string* out) {
216 auto status = ReadRandomBytes(count, *out);
217 if (status != OK) {
218 LOG(ERROR) << "Random read failed with status: " << status;
219 return false;
220 }
221 return true;
222}
223
224bool createSecdiscardable(const std::string& filename, std::string* hash) {
225 std::string secdiscardable;
226 if (!readRandomBytesOrLog(SECDISCARDABLE_BYTES, &secdiscardable)) return false;
227 if (!writeStringToFile(secdiscardable, filename)) return false;
228 hashWithPrefix(kHashPrefix_secdiscardable, secdiscardable, hash);
229 return true;
230}
231
232bool readSecdiscardable(const std::string& filename, std::string* hash) {
233 std::string secdiscardable;
234 if (!readFileToString(filename, &secdiscardable)) return false;
235 hashWithPrefix(kHashPrefix_secdiscardable, secdiscardable, hash);
236 return true;
237}
238
Eric Biggersf74373b2020-11-05 19:58:26 -0800239static std::mutex key_upgrade_lock;
240
241// List of key directories that have had their Keymaster key upgraded during
242// this boot and written to "keymaster_key_blob_upgraded", but replacing the old
243// key was delayed due to an active checkpoint. Protected by key_upgrade_lock.
244static std::vector<std::string> key_dirs_to_commit;
245
246// Replaces |dir|/keymaster_key_blob with |dir|/keymaster_key_blob_upgraded and
247// deletes the old key from Keymaster.
248static bool CommitUpgradedKey(Keymaster& keymaster, const std::string& dir) {
249 auto blob_file = dir + "/" + kFn_keymaster_key_blob;
250 auto upgraded_blob_file = dir + "/" + kFn_keymaster_key_blob_upgraded;
251
252 std::string blob;
253 if (!readFileToString(blob_file, &blob)) return false;
254
255 if (rename(upgraded_blob_file.c_str(), blob_file.c_str()) != 0) {
256 PLOG(ERROR) << "Failed to rename " << upgraded_blob_file << " to " << blob_file;
257 return false;
Daniel Rosenberga48730a2019-06-06 20:38:38 -0700258 }
Eric Biggersf74373b2020-11-05 19:58:26 -0800259 // Ensure that the rename is persisted before deleting the Keymaster key.
260 if (!FsyncDirectory(dir)) return false;
261
262 if (!keymaster || !keymaster.deleteKey(blob)) {
263 LOG(WARNING) << "Failed to delete old key " << blob_file
264 << " from Keymaster; continuing anyway";
265 // Continue on, but the space in Keymaster used by the old key won't be freed.
266 }
267 return true;
268}
269
270static void DeferredCommitKeys() {
271 android::base::WaitForProperty("vold.checkpoint_committed", "1");
272 LOG(INFO) << "Committing upgraded keys";
Daniel Rosenberga48730a2019-06-06 20:38:38 -0700273 Keymaster keymaster;
Eric Biggersf74373b2020-11-05 19:58:26 -0800274 if (!keymaster) {
275 LOG(ERROR) << "Failed to open Keymaster; old keys won't be deleted from Keymaster";
276 // Continue on, but the space in Keymaster used by the old keys won't be freed.
277 }
278 std::lock_guard<std::mutex> lock(key_upgrade_lock);
279 for (auto& dir : key_dirs_to_commit) {
280 LOG(INFO) << "Committing upgraded key " << dir;
281 CommitUpgradedKey(keymaster, dir);
282 }
283 key_dirs_to_commit.clear();
284}
285
286// Returns true if the Keymaster key in |dir| has already been upgraded and is
287// pending being committed. Assumes that key_upgrade_lock is held.
288static bool IsKeyCommitPending(const std::string& dir) {
289 for (const auto& dir_to_commit : key_dirs_to_commit) {
290 if (IsSameFile(dir, dir_to_commit)) return true;
291 }
292 return false;
293}
294
295// Schedules the upgraded Keymaster key in |dir| to be committed later.
296// Assumes that key_upgrade_lock is held.
297static void ScheduleKeyCommit(const std::string& dir) {
298 if (key_dirs_to_commit.empty()) std::thread(DeferredCommitKeys).detach();
299 key_dirs_to_commit.push_back(dir);
300}
301
302static void CancelPendingKeyCommit(const std::string& dir) {
303 std::lock_guard<std::mutex> lock(key_upgrade_lock);
304 for (auto it = key_dirs_to_commit.begin(); it != key_dirs_to_commit.end(); it++) {
305 if (IsSameFile(*it, dir)) {
306 LOG(DEBUG) << "Cancelling pending commit of upgraded key " << dir
307 << " because it is being destroyed";
308 key_dirs_to_commit.erase(it);
309 break;
310 }
Daniel Rosenberga48730a2019-06-06 20:38:38 -0700311 }
312}
313
Eric Biggersf74373b2020-11-05 19:58:26 -0800314// Deletes a leftover upgraded key, if present. An upgraded key can be left
315// over if an update failed, or if we rebooted before committing the key in a
316// freak accident. Either way, we can re-upgrade the key if we need to.
317static void DeleteUpgradedKey(Keymaster& keymaster, const std::string& path) {
318 if (pathExists(path)) {
319 LOG(DEBUG) << "Deleting leftover upgraded key " << path;
320 std::string blob;
321 if (!android::base::ReadFileToString(path, &blob)) {
322 LOG(WARNING) << "Failed to read leftover upgraded key " << path
323 << "; continuing anyway";
324 } else if (!keymaster.deleteKey(blob)) {
325 LOG(WARNING) << "Failed to delete leftover upgraded key " << path
326 << " from Keymaster; continuing anyway";
327 }
328 if (unlink(path.c_str()) != 0) {
329 LOG(WARNING) << "Failed to unlink leftover upgraded key " << path
330 << "; continuing anyway";
331 }
Daniel Rosenberga48730a2019-06-06 20:38:38 -0700332 }
333}
334
Eric Biggersf74373b2020-11-05 19:58:26 -0800335// Begins a Keymaster operation using the key stored in |dir|.
336static KeymasterOperation BeginKeymasterOp(Keymaster& keymaster, const std::string& dir,
337 km::KeyPurpose purpose,
338 const km::AuthorizationSet& keyParams,
339 const km::AuthorizationSet& opParams,
340 const km::HardwareAuthToken& authToken,
341 km::AuthorizationSet* outParams) {
Shawn Willden35351812018-01-22 09:08:32 -0700342 km::AuthorizationSet inParams(keyParams);
Janis Danisevskis8e537b82016-10-26 14:27:10 +0100343 inParams.append(opParams.begin(), opParams.end());
Eric Biggersf74373b2020-11-05 19:58:26 -0800344
345 auto blob_file = dir + "/" + kFn_keymaster_key_blob;
346 auto upgraded_blob_file = dir + "/" + kFn_keymaster_key_blob_upgraded;
347
348 std::lock_guard<std::mutex> lock(key_upgrade_lock);
349
350 std::string blob;
351 bool already_upgraded = IsKeyCommitPending(dir);
352 if (already_upgraded) {
353 LOG(DEBUG)
354 << blob_file
355 << " was already upgraded and is waiting to be committed; using the upgraded blob";
356 if (!readFileToString(upgraded_blob_file, &blob)) return KeymasterOperation();
357 } else {
358 DeleteUpgradedKey(keymaster, upgraded_blob_file);
359 if (!readFileToString(blob_file, &blob)) return KeymasterOperation();
Paul Crowleydff8c722016-05-16 08:14:56 -0700360 }
Eric Biggersf74373b2020-11-05 19:58:26 -0800361
362 auto opHandle = keymaster.begin(purpose, blob, inParams, authToken, outParams);
363 if (opHandle) return opHandle;
364 if (opHandle.errorCode() != km::ErrorCode::KEY_REQUIRES_UPGRADE) return opHandle;
365
366 if (already_upgraded) {
367 LOG(ERROR) << "Unexpected case; already-upgraded key " << upgraded_blob_file
368 << " still requires upgrade";
369 return KeymasterOperation();
370 }
371 LOG(INFO) << "Upgrading key: " << blob_file;
372 if (!keymaster.upgradeKey(blob, keyParams, &blob)) return KeymasterOperation();
373 if (!writeStringToFile(blob, upgraded_blob_file)) return KeymasterOperation();
374 if (cp_needsCheckpoint()) {
375 LOG(INFO) << "Wrote upgraded key to " << upgraded_blob_file
376 << "; delaying commit due to checkpoint";
377 ScheduleKeyCommit(dir);
378 } else {
379 if (!CommitUpgradedKey(keymaster, dir)) return KeymasterOperation();
380 LOG(INFO) << "Key upgraded: " << blob_file;
381 }
382
383 return keymaster.begin(purpose, blob, inParams, authToken, outParams);
Paul Crowleydff8c722016-05-16 08:14:56 -0700384}
385
386static bool encryptWithKeymasterKey(Keymaster& keymaster, const std::string& dir,
Shawn Willden35351812018-01-22 09:08:32 -0700387 const km::AuthorizationSet& keyParams,
Eric Biggersf74373b2020-11-05 19:58:26 -0800388 const km::HardwareAuthToken& authToken,
389 const KeyBuffer& message, std::string* ciphertext) {
Shawn Willden35351812018-01-22 09:08:32 -0700390 km::AuthorizationSet opParams;
391 km::AuthorizationSet outParams;
Eric Biggersf74373b2020-11-05 19:58:26 -0800392 auto opHandle = BeginKeymasterOp(keymaster, dir, km::KeyPurpose::ENCRYPT, keyParams, opParams,
393 authToken, &outParams);
Paul Crowleydff8c722016-05-16 08:14:56 -0700394 if (!opHandle) return false;
Shawn Willden35351812018-01-22 09:08:32 -0700395 auto nonceBlob = outParams.GetTagValue(km::TAG_NONCE);
Janis Danisevskis8e537b82016-10-26 14:27:10 +0100396 if (!nonceBlob.isOk()) {
Paul Crowleydff8c722016-05-16 08:14:56 -0700397 LOG(ERROR) << "GCM encryption but no nonce generated";
398 return false;
399 }
400 // nonceBlob here is just a pointer into existing data, must not be freed
Shawn Willden785365b2018-01-20 09:37:36 -0700401 std::string nonce(reinterpret_cast<const char*>(&nonceBlob.value()[0]),
402 nonceBlob.value().size());
Paul Crowleydff8c722016-05-16 08:14:56 -0700403 if (!checkSize("nonce", nonce.size(), GCM_NONCE_BYTES)) return false;
404 std::string body;
405 if (!opHandle.updateCompletely(message, &body)) return false;
406
407 std::string mac;
408 if (!opHandle.finish(&mac)) return false;
409 if (!checkSize("mac", mac.size(), GCM_MAC_BYTES)) return false;
410 *ciphertext = nonce + body + mac;
411 return true;
412}
413
414static bool decryptWithKeymasterKey(Keymaster& keymaster, const std::string& dir,
Shawn Willden35351812018-01-22 09:08:32 -0700415 const km::AuthorizationSet& keyParams,
416 const km::HardwareAuthToken& authToken,
Eric Biggersf74373b2020-11-05 19:58:26 -0800417 const std::string& ciphertext, KeyBuffer* message) {
Paul Crowleydff8c722016-05-16 08:14:56 -0700418 auto nonce = ciphertext.substr(0, GCM_NONCE_BYTES);
419 auto bodyAndMac = ciphertext.substr(GCM_NONCE_BYTES);
Shawn Willden35351812018-01-22 09:08:32 -0700420 auto opParams = km::AuthorizationSetBuilder().Authorization(km::TAG_NONCE,
421 km::support::blob2hidlVec(nonce));
Eric Biggersf74373b2020-11-05 19:58:26 -0800422 auto opHandle = BeginKeymasterOp(keymaster, dir, km::KeyPurpose::DECRYPT, keyParams, opParams,
423 authToken, nullptr);
Paul Crowleydff8c722016-05-16 08:14:56 -0700424 if (!opHandle) return false;
425 if (!opHandle.updateCompletely(bodyAndMac, message)) return false;
426 if (!opHandle.finish(nullptr)) return false;
427 return true;
428}
429
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800430static std::string getStretching(const KeyAuthentication& auth) {
431 if (!auth.usesKeymaster()) {
432 return kStretch_none;
433 } else if (auth.secret.empty()) {
434 return kStretch_nopassword;
435 } else {
436 char paramstr[PROPERTY_VALUE_MAX];
Paul Crowley63c18d32016-02-10 14:02:47 +0000437
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800438 property_get(SCRYPT_PROP, paramstr, SCRYPT_DEFAULTS);
439 return std::string() + kStretchPrefix_scrypt + paramstr;
440 }
Paul Crowley63c18d32016-02-10 14:02:47 +0000441}
442
Paul Crowleydf528a72016-03-09 09:31:37 -0800443static bool stretchingNeedsSalt(const std::string& stretching) {
Paul Crowley63c18d32016-02-10 14:02:47 +0000444 return stretching != kStretch_nopassword && stretching != kStretch_none;
445}
446
Paul Crowleydf528a72016-03-09 09:31:37 -0800447static bool stretchSecret(const std::string& stretching, const std::string& secret,
448 const std::string& salt, std::string* stretched) {
Paul Crowley63c18d32016-02-10 14:02:47 +0000449 if (stretching == kStretch_nopassword) {
450 if (!secret.empty()) {
Paul Crowleyd9b92952016-03-04 13:45:00 -0800451 LOG(WARNING) << "Password present but stretching is nopassword";
Paul Crowley63c18d32016-02-10 14:02:47 +0000452 // Continue anyway
453 }
Paul Crowleya051eb72016-03-08 16:08:32 -0800454 stretched->clear();
Paul Crowley63c18d32016-02-10 14:02:47 +0000455 } else if (stretching == kStretch_none) {
Paul Crowleya051eb72016-03-08 16:08:32 -0800456 *stretched = secret;
Paul Crowleydf528a72016-03-09 09:31:37 -0800457 } else if (std::equal(kStretchPrefix_scrypt.begin(), kStretchPrefix_scrypt.end(),
458 stretching.begin())) {
Paul Crowley63c18d32016-02-10 14:02:47 +0000459 int Nf, rf, pf;
Paul Crowleydf528a72016-03-09 09:31:37 -0800460 if (!parse_scrypt_parameters(stretching.substr(kStretchPrefix_scrypt.size()).c_str(), &Nf,
461 &rf, &pf)) {
Paul Crowley63c18d32016-02-10 14:02:47 +0000462 LOG(ERROR) << "Unable to parse scrypt params in stretching: " << stretching;
463 return false;
464 }
Paul Crowleya051eb72016-03-08 16:08:32 -0800465 stretched->assign(STRETCHED_BYTES, '\0');
Paul Crowleydf528a72016-03-09 09:31:37 -0800466 if (crypto_scrypt(reinterpret_cast<const uint8_t*>(secret.data()), secret.size(),
Shawn Willden785365b2018-01-20 09:37:36 -0700467 reinterpret_cast<const uint8_t*>(salt.data()), salt.size(), 1 << Nf,
468 1 << rf, 1 << pf, reinterpret_cast<uint8_t*>(&(*stretched)[0]),
469 stretched->size()) != 0) {
Paul Crowley63c18d32016-02-10 14:02:47 +0000470 LOG(ERROR) << "scrypt failed with params: " << stretching;
471 return false;
472 }
473 } else {
474 LOG(ERROR) << "Unknown stretching type: " << stretching;
475 return false;
476 }
477 return true;
478}
479
Paul Crowleydf528a72016-03-09 09:31:37 -0800480static bool generateAppId(const KeyAuthentication& auth, const std::string& stretching,
Paul Crowley26a53882017-10-26 11:16:39 -0700481 const std::string& salt, const std::string& secdiscardable_hash,
Paul Crowleydf528a72016-03-09 09:31:37 -0800482 std::string* appId) {
Paul Crowley63c18d32016-02-10 14:02:47 +0000483 std::string stretched;
Paul Crowleya051eb72016-03-08 16:08:32 -0800484 if (!stretchSecret(stretching, auth.secret, salt, &stretched)) return false;
Paul Crowley26a53882017-10-26 11:16:39 -0700485 *appId = secdiscardable_hash + stretched;
Seth Moore5a43d612021-01-19 17:51:51 +0000486
487 const std::lock_guard<std::mutex> scope_lock(storage_binding_info.guard);
488 switch (storage_binding_info.state) {
489 case StorageBindingInfo::State::UNINITIALIZED:
490 storage_binding_info.state = StorageBindingInfo::State::NOT_USED;
491 break;
492 case StorageBindingInfo::State::IN_USE:
493 appId->append(storage_binding_info.seed.begin(), storage_binding_info.seed.end());
494 break;
495 case StorageBindingInfo::State::NOT_USED:
496 // noop
497 break;
498 }
499
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800500 return true;
501}
502
503static void logOpensslError() {
504 LOG(ERROR) << "Openssl error: " << ERR_get_error();
505}
506
Shawn Willden785365b2018-01-20 09:37:36 -0700507static bool encryptWithoutKeymaster(const std::string& preKey, const KeyBuffer& plaintext,
508 std::string* ciphertext) {
Paul Crowley26a53882017-10-26 11:16:39 -0700509 std::string key;
510 hashWithPrefix(kHashPrefix_keygen, preKey, &key);
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800511 key.resize(AES_KEY_BYTES);
512 if (!readRandomBytesOrLog(GCM_NONCE_BYTES, ciphertext)) return false;
513 auto ctx = std::unique_ptr<EVP_CIPHER_CTX, decltype(&::EVP_CIPHER_CTX_free)>(
514 EVP_CIPHER_CTX_new(), EVP_CIPHER_CTX_free);
515 if (!ctx) {
516 logOpensslError();
517 return false;
518 }
519 if (1 != EVP_EncryptInit_ex(ctx.get(), EVP_aes_256_gcm(), NULL,
Shawn Willden785365b2018-01-20 09:37:36 -0700520 reinterpret_cast<const uint8_t*>(key.data()),
521 reinterpret_cast<const uint8_t*>(ciphertext->data()))) {
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800522 logOpensslError();
523 return false;
524 }
525 ciphertext->resize(GCM_NONCE_BYTES + plaintext.size() + GCM_MAC_BYTES);
526 int outlen;
Shawn Willden785365b2018-01-20 09:37:36 -0700527 if (1 != EVP_EncryptUpdate(
528 ctx.get(), reinterpret_cast<uint8_t*>(&(*ciphertext)[0] + GCM_NONCE_BYTES),
529 &outlen, reinterpret_cast<const uint8_t*>(plaintext.data()), plaintext.size())) {
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800530 logOpensslError();
531 return false;
532 }
533 if (outlen != static_cast<int>(plaintext.size())) {
534 LOG(ERROR) << "GCM ciphertext length should be " << plaintext.size() << " was " << outlen;
535 return false;
536 }
Shawn Willden785365b2018-01-20 09:37:36 -0700537 if (1 != EVP_EncryptFinal_ex(
538 ctx.get(),
539 reinterpret_cast<uint8_t*>(&(*ciphertext)[0] + GCM_NONCE_BYTES + plaintext.size()),
540 &outlen)) {
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800541 logOpensslError();
542 return false;
543 }
544 if (outlen != 0) {
545 LOG(ERROR) << "GCM EncryptFinal should be 0, was " << outlen;
546 return false;
547 }
548 if (1 != EVP_CIPHER_CTX_ctrl(ctx.get(), EVP_CTRL_GCM_GET_TAG, GCM_MAC_BYTES,
Shawn Willden785365b2018-01-20 09:37:36 -0700549 reinterpret_cast<uint8_t*>(&(*ciphertext)[0] + GCM_NONCE_BYTES +
550 plaintext.size()))) {
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800551 logOpensslError();
552 return false;
553 }
554 return true;
555}
556
Shawn Willden785365b2018-01-20 09:37:36 -0700557static bool decryptWithoutKeymaster(const std::string& preKey, const std::string& ciphertext,
558 KeyBuffer* plaintext) {
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800559 if (ciphertext.size() < GCM_NONCE_BYTES + GCM_MAC_BYTES) {
560 LOG(ERROR) << "GCM ciphertext too small: " << ciphertext.size();
561 return false;
562 }
Paul Crowley26a53882017-10-26 11:16:39 -0700563 std::string key;
564 hashWithPrefix(kHashPrefix_keygen, preKey, &key);
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800565 key.resize(AES_KEY_BYTES);
566 auto ctx = std::unique_ptr<EVP_CIPHER_CTX, decltype(&::EVP_CIPHER_CTX_free)>(
567 EVP_CIPHER_CTX_new(), EVP_CIPHER_CTX_free);
568 if (!ctx) {
569 logOpensslError();
570 return false;
571 }
572 if (1 != EVP_DecryptInit_ex(ctx.get(), EVP_aes_256_gcm(), NULL,
Shawn Willden785365b2018-01-20 09:37:36 -0700573 reinterpret_cast<const uint8_t*>(key.data()),
574 reinterpret_cast<const uint8_t*>(ciphertext.data()))) {
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800575 logOpensslError();
576 return false;
577 }
Pavel Grafove2e2d302017-08-01 17:15:53 +0100578 *plaintext = KeyBuffer(ciphertext.size() - GCM_NONCE_BYTES - GCM_MAC_BYTES);
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800579 int outlen;
Shawn Willden785365b2018-01-20 09:37:36 -0700580 if (1 != EVP_DecryptUpdate(ctx.get(), reinterpret_cast<uint8_t*>(&(*plaintext)[0]), &outlen,
581 reinterpret_cast<const uint8_t*>(ciphertext.data() + GCM_NONCE_BYTES),
582 plaintext->size())) {
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800583 logOpensslError();
584 return false;
585 }
586 if (outlen != static_cast<int>(plaintext->size())) {
587 LOG(ERROR) << "GCM plaintext length should be " << plaintext->size() << " was " << outlen;
588 return false;
589 }
590 if (1 != EVP_CIPHER_CTX_ctrl(ctx.get(), EVP_CTRL_GCM_SET_TAG, GCM_MAC_BYTES,
Shawn Willden785365b2018-01-20 09:37:36 -0700591 const_cast<void*>(reinterpret_cast<const void*>(
592 ciphertext.data() + GCM_NONCE_BYTES + plaintext->size())))) {
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800593 logOpensslError();
594 return false;
595 }
596 if (1 != EVP_DecryptFinal_ex(ctx.get(),
Shawn Willden785365b2018-01-20 09:37:36 -0700597 reinterpret_cast<uint8_t*>(&(*plaintext)[0] + plaintext->size()),
598 &outlen)) {
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800599 logOpensslError();
600 return false;
601 }
602 if (outlen != 0) {
603 LOG(ERROR) << "GCM EncryptFinal should be 0, was " << outlen;
604 return false;
605 }
Paul Crowley63c18d32016-02-10 14:02:47 +0000606 return true;
Paul Crowley05720802016-02-08 15:55:41 +0000607}
608
Pavel Grafove2e2d302017-08-01 17:15:53 +0100609bool storeKey(const std::string& dir, const KeyAuthentication& auth, const KeyBuffer& key) {
Paul Crowley1ef25582016-01-21 20:26:12 +0000610 if (TEMP_FAILURE_RETRY(mkdir(dir.c_str(), 0700)) == -1) {
611 PLOG(ERROR) << "key mkdir " << dir;
612 return false;
613 }
Paul Crowleydf528a72016-03-09 09:31:37 -0800614 if (!writeStringToFile(kCurrentVersion, dir + "/" + kFn_version)) return false;
Paul Crowley26a53882017-10-26 11:16:39 -0700615 std::string secdiscardable_hash;
616 if (!createSecdiscardable(dir + "/" + kFn_secdiscardable, &secdiscardable_hash)) return false;
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800617 std::string stretching = getStretching(auth);
Paul Crowleydf528a72016-03-09 09:31:37 -0800618 if (!writeStringToFile(stretching, dir + "/" + kFn_stretching)) return false;
Paul Crowley63c18d32016-02-10 14:02:47 +0000619 std::string salt;
620 if (stretchingNeedsSalt(stretching)) {
621 if (ReadRandomBytes(SALT_BYTES, salt) != OK) {
622 LOG(ERROR) << "Random read failed";
623 return false;
624 }
Paul Crowleydf528a72016-03-09 09:31:37 -0800625 if (!writeStringToFile(salt, dir + "/" + kFn_salt)) return false;
Paul Crowley63c18d32016-02-10 14:02:47 +0000626 }
Paul Crowley320e5e12016-03-04 14:07:05 -0800627 std::string appId;
Paul Crowley26a53882017-10-26 11:16:39 -0700628 if (!generateAppId(auth, stretching, salt, secdiscardable_hash, &appId)) return false;
Paul Crowley320e5e12016-03-04 14:07:05 -0800629 std::string encryptedKey;
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800630 if (auth.usesKeymaster()) {
631 Keymaster keymaster;
632 if (!keymaster) return false;
633 std::string kmKey;
634 if (!generateKeymasterKey(keymaster, auth, appId, &kmKey)) return false;
635 if (!writeStringToFile(kmKey, dir + "/" + kFn_keymaster_key_blob)) return false;
Shawn Willden35351812018-01-22 09:08:32 -0700636 km::AuthorizationSet keyParams;
637 km::HardwareAuthToken authToken;
638 std::tie(keyParams, authToken) = beginParams(auth, appId);
Eric Biggersf74373b2020-11-05 19:58:26 -0800639 if (!encryptWithKeymasterKey(keymaster, dir, keyParams, authToken, key, &encryptedKey))
Shawn Willden35351812018-01-22 09:08:32 -0700640 return false;
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800641 } else {
642 if (!encryptWithoutKeymaster(appId, key, &encryptedKey)) return false;
643 }
Paul Crowley13ffd8e2016-01-27 14:30:22 +0000644 if (!writeStringToFile(encryptedKey, dir + "/" + kFn_encrypted_key)) return false;
Paul Crowley621d9b92018-12-07 15:36:09 -0800645 if (!FsyncDirectory(dir)) return false;
Paul Crowley1ef25582016-01-21 20:26:12 +0000646 return true;
647}
648
Paul Crowleyf71ace32016-06-02 11:01:19 -0700649bool storeKeyAtomically(const std::string& key_path, const std::string& tmp_path,
Pavel Grafove2e2d302017-08-01 17:15:53 +0100650 const KeyAuthentication& auth, const KeyBuffer& key) {
Paul Crowleyf71ace32016-06-02 11:01:19 -0700651 if (pathExists(key_path)) {
652 LOG(ERROR) << "Already exists, cannot create key at: " << key_path;
653 return false;
654 }
655 if (pathExists(tmp_path)) {
656 LOG(DEBUG) << "Already exists, destroying: " << tmp_path;
657 destroyKey(tmp_path); // May be partially created so ignore errors
658 }
659 if (!storeKey(tmp_path, auth, key)) return false;
660 if (rename(tmp_path.c_str(), key_path.c_str()) != 0) {
661 PLOG(ERROR) << "Unable to move new key to location: " << key_path;
662 return false;
663 }
Eric Biggers3345a2a2021-02-16 15:59:17 -0800664 if (!FsyncParentDirectory(key_path)) return false;
Paul Crowleyf71ace32016-06-02 11:01:19 -0700665 LOG(DEBUG) << "Created key: " << key_path;
666 return true;
667}
668
Eric Biggersf74373b2020-11-05 19:58:26 -0800669bool retrieveKey(const std::string& dir, const KeyAuthentication& auth, KeyBuffer* key) {
Paul Crowley05720802016-02-08 15:55:41 +0000670 std::string version;
Paul Crowleya051eb72016-03-08 16:08:32 -0800671 if (!readFileToString(dir + "/" + kFn_version, &version)) return false;
Paul Crowley05720802016-02-08 15:55:41 +0000672 if (version != kCurrentVersion) {
673 LOG(ERROR) << "Version mismatch, expected " << kCurrentVersion << " got " << version;
674 return false;
675 }
Paul Crowley26a53882017-10-26 11:16:39 -0700676 std::string secdiscardable_hash;
677 if (!readSecdiscardable(dir + "/" + kFn_secdiscardable, &secdiscardable_hash)) return false;
Paul Crowley63c18d32016-02-10 14:02:47 +0000678 std::string stretching;
Paul Crowleya051eb72016-03-08 16:08:32 -0800679 if (!readFileToString(dir + "/" + kFn_stretching, &stretching)) return false;
Paul Crowley63c18d32016-02-10 14:02:47 +0000680 std::string salt;
681 if (stretchingNeedsSalt(stretching)) {
Paul Crowleydf528a72016-03-09 09:31:37 -0800682 if (!readFileToString(dir + "/" + kFn_salt, &salt)) return false;
Paul Crowley63c18d32016-02-10 14:02:47 +0000683 }
Paul Crowley320e5e12016-03-04 14:07:05 -0800684 std::string appId;
Paul Crowley26a53882017-10-26 11:16:39 -0700685 if (!generateAppId(auth, stretching, salt, secdiscardable_hash, &appId)) return false;
Paul Crowley13ffd8e2016-01-27 14:30:22 +0000686 std::string encryptedMessage;
Paul Crowleya051eb72016-03-08 16:08:32 -0800687 if (!readFileToString(dir + "/" + kFn_encrypted_key, &encryptedMessage)) return false;
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800688 if (auth.usesKeymaster()) {
689 Keymaster keymaster;
690 if (!keymaster) return false;
Shawn Willden35351812018-01-22 09:08:32 -0700691 km::AuthorizationSet keyParams;
692 km::HardwareAuthToken authToken;
693 std::tie(keyParams, authToken) = beginParams(auth, appId);
Eric Biggersf74373b2020-11-05 19:58:26 -0800694 if (!decryptWithKeymasterKey(keymaster, dir, keyParams, authToken, encryptedMessage, key))
Shawn Willden785365b2018-01-20 09:37:36 -0700695 return false;
Paul Crowley6ab2cab2017-01-04 22:32:40 -0800696 } else {
697 if (!decryptWithoutKeymaster(appId, encryptedMessage, key)) return false;
698 }
699 return true;
Paul Crowley1ef25582016-01-21 20:26:12 +0000700}
701
Eric Biggersf74373b2020-11-05 19:58:26 -0800702static bool DeleteKeymasterKey(const std::string& blob_file) {
703 std::string blob;
704 if (!readFileToString(blob_file, &blob)) return false;
Paul Crowley1ef25582016-01-21 20:26:12 +0000705 Keymaster keymaster;
706 if (!keymaster) return false;
Eric Biggersf74373b2020-11-05 19:58:26 -0800707 LOG(DEBUG) << "Deleting key " << blob_file << " from Keymaster";
708 if (!keymaster.deleteKey(blob)) return false;
Paul Crowley1ef25582016-01-21 20:26:12 +0000709 return true;
710}
711
Rubin Xu2436e272017-04-27 20:43:10 +0100712bool runSecdiscardSingle(const std::string& file) {
Shawn Willden785365b2018-01-20 09:37:36 -0700713 if (ForkExecvp(std::vector<std::string>{kSecdiscardPath, "--", file}) != 0) {
Rubin Xu2436e272017-04-27 20:43:10 +0100714 LOG(ERROR) << "secdiscard failed";
715 return false;
716 }
717 return true;
718}
719
Paul Crowleydf528a72016-03-09 09:31:37 -0800720static bool recursiveDeleteKey(const std::string& dir) {
721 if (ForkExecvp(std::vector<std::string>{kRmPath, "-rf", dir}) != 0) {
Paul Crowley1ef25582016-01-21 20:26:12 +0000722 LOG(ERROR) << "recursive delete failed";
723 return false;
724 }
725 return true;
726}
727
Paul Crowleydf528a72016-03-09 09:31:37 -0800728bool destroyKey(const std::string& dir) {
Paul Crowley1ef25582016-01-21 20:26:12 +0000729 bool success = true;
Eric Biggersf74373b2020-11-05 19:58:26 -0800730
731 CancelPendingKeyCommit(dir);
732
Paul Crowleyff19b052017-10-26 11:28:55 -0700733 auto secdiscard_cmd = std::vector<std::string>{
Paul Crowley14c8c072018-09-18 13:30:21 -0700734 kSecdiscardPath,
735 "--",
736 dir + "/" + kFn_encrypted_key,
737 dir + "/" + kFn_secdiscardable,
Paul Crowleyff19b052017-10-26 11:28:55 -0700738 };
Eric Biggersf74373b2020-11-05 19:58:26 -0800739 // Try each thing, even if previous things failed.
740
741 for (auto& fn : {kFn_keymaster_key_blob, kFn_keymaster_key_blob_upgraded}) {
742 auto blob_file = dir + "/" + fn;
743 if (pathExists(blob_file)) {
744 success &= DeleteKeymasterKey(blob_file);
745 secdiscard_cmd.push_back(blob_file);
746 }
Paul Crowleyff19b052017-10-26 11:28:55 -0700747 }
748 if (ForkExecvp(secdiscard_cmd) != 0) {
749 LOG(ERROR) << "secdiscard failed";
750 success = false;
751 }
Paul Crowley13ffd8e2016-01-27 14:30:22 +0000752 success &= recursiveDeleteKey(dir);
Paul Crowley1ef25582016-01-21 20:26:12 +0000753 return success;
754}
755
Seth Moore5a43d612021-01-19 17:51:51 +0000756bool setKeyStorageBindingSeed(const std::vector<uint8_t>& seed) {
757 const std::lock_guard<std::mutex> scope_lock(storage_binding_info.guard);
758 switch (storage_binding_info.state) {
759 case StorageBindingInfo::State::UNINITIALIZED:
760 storage_binding_info.state = StorageBindingInfo::State::IN_USE;
761 storage_binding_info.seed = seed;
762 return true;
763 case StorageBindingInfo::State::IN_USE:
764 LOG(ERROR) << "key storage binding seed already set";
765 return false;
766 case StorageBindingInfo::State::NOT_USED:
767 LOG(ERROR) << "key storage already in use without binding";
768 return false;
769 }
770 return false;
771}
772
Paul Crowley1ef25582016-01-21 20:26:12 +0000773} // namespace vold
774} // namespace android