blob: 33dc26fe7312895c98df234ec8a75eed1ecc2fba [file] [log] [blame]
Andrey Pronin9b10e512021-04-13 11:18:53 -07001/* Copyright 2018 The Chromium OS Authors. All rights reserved.
2 * Use of this source code is governed by a BSD-style license that can be
3 * found in the LICENSE file.
4 */
5
Andrey Pronincd7bcce2021-04-14 00:54:12 -07006#include <string.h>
7
Andrey Pronin04db55a2021-04-26 22:09:34 -07008#include "pinweaver.h"
9#include "pinweaver_eal.h"
10
Andrey Pronincd7bcce2021-04-14 00:54:12 -070011/* TODO(apronin): get rid of temporary #defines */
12
13#ifndef SHA256_DIGEST_SIZE
14#define SHA256_DIGEST_SIZE (256/8)
15#endif
16
17#ifndef AES256_BLOCK_CIPHER_KEY_SIZE
18#define AES256_BLOCK_CIPHER_KEY_SIZE (256/8)
19#endif
20
21#ifndef EC_SUCCESS
22#define EC_SUCCESS 0
23#endif
24
25#ifndef MIN
26#define MIN(a,b) ((a) < (b) ? (a) : (b))
27#endif
Andrey Pronin9b10e512021-04-13 11:18:53 -070028
29/* Compile time sanity checks. */
30/* Make sure the hash size is consistent with dcrypto. */
31BUILD_ASSERT(PW_HASH_SIZE >= SHA256_DIGEST_SIZE);
32
33/* sizeof(struct leaf_data_t) % 16 should be zero */
34BUILD_ASSERT(sizeof(struct leaf_sensitive_data_t) % PW_WRAP_BLOCK_SIZE == 0);
35
36BUILD_ASSERT(sizeof(((struct merkle_tree_t *)0)->wrap_key) ==
37 AES256_BLOCK_CIPHER_KEY_SIZE);
38
39/* Verify that the nvmem_vars log entries have the correct sizes. */
40BUILD_ASSERT(sizeof(struct pw_long_term_storage_t) +
41 sizeof(struct pw_log_storage_t) <= PW_MAX_VAR_USAGE);
42
43/* Verify that the request structs will fit into the message. */
44BUILD_ASSERT(PW_MAX_MESSAGE_SIZE >=
45 sizeof(struct pw_request_header_t) +
Howard Yangd4d2e7a2022-08-02 17:57:53 +080046 sizeof(union {pw_request_insert_leaf_t insert_leaf;
47 pw_request_remove_leaf_t remove_leaf;
48 pw_request_try_auth_t try_auth;
49 pw_request_reset_auth_t reset_auth;
50 pw_request_get_log_t get_log;
51 pw_request_log_replay_t log_replay; }) +
Andrey Pronin9b10e512021-04-13 11:18:53 -070052 sizeof(struct leaf_public_data_t) +
53 sizeof(struct leaf_sensitive_data_t) +
54 PW_MAX_PATH_SIZE);
55
56#define PW_MAX_RESPONSE_SIZE (sizeof(struct pw_response_header_t) + \
Howard Yangd4d2e7a2022-08-02 17:57:53 +080057 sizeof(union {pw_response_insert_leaf_t insert_leaf; \
58 pw_response_try_auth_t try_auth; \
59 pw_response_reset_auth_t reset_auth; \
60 pw_response_log_replay_t log_replay; }) + \
Andrey Pronin9b10e512021-04-13 11:18:53 -070061 PW_LEAF_PAYLOAD_SIZE)
62#define PW_VALID_PCR_CRITERIA_SIZE \
63 (sizeof(struct valid_pcr_value_t) * PW_MAX_PCR_CRITERIA_COUNT)
Howard Yangaa7a8972022-07-26 16:39:36 +080064#define PW_EXPIRATION_DATA_SIZE (sizeof(struct pw_timestamp_t) + 4)
Andrey Pronin9b10e512021-04-13 11:18:53 -070065/* Verify that the request structs will fit into the message. */
66BUILD_ASSERT(PW_MAX_MESSAGE_SIZE >= PW_MAX_RESPONSE_SIZE);
Andrey Pronin9b10e512021-04-13 11:18:53 -070067
68/* PW_MAX_PATH_SIZE should not change unless PW_LEAF_MAJOR_VERSION changes too.
69 * Update these statements whenever these constants are changed to remind future
70 * maintainers about this requirement.
71 *
72 * This requirement helps guarantee that forward compatibility across the same
73 * PW_LEAF_MAJOR_VERSION doesn't break because of a path length becoming too
74 * long after new fields are added to struct wrapped_leaf_data_t or its sub
75 * fields.
76 */
77BUILD_ASSERT(PW_LEAF_MAJOR_VERSION == 0);
78BUILD_ASSERT(PW_MAX_PATH_SIZE == 1024);
79
80/* If fields are appended to struct leaf_sensitive_data_t, an encryption
81 * operation should be performed on them reusing the same IV since the prefix
82 * won't change.
83 *
84 * If any data in the original struct leaf_sensitive_data_t changes, a new IV
85 * should be generated and stored as part of the log for a replay to be
86 * possible.
87 */
88BUILD_ASSERT(sizeof(struct leaf_sensitive_data_t) == 3 * PW_SECRET_SIZE);
89
Andrey Pronincd7bcce2021-04-14 00:54:12 -070090#define RESTART_TIMER_THRESHOLD (10 /* seconds */)
Andrey Pronin9b10e512021-04-13 11:18:53 -070091
92/* This var caches the restart count so the nvram log structure doesn't need to
93 * be walked every time try_auth request is made.
94 */
95uint32_t pw_restart_count;
96
97/******************************************************************************/
98/* Struct helper functions.
99 */
100
101void import_leaf(const struct unimported_leaf_data_t *unimported,
102 struct imported_leaf_data_t *imported)
103{
104 imported->head = &unimported->head;
105 imported->hmac = unimported->hmac;
106 imported->iv = unimported->iv;
107 imported->pub = (const struct leaf_public_data_t *)unimported->payload;
108 imported->cipher_text = unimported->payload + unimported->head.pub_len;
109 imported->hashes = (const uint8_t (*)[PW_HASH_SIZE])(
110 imported->cipher_text + unimported->head.sec_len);
111}
112
113/******************************************************************************/
114/* Basic operations required by the Merkle tree.
115 */
116
Andrey Pronin9b10e512021-04-13 11:18:53 -0700117/* Creates an empty merkle_tree with the given parameters. */
118static int create_merkle_tree(struct bits_per_level_t bits_per_level,
119 struct height_t height,
120 struct merkle_tree_t *merkle_tree)
121{
122 uint16_t fan_out = 1 << bits_per_level.v;
123 uint8_t temp_hash[PW_HASH_SIZE] = {};
124 uint8_t hx;
125 uint16_t kx;
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700126 pinweaver_eal_sha256_ctx_t ctx;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700127
128 merkle_tree->bits_per_level = bits_per_level;
129 merkle_tree->height = height;
130
Leo Lai788f41e2021-08-11 00:36:24 +0800131 int ret;
132
Andrey Pronin9b10e512021-04-13 11:18:53 -0700133 /* Initialize the root hash. */
134 for (hx = 0; hx < height.v; ++hx) {
Leo Lai788f41e2021-08-11 00:36:24 +0800135 ret = pinweaver_eal_sha256_init(&ctx);
136 if (ret)
137 return ret;
138 for (kx = 0; kx < fan_out; ++kx) {
139 ret = pinweaver_eal_sha256_update(&ctx, temp_hash,
140 PW_HASH_SIZE);
141 if (ret) {
142 pinweaver_eal_sha256_final(&ctx, temp_hash);
143 return ret;
144 }
145 }
146 ret = pinweaver_eal_sha256_final(&ctx, temp_hash);
147 if (ret)
148 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700149 }
Leo Laidb207912021-08-11 16:41:18 +0800150 ret = pinweaver_eal_memcpy_s(merkle_tree->root,
151 sizeof(merkle_tree->root), temp_hash,
152 PW_HASH_SIZE);
153 if (ret != EC_SUCCESS)
154 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700155
Leo Lai788f41e2021-08-11 00:36:24 +0800156 ret = pinweaver_eal_rand_bytes(
157 merkle_tree->key_derivation_nonce,
158 sizeof(merkle_tree->key_derivation_nonce));
159 if (ret)
160 return ret;
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700161 return pinweaver_eal_derive_keys(merkle_tree);
Andrey Pronin9b10e512021-04-13 11:18:53 -0700162}
163
164/* Computes the HMAC for an encrypted leaf using the key in the merkle_tree. */
Leo Lai788f41e2021-08-11 00:36:24 +0800165static int compute_hmac(const struct merkle_tree_t *merkle_tree,
166 const struct imported_leaf_data_t *imported_leaf_data,
167 uint8_t result[PW_HASH_SIZE])
Andrey Pronin9b10e512021-04-13 11:18:53 -0700168{
Leo Lai788f41e2021-08-11 00:36:24 +0800169 int ret;
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700170 pinweaver_eal_hmac_sha256_ctx_t hmac;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700171
Leo Lai788f41e2021-08-11 00:36:24 +0800172 ret = pinweaver_eal_hmac_sha256_init(&hmac, merkle_tree->hmac_key,
173 sizeof(merkle_tree->hmac_key));
174 if (ret)
175 return ret;
176 ret = pinweaver_eal_hmac_sha256_update(
177 &hmac, imported_leaf_data->head,
178 sizeof(*imported_leaf_data->head));
179 if (ret) {
180 pinweaver_eal_hmac_sha256_final(&hmac, result);
181 return ret;
182 }
183 ret = pinweaver_eal_hmac_sha256_update(&hmac, imported_leaf_data->iv,
184 sizeof(PW_WRAP_BLOCK_SIZE));
185 if (ret) {
186 pinweaver_eal_hmac_sha256_final(&hmac, result);
187 return ret;
188 }
189 ret = pinweaver_eal_hmac_sha256_update(
190 &hmac, imported_leaf_data->pub,
191 imported_leaf_data->head->pub_len);
192 if (ret) {
193 pinweaver_eal_hmac_sha256_final(&hmac, result);
194 return ret;
195 }
196 ret = pinweaver_eal_hmac_sha256_update(
197 &hmac, imported_leaf_data->cipher_text,
198 imported_leaf_data->head->sec_len);
199 if (ret) {
200 pinweaver_eal_hmac_sha256_final(&hmac, result);
201 return ret;
202 }
203 return pinweaver_eal_hmac_sha256_final(&hmac, result);
Andrey Pronin9b10e512021-04-13 11:18:53 -0700204}
205
206/* Computes the root hash for the specified path and child hash. */
Leo Lai788f41e2021-08-11 00:36:24 +0800207static int compute_root_hash(const struct merkle_tree_t *merkle_tree,
208 struct label_t path,
209 const uint8_t hashes[][PW_HASH_SIZE],
210 const uint8_t child_hash[PW_HASH_SIZE],
211 uint8_t new_root[PW_HASH_SIZE])
Andrey Pronin9b10e512021-04-13 11:18:53 -0700212{
213 /* This is one less than the fan out, the number of sibling hashes. */
214 const uint16_t num_aux = (1 << merkle_tree->bits_per_level.v) - 1;
215 const uint16_t path_suffix_mask = num_aux;
216 uint8_t temp_hash[PW_HASH_SIZE];
217 uint8_t hx = 0;
218 uint64_t index = path.v;
Leo Laidb207912021-08-11 16:41:18 +0800219 int ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700220
Leo Lai788f41e2021-08-11 00:36:24 +0800221 if (compute_hash(hashes, num_aux,
222 (struct index_t){ index & path_suffix_mask },
223 child_hash, temp_hash)) {
224 return PW_ERR_CRYPTO_FAILURE;
225 }
Andrey Pronin9b10e512021-04-13 11:18:53 -0700226 for (hx = 1; hx < merkle_tree->height.v; ++hx) {
227 hashes += num_aux;
228 index = index >> merkle_tree->bits_per_level.v;
Leo Lai788f41e2021-08-11 00:36:24 +0800229 if (compute_hash(hashes, num_aux,
230 (struct index_t){ index & path_suffix_mask },
231 temp_hash, temp_hash)) {
232 return PW_ERR_CRYPTO_FAILURE;
233 }
Andrey Pronin9b10e512021-04-13 11:18:53 -0700234 }
Leo Laidb207912021-08-11 16:41:18 +0800235 ret = pinweaver_eal_memcpy_s(new_root, PW_HASH_SIZE, temp_hash,
236 sizeof(temp_hash));
237 if (ret != EC_SUCCESS)
238 return PW_ERR_INTERNAL_FAILURE;
Leo Lai788f41e2021-08-11 00:36:24 +0800239 return EC_SUCCESS;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700240}
241
242/* Checks to see the specified path is valid. The length of the path should be
243 * validated prior to calling this function.
244 *
245 * Returns 0 on success or an error code otherwise.
246 */
247static int authenticate_path(const struct merkle_tree_t *merkle_tree,
248 struct label_t path,
249 const uint8_t hashes[][PW_HASH_SIZE],
250 const uint8_t child_hash[PW_HASH_SIZE])
251{
252 uint8_t parent[PW_HASH_SIZE];
253
Leo Lai788f41e2021-08-11 00:36:24 +0800254 if (compute_root_hash(merkle_tree, path, hashes, child_hash, parent) !=
255 0)
256 return PW_ERR_CRYPTO_FAILURE;
Yi Chouddf3b452021-08-11 13:40:11 +0800257 if (pinweaver_eal_safe_memcmp(parent, merkle_tree->root,
258 sizeof(parent)) != 0)
Andrey Pronin9b10e512021-04-13 11:18:53 -0700259 return PW_ERR_PATH_AUTH_FAILED;
260 return EC_SUCCESS;
261}
262
263static void init_wrapped_leaf_data(
264 struct wrapped_leaf_data_t *wrapped_leaf_data)
265{
266 wrapped_leaf_data->head.leaf_version.major = PW_LEAF_MAJOR_VERSION;
267 wrapped_leaf_data->head.leaf_version.minor = PW_LEAF_MINOR_VERSION;
268 wrapped_leaf_data->head.pub_len = sizeof(wrapped_leaf_data->pub);
269 wrapped_leaf_data->head.sec_len =
270 sizeof(wrapped_leaf_data->cipher_text);
271}
272
273/* Encrypts the leaf meta data. */
274static int encrypt_leaf_data(const struct merkle_tree_t *merkle_tree,
275 const struct leaf_data_t *leaf_data,
276 struct wrapped_leaf_data_t *wrapped_leaf_data)
277{
Leo Laidb207912021-08-11 16:41:18 +0800278 int ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700279 /* Generate a random IV.
280 *
281 * If fields are appended to struct leaf_sensitive_data_t, an encryption
282 * operation should be performed on them reusing the same IV since the
283 * prefix won't change.
284 *
285 * If any data of in the original struct leaf_sensitive_data_t changes,
286 * a new IV should be generated and stored as part of the log for a
287 * replay to be possible.
288 */
Leo Lai788f41e2021-08-11 00:36:24 +0800289 if (pinweaver_eal_rand_bytes(wrapped_leaf_data->iv,
290 sizeof(wrapped_leaf_data->iv))) {
291 return PW_ERR_CRYPTO_FAILURE;
292 }
Leo Laidb207912021-08-11 16:41:18 +0800293 ret = pinweaver_eal_memcpy_s(&wrapped_leaf_data->pub,
294 sizeof(wrapped_leaf_data->pub),
295 &leaf_data->pub, sizeof(leaf_data->pub));
296 if (ret != EC_SUCCESS)
297 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin1197a0d2021-05-14 20:18:05 -0700298 if (pinweaver_eal_aes256_ctr(merkle_tree->wrap_key,
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700299 sizeof(merkle_tree->wrap_key),
300 wrapped_leaf_data->iv,
301 &leaf_data->sec,
302 sizeof(leaf_data->sec),
303 wrapped_leaf_data->cipher_text)) {
Andrey Pronin9b10e512021-04-13 11:18:53 -0700304 return PW_ERR_CRYPTO_FAILURE;
305 }
306 return EC_SUCCESS;
307}
308
309/* Decrypts the leaf meta data. */
310static int decrypt_leaf_data(
311 const struct merkle_tree_t *merkle_tree,
312 const struct imported_leaf_data_t *imported_leaf_data,
313 struct leaf_data_t *leaf_data)
314{
Leo Laidb207912021-08-11 16:41:18 +0800315 int ret;
316 ret = pinweaver_eal_memcpy_s(&leaf_data->pub, sizeof(leaf_data->pub),
317 imported_leaf_data->pub,
318 MIN(imported_leaf_data->head->pub_len,
319 sizeof(struct leaf_public_data_t)));
320 if (ret != EC_SUCCESS)
321 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin1197a0d2021-05-14 20:18:05 -0700322 if (pinweaver_eal_aes256_ctr(merkle_tree->wrap_key,
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700323 sizeof(merkle_tree->wrap_key),
324 imported_leaf_data->iv,
325 imported_leaf_data->cipher_text,
326 sizeof(leaf_data->sec),
327 &leaf_data->sec)) {
Andrey Pronin9b10e512021-04-13 11:18:53 -0700328 return PW_ERR_CRYPTO_FAILURE;
329 }
330 return EC_SUCCESS;
331}
332
333static int handle_leaf_update(
334 const struct merkle_tree_t *merkle_tree,
335 const struct leaf_data_t *leaf_data,
336 const uint8_t hashes[][PW_HASH_SIZE],
337 struct wrapped_leaf_data_t *wrapped_leaf_data,
338 uint8_t new_root[PW_HASH_SIZE],
339 const struct imported_leaf_data_t *optional_old_wrapped_data)
340{
341 int ret;
342 struct imported_leaf_data_t ptrs;
343
344 init_wrapped_leaf_data(wrapped_leaf_data);
345 if (optional_old_wrapped_data == NULL) {
346 ret = encrypt_leaf_data(merkle_tree, leaf_data,
347 wrapped_leaf_data);
348 if (ret != EC_SUCCESS)
349 return ret;
350 } else {
Leo Laidb207912021-08-11 16:41:18 +0800351 ret = pinweaver_eal_memcpy_s(wrapped_leaf_data->iv,
352 sizeof(wrapped_leaf_data->iv),
353 optional_old_wrapped_data->iv,
354 sizeof(wrapped_leaf_data->iv));
355 if (ret != EC_SUCCESS)
356 return PW_ERR_INTERNAL_FAILURE;
357 ret = pinweaver_eal_memcpy_s(&wrapped_leaf_data->pub,
358 sizeof(wrapped_leaf_data->pub),
359 &leaf_data->pub,
360 sizeof(leaf_data->pub));
361 if (ret != EC_SUCCESS)
362 return PW_ERR_INTERNAL_FAILURE;
363 ret = pinweaver_eal_memcpy_s(
364 wrapped_leaf_data->cipher_text,
365 sizeof(wrapped_leaf_data->cipher_text),
366 optional_old_wrapped_data->cipher_text,
367 sizeof(wrapped_leaf_data->cipher_text));
368 if (ret != EC_SUCCESS)
369 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700370 }
371
372 import_leaf((const struct unimported_leaf_data_t *)wrapped_leaf_data,
373 &ptrs);
Leo Lai788f41e2021-08-11 00:36:24 +0800374 ret = compute_hmac(merkle_tree, &ptrs, wrapped_leaf_data->hmac);
375 if (ret)
376 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700377
Leo Lai788f41e2021-08-11 00:36:24 +0800378 ret = compute_root_hash(merkle_tree, leaf_data->pub.label, hashes,
379 wrapped_leaf_data->hmac, new_root);
380 if (ret)
381 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700382
383 return EC_SUCCESS;
384}
385
386/******************************************************************************/
387/* Parameter and state validation functions.
388 */
389
390static int validate_tree_parameters(struct bits_per_level_t bits_per_level,
391 struct height_t height)
392{
393 uint8_t fan_out = 1 << bits_per_level.v;
394
395 if (bits_per_level.v < BITS_PER_LEVEL_MIN ||
396 bits_per_level.v > BITS_PER_LEVEL_MAX)
397 return PW_ERR_BITS_PER_LEVEL_INVALID;
398
399 if (height.v < HEIGHT_MIN ||
400 height.v > HEIGHT_MAX(bits_per_level.v) ||
401 ((fan_out - 1) * height.v) * PW_HASH_SIZE > PW_MAX_PATH_SIZE)
402 return PW_ERR_HEIGHT_INVALID;
403
404 return EC_SUCCESS;
405}
406
407/* Verifies that merkle_tree has been initialized. */
408static int validate_tree(const struct merkle_tree_t *merkle_tree)
409{
410 if (validate_tree_parameters(merkle_tree->bits_per_level,
411 merkle_tree->height) != EC_SUCCESS)
412 return PW_ERR_TREE_INVALID;
413 return EC_SUCCESS;
414}
415
416/* Checks the following conditions:
417 * Extra index fields should be all zero.
418 */
419static int validate_label(const struct merkle_tree_t *merkle_tree,
420 struct label_t path)
421{
422 uint8_t shift_by = merkle_tree->bits_per_level.v *
423 merkle_tree->height.v;
424
425 if ((path.v >> shift_by) == 0)
426 return EC_SUCCESS;
427 return PW_ERR_LABEL_INVALID;
428}
429
430/* Checks the following conditions:
431 * Columns should be strictly increasing.
432 * Zeroes for filler at the end of the delay_schedule are permitted.
433 */
434static int validate_delay_schedule(const struct delay_schedule_entry_t
435 delay_schedule[PW_SCHED_COUNT])
436{
437 size_t x;
438
439 /* The first entry should not be useless. */
Yi Choueed2b652021-08-11 13:47:15 +0800440 if (delay_schedule[0].attempt_count.v == 0 ||
441 delay_schedule[0].time_diff.v == 0)
Andrey Pronin9b10e512021-04-13 11:18:53 -0700442 return PW_ERR_DELAY_SCHEDULE_INVALID;
443
444 for (x = PW_SCHED_COUNT - 1; x > 0; --x) {
445 if (delay_schedule[x].attempt_count.v == 0) {
446 if (delay_schedule[x].time_diff.v != 0)
447 return PW_ERR_DELAY_SCHEDULE_INVALID;
448 } else if (delay_schedule[x].attempt_count.v <=
449 delay_schedule[x - 1].attempt_count.v ||
450 delay_schedule[x].time_diff.v <=
451 delay_schedule[x - 1].time_diff.v) {
452 return PW_ERR_DELAY_SCHEDULE_INVALID;
453 }
454 }
455 return EC_SUCCESS;
456}
457
458static int validate_pcr_value(const struct valid_pcr_value_t
459 valid_pcr_criteria[PW_MAX_PCR_CRITERIA_COUNT])
460{
461 size_t index;
462 uint8_t sha256_of_selected_pcr[SHA256_DIGEST_SIZE];
463
464 for (index = 0; index < PW_MAX_PCR_CRITERIA_COUNT; ++index) {
465 /* The criteria with bitmask[0] = bitmask[1] = 0 is considered
466 * the end of list criteria. If it happens that the first
467 * bitmask is zero, we consider that no criteria has to be
468 * satisfied and return success in that case.
469 */
470 if (valid_pcr_criteria[index].bitmask[0] == 0 &&
471 valid_pcr_criteria[index].bitmask[1] == 0) {
472 if (index == 0)
473 return EC_SUCCESS;
474
475 return PW_ERR_PCR_NOT_MATCH;
476 }
477
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700478 if (pinweaver_eal_get_current_pcr_digest(
479 valid_pcr_criteria[index].bitmask,
480 sha256_of_selected_pcr)) {
481 PINWEAVER_EAL_INFO(
Andrey Pronin9b10e512021-04-13 11:18:53 -0700482 "PinWeaver: Read PCR error, bitmask: %d, %d",
483 valid_pcr_criteria[index].bitmask[0],
484 valid_pcr_criteria[index].bitmask[1]);
485 return PW_ERR_PCR_NOT_MATCH;
486 }
487
488 /* Check if the curent PCR digest is the same as expected by
489 * criteria.
490 */
Yi Chouddf3b452021-08-11 13:40:11 +0800491 if (pinweaver_eal_safe_memcmp(sha256_of_selected_pcr,
492 valid_pcr_criteria[index].digest,
493 SHA256_DIGEST_SIZE) == 0) {
Andrey Pronin9b10e512021-04-13 11:18:53 -0700494 return EC_SUCCESS;
495 }
496 }
497
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700498 PINWEAVER_EAL_INFO("PinWeaver: No criteria matches PCR values");
Andrey Pronin9b10e512021-04-13 11:18:53 -0700499 return PW_ERR_PCR_NOT_MATCH;
500}
501
Leo Lai8c9892c2021-06-22 21:32:02 +0800502static uint32_t expected_payload_len(int minor_version)
Andrey Pronin9b10e512021-04-13 11:18:53 -0700503{
504 switch (minor_version) {
505 case 0:
Howard Yangaa7a8972022-07-26 16:39:36 +0800506#if !BIOMETRICS_DEV
Andrey Pronin9b10e512021-04-13 11:18:53 -0700507 return PW_LEAF_PAYLOAD_SIZE - PW_VALID_PCR_CRITERIA_SIZE;
Howard Yangaa7a8972022-07-26 16:39:36 +0800508#else
509 return PW_LEAF_PAYLOAD_SIZE - PW_VALID_PCR_CRITERIA_SIZE
510 - PW_EXPIRATION_DATA_SIZE - sizeof(struct pw_leaf_type_t);
511 case 1:
512 return PW_LEAF_PAYLOAD_SIZE - PW_EXPIRATION_DATA_SIZE
513 - sizeof(struct pw_leaf_type_t);
514#endif
Andrey Pronin9b10e512021-04-13 11:18:53 -0700515 case PW_LEAF_MINOR_VERSION:
516 return PW_LEAF_PAYLOAD_SIZE;
517 default:
518 return 0;
519 }
520}
521
522static int validate_leaf_header(const struct leaf_header_t *head,
523 uint16_t payload_len, uint16_t aux_hash_len)
524{
525 uint32_t leaf_payload_len = head->pub_len + head->sec_len;
526
527 if (head->leaf_version.major != PW_LEAF_MAJOR_VERSION)
528 return PW_ERR_LEAF_VERSION_MISMATCH;
529
530 if (head->leaf_version.minor <= PW_LEAF_MINOR_VERSION &&
531 leaf_payload_len !=
532 expected_payload_len(head->leaf_version.minor)) {
533 return PW_ERR_LENGTH_INVALID;
534 }
535
536 if (payload_len != leaf_payload_len + aux_hash_len * PW_HASH_SIZE)
537 return PW_ERR_LENGTH_INVALID;
538
Yi Choue416ce32021-08-11 19:57:24 +0800539 if (head->sec_len < sizeof(struct leaf_sensitive_data_t))
540 return PW_ERR_LENGTH_INVALID;
541
Andrey Pronin9b10e512021-04-13 11:18:53 -0700542 return EC_SUCCESS;
543}
544
545/* Common validation for requests that include a path to authenticate. */
546static int validate_request_with_path(const struct merkle_tree_t *merkle_tree,
547 struct label_t path,
548 const uint8_t hashes[][PW_HASH_SIZE],
549 const uint8_t hmac[PW_HASH_SIZE])
550{
551 int ret;
552
553 ret = validate_tree(merkle_tree);
554 if (ret != EC_SUCCESS)
555 return ret;
556
557 ret = validate_label(merkle_tree, path);
558 if (ret != EC_SUCCESS)
559 return ret;
560
561 return authenticate_path(merkle_tree, path, hashes, hmac);
562}
563
564/* Common validation for requests that import a leaf. */
565static int validate_request_with_wrapped_leaf(
566 const struct merkle_tree_t *merkle_tree,
567 uint16_t payload_len,
568 const struct unimported_leaf_data_t *unimported_leaf_data,
569 struct imported_leaf_data_t *imported_leaf_data,
570 struct leaf_data_t *leaf_data)
571{
572 int ret;
573 uint8_t hmac[PW_HASH_SIZE];
574
575 ret = validate_leaf_header(&unimported_leaf_data->head, payload_len,
576 get_path_auxiliary_hash_count(merkle_tree));
577 if (ret != EC_SUCCESS)
578 return ret;
579
580 import_leaf(unimported_leaf_data, imported_leaf_data);
581 ret = validate_request_with_path(merkle_tree,
582 imported_leaf_data->pub->label,
583 imported_leaf_data->hashes,
584 imported_leaf_data->hmac);
585 if (ret != EC_SUCCESS)
586 return ret;
587
Leo Lai788f41e2021-08-11 00:36:24 +0800588 ret = compute_hmac(merkle_tree, imported_leaf_data, hmac);
589 if (ret != EC_SUCCESS)
590 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700591 /* Safe memcmp is used here to prevent an attacker from being able to
592 * brute force a valid HMAC for a crafted wrapped_leaf_data.
593 * memcmp provides an attacker a timing side-channel they can use to
594 * determine how much of a prefix is correct.
595 */
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700596 if (pinweaver_eal_safe_memcmp(hmac, unimported_leaf_data->hmac,
597 sizeof(hmac)))
Andrey Pronin9b10e512021-04-13 11:18:53 -0700598 return PW_ERR_HMAC_AUTH_FAILED;
599
600 ret = decrypt_leaf_data(merkle_tree, imported_leaf_data, leaf_data);
601 if (ret != EC_SUCCESS)
602 return ret;
603
604 /* The code below handles version upgrades. */
605 if (unimported_leaf_data->head.leaf_version.minor == 0 &&
606 unimported_leaf_data->head.leaf_version.major == 0) {
607 /* Populate the leaf_data with default pcr value */
608 memset(&leaf_data->pub.valid_pcr_criteria, 0,
609 PW_VALID_PCR_CRITERIA_SIZE);
610 }
611
Howard Yangaa7a8972022-07-26 16:39:36 +0800612#if BIOMETRICS_DEV
613 if (unimported_leaf_data->head.leaf_version.major == 0 &&
614 unimported_leaf_data->head.leaf_version.minor <= 1) {
615 /* Populate the leaf_data with default expiration timestamp value,
616 * expiration_delay_s will be set to 0 too, meaning the leaf won't
617 * expire.
618 */
619 memset(&leaf_data->pub.expiration_ts, 0, PW_EXPIRATION_DATA_SIZE);
620 /* Populate the leaf_data with default leaf type. */
621 leaf_data->pub.leaf_type.v = PW_LEAF_TYPE_NORMAL;
622 }
623#endif
624
Andrey Pronin9b10e512021-04-13 11:18:53 -0700625 return EC_SUCCESS;
626}
627
628/* Sets the value of ts to the current notion of time. */
629static void update_timestamp(struct pw_timestamp_t *ts)
630{
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700631 ts->timer_value = pinweaver_eal_seconds_since_boot();
Andrey Pronin9b10e512021-04-13 11:18:53 -0700632 ts->boot_count = pw_restart_count;
633}
634
635/* Checks if an auth attempt can be made or not based on the delay schedule.
636 * EC_SUCCESS is returned when a new attempt can be made otherwise
637 * seconds_to_wait will be updated with the remaining wait time required.
638 */
639static int test_rate_limit(struct leaf_data_t *leaf_data,
640 struct time_diff_t *seconds_to_wait)
641{
642 uint64_t ready_time;
643 uint8_t x;
644 struct pw_timestamp_t current_time;
645 struct time_diff_t delay = {0};
646
Howard Yangaa7a8972022-07-26 16:39:36 +0800647 /* TODO: Check expiration_ts here, before attempt counters */
648
Andrey Pronin9b10e512021-04-13 11:18:53 -0700649 /* This loop ends when x is one greater than the index that applies. */
650 for (x = 0; x < ARRAY_SIZE(leaf_data->pub.delay_schedule); ++x) {
651 /* Stop if a null entry is reached. The first part of the delay
652 * schedule has a list of increasing (attempt_count, time_diff)
653 * pairs with any unused entries zeroed out at the end.
654 */
655 if (leaf_data->pub.delay_schedule[x].attempt_count.v == 0)
656 break;
657
658 /* Stop once a delay schedule entry is reached whose
659 * threshold is greater than the current number of
660 * attempts.
661 */
662 if (leaf_data->pub.attempt_count.v <
663 leaf_data->pub.delay_schedule[x].attempt_count.v)
664 break;
665 }
666
667 /* If the first threshold was greater than the current number of
668 * attempts, there is no delay. Otherwise, grab the delay from the
669 * entry prior to the one that was too big.
670 */
671 if (x > 0)
672 delay = leaf_data->pub.delay_schedule[x - 1].time_diff;
673
674 if (delay.v == 0)
675 return EC_SUCCESS;
676
677 if (delay.v == PW_BLOCK_ATTEMPTS) {
678 seconds_to_wait->v = PW_BLOCK_ATTEMPTS;
679 return PW_ERR_RATE_LIMIT_REACHED;
680 }
681
682 update_timestamp(&current_time);
683
Howard Yang2b189b22022-07-29 11:11:34 +0800684 if (leaf_data->pub.last_access_ts.boot_count == current_time.boot_count)
685 ready_time = delay.v + leaf_data->pub.last_access_ts.timer_value;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700686 else
687 ready_time = delay.v;
688
689 if (current_time.timer_value >= ready_time)
690 return EC_SUCCESS;
691
692 seconds_to_wait->v = ready_time - current_time.timer_value;
693 return PW_ERR_RATE_LIMIT_REACHED;
694}
695
696/******************************************************************************/
697/* Logging implementation.
698 */
699
700/* Once the storage version is incremented, the update code needs to be written
701 * to handle differences in the structs.
702 *
703 * See the two comments "Add storage format updates here." below.
704 */
705BUILD_ASSERT(PW_STORAGE_VERSION == 0);
706
707void force_restart_count(uint32_t mock_value)
708{
709 pw_restart_count = mock_value;
710}
711
712/* Returns EC_SUCCESS if the root hash was found. Sets *index to the first index
713 * of the log entry with a matching root hash, or the index of the last valid
714 * entry.
715 */
716static int find_relevant_entry(const struct pw_log_storage_t *log,
717 const uint8_t root[PW_HASH_SIZE], int *index)
718{
719 /* Find the relevant log entry. */
720 for (*index = 0; *index < PW_LOG_ENTRY_COUNT; ++*index) {
Howard Yangc2f080c2022-07-29 11:28:13 +0800721 if (log->entries[*index].type.v == LOG_PW_MT_INVALID)
Andrey Pronin9b10e512021-04-13 11:18:53 -0700722 break;
Yi Chouddf3b452021-08-11 13:40:11 +0800723 if (pinweaver_eal_safe_memcmp(root, log->entries[*index].root,
724 PW_HASH_SIZE) == 0)
Andrey Pronin9b10e512021-04-13 11:18:53 -0700725 return EC_SUCCESS;
726 }
727 --*index;
728 return PW_ERR_ROOT_NOT_FOUND;
729}
730
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700731/* TODO(apronin): get rid of temporary redirect methods */
732
Andrey Pronin9b10e512021-04-13 11:18:53 -0700733static int load_log_data(struct pw_log_storage_t *log)
734{
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700735 return pinweaver_eal_storage_get_log(log);
Andrey Pronin9b10e512021-04-13 11:18:53 -0700736}
737
738int store_log_data(const struct pw_log_storage_t *log)
739{
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700740 return pinweaver_eal_storage_set_log(log);
Andrey Pronin9b10e512021-04-13 11:18:53 -0700741}
742
743static int load_merkle_tree(struct merkle_tree_t *merkle_tree)
744{
745 int ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700746
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700747 PINWEAVER_EAL_INFO("PinWeaver: Loading Tree!");
Andrey Pronin9b10e512021-04-13 11:18:53 -0700748
749 /* Handle the immutable data. */
750 {
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700751 struct pw_long_term_storage_t tree;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700752
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700753 ret = pinweaver_eal_storage_get_tree_data(&tree);
754 if (ret != EC_SUCCESS)
755 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700756
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700757 merkle_tree->bits_per_level = tree.bits_per_level;
758 merkle_tree->height = tree.height;
Leo Laidb207912021-08-11 16:41:18 +0800759 ret = pinweaver_eal_memcpy_s(
760 merkle_tree->key_derivation_nonce,
761 sizeof(merkle_tree->key_derivation_nonce),
762 tree.key_derivation_nonce,
763 sizeof(tree.key_derivation_nonce));
764 if (ret != EC_SUCCESS)
765 return ret;
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700766 ret = pinweaver_eal_derive_keys(merkle_tree);
Andrey Pronin9b10e512021-04-13 11:18:53 -0700767 if (ret != EC_SUCCESS)
768 return ret;
769 }
770
771 /* Handle the root hash. */
772 {
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700773 ret = pinweaver_eal_storage_init_state(merkle_tree->root,
774 &pw_restart_count);
775 if (ret != EC_SUCCESS)
776 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700777 }
778
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700779 PINWEAVER_EAL_INFO("PinWeaver: Loaded Tree. restart_count = %d",
Andrey Pronin9b10e512021-04-13 11:18:53 -0700780 pw_restart_count);
781
782 return EC_SUCCESS;
783}
784
785/* This should only be called when a new tree is created. */
786int store_merkle_tree(const struct merkle_tree_t *merkle_tree)
787{
788 int ret;
789
790 /* Handle the immutable data. */
791 {
792 struct pw_long_term_storage_t data;
793
794 data.storage_version = PW_STORAGE_VERSION;
795 data.bits_per_level = merkle_tree->bits_per_level;
796 data.height = merkle_tree->height;
Leo Laidb207912021-08-11 16:41:18 +0800797 ret = pinweaver_eal_memcpy_s(data.key_derivation_nonce,
798 sizeof(data.key_derivation_nonce),
799 merkle_tree->key_derivation_nonce,
800 sizeof(data.key_derivation_nonce));
801 if (ret != EC_SUCCESS)
802 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700803
Andrey Pronincd7bcce2021-04-14 00:54:12 -0700804 ret = pinweaver_eal_storage_set_tree_data(&data);
Andrey Pronin9b10e512021-04-13 11:18:53 -0700805 if (ret != EC_SUCCESS)
806 return ret;
807 }
808
809 /* Handle the root hash. */
810 {
811 struct pw_log_storage_t log = {};
812 struct pw_get_log_entry_t *entry = log.entries;
813
814 log.storage_version = PW_STORAGE_VERSION;
Howard Yangc2f080c2022-07-29 11:28:13 +0800815 entry->type.v = LOG_PW_RESET_TREE;
Leo Laidb207912021-08-11 16:41:18 +0800816 ret = pinweaver_eal_memcpy_s(entry->root, sizeof(entry->root),
817 merkle_tree->root,
818 sizeof(merkle_tree->root));
819 if (ret != EC_SUCCESS)
820 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700821
822 ret = store_log_data(&log);
823 if (ret == EC_SUCCESS)
824 pw_restart_count = 0;
825 return ret;
826 }
827
828}
829
830static int log_roll_for_append(struct pw_log_storage_t *log)
831{
832 int ret;
833
834 ret = load_log_data(log);
835 if (ret != EC_SUCCESS)
836 return ret;
837
838 memmove(&log->entries[1], &log->entries[0],
839 sizeof(log->entries[0]) * (PW_LOG_ENTRY_COUNT - 1));
840 memset(&log->entries[0], 0, sizeof(log->entries[0]));
841 return EC_SUCCESS;
842}
843
844int log_insert_leaf(struct label_t label, const uint8_t root[PW_HASH_SIZE],
845 const uint8_t hmac[PW_HASH_SIZE])
846{
847 int ret;
848 struct pw_log_storage_t log;
849 struct pw_get_log_entry_t *entry = log.entries;
850
851 ret = log_roll_for_append(&log);
852 if (ret != EC_SUCCESS)
853 return ret;
854
Howard Yangc2f080c2022-07-29 11:28:13 +0800855 entry->type.v = LOG_PW_INSERT_LEAF;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700856 entry->label.v = label.v;
Leo Laidb207912021-08-11 16:41:18 +0800857 ret = pinweaver_eal_memcpy_s(entry->root, sizeof(entry->root), root,
858 sizeof(entry->root));
859 if (ret != EC_SUCCESS)
860 return ret;
861 ret = pinweaver_eal_memcpy_s(entry->leaf_hmac, sizeof(entry->leaf_hmac),
862 hmac, sizeof(entry->leaf_hmac));
863 if (ret != EC_SUCCESS)
864 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700865
866 return store_log_data(&log);
867}
868
869int log_remove_leaf(struct label_t label, const uint8_t root[PW_HASH_SIZE])
870{
871 int ret;
872 struct pw_log_storage_t log;
873 struct pw_get_log_entry_t *entry = log.entries;
874
875 ret = log_roll_for_append(&log);
876 if (ret != EC_SUCCESS)
877 return ret;
878
Howard Yangc2f080c2022-07-29 11:28:13 +0800879 entry->type.v = LOG_PW_REMOVE_LEAF;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700880 entry->label.v = label.v;
Leo Laidb207912021-08-11 16:41:18 +0800881 ret = pinweaver_eal_memcpy_s(entry->root, sizeof(entry->root), root,
882 sizeof(entry->root));
883 if (ret != EC_SUCCESS)
884 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700885
886 return store_log_data(&log);
887}
888
889int log_auth(struct label_t label, const uint8_t root[PW_HASH_SIZE], int code,
Howard Yangaa7a8972022-07-26 16:39:36 +0800890 struct pw_timestamp_t last_access_ts,
891 struct pw_timestamp_t expiration_ts)
Andrey Pronin9b10e512021-04-13 11:18:53 -0700892{
893 int ret;
894 struct pw_log_storage_t log;
895 struct pw_get_log_entry_t *entry = log.entries;
896
897 ret = log_roll_for_append(&log);
898 if (ret != EC_SUCCESS)
899 return ret;
900
Howard Yangc2f080c2022-07-29 11:28:13 +0800901 entry->type.v = LOG_PW_TRY_AUTH;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700902 entry->label.v = label.v;
Leo Laidb207912021-08-11 16:41:18 +0800903 ret = pinweaver_eal_memcpy_s(entry->root, sizeof(entry->root), root,
904 sizeof(entry->root));
905 if (ret != EC_SUCCESS)
906 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700907 entry->return_code = code;
Howard Yang2b189b22022-07-29 11:11:34 +0800908 ret = pinweaver_eal_memcpy_s(&entry->last_access_ts,
909 sizeof(entry->last_access_ts), &last_access_ts,
910 sizeof(entry->last_access_ts));
Leo Laidb207912021-08-11 16:41:18 +0800911 if (ret != EC_SUCCESS)
912 return ret;
Howard Yangaa7a8972022-07-26 16:39:36 +0800913#if BIOMETRICS_DEV
914 ret = pinweaver_eal_memcpy_s(&entry->expiration_ts,
915 sizeof(entry->expiration_ts), &expiration_ts,
916 sizeof(entry->expiration_ts));
917 if (ret != EC_SUCCESS)
918 return ret;
919#endif
Andrey Pronin9b10e512021-04-13 11:18:53 -0700920
921 return store_log_data(&log);
922}
923
924/******************************************************************************/
925/* Per-request-type handler implementations.
926 */
927
928static int pw_handle_reset_tree(struct merkle_tree_t *merkle_tree,
Howard Yangd4d2e7a2022-08-02 17:57:53 +0800929 const pw_request_reset_tree_t *request,
Andrey Pronin9b10e512021-04-13 11:18:53 -0700930 uint16_t req_size)
931{
932 struct merkle_tree_t new_tree = {};
933 int ret;
934
935 if (req_size != sizeof(*request))
936 return PW_ERR_LENGTH_INVALID;
937
938 ret = validate_tree_parameters(request->bits_per_level,
939 request->height);
940 if (ret != EC_SUCCESS)
941 return ret;
942
943 ret = create_merkle_tree(request->bits_per_level, request->height,
944 &new_tree);
945 if (ret != EC_SUCCESS)
946 return ret;
947
948 ret = store_merkle_tree(&new_tree);
949 if (ret != EC_SUCCESS)
950 return ret;
951
Leo Laidb207912021-08-11 16:41:18 +0800952 ret = pinweaver_eal_memcpy_s(merkle_tree, sizeof(*merkle_tree),
953 &new_tree, sizeof(new_tree));
954 if (ret != EC_SUCCESS)
955 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -0700956 return EC_SUCCESS;
957}
958
959static int pw_handle_insert_leaf(struct merkle_tree_t *merkle_tree,
Howard Yangd4d2e7a2022-08-02 17:57:53 +0800960 const pw_request_insert_leaf_t *request,
Andrey Pronin9b10e512021-04-13 11:18:53 -0700961 uint16_t req_size,
Howard Yangd4d2e7a2022-08-02 17:57:53 +0800962 pw_response_insert_leaf_t *response,
Andrey Pronin9b10e512021-04-13 11:18:53 -0700963 uint16_t *response_size)
964{
965 int ret = EC_SUCCESS;
966 struct leaf_data_t leaf_data = {};
Leo Lai65749082021-08-10 16:32:18 +0800967 struct wrapped_leaf_data_t wrapped_leaf_data = {};
Andrey Pronin9b10e512021-04-13 11:18:53 -0700968 const uint8_t empty_hash[PW_HASH_SIZE] = {};
969 uint8_t new_root[PW_HASH_SIZE];
970
971 if (req_size != sizeof(*request) +
972 get_path_auxiliary_hash_count(merkle_tree) *
973 PW_HASH_SIZE)
974 return PW_ERR_LENGTH_INVALID;
975
976 ret = validate_request_with_path(merkle_tree, request->label,
977 request->path_hashes, empty_hash);
978 if (ret != EC_SUCCESS)
979 return ret;
980
981 ret = validate_delay_schedule(request->delay_schedule);
982 if (ret != EC_SUCCESS)
983 return ret;
984
985 memset(&leaf_data, 0, sizeof(leaf_data));
986 leaf_data.pub.label.v = request->label.v;
Leo Laidb207912021-08-11 16:41:18 +0800987 ret = pinweaver_eal_memcpy_s(&leaf_data.pub.valid_pcr_criteria,
988 sizeof(leaf_data.pub.valid_pcr_criteria),
989 request->valid_pcr_criteria,
990 sizeof(request->valid_pcr_criteria));
991 if (ret != EC_SUCCESS)
992 return PW_ERR_INTERNAL_FAILURE;
993 ret = pinweaver_eal_memcpy_s(&leaf_data.pub.delay_schedule,
994 sizeof(leaf_data.pub.delay_schedule),
995 &request->delay_schedule,
996 sizeof(request->delay_schedule));
997 if (ret != EC_SUCCESS)
998 return PW_ERR_INTERNAL_FAILURE;
Howard Yangaa7a8972022-07-26 16:39:36 +0800999
1000#if BIOMETRICS_DEV
1001 /* TODO: Support expiration_delay_s. */
1002 if (request->expiration_delay_s.v != 0) {
1003 return PW_ERR_INTERNAL_FAILURE;
1004 }
1005
1006 /* TODO: Support biometrics leaf type. */
1007 if (request->leaf_type.v != PW_LEAF_TYPE_NORMAL) {
1008 return PW_ERR_INTERNAL_FAILURE;
1009 }
1010#endif
1011
Leo Laidb207912021-08-11 16:41:18 +08001012 ret = pinweaver_eal_memcpy_s(&leaf_data.sec.low_entropy_secret,
1013 sizeof(leaf_data.sec.low_entropy_secret),
1014 &request->low_entropy_secret,
1015 sizeof(request->low_entropy_secret));
1016 if (ret != EC_SUCCESS)
1017 return PW_ERR_INTERNAL_FAILURE;
1018 ret = pinweaver_eal_memcpy_s(&leaf_data.sec.high_entropy_secret,
1019 sizeof(leaf_data.sec.high_entropy_secret),
1020 &request->high_entropy_secret,
1021 sizeof(request->high_entropy_secret));
1022 if (ret != EC_SUCCESS)
1023 return PW_ERR_INTERNAL_FAILURE;
1024 ret = pinweaver_eal_memcpy_s(&leaf_data.sec.reset_secret,
1025 sizeof(leaf_data.sec.reset_secret),
1026 &request->reset_secret,
1027 sizeof(request->reset_secret));
1028 if (ret != EC_SUCCESS)
1029 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001030
1031 ret = handle_leaf_update(merkle_tree, &leaf_data, request->path_hashes,
1032 &wrapped_leaf_data, new_root, NULL);
1033 if (ret != EC_SUCCESS)
1034 return ret;
1035
1036 ret = log_insert_leaf(request->label, new_root,
1037 wrapped_leaf_data.hmac);
1038 if (ret != EC_SUCCESS)
1039 return ret;
1040
Leo Laidb207912021-08-11 16:41:18 +08001041 ret = pinweaver_eal_memcpy_s(merkle_tree->root,
1042 sizeof(merkle_tree->root), new_root,
1043 sizeof(new_root));
1044 if (ret != EC_SUCCESS)
1045 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001046
Leo Laidb207912021-08-11 16:41:18 +08001047 ret = pinweaver_eal_memcpy_s(&response->unimported_leaf_data,
1048 sizeof(wrapped_leaf_data),
1049 &wrapped_leaf_data,
1050 sizeof(wrapped_leaf_data));
1051 if (ret != EC_SUCCESS)
1052 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001053
1054 *response_size = sizeof(*response) + PW_LEAF_PAYLOAD_SIZE;
1055
1056 return ret;
1057}
1058
1059static int pw_handle_remove_leaf(struct merkle_tree_t *merkle_tree,
Howard Yangd4d2e7a2022-08-02 17:57:53 +08001060 const pw_request_remove_leaf_t *request,
Andrey Pronin9b10e512021-04-13 11:18:53 -07001061 uint16_t req_size)
1062{
1063 int ret = EC_SUCCESS;
1064 const uint8_t empty_hash[PW_HASH_SIZE] = {};
1065 uint8_t new_root[PW_HASH_SIZE];
1066
1067 if (req_size != sizeof(*request) +
1068 get_path_auxiliary_hash_count(merkle_tree) *
1069 PW_HASH_SIZE)
1070 return PW_ERR_LENGTH_INVALID;
1071
1072 ret = validate_request_with_path(merkle_tree, request->leaf_location,
1073 request->path_hashes,
1074 request->leaf_hmac);
1075 if (ret != EC_SUCCESS)
1076 return ret;
1077
Leo Lai788f41e2021-08-11 00:36:24 +08001078 ret = compute_root_hash(merkle_tree, request->leaf_location,
1079 request->path_hashes, empty_hash, new_root);
1080 if (ret != EC_SUCCESS)
1081 return ret;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001082
1083 ret = log_remove_leaf(request->leaf_location, new_root);
1084 if (ret != EC_SUCCESS)
1085 return ret;
1086
Leo Laidb207912021-08-11 16:41:18 +08001087 ret = pinweaver_eal_memcpy_s(merkle_tree->root,
1088 sizeof(merkle_tree->root), new_root,
1089 sizeof(new_root));
1090 if (ret != EC_SUCCESS)
1091 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001092 return ret;
1093}
1094
1095/* Processes a try_auth request.
1096 *
1097 * The valid fields in response based on return code are:
1098 * EC_SUCCESS -> unimported_leaf_data and high_entropy_secret
1099 * PW_ERR_RATE_LIMIT_REACHED -> seconds_to_wait
1100 * PW_ERR_LOWENT_AUTH_FAILED -> unimported_leaf_data
1101 */
1102static int pw_handle_try_auth(struct merkle_tree_t *merkle_tree,
Howard Yangd4d2e7a2022-08-02 17:57:53 +08001103 const pw_request_try_auth_t *request,
Andrey Pronin9b10e512021-04-13 11:18:53 -07001104 uint16_t req_size,
Howard Yangd4d2e7a2022-08-02 17:57:53 +08001105 pw_response_try_auth_t *response,
Andrey Pronin9b10e512021-04-13 11:18:53 -07001106 uint16_t *data_length)
1107{
1108 int ret = EC_SUCCESS;
1109 struct leaf_data_t leaf_data = {};
1110 struct imported_leaf_data_t imported_leaf_data;
Andrey Pronin8ec6dc52021-08-12 14:00:09 -07001111 struct wrapped_leaf_data_t wrapped_leaf_data = {};
Andrey Pronin9b10e512021-04-13 11:18:53 -07001112 struct time_diff_t seconds_to_wait;
Howard Yangaa7a8972022-07-26 16:39:36 +08001113 struct pw_timestamp_t expiration_ts = {};
Andrey Pronin9b10e512021-04-13 11:18:53 -07001114 uint8_t zeros[PW_SECRET_SIZE] = {};
1115 uint8_t new_root[PW_HASH_SIZE];
1116
1117 /* These variables help eliminate the possibility of a timing side
1118 * channel that would allow an attacker to prevent the log write.
1119 */
1120 volatile int auth_result;
1121
1122 volatile struct {
1123 uint32_t attempts;
1124 int ret;
1125 uint8_t *secret;
1126 uint8_t *reset_secret;
1127 } results_table[2] = {
1128 { 0, PW_ERR_LOWENT_AUTH_FAILED, zeros, zeros },
1129 { 0, EC_SUCCESS, leaf_data.sec.high_entropy_secret,
1130 leaf_data.sec.reset_secret },
1131 };
1132
1133 if (req_size < sizeof(*request))
1134 return PW_ERR_LENGTH_INVALID;
1135
1136 ret = validate_request_with_wrapped_leaf(
1137 merkle_tree, req_size - sizeof(*request),
1138 &request->unimported_leaf_data, &imported_leaf_data,
1139 &leaf_data);
1140 if (ret != EC_SUCCESS)
1141 return ret;
1142
1143 /* Check if at least one PCR criteria is satisfied if the leaf is
1144 * bound to PCR.
1145 */
1146 ret = validate_pcr_value(leaf_data.pub.valid_pcr_criteria);
1147 if (ret != EC_SUCCESS)
1148 return ret;
1149
1150 ret = test_rate_limit(&leaf_data, &seconds_to_wait);
1151 if (ret != EC_SUCCESS) {
1152 *data_length = sizeof(*response) + PW_LEAF_PAYLOAD_SIZE;
1153 memset(response, 0, *data_length);
Leo Laidb207912021-08-11 16:41:18 +08001154 pinweaver_eal_memcpy_s(&response->seconds_to_wait,
1155 sizeof(response->seconds_to_wait),
1156 &seconds_to_wait,
1157 sizeof(seconds_to_wait));
Andrey Pronin9b10e512021-04-13 11:18:53 -07001158 return ret;
1159 }
1160
Howard Yang2b189b22022-07-29 11:11:34 +08001161 update_timestamp(&leaf_data.pub.last_access_ts);
Andrey Pronin9b10e512021-04-13 11:18:53 -07001162
1163 /* Precompute the failed attempts. */
1164 results_table[0].attempts = leaf_data.pub.attempt_count.v;
1165 if (results_table[0].attempts != UINT32_MAX)
1166 ++results_table[0].attempts;
1167
Howard Yangaa7a8972022-07-26 16:39:36 +08001168 /* TODO: Make biometrics type leaf use different results table. */
1169
Andrey Pronin9b10e512021-04-13 11:18:53 -07001170 /**********************************************************************/
1171 /* After this:
1172 * 1) results_table should not be changed;
1173 * 2) the runtime of the code paths for failed and successful
1174 * authentication attempts should not diverge.
1175 */
Andrey Pronincd7bcce2021-04-14 00:54:12 -07001176 auth_result = pinweaver_eal_safe_memcmp(
1177 request->low_entropy_secret,
1178 leaf_data.sec.low_entropy_secret,
1179 sizeof(request->low_entropy_secret)) == 0;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001180 leaf_data.pub.attempt_count.v = results_table[auth_result].attempts;
1181
1182 /* This has a non-constant time path, but it doesn't convey information
1183 * about whether a PW_ERR_LOWENT_AUTH_FAILED happened or not.
1184 */
1185 ret = handle_leaf_update(merkle_tree, &leaf_data,
1186 imported_leaf_data.hashes, &wrapped_leaf_data,
1187 new_root, &imported_leaf_data);
1188 if (ret != EC_SUCCESS)
1189 return ret;
1190
Howard Yangaa7a8972022-07-26 16:39:36 +08001191
1192#if BIOMETRICS_DEV
1193 expiration_ts = leaf_data.pub.expiration_ts;
1194#endif
Andrey Pronin9b10e512021-04-13 11:18:53 -07001195 ret = log_auth(wrapped_leaf_data.pub.label, new_root,
Howard Yangaa7a8972022-07-26 16:39:36 +08001196 results_table[auth_result].ret, leaf_data.pub.last_access_ts,
1197 expiration_ts);
Andrey Pronin9b10e512021-04-13 11:18:53 -07001198 if (ret != EC_SUCCESS) {
Leo Laidb207912021-08-11 16:41:18 +08001199 pinweaver_eal_memcpy_s(new_root, sizeof(new_root),
1200 merkle_tree->root,
1201 sizeof(merkle_tree->root));
Andrey Pronin9b10e512021-04-13 11:18:53 -07001202 return ret;
1203 }
1204 /**********************************************************************/
1205 /* At this point the log should be written so it should be safe for the
1206 * runtime of the code paths to diverge.
1207 */
1208
Leo Laidb207912021-08-11 16:41:18 +08001209 ret = pinweaver_eal_memcpy_s(merkle_tree->root,
1210 sizeof(merkle_tree->root), new_root,
1211 sizeof(new_root));
1212 if (ret != EC_SUCCESS)
1213 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001214
1215 *data_length = sizeof(*response) + PW_LEAF_PAYLOAD_SIZE;
1216 memset(response, 0, *data_length);
1217
Leo Laidb207912021-08-11 16:41:18 +08001218 ret = pinweaver_eal_memcpy_s(&response->unimported_leaf_data,
1219 sizeof(wrapped_leaf_data),
1220 &wrapped_leaf_data,
1221 sizeof(wrapped_leaf_data));
1222 if (ret != EC_SUCCESS)
1223 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001224
Leo Laidb207912021-08-11 16:41:18 +08001225 ret = pinweaver_eal_memcpy_s(&response->high_entropy_secret,
1226 sizeof(response->high_entropy_secret),
1227 results_table[auth_result].secret,
1228 sizeof(response->high_entropy_secret));
1229 if (ret != EC_SUCCESS)
1230 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001231
Leo Laidb207912021-08-11 16:41:18 +08001232 ret = pinweaver_eal_memcpy_s(&response->reset_secret,
1233 sizeof(response->reset_secret),
1234 results_table[auth_result].reset_secret,
1235 sizeof(response->reset_secret));
1236 if (ret != EC_SUCCESS)
1237 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001238
1239 return results_table[auth_result].ret;
1240}
1241
1242static int pw_handle_reset_auth(struct merkle_tree_t *merkle_tree,
Howard Yangd4d2e7a2022-08-02 17:57:53 +08001243 const pw_request_reset_auth_t *request,
Andrey Pronin9b10e512021-04-13 11:18:53 -07001244 uint16_t req_size,
Howard Yangd4d2e7a2022-08-02 17:57:53 +08001245 pw_response_reset_auth_t *response,
Andrey Pronin9b10e512021-04-13 11:18:53 -07001246 uint16_t *response_size)
1247{
1248 int ret = EC_SUCCESS;
1249 struct leaf_data_t leaf_data = {};
1250 struct imported_leaf_data_t imported_leaf_data;
Andrey Pronin8ec6dc52021-08-12 14:00:09 -07001251 struct wrapped_leaf_data_t wrapped_leaf_data = {};
Howard Yangaa7a8972022-07-26 16:39:36 +08001252 struct pw_timestamp_t expiration_ts = {};
Andrey Pronin9b10e512021-04-13 11:18:53 -07001253 uint8_t new_root[PW_HASH_SIZE];
1254
1255 if (req_size < sizeof(*request))
1256 return PW_ERR_LENGTH_INVALID;
1257
1258 ret = validate_request_with_wrapped_leaf(
1259 merkle_tree, req_size - sizeof(*request),
1260 &request->unimported_leaf_data, &imported_leaf_data,
1261 &leaf_data);
1262 if (ret != EC_SUCCESS)
1263 return ret;
1264
1265 /* Safe memcmp is used here to prevent an attacker from being able to
1266 * brute force the reset secret and use it to unlock the leaf.
1267 * memcmp provides an attacker a timing side-channel they can use to
1268 * determine how much of a prefix is correct.
1269 */
Andrey Pronincd7bcce2021-04-14 00:54:12 -07001270 if (pinweaver_eal_safe_memcmp(request->reset_secret,
1271 leaf_data.sec.reset_secret,
1272 sizeof(request->reset_secret)) != 0)
Andrey Pronin9b10e512021-04-13 11:18:53 -07001273 return PW_ERR_RESET_AUTH_FAILED;
1274
1275 leaf_data.pub.attempt_count.v = 0;
1276
Howard Yangaa7a8972022-07-26 16:39:36 +08001277#if BIOMETRICS_DEV
1278 /* TODO: Support strong_reset. */
1279 if (request->strong_reset) {
1280 return PW_ERR_INTERNAL_FAILURE;
1281 }
1282#endif
1283
Andrey Pronin9b10e512021-04-13 11:18:53 -07001284 ret = handle_leaf_update(merkle_tree, &leaf_data,
1285 imported_leaf_data.hashes, &wrapped_leaf_data,
1286 new_root, &imported_leaf_data);
1287 if (ret != EC_SUCCESS)
1288 return ret;
1289
Howard Yangaa7a8972022-07-26 16:39:36 +08001290#if BIOMETRICS_DEV
1291 expiration_ts = leaf_data.pub.expiration_ts;
1292#endif
Andrey Pronin9b10e512021-04-13 11:18:53 -07001293 ret = log_auth(leaf_data.pub.label, new_root, ret,
Howard Yangaa7a8972022-07-26 16:39:36 +08001294 leaf_data.pub.last_access_ts, expiration_ts);
Andrey Pronin9b10e512021-04-13 11:18:53 -07001295 if (ret != EC_SUCCESS)
1296 return ret;
1297
Leo Laidb207912021-08-11 16:41:18 +08001298 ret = pinweaver_eal_memcpy_s(merkle_tree->root,
1299 sizeof(merkle_tree->root), new_root,
1300 sizeof(new_root));
1301 if (ret != EC_SUCCESS)
1302 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001303
Leo Laidb207912021-08-11 16:41:18 +08001304 ret = pinweaver_eal_memcpy_s(&response->unimported_leaf_data,
1305 sizeof(wrapped_leaf_data),
1306 &wrapped_leaf_data,
1307 sizeof(wrapped_leaf_data));
1308 if (ret != EC_SUCCESS)
1309 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001310
Leo Laidb207912021-08-11 16:41:18 +08001311 ret = pinweaver_eal_memcpy_s(response->high_entropy_secret,
1312 sizeof(response->high_entropy_secret),
1313 leaf_data.sec.high_entropy_secret,
1314 sizeof(response->high_entropy_secret));
1315 if (ret != EC_SUCCESS)
1316 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001317
1318 *response_size = sizeof(*response) + PW_LEAF_PAYLOAD_SIZE;
1319
1320 return ret;
1321}
1322
1323static int pw_handle_get_log(const struct merkle_tree_t *merkle_tree,
Howard Yangd4d2e7a2022-08-02 17:57:53 +08001324 const pw_request_get_log_t *request,
Andrey Pronin9b10e512021-04-13 11:18:53 -07001325 uint16_t req_size,
1326 struct pw_get_log_entry_t response[],
1327 uint16_t *response_size)
1328{
1329 int ret;
1330 int x;
1331 struct pw_log_storage_t log;
1332
1333 if (req_size != sizeof(*request))
1334 return PW_ERR_LENGTH_INVALID;
1335
1336 ret = validate_tree(merkle_tree);
1337 if (ret != EC_SUCCESS)
1338 return ret;
1339
1340 ret = load_log_data(&log);
1341 if (ret != EC_SUCCESS)
1342 return ret;
1343
1344 /* Find the relevant log entry. The return value isn't used because if
1345 * the entry isn't found the entire log is returned. This makes it
1346 * easier to recover when the log is too short.
1347 *
1348 * Here is an example:
1349 * 50 attempts have been made against a leaf that becomes out of sync
1350 * because of a disk flush failing. The copy of the leaf on disk is
1351 * behind by 50 and the log contains less than 50 entries. The CrOS
1352 * implementation can check the public parameters of the local copy with
1353 * the log entry to determine that leaf is out of sync. It can then send
1354 * any valid copy of that leaf with a log replay request that will only
1355 * succeed if the HMAC of the resulting leaf matches the log entry.
1356 */
1357 find_relevant_entry(&log, request->root, &x);
1358 /* If there are no valid entries, return. */
1359 if (x < 0)
1360 return EC_SUCCESS;
1361
1362 /* Copy the entries in reverse order. */
1363 while (1) {
Leo Laidb207912021-08-11 16:41:18 +08001364 ret = pinweaver_eal_memcpy_s(&response[x], sizeof(response[x]),
1365 &log.entries[x],
1366 sizeof(log.entries[x]));
1367 if (ret != EC_SUCCESS)
1368 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001369 *response_size += sizeof(log.entries[x]);
1370 if (x == 0)
1371 break;
1372 --x;
1373 }
1374
1375 return EC_SUCCESS;
1376}
1377
1378static int pw_handle_log_replay(const struct merkle_tree_t *merkle_tree,
Howard Yangd4d2e7a2022-08-02 17:57:53 +08001379 const pw_request_log_replay_t *request,
Andrey Pronin9b10e512021-04-13 11:18:53 -07001380 uint16_t req_size,
Howard Yangd4d2e7a2022-08-02 17:57:53 +08001381 pw_response_log_replay_t *response,
Andrey Pronin9b10e512021-04-13 11:18:53 -07001382 uint16_t *response_size)
1383{
1384 int ret;
1385 int x;
1386 struct pw_log_storage_t log;
1387 struct leaf_data_t leaf_data = {};
1388 struct imported_leaf_data_t imported_leaf_data;
Andrey Pronin8ec6dc52021-08-12 14:00:09 -07001389 struct wrapped_leaf_data_t wrapped_leaf_data = {};
Andrey Pronin9b10e512021-04-13 11:18:53 -07001390 uint8_t hmac[PW_HASH_SIZE];
1391 uint8_t root[PW_HASH_SIZE];
1392
1393 if (req_size < sizeof(*request))
1394 return PW_ERR_LENGTH_INVALID;
1395
1396 ret = validate_tree(merkle_tree);
1397 if (ret != EC_SUCCESS)
1398 return ret;
1399
1400 /* validate_request_with_wrapped_leaf() isn't used here because the
1401 * path validation is delayed to allow any valid copy of the same leaf
1402 * to be used in the replay operation as long as the result passes path
1403 * validation.
1404 */
1405 ret = validate_leaf_header(&request->unimported_leaf_data.head,
1406 req_size - sizeof(*request),
1407 get_path_auxiliary_hash_count(merkle_tree));
1408 if (ret != EC_SUCCESS)
1409 return ret;
1410
1411 import_leaf(&request->unimported_leaf_data, &imported_leaf_data);
1412
1413 ret = load_log_data(&log);
1414 if (ret != EC_SUCCESS)
1415 return ret;
1416
1417 /* Find the relevant log entry. */
1418 ret = find_relevant_entry(&log, request->log_root, &x);
1419 if (ret != EC_SUCCESS)
1420 return ret;
1421
1422 /* The other message types don't need to be handled by Cr50. */
Howard Yangc2f080c2022-07-29 11:28:13 +08001423 if (log.entries[x].type.v != LOG_PW_TRY_AUTH)
Andrey Pronin9b10e512021-04-13 11:18:53 -07001424 return PW_ERR_TYPE_INVALID;
1425
Leo Lai788f41e2021-08-11 00:36:24 +08001426 ret = compute_hmac(merkle_tree, &imported_leaf_data, hmac);
1427 if (ret != EC_SUCCESS)
1428 return ret;
Andrey Pronincd7bcce2021-04-14 00:54:12 -07001429 if (pinweaver_eal_safe_memcmp(hmac,
1430 request->unimported_leaf_data.hmac,
1431 sizeof(hmac)))
Andrey Pronin9b10e512021-04-13 11:18:53 -07001432 return PW_ERR_HMAC_AUTH_FAILED;
1433
1434 ret = decrypt_leaf_data(merkle_tree, &imported_leaf_data, &leaf_data);
1435 if (ret != EC_SUCCESS)
1436 return ret;
1437
1438 if (leaf_data.pub.label.v != log.entries[x].label.v)
1439 return PW_ERR_LABEL_INVALID;
1440
1441 /* Update the metadata to match the log. */
1442 if (log.entries[x].return_code == EC_SUCCESS)
1443 leaf_data.pub.attempt_count.v = 0;
1444 else
1445 ++leaf_data.pub.attempt_count.v;
Howard Yang2b189b22022-07-29 11:11:34 +08001446 ret = pinweaver_eal_memcpy_s(&leaf_data.pub.last_access_ts,
1447 sizeof(leaf_data.pub.last_access_ts),
1448 &log.entries[x].last_access_ts,
1449 sizeof(leaf_data.pub.last_access_ts));
Leo Laidb207912021-08-11 16:41:18 +08001450 if (ret != EC_SUCCESS)
1451 return PW_ERR_INTERNAL_FAILURE;
Howard Yangaa7a8972022-07-26 16:39:36 +08001452#if BIOMETRICS_DEV
1453 ret = pinweaver_eal_memcpy_s(&leaf_data.pub.expiration_ts,
1454 sizeof(leaf_data.pub.expiration_ts),
1455 &log.entries[x].expiration_ts,
1456 sizeof(leaf_data.pub.expiration_ts));
1457 if (ret != EC_SUCCESS)
1458 return PW_ERR_INTERNAL_FAILURE;
1459#endif
Andrey Pronin9b10e512021-04-13 11:18:53 -07001460
1461 ret = handle_leaf_update(merkle_tree, &leaf_data,
1462 imported_leaf_data.hashes, &wrapped_leaf_data,
1463 root, &imported_leaf_data);
1464 if (ret != EC_SUCCESS)
1465 return ret;
1466
Yi Chouddf3b452021-08-11 13:40:11 +08001467 if (pinweaver_eal_safe_memcmp(root, log.entries[x].root, PW_HASH_SIZE))
Andrey Pronin9b10e512021-04-13 11:18:53 -07001468 return PW_ERR_PATH_AUTH_FAILED;
1469
Leo Laidb207912021-08-11 16:41:18 +08001470 ret = pinweaver_eal_memcpy_s(&response->unimported_leaf_data,
1471 sizeof(wrapped_leaf_data),
1472 &wrapped_leaf_data,
1473 sizeof(wrapped_leaf_data));
1474 if (ret != EC_SUCCESS)
1475 return PW_ERR_INTERNAL_FAILURE;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001476
1477 *response_size = sizeof(*response) + PW_LEAF_PAYLOAD_SIZE;
1478
1479 return EC_SUCCESS;
1480}
1481
1482struct merkle_tree_t pw_merkle_tree;
1483
Andrey Pronin9b10e512021-04-13 11:18:53 -07001484/******************************************************************************/
1485/* Non-static functions.
1486 */
1487
1488void pinweaver_init(void)
1489{
1490 load_merkle_tree(&pw_merkle_tree);
1491}
1492
1493int get_path_auxiliary_hash_count(const struct merkle_tree_t *merkle_tree)
1494{
1495 return ((1 << merkle_tree->bits_per_level.v) - 1) *
1496 merkle_tree->height.v;
1497}
1498
1499/* Computes the SHA256 parent hash of a set of child hashes given num_hashes
1500 * sibling hashes in hashes[] and the index of child_hash.
1501 *
1502 * Assumptions:
1503 * num_hashes == fan_out - 1
1504 * ARRAY_SIZE(hashes) == num_hashes
1505 * 0 <= location <= num_hashes
1506 */
Leo Lai788f41e2021-08-11 00:36:24 +08001507int compute_hash(const uint8_t hashes[][PW_HASH_SIZE], uint16_t num_hashes,
1508 struct index_t location,
1509 const uint8_t child_hash[PW_HASH_SIZE],
1510 uint8_t result[PW_HASH_SIZE])
Andrey Pronin9b10e512021-04-13 11:18:53 -07001511{
Leo Lai788f41e2021-08-11 00:36:24 +08001512 int ret;
Andrey Pronincd7bcce2021-04-14 00:54:12 -07001513 pinweaver_eal_sha256_ctx_t ctx;
Andrey Pronin9b10e512021-04-13 11:18:53 -07001514
Leo Lai788f41e2021-08-11 00:36:24 +08001515 ret = pinweaver_eal_sha256_init(&ctx);
1516 if (ret)
1517 return ret;
Yi Chou89f8d532021-08-12 16:36:46 +08001518 if (location.v > 0) {
1519 ret = pinweaver_eal_sha256_update(&ctx, hashes[0],
1520 PW_HASH_SIZE * location.v);
1521 if (ret) {
1522 pinweaver_eal_sha256_final(&ctx, result);
1523 return ret;
1524 }
Leo Lai788f41e2021-08-11 00:36:24 +08001525 }
1526 ret = pinweaver_eal_sha256_update(&ctx, child_hash, PW_HASH_SIZE);
1527 if (ret) {
1528 pinweaver_eal_sha256_final(&ctx, result);
1529 return ret;
1530 }
1531 if (location.v < num_hashes) {
1532 ret = pinweaver_eal_sha256_update(
1533 &ctx, hashes[location.v],
1534 PW_HASH_SIZE * (num_hashes - location.v));
1535 if (ret) {
1536 pinweaver_eal_sha256_final(&ctx, result);
1537 return ret;
1538 }
1539 }
1540 return pinweaver_eal_sha256_final(&ctx, result);
Andrey Pronin9b10e512021-04-13 11:18:53 -07001541}
1542
1543/* If a request from older protocol comes, this method should make it
1544 * compatible with the current request structure.
1545 */
1546int make_compatible_request(struct merkle_tree_t *merkle_tree,
1547 struct pw_request_t *request)
1548{
1549 switch (request->header.version) {
1550 case 0:
1551 /* The switch from protocol version 0 to 1 means all the
1552 * requests have the same format, except insert_leaf.
1553 * Update the request in that case.
1554 */
1555 if (request->header.type.v == PW_INSERT_LEAF) {
1556 unsigned char *src = (unsigned char *)
1557 (&request->data.insert_leaf00.path_hashes);
1558 unsigned char *dest = (unsigned char *)
Howard Yangaa7a8972022-07-26 16:39:36 +08001559 (&request->data.insert_leaf01.path_hashes);
Yi Chouc3901ca2021-08-11 14:11:15 +08001560 const uint16_t src_size =
1561 request->header.data_length -
1562 offsetof(struct pw_request_insert_leaf00_t,
1563 path_hashes);
Howard Yangd4d2e7a2022-08-02 17:57:53 +08001564 if (offsetof(struct pw_request_insert_leaf01_t,
Andrey Proninee44ef02021-08-13 15:11:38 -07001565 path_hashes) + src_size >
1566 PW_MAX_MESSAGE_SIZE) {
Yi Chouc3901ca2021-08-11 14:11:15 +08001567 /* The total length of request overflowed. */
1568 return 0;
1569 }
1570 memmove(dest, src, src_size);
Howard Yangaa7a8972022-07-26 16:39:36 +08001571 memset(&request->data.insert_leaf01.valid_pcr_criteria, 0,
Yi Chouc3901ca2021-08-11 14:11:15 +08001572 PW_VALID_PCR_CRITERIA_SIZE);
Andrey Pronin9b10e512021-04-13 11:18:53 -07001573 request->header.data_length +=
1574 PW_VALID_PCR_CRITERIA_SIZE;
1575 }
1576 /* Fallthrough to make compatible from next version */
Leo Lai8c9892c2021-06-22 21:32:02 +08001577 __attribute__((fallthrough));
Howard Yangaa7a8972022-07-26 16:39:36 +08001578#if BIOMETRICS_DEV
1579 case 1:
1580 /* The switch from protocol version 1 to 2 means all the
1581 * requests have the same format, except insert_leaf and
1582 * reset_auth.
1583 * Update the request in that case.
1584 */
1585 if (request->header.type.v == PW_INSERT_LEAF) {
1586 unsigned char *src = (unsigned char *)
1587 (&request->data.insert_leaf01.path_hashes);
1588 unsigned char *dest = (unsigned char *)
1589 (&request->data.insert_leaf.path_hashes);
1590 const size_t src_offset = offsetof(struct pw_request_insert_leaf01_t,
1591 path_hashes);
1592 const size_t dest_offset = offsetof(struct pw_request_insert_leaf02_t,
1593 path_hashes);
1594 const uint16_t src_size = request->header.data_length - src_offset;
1595 if (dest_offset + src_size > PW_MAX_MESSAGE_SIZE) {
1596 /* The total length of request overflowed. */
1597 return 0;
1598 }
1599 memmove(dest, src, src_size);
1600 request->data.insert_leaf.expiration_delay_s.v = 0;
1601 request->data.insert_leaf.leaf_type.v = PW_LEAF_TYPE_NORMAL;
1602 request->header.data_length += dest_offset - src_offset;
1603 } else if (request->header.type.v == PW_RESET_AUTH) {
1604 unsigned char *src = (unsigned char *)
1605 (&request->data.reset_auth00.unimported_leaf_data);
1606 unsigned char *dest = (unsigned char *)
1607 (&request->data.reset_auth.unimported_leaf_data);
1608 const uint16_t src_size =
1609 request->header.data_length -
1610 offsetof(struct pw_request_reset_auth00_t,
1611 unimported_leaf_data);
1612 if (offsetof(struct pw_request_reset_auth02_t,
1613 unimported_leaf_data) + src_size >
1614 PW_MAX_MESSAGE_SIZE) {
1615 /* The total length of request overflowed. */
1616 return 0;
1617 }
1618 memmove(dest, src, src_size);
1619 request->data.reset_auth.strong_reset = 0;
1620 request->header.data_length += 1;
1621 }
1622 /* Fallthrough to make compatible from next version */
1623 __attribute__((fallthrough));
1624#endif
Andrey Pronin9b10e512021-04-13 11:18:53 -07001625 case PW_PROTOCOL_VERSION:
1626 return 1;
1627 }
1628 /* Unsupported version. */
1629 return 0;
1630}
1631
1632/* Converts the response to be understandable by an older protocol.
1633 */
1634void make_compatible_response(int version, int req_type,
1635 struct pw_response_t *response)
1636{
Howard Yangaa7a8972022-07-26 16:39:36 +08001637#if BIOMETRICS_DEV
1638 size_t offset;
1639#endif
1640
Andrey Pronin9b10e512021-04-13 11:18:53 -07001641 if (version >= PW_PROTOCOL_VERSION)
1642 return;
1643
1644 response->header.version = version;
1645 if (version == 0) {
1646 if (req_type == PW_TRY_AUTH) {
1647 unsigned char *src = (unsigned char *)
1648 (&response->data.try_auth.unimported_leaf_data);
1649 unsigned char *dest = (unsigned char *)
1650 (&response->data.try_auth00.unimported_leaf_data);
1651 memmove(dest, src,
1652 PW_LEAF_PAYLOAD_SIZE +
1653 sizeof(struct unimported_leaf_data_t));
1654 response->header.data_length -= PW_SECRET_SIZE;
1655 }
1656 }
Howard Yangaa7a8972022-07-26 16:39:36 +08001657
1658#if BIOMETRICS_DEV
1659 if (version <= 1) {
1660 if (req_type == PW_GET_LOG) {
1661 for (offset = 0;
1662 offset + sizeof(struct pw_get_log_entry_t) <=
1663 response->header.data_length;
1664 offset += sizeof(struct pw_get_log_entry_t)) {
1665 struct pw_get_log_entry_t * entry =
1666 (struct pw_get_log_entry_t *) (response->data.get_log + offset);
1667 /* LOG_PW_TRY_AUTH00's union variant is the prefix of
1668 * LOG_PW_TRY_AUTH's, so we can just change the type here.
1669 */
1670 if (entry->type.v == LOG_PW_TRY_AUTH)
1671 entry->type.v = LOG_PW_TRY_AUTH00;
1672 }
1673 }
1674 }
1675#endif
Andrey Pronin9b10e512021-04-13 11:18:53 -07001676}
1677
Andrey Pronincd7bcce2021-04-14 00:54:12 -07001678enum pinweaver_command_res_t pinweaver_command(void *request_buf,
1679 size_t request_size,
1680 void *response_buf,
1681 size_t *response_size) {
1682 struct pw_request_t *request = request_buf;
1683 struct pw_response_t *response = response_buf;
1684
1685 if (request_size < sizeof(request->header)) {
1686 PINWEAVER_EAL_INFO(
1687 "PinWeaver: message smaller than a header (%zd).\n",
1688 request_size);
1689 return PW_CMD_RES_TOO_SMALL;
1690 }
1691
1692 if (request_size != request->header.data_length +
1693 sizeof(request->header)) {
1694 PINWEAVER_EAL_INFO(
1695 "PinWeaver: header size mismatch %zd != %zd.\n",
1696 request_size,
1697 request->header.data_length + sizeof(request->header));
1698 return PW_CMD_RES_SIZE;
1699 }
1700
1701 /* The response_size is validated by compile time checks. */
1702
1703 /* The return value of this function call is intentionally unused. */
1704 pw_handle_request(&pw_merkle_tree, request, response);
1705
1706 *response_size = response->header.data_length +
1707 sizeof(response->header);
1708
1709 /* The response is only sent for EC_SUCCESS so it is used even for
1710 * errors which are reported through header.return_code.
1711 */
1712 return PW_CMD_RES_SUCCESS;
1713}
1714
1715
Andrey Pronin9b10e512021-04-13 11:18:53 -07001716/* Handles the message in request using the context in merkle_tree and writes
1717 * the results to response. The return value captures any error conditions that
1718 * occurred or EC_SUCCESS if there were no errors.
1719 *
1720 * This implementation is written to handle the case where request and response
1721 * exist at the same memory location---are backed by the same buffer. This means
1722 * the implementation requires that no reads are made to request after response
1723 * has been written to.
1724 */
1725int pw_handle_request(struct merkle_tree_t *merkle_tree,
1726 struct pw_request_t *request,
1727 struct pw_response_t *response)
1728{
1729 int32_t ret;
1730 uint16_t resp_length;
1731 /* Store the message type of the request since it may be overwritten
1732 * inside the switch whenever response and request overlap in memory.
1733 */
1734 struct pw_message_type_t type = request->header.type;
1735 int version = request->header.version;
1736
1737 resp_length = 0;
1738
1739 if (!make_compatible_request(merkle_tree, request)) {
1740 ret = PW_ERR_VERSION_MISMATCH;
1741 goto cleanup;
1742 }
1743 switch (type.v) {
1744 case PW_RESET_TREE:
1745 ret = pw_handle_reset_tree(merkle_tree,
1746 &request->data.reset_tree,
1747 request->header.data_length);
1748 break;
1749 case PW_INSERT_LEAF:
1750 ret = pw_handle_insert_leaf(merkle_tree,
1751 &request->data.insert_leaf,
1752 request->header.data_length,
1753 &response->data.insert_leaf,
1754 &resp_length);
1755 break;
1756 case PW_REMOVE_LEAF:
1757 ret = pw_handle_remove_leaf(merkle_tree,
1758 &request->data.remove_leaf,
1759 request->header.data_length);
1760 break;
1761 case PW_TRY_AUTH:
1762 ret = pw_handle_try_auth(merkle_tree, &request->data.try_auth,
1763 request->header.data_length,
1764 &response->data.try_auth,
1765 &resp_length);
1766 break;
1767 case PW_RESET_AUTH:
1768 ret = pw_handle_reset_auth(merkle_tree,
1769 &request->data.reset_auth,
1770 request->header.data_length,
1771 &response->data.reset_auth,
1772 &resp_length);
1773 break;
1774 case PW_GET_LOG:
1775 ret = pw_handle_get_log(merkle_tree, &request->data.get_log,
1776 request->header.data_length,
1777 (void *)&response->data, &resp_length);
1778 break;
1779 case PW_LOG_REPLAY:
1780 ret = pw_handle_log_replay(merkle_tree,
1781 &request->data.log_replay,
1782 request->header.data_length,
1783 &response->data.log_replay,
1784 &resp_length);
1785 break;
1786 default:
1787 ret = PW_ERR_TYPE_INVALID;
1788 break;
1789 }
1790cleanup:
1791 response->header.version = PW_PROTOCOL_VERSION;
1792 response->header.data_length = resp_length;
1793 response->header.result_code = ret;
Leo Laidb207912021-08-11 16:41:18 +08001794 if (pinweaver_eal_memcpy_s(&response->header.root,
1795 sizeof(response->header.root),
1796 merkle_tree->root,
1797 sizeof(merkle_tree->root))) {
1798 ret = PW_ERR_INTERNAL_FAILURE;
1799 }
Andrey Pronin9b10e512021-04-13 11:18:53 -07001800
1801 make_compatible_response(version, type.v, response);
1802
1803 return ret;
1804};