sec-admin.h File Reference

---

Detailed Description

This is the admin security library header file that interfaces to the smart card.

This header file provides access to admin smart-card functions.

Author:

Rod Boyce

Date:

06/12/04

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
int	sec_AdminSetDesSessionKey (tsSMARTCARD_INFO *psSmartCard, LONG lIdx, BYTE *pabDesKeyBuf)
	set a DES session key on the smart card
int	sec_AdminSetSecretKey (tsSMARTCARD_INFO *psSmartCard, BYTE *pabSecKeyBuf)
	Set the secret key on the smart card.
int	sec_AdminZeroAuthCntrs (tsSMARTCARD_INFO *psSmartCard)
	Zero out the authentication counters.
int	sec_AdminReadAuthCntrs (tsSMARTCARD_INFO *psSmartCard, LONG *plFailure, LONG *plSuccess)
	Read the auth counters from the smart card.

---

Function Documentation

int sec_AdminReadAuthCntrs (  tsSMARTCARD_INFO *  psSmartCard, LONG *  plFailure, LONG *  plSuccess )

Read the auth counters from the smart card. Read the auth counters from the smart card. These counters only indicate comms failures in comms to the smart card. The basic declaration is: Command &H80 &H0c ReadCounters( SessionId As Long, Failure As Long, Success As Long ) Date: 07/12/04 Author: Rod Boyce Parameters: psSmartCard  - pointer to the smart card structure plFailure  - pointer to a long value to store the failure count in. plSuccess  - pointer to a long value to store the number of success Returns: 0 on success anything else is a failure History

Here is the call graph for this function:

int sec_AdminSetDesSessionKey (  tsSMARTCARD_INFO *  psSmartCard, LONG  lIdx, BYTE *  pabDesKeyBuf )

set a DES session key on the smart card This command is called from the admin interface to set a DES session key. The key is firstly encrypted with the FPGA hardware key. The basic declaration is: Command &H80 &H04 SetSessionKey( SessionId As Long, Indx As Long, SessionKey As Des3Key ) Date: 03/12/04 Author: Rod Boyce Parameters: psSmartCard  - pointer to the smart card structure lIdx  - The index of the session key to get from the smart card pabDesKeyBuf  - a pointer to a buffer that contains the 3DES key. Returns: 0 for success anything else on failure History

Here is the call graph for this function:

int sec_AdminSetSecretKey (  tsSMARTCARD_INFO *  psSmartCard, BYTE *  pabSecKeyBuf )

Set the secret key on the smart card. This function will set the secret key to a known value on the smart card. This key is stored in pllain text on the smart card. The basic declaration is: Command &H80 &H08 SetSecretKey( SessionId As Long, Magic As Long, SessionKey As Des3Key ) Date: 06/12/04 Author: Rod Boyce Parameters: psSmartCard  - pointer to the smart card structure pabSecKeyBuf  - Pointer to the secret key used for verifing the FPGA. Returns: 0 on success anything else a failure History

Here is the call graph for this function:

int sec_AdminZeroAuthCntrs (  tsSMARTCARD_INFO *  psSmartCard  )

Zero out the authentication counters. This function is an admin function to reset the auth counters. The counters are FPGA success and failure counters from the smart cards view. The failure counter only increments if there is a comms failure. The basic declaration is: Command &H80 &H0a ZeroCounters( SessionId As Long ) Date: 06/12/04 Author: Rod Boyce Parameters: psSmartCard  - pointer to the smart card structure Returns: 0 on success anything else a failure History

Here is the call graph for this function:

---