taf_ks_interface.h File Reference

#include "legato.h"
#include "le_limit_interface.h"
#include "taf_ks_common.h"

Go to the source code of this file.

Typedefs
typedef void(*	taf_ks_DisconnectHandler_t) (void *)

Functions
void	taf_ks_ConnectService (void)
le_result_t	taf_ks_TryConnectService (void)
LE_FULL_API void	taf_ks_SetServerDisconnectHandler (taf_ks_DisconnectHandler_t disconnectHandler, void *contextPtr)
LE_FULL_API void	taf_ks_SetNonExitServerDisconnectHandler (taf_ks_DisconnectHandler_t disconnectHandler, void *contextPtr)
void	taf_ks_DisconnectService (void)
le_result_t	taf_ks_CreateKey (const char *LE_NONNULL keyName, taf_ks_KeyUsage_t keyUsage, taf_ks_KeyRef_t *keyRefPtr)
le_result_t	taf_ks_GetKey (const char *LE_NONNULL keyName, taf_ks_KeyRef_t *keyRefPtr)
le_result_t	taf_ks_DeleteKey (taf_ks_KeyRef_t keyRef)
le_result_t	taf_ks_GetKeyUsage (taf_ks_KeyRef_t keyRef, taf_ks_KeyUsage_t *keyUsagePtr)
le_result_t	taf_ks_SetKeyMaxUsesPerBoot (taf_ks_KeyRef_t keyRef, uint32_t value)
le_result_t	taf_ks_SetKeyMinSecondsBetweenOps (taf_ks_KeyRef_t keyRef, uint32_t value)
le_result_t	taf_ks_SetKeyAppData (taf_ks_KeyRef_t keyRef, const uint8_t *dataPtr, size_t dataSize)
le_result_t	taf_ks_SetKeyActiveDateTime (taf_ks_KeyRef_t keyRef, uint64_t value)
le_result_t	taf_ks_SetKeyOriginationExpireDateTime (taf_ks_KeyRef_t keyRef, uint64_t value)
le_result_t	taf_ks_SetKeyUsageExpireDateTime (taf_ks_KeyRef_t keyRef, uint64_t value)
le_result_t	taf_ks_ProvisionRsaEncKeyValue (taf_ks_KeyRef_t keyRef, taf_ks_RsaKeySize_t keySize, taf_ks_RsaEncPadding_t padding, const uint8_t *impDataPtr, size_t impDataSize)
le_result_t	taf_ks_ProvisionRsaSigKeyValue (taf_ks_KeyRef_t keyRef, taf_ks_RsaKeySize_t keySize, taf_ks_RsaSigPadding_t padding, const uint8_t *impDataPtr, size_t impDataSize)
le_result_t	taf_ks_ProvisionEcdsaKeyValue (taf_ks_KeyRef_t keyRef, taf_ks_EccKeySize_t keySize, taf_ks_Digest_t digest, const uint8_t *impDataPtr, size_t impDataSize)
le_result_t	taf_ks_ProvisionAesKeyValue (taf_ks_KeyRef_t keyRef, taf_ks_AesKeySize_t keySize, taf_ks_AesBlockMode_t mode, const uint8_t *impDataPtr, size_t impDataSize)
le_result_t	taf_ks_ProvisionHmacKeyValue (taf_ks_KeyRef_t keyRef, uint32_t keySize, taf_ks_Digest_t digest, const uint8_t *impDataPtr, size_t impDataSize)
le_result_t	taf_ks_ExportKey (taf_ks_KeyRef_t keyRef, const uint8_t *appDataPtr, size_t appDataSize, uint8_t *expDataPtr, size_t *expDataSizePtr)
le_result_t	taf_ks_CryptoSessionCreate (taf_ks_KeyRef_t keyRef, taf_ks_CryptoSessionRef_t *sessionRefPtr)
le_result_t	taf_ks_CryptoSessionSetAesNonce (taf_ks_CryptoSessionRef_t sessionRef, const uint8_t *dataPtr, size_t dataSize)
le_result_t	taf_ks_CryptoSessionSetAppData (taf_ks_CryptoSessionRef_t sessionRef, const uint8_t *dataPtr, size_t dataSize)
le_result_t	taf_ks_CryptoSessionStart (taf_ks_CryptoSessionRef_t sessionRef, taf_ks_CryptoPurpose_t cryptoPurpose)
le_result_t	taf_ks_CryptoSessionProcessAead (taf_ks_CryptoSessionRef_t sessionRef, const uint8_t *dataPtr, size_t dataSize)
le_result_t	taf_ks_CryptoSessionProcess (taf_ks_CryptoSessionRef_t sessionRef, const uint8_t *inputDataPtr, size_t inputDataSize, uint8_t *outputDataPtr, size_t *outputDataSizePtr)
le_result_t	taf_ks_CryptoSessionEnd (taf_ks_CryptoSessionRef_t sessionRef, const uint8_t *inputDataPtr, size_t inputDataSize, uint8_t *outputDataPtr, size_t *outputDataSizePtr)
le_result_t	taf_ks_CryptoSessionAbort (taf_ks_CryptoSessionRef_t sessionRef)

