SEC_LoadE2EE API for Telium Tetra: Library API reference

Telium Tetra SEC Load E2EE API

SEC_LoadE2EE API for Telium Tetra  1.12.1
Lib API
Library API reference

Reference for all APIs in the SEC_LoadE2EE Library. More...

Functions

int SEC_DukptE2EE_GetCurrentSMID (T_SEC_PARTTYPE exSecureType, T_SEC_DATAKEY_ID *pt_stxDukptId, unsigned char *pt_ucxOutputSMID)
 To get the status and the current transaction SMID of the DATA TDES DUKPT algorithm

used schemes NAM_TLV_LOAD_DUKPT_E2EE

More...
 
int SEC_DukptE2EE_LoadKSN (T_SEC_PARTTYPE exSecureType, T_SEC_DATAKEY_ID *pt_stxDukptId, unsigned char *pt_ucxKSNValue)
 To load the Key Serial Number (KSN) for DATA DUKPT algorithm

used schemes NAM_TLV_LOAD_DUKPT_E2EE

More...
 
int SEC_DukptE2EE_LoadInitialKey (T_SEC_PARTTYPE exSecureType, T_SEC_DATAKEY_ID *pt_stxDukptId, T_SEC_DATAKEY_ID *pt_stxCipherKeyId, unsigned char *pt_ucxInitialKeyValue)
 To load the Initial Key (16 bytes TDES Dukpt) for DATA DUKPT algoritm. More...
 
int SEC_DukptE2EE_CreateKeys (T_SEC_PARTTYPE exSecureType, T_SEC_DATAKEY_ID *pt_stxDukptId)
 To generate the initial Key (16 bytes TDES Dukpt) for DATA DUKPT algoritm by derivation of the Key Serial Number KSN (8 bytes) with the Derivation Key (16 bytes) and to initialise the set of 21 keys and counter. More...
 
int SEC_DukptE2EE_GetCurrentState (T_SEC_PARTTYPE exSecureType, T_SEC_DATAKEY_ID *pt_stxDukptId, int *pt_ixStatus)
 To get the current status of DTDES DATA DUKPT algoritm

used schemes NAM_TLV_LOAD_DUKPT_E2EE

More...
 
int SEC_DukptE2EE_CancelKeys (T_SEC_PARTTYPE exSecureType, T_SEC_DATAKEY_ID *pt_stxDukptId)
 To stop and delete the data of TDES DATA DUKPT algoritm

used schemes NAM_TLV_LOAD_DUKPT_E2EE

More...
 

Detailed Description

Reference for all APIs in the SEC_LoadE2EE Library.

Function Documentation

int SEC_DukptE2EE_CancelKeys ( T_SEC_PARTTYPE  exSecureType,
T_SEC_DATAKEY_ID *  pt_stxDukptId 
)

To stop and delete the data of TDES DATA DUKPT algoritm

used schemes NAM_TLV_LOAD_DUKPT_E2EE

Parameters
[in]exSecureType: Secure part
[in]pt_stxDukptId: pointer to Dukpt Id (cAlgoType has to be set to TLV_TYPE_TDESDUKPT_E2EE)
Returns
OK or Error code (ERR_Schemes)

Back to top

int SEC_DukptE2EE_CreateKeys ( T_SEC_PARTTYPE  exSecureType,
T_SEC_DATAKEY_ID *  pt_stxDukptId 
)

To generate the initial Key (16 bytes TDES Dukpt) for DATA DUKPT algoritm by derivation of the Key Serial Number KSN (8 bytes) with the Derivation Key (16 bytes) and to initialise the set of 21 keys and counter.

used schemes NAM_TLV_LOAD_DUKPT_E2EE

Parameters
[in]exSecureType: Secure part
[in]pt_stxDukptId: pointer to Dukpt Id (cAlgoType has to be set to TLV_TYPE_TDESDUKPT_E2EE)
Returns
OK or Error code (ERR_Schemes)

Back to top

int SEC_DukptE2EE_GetCurrentSMID ( T_SEC_PARTTYPE  exSecureType,
T_SEC_DATAKEY_ID *  pt_stxDukptId,
unsigned char *  pt_ucxOutputSMID 
)

To get the status and the current transaction SMID of the DATA TDES DUKPT algorithm

used schemes NAM_TLV_LOAD_DUKPT_E2EE

Parameters
[in]exSecureType: Secure part
[in]pt_stxDukptId: pointer to Dukpt Id (cAlgoType has to be set to TLV_TYPE_TDESDUKPT_E2EE)
[out]pt_ucxOutputSMID: 10 bytes current SMID
Returns
OK or Error code (ERR_Schemes)

Back to top

int SEC_DukptE2EE_GetCurrentState ( T_SEC_PARTTYPE  exSecureType,
T_SEC_DATAKEY_ID *  pt_stxDukptId,
int *  pt_ixStatus 
)

To get the current status of DTDES DATA DUKPT algoritm

used schemes NAM_TLV_LOAD_DUKPT_E2EE

Parameters
[in]exSecureType: Secure part
[in]pt_stxDukptId: pointer to Dukpt Id (cAlgoType has to be set to TLV_TYPE_TDESDUKPT_E2EE)
[out]pt_ixStatus: status (DUKPT_IN_FUNCTION or DUKPT_END_OF_LIFE)
Returns
OK or Error code (ERR_Schemes)

Back to top

int SEC_DukptE2EE_LoadInitialKey ( T_SEC_PARTTYPE  exSecureType,
T_SEC_DATAKEY_ID *  pt_stxDukptId,
T_SEC_DATAKEY_ID *  pt_stxCipherKeyId,
unsigned char *  pt_ucxInitialKeyValue 
)

To load the Initial Key (16 bytes TDES Dukpt) for DATA DUKPT algoritm.

used schemes NAM_TLV_LOAD_DUKPT_E2EE

Parameters
[in]exSecureType: Secure part
[in]pt_stxDukptId: pointer to Dukpt Id (cAlgoType has to be set to TLV_TYPE_TDESDUKPT_E2EE)
[in]pt_stxCipherKeyId: Identifier of the TDES ciphering key
[in]pt_ucxInitialKeyValue: Ciphered Initial Key value (16 bytes)
Returns
OK or Error code (ERR_Schemes)

Back to top

int SEC_DukptE2EE_LoadKSN ( T_SEC_PARTTYPE  exSecureType,
T_SEC_DATAKEY_ID *  pt_stxDukptId,
unsigned char *  pt_ucxKSNValue 
)

To load the Key Serial Number (KSN) for DATA DUKPT algorithm

used schemes NAM_TLV_LOAD_DUKPT_E2EE

Parameters
[in]exSecureType: Secure part
[in]pt_stxDukptId: pointer to Dukpt Id (cAlgoType has to be set to TLV_TYPE_TDESDUKPT_E2EE)
[in]pt_ucxKSNValue: KSN value (8 bytes)
Returns
OK or Error code (ERR_Schemes)

Back to top

Ingenico