#ifndef TREZORHAL_SECRET_H #define TREZORHAL_SECRET_H #include #include "secbool.h" #ifdef KERNEL_MODE #define SECRET_HEADER_MAGIC "TRZS" #define SECRET_HEADER_LEN 16 #define SECRET_OPTIGA_KEY_OFFSET 16 #define SECRET_OPTIGA_KEY_LEN 32 #define SECRET_MONOTONIC_COUNTER_OFFSET 48 #define SECRET_MONOTONIC_COUNTER_LEN 1024 #define SECRET_MONOTONIC_COUNTER2_OFFSET (SECRET_MONOTONIC_COUNTER_LEN + 48) #define SECRET_BHK_OFFSET (1024 * 8) #define SECRET_BHK_LEN 32 // Writes data to the secret storage void secret_write(const uint8_t* data, uint32_t offset, uint32_t len); // Reads data from the secret storage secbool secret_read(uint8_t* data, uint32_t offset, uint32_t len); // Checks if the secret storage has been wiped secbool secret_wiped(void); // Verifies that the secret storage has correct header secbool secret_verify_header(void); // Checks that the secret storage is initialized and initializes it if not secbool secret_ensure_initialized(void); // Erases the entire secret storage void secret_erase(void); // Writes the secret header to the secret storage void secret_write_header(void); // Writes optiga pairing secret to the secret storage // Encrypts the secret if encryption is available on the platform // Returns true if the secret was written successfully secbool secret_optiga_set(const uint8_t secret[SECRET_OPTIGA_KEY_LEN]); // Reads optiga pairing secret // Decrypts the secret if encryption is available on the platform // Returns true if the secret was read successfully // Reading can fail if optiga is not paired, the pairing secret was not // provisioned to the firmware (by calling secret_optiga_backup), or the secret // was made unavailable by calling secret_optiga_hide secbool secret_optiga_get(uint8_t dest[SECRET_OPTIGA_KEY_LEN]); // Checks if the optiga pairing secret is present in the secret storage secbool secret_optiga_present(void); // Checks if the optiga pairing secret can be written to the secret storage secbool secret_optiga_writable(void); // Erases optiga pairing secret from the secret storage void secret_optiga_erase(void); // Regenerates the BHK and writes it to the secret storage void secret_bhk_regenerate(void); // Prepares the secret storage for running the firmware // Provisions secrets/keys to the firmware, depending on the trust level // Disables access to the secret storage until next reset, if possible // This function is called by the bootloader before starting the firmware void secret_prepare_fw(secbool allow_run_with_secret, secbool trust_all); #endif // KERNEL_MODE // Checks if bootloader is locked, that is the secret storage contains optiga // pairing secret on platforms where access to the secret storage cannot be // restricted for unofficial firmware secbool secret_bootloader_locked(void); #endif // TREZORHAL_SECRET_H