Typedef Documentation

taf_ks_DisconnectHandler_t

typedef void(* taf_ks_DisconnectHandler_t) (void *)

Type for handler called when a server disconnects.

Function Documentation

taf_ks_ConnectService()

void taf_ks_ConnectService

(

void

)

Connect the current client thread to the service providing this API. Block until the service is available.

For each thread that wants to use this API, either ConnectService or TryConnectService must be called before any other functions in this API. Normally, ConnectService is automatically called for the main thread, but not for any other thread. For details, see apiFilesC_client.

This function is created automatically.

taf_ks_TryConnectService()

le_result_t taf_ks_TryConnectService

(

void

)

Try to connect the current client thread to the service providing this API. Return with an error if the service is not available.

For each thread that wants to use this API, either ConnectService or TryConnectService must be called before any other functions in this API. Normally, ConnectService is automatically called for the main thread, but not for any other thread. For details, see apiFilesC_client.

This function is created automatically.

Returns

• LE_OK if the client connected successfully to the service.
• LE_UNAVAILABLE if the server is not currently offering the service to which the client is bound.
• LE_NOT_PERMITTED if the client interface is not bound to any service (doesn't have a binding).
• LE_COMM_ERROR if the Service Directory cannot be reached.

taf_ks_SetServerDisconnectHandler()

LE_FULL_API void taf_ks_SetServerDisconnectHandler	(	taf_ks_DisconnectHandler_t	disconnectHandler,
		void *	contextPtr
	)

Set handler called when server disconnection is detected.

When a server connection is lost, call this handler then exit with LE_FATAL. If a program wants to continue without exiting, it should call longjmp() from inside the handler.

taf_ks_SetNonExitServerDisconnectHandler()

LE_FULL_API void taf_ks_SetNonExitServerDisconnectHandler	(	taf_ks_DisconnectHandler_t	disconnectHandler,
		void *	contextPtr
	)

Set handler called when server disconnection is detected without exiting.

When a server connection is lost, call this handler without exit.

Warning

When using the API, it needs the application developer to handle some cases like re-connecting and recycling the resources. For most of cases, it is safe to use SetServerDisconnectHandler.

taf_ks_DisconnectService()

void taf_ks_DisconnectService

(

void

)

Disconnect the current client thread from the service providing this API.

Normally, this function doesn't need to be called. After this function is called, there's no longer a connection to the service, and the functions in this API can't be used. For details, see apiFilesC_client.

This function is created automatically.

taf_ks_CreateKey()

le_result_t taf_ks_CreateKey	(	const char *LE_NONNULL	keyName,
		taf_ks_KeyUsage_t	keyUsage,
		taf_ks_KeyRef_t *	keyRefPtr
	)

Creates a new key.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_PERMITTED – Key already exists.
• LE_FAULT – Error.

Parameters

[in]	keyName	Key name.
[in]	keyUsage	Key usage.
[out]	keyRefPtr	Key reference.

taf_ks_GetKey()

le_result_t taf_ks_GetKey	(	const char *LE_NONNULL	keyName,
		taf_ks_KeyRef_t *	keyRefPtr
	)

Gets a key by key name.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – The key does not exist or is not provisioned.
• LE_FAULT – Error.

Parameters

[in]	keyName	Key name.
[out]	keyRefPtr	Key reference.

taf_ks_DeleteKey()

le_result_t taf_ks_DeleteKey

(

taf_ks_KeyRef_t

keyRef

)

Deletes a key by key reference.

Returns

• LE_OK – Succeeded.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key has a running cryptography session.
• LE_FAULT – Error.

Parameters

[in]

keyRef

Key reference.

taf_ks_GetKeyUsage()

le_result_t taf_ks_GetKeyUsage	(	taf_ks_KeyRef_t	keyRef,
		taf_ks_KeyUsage_t *	keyUsagePtr
	)

Gets a key's usage.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Key does not exist.
• LE_FAULT – Error.

Parameters

[in]	keyRef	Key reference.
[out]	keyUsagePtr	Key usage.

taf_ks_SetKeyMaxUsesPerBoot()

le_result_t taf_ks_SetKeyMaxUsesPerBoot	(	taf_ks_KeyRef_t	keyRef,
		uint32_t	value
	)

Sets the maximum number of times a key may be used between system reboots.

Returns

• LE_OK – Succeeded.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned.

Parameters

[in]	keyRef	Key reference.
[in]	value	Uses per boot.

taf_ks_SetKeyMinSecondsBetweenOps()

le_result_t taf_ks_SetKeyMinSecondsBetweenOps	(	taf_ks_KeyRef_t	keyRef,
		uint32_t	value
	)

Sets the minimum amount of time that elapses between allowed operations using a key.

Returns

• LE_OK – Succeeded.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned.

Parameters

[in]	keyRef	Key reference.
[in]	value	Seconds interval between allowed operations.

taf_ks_SetKeyAppData()

le_result_t taf_ks_SetKeyAppData	(	taf_ks_KeyRef_t	keyRef,
		const uint8_t *	dataPtr,
		size_t	dataSize
	)

Sets application data to the key.

When this attribute is provided to the key, the same data must be also provided through taf_ks_CryptoSessionSetAppData() for each cryptographic operation using the key.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned.

Parameters

[in]	keyRef	Key reference.
[in]	dataPtr	Data buffer to hold the application data.
[in]	dataSize

taf_ks_SetKeyActiveDateTime()

le_result_t taf_ks_SetKeyActiveDateTime	(	taf_ks_KeyRef_t	keyRef,
		uint64_t	value
	)

Sets the date and time at which the key becomes active. Any attempt to use the key prior to this time will fail.

Returns

• LE_OK – Succeeded.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned.

Parameters

[in]	keyRef	Key reference.
[in]	value	Milliseconds since January 1, 1970.

taf_ks_SetKeyOriginationExpireDateTime()

le_result_t taf_ks_SetKeyOriginationExpireDateTime	(	taf_ks_KeyRef_t	keyRef,
		uint64_t	value
	)

Sets the date and time at which the key expires for signing and encryption. Any attempt to use a key for signing or encryption after this time will fail.

Returns

• LE_OK – Succeeded.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned.

Parameters

[in]	keyRef	Key reference.
[in]	value	Milliseconds since January 1, 1970.

taf_ks_SetKeyUsageExpireDateTime()

le_result_t taf_ks_SetKeyUsageExpireDateTime	(	taf_ks_KeyRef_t	keyRef,
		uint64_t	value
	)

Sets the date and time at which the key expires for verification and decryption. Any attempt to use a key for verification and decryption after this time will fail.

Returns

• LE_OK – Succeeded.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned.

Parameters

[in]	keyRef	Key reference.
[in]	value	Milliseconds since January 1, 1970.

taf_ks_ProvisionRsaEncKeyValue()

le_result_t taf_ks_ProvisionRsaEncKeyValue	(	taf_ks_KeyRef_t	keyRef,
		taf_ks_RsaKeySize_t	keySize,
		taf_ks_RsaEncPadding_t	padding,
		const uint8_t *	impDataPtr,
		size_t	impDataSize
	)

Provisons or imports a RSA encryption key value to the newly created key.

The impData parameter, if provided, shall hold PKCS#8 DER format of RSA key data for import.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned, is not suitable for this provision, or is not created by the client.
• LE_FAULT – Error.

Parameters

[in]	keyRef	Key reference.
[in]	keySize	Key size. Shall match the import key size if impData is provided.
[in]	padding	Padding type of RSA encryption key.
[in]	impDataPtr	Imported key data.
[in]	impDataSize

taf_ks_ProvisionRsaSigKeyValue()

le_result_t taf_ks_ProvisionRsaSigKeyValue	(	taf_ks_KeyRef_t	keyRef,
		taf_ks_RsaKeySize_t	keySize,
		taf_ks_RsaSigPadding_t	padding,
		const uint8_t *	impDataPtr,
		size_t	impDataSize
	)

Provisions or imports a RSA signing key value to the newly created key.

The impData parameter, if provided, shall hold PKCS#8 DER format of RSA key data for import.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned, is not suitable for this provision, or is not created by the client.
• LE_FAULT – Error.

Parameters

[in]	keyRef	Key reference.
[in]	keySize	Key size. Shall match the import key size if impData is provided.
[in]	padding	Padding type of RSA signing key.
[in]	impDataPtr	Imported key data.
[in]	impDataSize

taf_ks_ProvisionEcdsaKeyValue()

le_result_t taf_ks_ProvisionEcdsaKeyValue	(	taf_ks_KeyRef_t	keyRef,
		taf_ks_EccKeySize_t	keySize,
		taf_ks_Digest_t	digest,
		const uint8_t *	impDataPtr,
		size_t	impDataSize
	)

Provisions or imports an ECDSA key value to the newly created key.

The impData parameter, if provided, shall hold PKCS#8 DER format of ECDSA key data for import.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned, is not suitable for this provision, or is not created by the client.
• LE_FAULT – Error.

Parameters

[in]	keyRef	Key reference.
[in]	keySize	Key size. Shall match the import key size if impData is provided.
[in]	digest	Digest.
[in]	impDataPtr	Imported key data.
[in]	impDataSize

taf_ks_ProvisionAesKeyValue()

le_result_t taf_ks_ProvisionAesKeyValue	(	taf_ks_KeyRef_t	keyRef,
		taf_ks_AesKeySize_t	keySize,
		taf_ks_AesBlockMode_t	mode,
		const uint8_t *	impDataPtr,
		size_t	impDataSize
	)

Provisions or imports an AES key value to the newly created key.

The impData parameter, if provided, shall hold the AES raw key data for import.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned, is not suitable for this provision, or is not created by the client.
• LE_FAULT – Error.

Parameters

[in]	keyRef	Key reference.
[in]	keySize	Key size. Shall match the import key size if impData is provided.
[in]	mode	AES block mode.
[in]	impDataPtr	Imported key data.
[in]	impDataSize

taf_ks_ProvisionHmacKeyValue()

le_result_t taf_ks_ProvisionHmacKeyValue	(	taf_ks_KeyRef_t	keyRef,
		uint32_t	keySize,
		taf_ks_Digest_t	digest,
		const uint8_t *	impDataPtr,
		size_t	impDataSize
	)

Provisions or imports a HMAC key value to the newly created key.

The impData parameter, if provided, shall hold the HMAC raw key data for import.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is already provisioned, is not suitable for this provision, or is not created by the client.
• LE_FAULT – Error.

Parameters

[in]	keyRef	Key reference.
[in]	keySize	Key size. Shall match the import key size if impData is provided.
[in]	digest	Digest.
[in]	impDataPtr	Imported key data.
[in]	impDataSize

taf_ks_ExportKey()

le_result_t taf_ks_ExportKey	(	taf_ks_KeyRef_t	keyRef,
		const uint8_t *	appDataPtr,
		size_t	appDataSize,
		uint8_t *	expDataPtr,
		size_t *	expDataSizePtr
	)

Exports a key into the specified key data format.

For asymmetric key exports the x.509 DER format (SubjectPublicKeyInfo) public key. Currently symmetric key exports are not supported.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameter(s).
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is not provisioned or the key is not created by the client.
• LE_FAULT – Error.

Parameters

[in]	keyRef	Key reference.
[in]	appDataPtr	Data buffer to hold the application data.
[in]	appDataSize
[out]	expDataPtr	Exported key data.
[in,out]	expDataSizePtr

taf_ks_CryptoSessionCreate()

le_result_t taf_ks_CryptoSessionCreate	(	taf_ks_KeyRef_t	keyRef,
		taf_ks_CryptoSessionRef_t *	sessionRefPtr
	)

Creates a cryptographic operation session for a key.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Key does not exist.
• LE_NOT_PERMITTED – Key is not provisioned.

Parameters

[in]	keyRef	Key to use for this cryptographic session.
[out]	sessionRefPtr	Session reference.

taf_ks_CryptoSessionSetAesNonce()

le_result_t taf_ks_CryptoSessionSetAesNonce	(	taf_ks_CryptoSessionRef_t	sessionRef,
		const uint8_t *	dataPtr,
		size_t	dataSize
	)

Sets the nonce or IVs for AES GCM, CBC, CTR for a cryptographic session. For AES GCM the nonce size must be 12 bytes, for AES CBC, CTR the IV must be 16 bytes.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Session or key does not exist.
• LE_NOT_PERMITTED – Key is not provisioned or the session is not created by the client.

Parameters

[in]	sessionRef	Session reference.
[in]	dataPtr	Data buffer to hold the nonce or IV.
[in]	dataSize

taf_ks_CryptoSessionSetAppData()

le_result_t taf_ks_CryptoSessionSetAppData	(	taf_ks_CryptoSessionRef_t	sessionRef,
		const uint8_t *	dataPtr,
		size_t	dataSize
	)

Sets the application data for a cryptographic session.

This API must be called before taf_ks_CryptoSessionStart() if the key has set the attribute of application data by taf_ks_SetKeyAppData().

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Session or key does not exist.
• LE_NOT_PERMITTED – Key is not provisioned or the session is not created by the client.

Parameters

[in]	sessionRef	Session reference.
[in]	dataPtr	Data buffer to hold the application data.
[in]	dataSize

taf_ks_CryptoSessionStart()

le_result_t taf_ks_CryptoSessionStart	(	taf_ks_CryptoSessionRef_t	sessionRef,
		taf_ks_CryptoPurpose_t	cryptoPurpose
	)

Starts the cryptographic session for the given operation. The cryptographic session is automatically deleted if an error occurs.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Session or key does not exist.
• LE_NOT_PERMITTED – Key is not provisioned or the session is not created by the client.
• LE_DUPLICATE – Session is already started.
• LE_FAULT – Error.

Parameters

[in]	sessionRef	Session reference.
[in]	cryptoPurpose	Cryptographic operation purpose.

taf_ks_CryptoSessionProcessAead()

le_result_t taf_ks_CryptoSessionProcessAead	(	taf_ks_CryptoSessionRef_t	sessionRef,
		const uint8_t *	dataPtr,
		size_t	dataSize
	)

Provides AEAD to an AES GCM crypto session started with taf_ks_CryptoSessionStart(). This API can be called multiple times before taf_ks_CryptoSessionProcess() and the cryptographic session will be automatically deleted if an error occurs.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Session or key does not exist.
• LE_NOT_PERMITTED – Key is not provisioned, the session is not created by the client, or the session is not started.
• LE_FAULT – Error.

Parameters

[in]	sessionRef	Session reference.
[in]	dataPtr	Data buffer to hold the AEAD data.
[in]	dataSize

taf_ks_CryptoSessionProcess()

le_result_t taf_ks_CryptoSessionProcess	(	taf_ks_CryptoSessionRef_t	sessionRef,
		const uint8_t *	inputDataPtr,
		size_t	inputDataSize,
		uint8_t *	outputDataPtr,
		size_t *	outputDataSizePtr
	)

Provides data to, and possibly receives output from, a running cryptographic session started with taf_ks_CryptoSessionStart(). It can be called multiple times before taf_ks_CryptoSessionEnd() is called. The crypto session is automatically deleted if an error occurs.

Returns

• LE_OK – Succeeded.
• LE_BAD_PARAMETER – Bad parameters.
• LE_NOT_FOUND – Session or the key does not exist.
• LE_NOT_PERMITTED – Key is not provisioned, the session is not created by the client, or the session is not started.
• LE_FAULT – Error.

Parameters

[in]	sessionRef	Session reference.
[in]	inputDataPtr	InputData can be one of the following cases. Plain text for encryption session. Cipher text for decryption session. Message to sign for signing session. Message to verify for verification session.
[in]	inputDataSize
[out]	outputDataPtr	OutputData can be one of the following cases. Encrypted data for encryption session. Decrypted data for decryption session. Shall set NULL for signing and verification sessions.
[in,out]	outputDataSizePtr

taf_ks_CryptoSessionEnd()

le_result_t taf_ks_CryptoSessionEnd	(	taf_ks_CryptoSessionRef_t	sessionRef,
		const uint8_t *	inputDataPtr,
		size_t	inputDataSize,
		uint8_t *	outputDataPtr,
		size_t *	outputDataSizePtr
	)

Finalizes the cryptographic session started with taf_ks_CryptoSessionStart(). This API shall be called once all input data is processed by taf_ks_CryptoSessionProcess(). The cryptographic session will be deleted automatically.

Returns

• LE_OK – Succeeded.
• LE_NOT_FOUND – Session or key does not exist.
• LE_NOT_PERMITTED – Key is not provisioned, the session is not created by the client, or the session is not started.
• LE_FAULT – Error.

Parameters

[in]	sessionRef	Session reference.
[in]	inputDataPtr	Signature to verify for verification session and shall set to NULL for other sessions.
[in]	inputDataSize
[out]	outputDataPtr	OutputData can be one of the following cases. Encrypted data for encryption session. Decrypted data for decryption session. Signature for signing session. Shall set to NULL for verfication session.
[in,out]	outputDataSizePtr

taf_ks_CryptoSessionAbort()

le_result_t taf_ks_CryptoSessionAbort

(

taf_ks_CryptoSessionRef_t

sessionRef

)

Aborts the cryptographic session started with taf_ks_CryptoSessionStart(). The cryptographic session will be deleted automatically.

Returns

• LE_OK – Succeeded.
• LE_NOT_FOUND – Session or key does not exist.
• LE_NOT_PERMITTED – Key is not provisioned, the session is not created by the client, or the session is not started.
• LE_FAULT – Error.

Parameters

[in]

sessionRef

Session reference.