Knox Tizen Wearable SDK
Attestation

Enumerations

enum  knox_attestation_error_type_e
 The KNOX Attestation error types. More...
 

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

◆ 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 

Invalud 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

◆ knox_attestation_get_attestation_blob()

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]nonceRandom number for device authentication
[in]sizeSize of nonce
[out]blob_dataBlob data
[out]blob_data_sizeSize 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_NONESuccessful
KNOX_ATTESTATION_ERROR_INVALID_PARAMETERInvalid parameter
KNOX_ATTESTATION_ERROR_OUT_OF_MEMORYOut of memory
KNOX_ATTESTATION_ERROR_PERMISSION_DENIEDPermission denied
KNOX_ATTESTATION_ERROR_KEY_ERRORKnox Key error
KNOX_ATTESTATION_ERROR_SIGNING_ERRORSigning data failed
KNOX_ATTESTATION_ERROR_TZ_ERRORTrustzone error
KNOX_ATTESTATION_ERROR_UNKNOWNUnknown error

◆ knox_attestation_get_attestation_device_id()

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_idDevice ID
[out]sizeSize 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_NONESuccessful
KNOX_ATTESTATION_ERROR_INVALID_PARAMETERInvalid parameter
KNOX_ATTESTATION_ERROR_OUT_OF_MEMORYOut of memory
KNOX_ATTESTATION_ERROR_PERMISSION_DENIEDPermission denied
KNOX_ATTESTATION_ERROR_TZ_ERRORTrustzone error
KNOX_ATTESTATION_ERROR_UNKNOWNUnknown error