SysTutorials Posts

TCG Software Stack Developer’s Reference Name Tspi_Key_LoadKey – load a key into the TPM Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Key_LoadKey(TSS_HKEY hKey, TSS_HKEY hUnwrappingKey); Description Tspi_Key_LoadKey loads the key referenced by hKey into the TPM. Parameters hKey The hKey parameter is the handle of the…

TCG Software Stack Developer’s Reference Name Tspi_Key_GetPubKey – get the public key of an object Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Key_GetPubKey(TSS_HKEY hKey, UINT32* pulPubKeyLength, BYTE** prgbPubKey); Description Tspi_Key_GetPubKey gets the public portion of a given key object. Parameters hKey The hKey parameter is the…

Tspi_Key_CreateMigrationBlob – create a key blob suitable for migrating to another TPM. Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Key_CreateMigrationBlob(TSS_HKEY hKeyToMigrate, TSS_HKEY hParentKey, UINT32 ulMigTicketLength, BYTE* rgbMigTicket, UINT32* pulRandomLength, BYTE** prgbRandom, UINT32* pulMigrationBlobLength, BYTE** prgbMigrationBlob); Description Tspi_Key_CreateMigrationBlob returns a key blob containing an encrypted section, which…

Tspi_Key_CreateKey – create a key pair within the TPM, wrapping it with the key addressed by hWrappingKey. Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Key_CreateKey(TSS_HKEY hKey, TSS_HKEY hWrappingKey, TSS_HPCRS hPcrComposite); Description TSS_Key_CreateKey calls the TPM command TPM_CreateWrapKey. If hPcrComposite is not set to NULL, the created…

TCG Software Stack Developer’s Reference Name Tspi_Key_ConvertMigrationBlob – create a wrapped key from a migration blob Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Key_ConvertMigrationBlob(TSS_HKEY hKeyToMigrate, TSS_HKEY hParentKey, UINT32 ulRandomLength, BYTE* rgbRandom, UINT32 ulMigrationBlobLength, BYTE* rgbMigrationBlob); Description Tspi_Key_ConvertMigrationBlob takes the migration blob built by Tspi_Key_CreateMigrationBlob using the…

Tspi_Key_CertifyKey – sign a public key. Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Key_CertifyKey(TSS_HKEY hKey, TSS_HKEY hCertifyingKey, TSS_VALIDATION* pValidationData); Description Tspi_Key_CertifyKey signs a public key. Parameters hKey Handle of the key object to be loaded. hCertifyingKey Handle to the certifying key used to sign the addressed…

TCG Software Stack Developer’s Reference Name Tspi_Hash_VerifySignature – verify the hash value with a given signature Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Hash_VerifySignature(TSS_HHASH hHash, TSS_HKEY hKey, UINT32 ulSignatureLength, BYTE* rgbSignature); Description Tspi_Hash_VerifySignature verifies the hash value of a given hash object with a given signature….

TCG Software Stack Developer’s Reference Name Tspi_Hash_UpdateHashValue – update the hash value of a hash object Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Hash_UpdateHashValue(TSS_HHASH hHash, UINT32 ulDataLength, BYTE* rgbData); Description Tspi_Hash_UpdateHashValue updates the hash value of a hash object with new information. If the object was…

TCG Software Stack Developer’s Reference Name Tspi_Hash_Sign – sign the hash data of an object with a signing key Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Hash_Sign(TSS_HHASH hHash, TSS_HKEY hKey, UINT32 pulSignatureLength, BYTE** prgbSignature); Description Tspi_Hash_Sign signs the hash data of an object with a given…

TCG Software Stack Developer’s Reference Name Tspi_Hash_SetHashValue – Sets the hash value of a hash object for non-SHA1 hash objects. Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Hash_SetHashValue(TSS_HHASH hHash, UINT32 ulHashValueLength, BYTE* rgbHashValue); Description Tspi_Hash_SetHashValue sets the hash value of a hash object. If the object…

TCG Software Stack Developer’s Reference Name Tspi_Hash_GetHashValue – get the current hash value of a hash object Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Hash_GetHashValue(TSS_HHASH hHash, UINT32* pulHashValueLength, BYTE** prgbHashValue); Description Tspi_Hash_GetHashValue gets the hash value of a hash object. Tspi_Context_FreeMemory must be used to clean…

