// // Copyright (C) 2015 The Android Open Source Project // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // #ifndef TPM_MANAGER_SERVER_TPM_INITIALIZER_IMPL_H_ #define TPM_MANAGER_SERVER_TPM_INITIALIZER_IMPL_H_ #include <string> #include <base/macros.h> #include <trousers/tss.h> #include <trousers/trousers.h> // NOLINT(build/include_alpha) #include "tpm_manager/server/openssl_crypto_util_impl.h" #include "tpm_manager/server/tpm_connection.h" #include "tpm_manager/server/tpm_initializer.h" namespace tpm_manager { class LocalDataStore; class TpmStatus; // This class initializes a Tpm1.2 chip by taking ownership. Example use of // this class is: // LocalDataStore data_store; // TpmStatusImpl status; // TpmInitializerImpl initializer(&data_store, &status); // initializer.InitializeTpm(); // If the tpm is unowned, InitializeTpm injects a random owner password, // initializes and unrestricts the SRK, and persists the owner password to disk // until all the owner dependencies are satisfied. class TpmInitializerImpl : public TpmInitializer { public: // Does not take ownership of |local_data_store| or |tpm_status|. TpmInitializerImpl(LocalDataStore* local_data_store, TpmStatus* tpm_status); ~TpmInitializerImpl() override = default; // TpmInitializer methods. bool InitializeTpm() override; private: // This method checks if an EndorsementKey exists on the Tpm and creates it // if not. Returns true on success, else false. |tpm_handle| is a handle to // the Tpm with the owner_password injected. bool InitializeEndorsementKey(TSS_HTPM tpm_handle); // This method takes ownership of the Tpm with the default TSS password. // Returns true on success, else false. |tpm_handle| is a handle to the Tpm // with the owner_password injected. bool TakeOwnership(TSS_HTPM tpm_handle); // This method initializes the SRK if it does not exist, zero's the SRK // password and unrestricts its usage. Returns true on success, else false. // |tpm_handle| is a handle to the Tpm with the owner_password injected. bool InitializeSrk(TSS_HTPM tpm_handle); // This method changes the Tpm owner password from the default TSS password // to the password provided in the |owner_password| argument. // Returns true on success, else false. |tpm_handle| is a handle to the Tpm // with the old owner_password injected. bool ChangeOwnerPassword(TSS_HTPM tpm_handle, const std::string& owner_password); // This method return true iff the provided |owner_password| is the current // owner password in the Tpm. This method can also return false if there was // an error communicating with the Tpm. bool TestTpmAuth(const std::string& owner_password); OpensslCryptoUtilImpl openssl_util_; TpmConnection tpm_connection_; LocalDataStore* local_data_store_; TpmStatus* tpm_status_; DISALLOW_COPY_AND_ASSIGN(TpmInitializerImpl); }; } // namespace tpm_manager #endif // TPM_MANAGER_SERVER_TPM_INITIALIZER_IMPL_H_