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