TCG Software Stack Developers Reference Name Tspi_GetPolicyObject – get a policy object assigned to a working object Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_GetPolicyObject(TSS_HOBJECT hObject, TSS_FLAG policyType, TSS_HPOLICY* phPolicy); Description Tspi_GetPolicyObject returns a policy object currently assigned to a working object. If you determine that…

TCG Software Stack Developers Reference Name Tspi_GetAttribUint32 – get the value of particular attribute associated with a given class or object Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_GetAttribUint32(TSS_HOBJECT hObject, TSS_FLAG attribFlag, TSS_FLAG subFlag, UINT32* pulAttrib); Description Tspi_GetAttribUint32 returns a specified uint32 attribute associated with a…

Tspi_GetAttribData – get a non 32bit attribute of the object. Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_GetAttribData(TSS_HOBJECT hObject, TSS_FLAG attribFlag, TSS_FLAG subFlag, UINT32* pulAttribDataSize, BYTE** prgbAttribData); Description Tspi_GetAttribData is used to get the value of a particular attribute associated iwth a particular object where that…

Tspi_EncodeDER_TssBlob – generate a DER encoded TSS blob. Synopsis #include <tss/tspi.h> TSS_RESULT Tspi_EncodeDER_TssBlob(UINT32 rawBlobSize, BYTE* rawBlob, UINT32 blobType, UINT32* derBlobSize, BYTE* derBlob); Description Tspi_EncodeDER_TssBlob is used to generate a DER-encoded blob in accordance with the ASN.1 data definitions in the Portable Data section of the Trusted Computing Group Software Stack Specification Version 1.2. Parameters rawBlobSize…

Tspi_DecodeBER_TssBlob – unwraps a BER-encoded TSS blob. Synopsis #include <tss/tspi.h> TSS_RESULT Tspi_DecodeBER_TssBlob(UINT32 berBlobSize, BYTE* berBlob, UINT32* blobType, UINT32* rawBlobSize, BYTE* rawBlob); Description Tspi_DecodeBER_TssBlob is used to unwrap a BER-encoded blob in accordance with the ASN.1 data definitions in the Portable Data section of the Trusted Computing Group Software Stack Specification Version 1.2. Parameters berBlobSize Size…

Tspi_Data_Unseal – dencrypt data encrypted by Tspi_Data_Seal() only if it was encrypted on the same platform and under the current configuration. Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Data_Unseal(TSS_HENCDATA hEncData, TSS_HKEY hKey, UINT32 pulUnsealedDataLength, BYTE** prgbUnsealedData); Description Tspi_Data_Unseal reveals data encrypted by the Tspi_Data_Seal only if…

TCG Software Stack Developer’s Reference Name Tspi_Data_Unbind – Decrypts data that has been bound to a key Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Data_Unbind(TSS_HENCDATA hEncData, TSS_HKEY hEncKey, UINT32* pulUnboundDataLength, BYTE** prgbUnboundData); Description Tspi_Data_Unbind decrypts the encrypted data blob exportedfrom the data object used in Tspi_Data_Bind….

Tspi_Data_Seal – encrypt a data blob in a mannar that is only decryptable by Tspi_Data_Unseal on the same system. Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Data_Seal(TSS_HENCDATA hEncData, TSS_HKEY hEncKey, UINT32 ulDataLength, BYTE* rgbDataToSeal, TSS_HPCRS hPcrComposite); Description Tspi_Data_Seal encrypts a data blob in a mannar that…

TCG Software Stack Developer’s Reference Name Tspi_Data_Bind – Encrypts a data blob Synopsis #include <tss/platform.h> #include <tss/tcpa_defines.h> #include <tss/tcpa_typedef.h> #include <tss/tcpa_struct.h> #include <tss/tss_typedef.h> #include <tss/tss_structs.h> #include <tss/tspi.h> TSS_RESULT Tspi_Data_Bind(TSS_HENCDATA hEncData, TSS_HKEY hEncKey, UINT32 ulDataLength, BYTE* rgbDataToBind); Description Tspi_Data_Bind encrypts a data blob in a manner that is decryptable by Tspi_Data_Unbind. The data blob is encrypted…