| // SPDX-License-Identifier: MIT |
| /* |
| * Copyright (C) 2016 The Android Open Source Project |
| */ |
| |
| #include "avb_vbmeta_image.h" |
| #include "avb_crypto.h" |
| #include "avb_rsa.h" |
| #include "avb_sha.h" |
| #include "avb_util.h" |
| #include "avb_version.h" |
| |
| AvbVBMetaVerifyResult avb_vbmeta_image_verify( |
| const uint8_t* data, |
| size_t length, |
| const uint8_t** out_public_key_data, |
| size_t* out_public_key_length) { |
| AvbVBMetaVerifyResult ret; |
| AvbVBMetaImageHeader h; |
| uint8_t* computed_hash; |
| const AvbAlgorithmData* algorithm; |
| AvbSHA256Ctx sha256_ctx; |
| AvbSHA512Ctx sha512_ctx; |
| const uint8_t* header_block; |
| const uint8_t* authentication_block; |
| const uint8_t* auxiliary_block; |
| int verification_result; |
| |
| ret = AVB_VBMETA_VERIFY_RESULT_INVALID_VBMETA_HEADER; |
| |
| if (out_public_key_data != NULL) { |
| *out_public_key_data = NULL; |
| } |
| if (out_public_key_length != NULL) { |
| *out_public_key_length = 0; |
| } |
| |
| /* Before we byteswap or compare Magic, ensure length is long enough. */ |
| if (length < sizeof(AvbVBMetaImageHeader)) { |
| avb_error("Length is smaller than header.\n"); |
| goto out; |
| } |
| |
| /* Ensure magic is correct. */ |
| if (avb_safe_memcmp(data, AVB_MAGIC, AVB_MAGIC_LEN) != 0) { |
| avb_error("Magic is incorrect.\n"); |
| goto out; |
| } |
| |
| avb_vbmeta_image_header_to_host_byte_order((const AvbVBMetaImageHeader*)data, |
| &h); |
| |
| /* Ensure we don't attempt to access any fields if we do not meet |
| * the specified minimum version of libavb. |
| */ |
| if ((h.required_libavb_version_major != AVB_VERSION_MAJOR) || |
| (h.required_libavb_version_minor > AVB_VERSION_MINOR)) { |
| avb_error("Mismatch between image version and libavb version.\n"); |
| ret = AVB_VBMETA_VERIFY_RESULT_UNSUPPORTED_VERSION; |
| goto out; |
| } |
| |
| /* Ensure |release_string| ends with a NUL byte. */ |
| if (h.release_string[AVB_RELEASE_STRING_SIZE - 1] != '\0') { |
| avb_error("Release string does not end with a NUL byte.\n"); |
| goto out; |
| } |
| |
| /* Ensure inner block sizes are multiple of 64. */ |
| if ((h.authentication_data_block_size & 0x3f) != 0 || |
| (h.auxiliary_data_block_size & 0x3f) != 0) { |
| avb_error("Block size is not a multiple of 64.\n"); |
| goto out; |
| } |
| |
| /* Ensure block sizes all add up to at most |length|. */ |
| uint64_t block_total = sizeof(AvbVBMetaImageHeader); |
| if (!avb_safe_add_to(&block_total, h.authentication_data_block_size) || |
| !avb_safe_add_to(&block_total, h.auxiliary_data_block_size)) { |
| avb_error("Overflow while computing size of boot image.\n"); |
| goto out; |
| } |
| if (block_total > length) { |
| avb_error("Block sizes add up to more than given length.\n"); |
| goto out; |
| } |
| |
| uintptr_t data_ptr = (uintptr_t)data; |
| /* Ensure passed in memory doesn't wrap. */ |
| if (!avb_safe_add(NULL, (uint64_t)data_ptr, length)) { |
| avb_error("Boot image location and length mismatch.\n"); |
| goto out; |
| } |
| |
| /* Ensure hash and signature are entirely in the Authentication data block. */ |
| uint64_t hash_end; |
| if (!avb_safe_add(&hash_end, h.hash_offset, h.hash_size) || |
| hash_end > h.authentication_data_block_size) { |
| avb_error("Hash is not entirely in its block.\n"); |
| goto out; |
| } |
| uint64_t signature_end; |
| if (!avb_safe_add(&signature_end, h.signature_offset, h.signature_size) || |
| signature_end > h.authentication_data_block_size) { |
| avb_error("Signature is not entirely in its block.\n"); |
| goto out; |
| } |
| |
| /* Ensure public key is entirely in the Auxiliary data block. */ |
| uint64_t pubkey_end; |
| if (!avb_safe_add(&pubkey_end, h.public_key_offset, h.public_key_size) || |
| pubkey_end > h.auxiliary_data_block_size) { |
| avb_error("Public key is not entirely in its block.\n"); |
| goto out; |
| } |
| |
| /* Ensure public key metadata (if set) is entirely in the Auxiliary |
| * data block. */ |
| if (h.public_key_metadata_size > 0) { |
| uint64_t pubkey_md_end; |
| if (!avb_safe_add(&pubkey_md_end, |
| h.public_key_metadata_offset, |
| h.public_key_metadata_size) || |
| pubkey_md_end > h.auxiliary_data_block_size) { |
| avb_error("Public key metadata is not entirely in its block.\n"); |
| goto out; |
| } |
| } |
| |
| /* Bail early if there's no hash or signature. */ |
| if (h.algorithm_type == AVB_ALGORITHM_TYPE_NONE) { |
| ret = AVB_VBMETA_VERIFY_RESULT_OK_NOT_SIGNED; |
| goto out; |
| } |
| |
| /* Ensure algorithm field is supported. */ |
| algorithm = avb_get_algorithm_data(h.algorithm_type); |
| if (!algorithm) { |
| avb_error("Invalid or unknown algorithm.\n"); |
| goto out; |
| } |
| |
| /* Bail if the embedded hash size doesn't match the chosen algorithm. */ |
| if (h.hash_size != algorithm->hash_len) { |
| avb_error("Embedded hash has wrong size.\n"); |
| goto out; |
| } |
| |
| /* No overflow checks needed from here-on after since all block |
| * sizes and offsets have been verified above. |
| */ |
| |
| header_block = data; |
| authentication_block = header_block + sizeof(AvbVBMetaImageHeader); |
| auxiliary_block = authentication_block + h.authentication_data_block_size; |
| |
| switch (h.algorithm_type) { |
| /* Explicit fall-through: */ |
| case AVB_ALGORITHM_TYPE_SHA256_RSA2048: |
| case AVB_ALGORITHM_TYPE_SHA256_RSA4096: |
| case AVB_ALGORITHM_TYPE_SHA256_RSA8192: |
| avb_sha256_init(&sha256_ctx); |
| avb_sha256_update( |
| &sha256_ctx, header_block, sizeof(AvbVBMetaImageHeader)); |
| avb_sha256_update( |
| &sha256_ctx, auxiliary_block, h.auxiliary_data_block_size); |
| computed_hash = avb_sha256_final(&sha256_ctx); |
| break; |
| /* Explicit fall-through: */ |
| case AVB_ALGORITHM_TYPE_SHA512_RSA2048: |
| case AVB_ALGORITHM_TYPE_SHA512_RSA4096: |
| case AVB_ALGORITHM_TYPE_SHA512_RSA8192: |
| avb_sha512_init(&sha512_ctx); |
| avb_sha512_update( |
| &sha512_ctx, header_block, sizeof(AvbVBMetaImageHeader)); |
| avb_sha512_update( |
| &sha512_ctx, auxiliary_block, h.auxiliary_data_block_size); |
| computed_hash = avb_sha512_final(&sha512_ctx); |
| break; |
| default: |
| avb_error("Unknown algorithm.\n"); |
| goto out; |
| } |
| |
| if (avb_safe_memcmp(authentication_block + h.hash_offset, |
| computed_hash, |
| h.hash_size) != 0) { |
| avb_error("Hash does not match!\n"); |
| ret = AVB_VBMETA_VERIFY_RESULT_HASH_MISMATCH; |
| goto out; |
| } |
| |
| verification_result = |
| avb_rsa_verify(auxiliary_block + h.public_key_offset, |
| h.public_key_size, |
| authentication_block + h.signature_offset, |
| h.signature_size, |
| authentication_block + h.hash_offset, |
| h.hash_size, |
| algorithm->padding, |
| algorithm->padding_len); |
| |
| if (verification_result == 0) { |
| ret = AVB_VBMETA_VERIFY_RESULT_SIGNATURE_MISMATCH; |
| goto out; |
| } |
| |
| if (h.public_key_size > 0) { |
| if (out_public_key_data != NULL) { |
| *out_public_key_data = auxiliary_block + h.public_key_offset; |
| } |
| if (out_public_key_length != NULL) { |
| *out_public_key_length = h.public_key_size; |
| } |
| } |
| |
| ret = AVB_VBMETA_VERIFY_RESULT_OK; |
| |
| out: |
| return ret; |
| } |
| |
| void avb_vbmeta_image_header_to_host_byte_order(const AvbVBMetaImageHeader* src, |
| AvbVBMetaImageHeader* dest) { |
| avb_memcpy(dest, src, sizeof(AvbVBMetaImageHeader)); |
| |
| dest->required_libavb_version_major = |
| avb_be32toh(dest->required_libavb_version_major); |
| dest->required_libavb_version_minor = |
| avb_be32toh(dest->required_libavb_version_minor); |
| |
| dest->authentication_data_block_size = |
| avb_be64toh(dest->authentication_data_block_size); |
| dest->auxiliary_data_block_size = |
| avb_be64toh(dest->auxiliary_data_block_size); |
| |
| dest->algorithm_type = avb_be32toh(dest->algorithm_type); |
| |
| dest->hash_offset = avb_be64toh(dest->hash_offset); |
| dest->hash_size = avb_be64toh(dest->hash_size); |
| |
| dest->signature_offset = avb_be64toh(dest->signature_offset); |
| dest->signature_size = avb_be64toh(dest->signature_size); |
| |
| dest->public_key_offset = avb_be64toh(dest->public_key_offset); |
| dest->public_key_size = avb_be64toh(dest->public_key_size); |
| |
| dest->public_key_metadata_offset = |
| avb_be64toh(dest->public_key_metadata_offset); |
| dest->public_key_metadata_size = avb_be64toh(dest->public_key_metadata_size); |
| |
| dest->descriptors_offset = avb_be64toh(dest->descriptors_offset); |
| dest->descriptors_size = avb_be64toh(dest->descriptors_size); |
| |
| dest->rollback_index = avb_be64toh(dest->rollback_index); |
| dest->flags = avb_be32toh(dest->flags); |
| } |
| |
| const char* avb_vbmeta_verify_result_to_string(AvbVBMetaVerifyResult result) { |
| const char* ret = NULL; |
| |
| switch (result) { |
| case AVB_VBMETA_VERIFY_RESULT_OK: |
| ret = "OK"; |
| break; |
| case AVB_VBMETA_VERIFY_RESULT_OK_NOT_SIGNED: |
| ret = "OK_NOT_SIGNED"; |
| break; |
| case AVB_VBMETA_VERIFY_RESULT_INVALID_VBMETA_HEADER: |
| ret = "INVALID_VBMETA_HEADER"; |
| break; |
| case AVB_VBMETA_VERIFY_RESULT_UNSUPPORTED_VERSION: |
| ret = "UNSUPPORTED_VERSION"; |
| break; |
| case AVB_VBMETA_VERIFY_RESULT_HASH_MISMATCH: |
| ret = "HASH_MISMATCH"; |
| break; |
| case AVB_VBMETA_VERIFY_RESULT_SIGNATURE_MISMATCH: |
| ret = "SIGNATURE_MISMATCH"; |
| break; |
| /* Do not add a 'default:' case here because of -Wswitch. */ |
| } |
| |
| if (ret == NULL) { |
| avb_error("Unknown AvbVBMetaVerifyResult value.\n"); |
| ret = "(unknown)"; |
| } |
| |
| return ret; |
| } |