Attestation

Enumerations

Functions
EXPORT_API int	knox_attestation_get_attestation_blob (const unsigned char *nonce, int size, unsigned char **blob_data, int *blob_data_size)
	Get blob data to check if device is available for authentication. More...
EXPORT_API int	knox_attestation_get_attestation_device_id (unsigned char **device_id, int *size)
	Get device id for attestation. More...

Detailed Description

Enumeration Type Documentation

enum knox_attestation_error_type_e

The KNOX Attestation error types.

Since (Tizen):

2.3.2

Enumerator
KNOX_ATTESTATION_ERROR_NONE	Successful
KNOX_ATTESTATION_ERROR_INVALID_PARAMETER	Invalid Parameter
KNOX_ATTESTATION_ERROR_OUT_OF_MEMORY	Out of Memory
KNOX_ATTESTATION_ERROR_IO_ERROR	I/O Error
KNOX_ATTESTATION_ERROR_NO_DATA	No data found
KNOX_ATTESTATION_ERROR_PERMISSION_DENIED	Access denied
KNOX_ATTESTATION_ERROR_NOT_SUPPORTED	Operation is not supported
KNOX_ATTESTATION_ERROR_IPC_FAILED	Failed to communicate with server
KNOX_ATTESTATION_ERROR_TZ_ERROR	Error occured in Trust Zone
KNOX_ATTESTATION_ERROR_INVALID_NONCE	Invalid nonce error
KNOX_ATTESTATION_ERROR_SIGNING_ERROR	Data signing error
KNOX_ATTESTATION_ERROR_KEY_ERROR	Invalid Knox Key error
KNOX_ATTESTATION_ERROR_UNKNOWN	Unknown error

Definition at line 33 of file knox_attestation_error_type.h.

Function Documentation

EXPORT_API int knox_attestation_get_attestation_blob	(	const unsigned char *	nonce,
		int	size,
		unsigned char **	blob_data,
		int *	blob_data_size
	)

Get blob data to check if device is available for authentication.

Since (Tizen):

2.3.2

Feature:

http://developer.samsung.com/tizen/feature/knox.tima

Privilege:

http://developer.samsung.com/tizen/privilege/knox.attestation

Privilege Level:

public

Parameters

[in]	nonce	Random number for device authentication
[in]	size	Size of nonce
[out]	blob_data	Blob data
[out]	blob_data_size	Size of output data

Remarks

blob_data must be freed after using

Returns

0 on success, otherwise a negative error value.

Return values

KNOX_ATTESTATION_ERROR_NONE	Successful
KNOX_ATTESTATION_ERROR_INVALID_PARAMETER	Invalid parameter
KNOX_ATTESTATION_ERROR_OUT_OF_MEMORY	Out of memory
KNOX_ATTESTATION_ERROR_PERMISSION_DENIED	Permission denied
KNOX_ATTESTATION_ERROR_KEY_ERROR	Knox Key error
KNOX_ATTESTATION_ERROR_SIGNING_ERROR	Signing data failed
KNOX_ATTESTATION_ERROR_TZ_ERROR	Trustzone error
KNOX_ATTESTATION_ERROR_UNKNOWN	Unknown error

EXPORT_API int knox_attestation_get_attestation_device_id	(	unsigned char **	device_id,
		int *	size
	)

Get device id for attestation.

Since (Tizen):

2.3.2

Feature:

http://developer.samsung.com/tizen/feature/knox.tima

Privilege:

http://developer.samsung.com/tizen/privilege/knox.attestation

Privilege Level:

public

Parameters

[out]	device_id	Device ID
[out]	size	Size of device ID

Remarks

device_id must be freed after using

Returns

0 on success, otherwise a negative error value.

Return values

KNOX_ATTESTATION_ERROR_NONE	Successful
KNOX_ATTESTATION_ERROR_INVALID_PARAMETER	Invalid parameter
KNOX_ATTESTATION_ERROR_OUT_OF_MEMORY	Out of memory
KNOX_ATTESTATION_ERROR_PERMISSION_DENIED	Permission denied
KNOX_ATTESTATION_ERROR_TZ_ERROR	Trustzone error
KNOX_ATTESTATION_ERROR_UNKNOWN	Unknown error