blob: c9a156d3e6988a945b82b15935ec4ed64da7ffa5 [file] [log] [blame]
/*
* Copyright (C) 2021 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#define LOG_TAG "keymint_2_se_provisioning_test"
#include <map>
#include <memory>
#include <vector>
#include <android-base/logging.h>
#include <android/binder_manager.h>
#include <cppbor_parse.h>
#include <keymaster/cppcose/cppcose.h>
#include <keymint_support/key_param_output.h>
#include "KeyMintAidlTestBase.h"
namespace aidl::android::hardware::security::keymint::test {
using std::array;
using std::map;
using std::shared_ptr;
using std::vector;
constexpr int kRoTVersion1 = 40001;
class SecureElementProvisioningTest : public testing::Test {
protected:
static void SetUpTestSuite() {
auto params = ::android::getAidlHalInstanceNames(IKeyMintDevice::descriptor);
for (auto& param : params) {
ASSERT_TRUE(AServiceManager_isDeclared(param.c_str()))
<< "IKeyMintDevice instance " << param << " found but not declared.";
::ndk::SpAIBinder binder(AServiceManager_waitForService(param.c_str()));
auto keymint = IKeyMintDevice::fromBinder(binder);
ASSERT_NE(keymint, nullptr) << "Failed to get IKeyMintDevice instance " << param;
KeyMintHardwareInfo info;
ASSERT_TRUE(keymint->getHardwareInfo(&info).isOk());
ASSERT_EQ(keymints_.count(info.securityLevel), 0)
<< "There must be exactly one IKeyMintDevice with security level "
<< info.securityLevel;
keymints_[info.securityLevel] = std::move(keymint);
}
}
void validateMacedRootOfTrust(const vector<uint8_t>& rootOfTrust) {
SCOPED_TRACE(testing::Message() << "RoT: " << bin2hex(rootOfTrust));
const auto [macItem, macEndPos, macErrMsg] = cppbor::parse(rootOfTrust);
ASSERT_TRUE(macItem) << "Root of trust parsing failed: " << macErrMsg;
ASSERT_EQ(macItem->semanticTagCount(), 1);
ASSERT_EQ(macItem->semanticTag(0), cppcose::kCoseMac0SemanticTag);
ASSERT_TRUE(macItem->asArray());
ASSERT_EQ(macItem->asArray()->size(), cppcose::kCoseMac0EntryCount);
const auto& protectedItem = macItem->asArray()->get(cppcose::kCoseMac0ProtectedParams);
ASSERT_TRUE(protectedItem);
ASSERT_TRUE(protectedItem->asBstr());
const auto [protMap, protEndPos, protErrMsg] = cppbor::parse(protectedItem->asBstr());
ASSERT_TRUE(protMap);
ASSERT_TRUE(protMap->asMap());
ASSERT_EQ(protMap->asMap()->size(), 1);
const auto& algorithm = protMap->asMap()->get(cppcose::ALGORITHM);
ASSERT_TRUE(algorithm);
ASSERT_TRUE(algorithm->asInt());
ASSERT_EQ(algorithm->asInt()->value(), cppcose::HMAC_256);
const auto& unprotItem = macItem->asArray()->get(cppcose::kCoseMac0UnprotectedParams);
ASSERT_TRUE(unprotItem);
ASSERT_TRUE(unprotItem->asMap());
ASSERT_EQ(unprotItem->asMap()->size(), 0);
const auto& payload = macItem->asArray()->get(cppcose::kCoseMac0Payload);
ASSERT_TRUE(payload);
ASSERT_TRUE(payload->asBstr());
validateRootOfTrust(payload->asBstr()->value());
const auto& tag = macItem->asArray()->get(cppcose::kCoseMac0Tag);
ASSERT_TRUE(tag);
ASSERT_TRUE(tag->asBstr());
ASSERT_EQ(tag->asBstr()->value().size(), 32);
// Cannot validate tag correctness. Only the secure side has the necessary key.
}
void validateRootOfTrust(const vector<uint8_t>& payload) {
SCOPED_TRACE(testing::Message() << "RoT payload: " << bin2hex(payload));
const auto [rot, rotPos, rotErrMsg] = cppbor::parse(payload);
ASSERT_TRUE(rot);
ASSERT_EQ(rot->semanticTagCount(), 1);
ASSERT_EQ(rot->semanticTag(), kRoTVersion1);
ASSERT_TRUE(rot->asArray());
ASSERT_EQ(rot->asArray()->size(), 5);
size_t pos = 0;
const auto& vbKey = rot->asArray()->get(pos++);
ASSERT_TRUE(vbKey);
ASSERT_TRUE(vbKey->asBstr());
const auto& deviceLocked = rot->asArray()->get(pos++);
ASSERT_TRUE(deviceLocked);
ASSERT_TRUE(deviceLocked->asBool());
const auto& verifiedBootState = rot->asArray()->get(pos++);
ASSERT_TRUE(verifiedBootState);
ASSERT_TRUE(verifiedBootState->asInt());
const auto& verifiedBootHash = rot->asArray()->get(pos++);
ASSERT_TRUE(verifiedBootHash);
ASSERT_TRUE(verifiedBootHash->asBstr());
const auto& bootPatchLevel = rot->asArray()->get(pos++);
ASSERT_TRUE(bootPatchLevel);
ASSERT_TRUE(bootPatchLevel->asInt());
verify_root_of_trust(vbKey->asBstr()->value(), deviceLocked->asBool()->value(),
static_cast<VerifiedBoot>(verifiedBootState->asInt()->value()),
verifiedBootHash->asBstr()->value());
}
int32_t AidlVersion(shared_ptr<IKeyMintDevice> keymint) {
int32_t version = 0;
auto status = keymint->getInterfaceVersion(&version);
if (!status.isOk()) {
ADD_FAILURE() << "Failed to determine interface version";
}
return version;
}
static map<SecurityLevel, shared_ptr<IKeyMintDevice>> keymints_;
};
map<SecurityLevel, shared_ptr<IKeyMintDevice>> SecureElementProvisioningTest::keymints_;
TEST_F(SecureElementProvisioningTest, ValidConfigurations) {
if (keymints_.empty()) {
GTEST_SKIP() << "Test not applicable to device with no KeyMint devices";
}
// TEE is required
ASSERT_EQ(keymints_.count(SecurityLevel::TRUSTED_ENVIRONMENT), 1);
// StrongBox is optional
ASSERT_LE(keymints_.count(SecurityLevel::STRONGBOX), 1);
}
TEST_F(SecureElementProvisioningTest, TeeOnly) {
if (keymints_.count(SecurityLevel::TRUSTED_ENVIRONMENT) == 0) {
GTEST_SKIP() << "Test not applicable to device with no TEE KeyMint device";
}
auto tee = keymints_.find(SecurityLevel::TRUSTED_ENVIRONMENT)->second;
// Execute the test only for KeyMint version >= 2.
if (AidlVersion(tee) < 2) {
GTEST_SKIP() << "Test not applicable to TEE KeyMint device before v2";
}
array<uint8_t, 16> challenge1 = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
array<uint8_t, 16> challenge2 = {1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
vector<uint8_t> rootOfTrust1;
Status result = tee->getRootOfTrust(challenge1, &rootOfTrust1);
ASSERT_TRUE(result.isOk()) << "getRootOfTrust returned " << result.getServiceSpecificError();
validateMacedRootOfTrust(rootOfTrust1);
vector<uint8_t> rootOfTrust2;
result = tee->getRootOfTrust(challenge2, &rootOfTrust2);
ASSERT_TRUE(result.isOk());
validateMacedRootOfTrust(rootOfTrust2);
ASSERT_NE(rootOfTrust1, rootOfTrust2);
vector<uint8_t> rootOfTrust3;
result = tee->getRootOfTrust(challenge1, &rootOfTrust3);
ASSERT_TRUE(result.isOk());
ASSERT_EQ(rootOfTrust1, rootOfTrust3);
}
TEST_F(SecureElementProvisioningTest, TeeDoesNotImplementStrongBoxMethods) {
if (keymints_.count(SecurityLevel::TRUSTED_ENVIRONMENT) == 0) {
GTEST_SKIP() << "Test not applicable to device with no TEE KeyMint device";
}
auto tee = keymints_.find(SecurityLevel::TRUSTED_ENVIRONMENT)->second;
// Execute the test only for KeyMint version >= 2.
if (AidlVersion(tee) < 2) {
GTEST_SKIP() << "Test not applicable to TEE KeyMint device before v2";
}
array<uint8_t, 16> challenge;
Status result = tee->getRootOfTrustChallenge(&challenge);
ASSERT_FALSE(result.isOk());
ASSERT_EQ(result.getExceptionCode(), EX_SERVICE_SPECIFIC);
ASSERT_EQ(static_cast<ErrorCode>(result.getServiceSpecificError()), ErrorCode::UNIMPLEMENTED);
result = tee->sendRootOfTrust({});
ASSERT_FALSE(result.isOk());
ASSERT_EQ(result.getExceptionCode(), EX_SERVICE_SPECIFIC);
ASSERT_EQ(static_cast<ErrorCode>(result.getServiceSpecificError()), ErrorCode::UNIMPLEMENTED);
}
TEST_F(SecureElementProvisioningTest, StrongBoxDoesNotImplementTeeMethods) {
if (keymints_.count(SecurityLevel::STRONGBOX) == 0) {
// Need a StrongBox to provision.
GTEST_SKIP() << "Test not applicable to device with no StrongBox KeyMint device";
}
// Execute the test only for KeyMint version >= 2.
auto sb = keymints_.find(SecurityLevel::STRONGBOX)->second;
if (AidlVersion(sb) < 2) {
GTEST_SKIP() << "Test not applicable to StrongBox KeyMint device before v2";
}
vector<uint8_t> rootOfTrust;
Status result = sb->getRootOfTrust({}, &rootOfTrust);
ASSERT_FALSE(result.isOk());
ASSERT_EQ(result.getExceptionCode(), EX_SERVICE_SPECIFIC);
ASSERT_EQ(static_cast<ErrorCode>(result.getServiceSpecificError()), ErrorCode::UNIMPLEMENTED);
}
TEST_F(SecureElementProvisioningTest, UnimplementedTest) {
if (keymints_.count(SecurityLevel::STRONGBOX) == 0) {
// Need a StrongBox to provision.
GTEST_SKIP() << "Test not applicable to device with no StrongBox KeyMint device";
}
// Execute the test only for KeyMint version >= 2.
auto sb = keymints_.find(SecurityLevel::STRONGBOX)->second;
if (AidlVersion(sb) < 2) {
GTEST_SKIP() << "Test not applicable to StrongBox KeyMint device before v2";
}
if (keymints_.count(SecurityLevel::TRUSTED_ENVIRONMENT) == 0) {
GTEST_SKIP() << "Test not applicable to device with no TEE KeyMint device";
}
auto tee = keymints_.find(SecurityLevel::TRUSTED_ENVIRONMENT)->second;
if (AidlVersion(tee) < 2) {
GTEST_SKIP() << "Test not applicable to TEE KeyMint device before v2";
}
array<uint8_t, 16> challenge;
Status result = sb->getRootOfTrustChallenge(&challenge);
if (!result.isOk()) {
// Strongbox does not have to implement this feature if it has uses an alternative mechanism
// to provision the root of trust. In that case it MUST return UNIMPLEMENTED, both from
// getRootOfTrustChallenge() and from sendRootOfTrust().
ASSERT_EQ(result.getExceptionCode(), EX_SERVICE_SPECIFIC);
ASSERT_EQ(static_cast<ErrorCode>(result.getServiceSpecificError()),
ErrorCode::UNIMPLEMENTED);
result = sb->sendRootOfTrust({});
ASSERT_EQ(result.getExceptionCode(), EX_SERVICE_SPECIFIC);
ASSERT_EQ(static_cast<ErrorCode>(result.getServiceSpecificError()),
ErrorCode::UNIMPLEMENTED);
SUCCEED() << "This Strongbox implementation does not use late root of trust delivery.";
return;
}
}
TEST_F(SecureElementProvisioningTest, ChallengeQualityTest) {
if (keymints_.count(SecurityLevel::STRONGBOX) == 0) {
// Need a StrongBox to provision.
GTEST_SKIP() << "Test not applicable to device with no StrongBox KeyMint device";
}
// Execute the test only for KeyMint version >= 2.
auto sb = keymints_.find(SecurityLevel::STRONGBOX)->second;
if (AidlVersion(sb) < 2) {
GTEST_SKIP() << "Test not applicable to StrongBox KeyMint device before v2";
}
array<uint8_t, 16> challenge1;
Status result = sb->getRootOfTrustChallenge(&challenge1);
if (!result.isOk()) return;
array<uint8_t, 16> challenge2;
result = sb->getRootOfTrustChallenge(&challenge2);
ASSERT_TRUE(result.isOk());
ASSERT_NE(challenge1, challenge2);
// TODO: When we add entropy testing in other relevant places in these tests, add it here, too,
// to verify that challenges appear to have adequate entropy.
}
TEST_F(SecureElementProvisioningTest, ProvisioningTest) {
if (keymints_.count(SecurityLevel::STRONGBOX) == 0) {
// Need a StrongBox to provision.
GTEST_SKIP() << "Test not applicable to device with no StrongBox KeyMint device";
}
// Execute the test only for KeyMint version >= 2.
auto sb = keymints_.find(SecurityLevel::STRONGBOX)->second;
if (AidlVersion(sb) < 2) {
GTEST_SKIP() << "Test not applicable to StrongBox KeyMint device before v2";
}
if (keymints_.count(SecurityLevel::TRUSTED_ENVIRONMENT) == 0) {
GTEST_SKIP() << "Test not applicable to device with no TEE KeyMint device";
}
// Execute the test only for KeyMint version >= 2.
auto tee = keymints_.find(SecurityLevel::TRUSTED_ENVIRONMENT)->second;
if (AidlVersion(tee) < 2) {
GTEST_SKIP() << "Test not applicable to TEE KeyMint device before v2";
}
array<uint8_t, 16> challenge;
Status result = sb->getRootOfTrustChallenge(&challenge);
if (!result.isOk()) return;
vector<uint8_t> rootOfTrust;
result = tee->getRootOfTrust(challenge, &rootOfTrust);
ASSERT_TRUE(result.isOk());
validateMacedRootOfTrust(rootOfTrust);
result = sb->sendRootOfTrust(rootOfTrust);
ASSERT_TRUE(result.isOk());
// Sending again must fail, because a new challenge is required.
result = sb->sendRootOfTrust(rootOfTrust);
ASSERT_FALSE(result.isOk());
}
TEST_F(SecureElementProvisioningTest, InvalidProvisioningTest) {
if (keymints_.count(SecurityLevel::STRONGBOX) == 0) {
// Need a StrongBox to provision.
GTEST_SKIP() << "Test not applicable to device with no StrongBox KeyMint device";
}
// Execute the test only for KeyMint version >= 2.
auto sb = keymints_.find(SecurityLevel::STRONGBOX)->second;
if (AidlVersion(sb) < 2) {
GTEST_SKIP() << "Test not applicable to StrongBox KeyMint device before v2";
}
if (keymints_.count(SecurityLevel::TRUSTED_ENVIRONMENT) == 0) {
GTEST_SKIP() << "Test not applicable to device with no TEE KeyMint device";
}
// Execute the test only for KeyMint version >= 2.
auto tee = keymints_.find(SecurityLevel::TRUSTED_ENVIRONMENT)->second;
if (AidlVersion(tee) < 2) {
GTEST_SKIP() << "Test not applicable to TEE KeyMint device before v2";
}
array<uint8_t, 16> challenge;
Status result = sb->getRootOfTrustChallenge(&challenge);
if (!result.isOk()) return;
result = sb->sendRootOfTrust({});
ASSERT_FALSE(result.isOk());
ASSERT_EQ(result.getExceptionCode(), EX_SERVICE_SPECIFIC);
ASSERT_EQ(static_cast<ErrorCode>(result.getServiceSpecificError()),
ErrorCode::VERIFICATION_FAILED);
vector<uint8_t> rootOfTrust;
result = tee->getRootOfTrust(challenge, &rootOfTrust);
ASSERT_TRUE(result.isOk());
validateMacedRootOfTrust(rootOfTrust);
vector<uint8_t> corruptedRootOfTrust = rootOfTrust;
corruptedRootOfTrust[corruptedRootOfTrust.size() / 2]++;
result = sb->sendRootOfTrust(corruptedRootOfTrust);
ASSERT_FALSE(result.isOk());
ASSERT_EQ(result.getExceptionCode(), EX_SERVICE_SPECIFIC);
ASSERT_EQ(static_cast<ErrorCode>(result.getServiceSpecificError()),
ErrorCode::VERIFICATION_FAILED);
// Now try the correct RoT
result = sb->sendRootOfTrust(rootOfTrust);
ASSERT_TRUE(result.isOk());
}
} // namespace aidl::android::hardware::security::keymint::test