starcos.h File Reference

#include <chipcard3/client/card.h>
#include <gwenhywfar/keyspec.h>
#include <gwenhywfar/crypt.h>

Include dependency graph for starcos.h:

Go to the source code of this file.

Defines
#define	LC_STARCOS_KEY_STATUS_ACTIVE   0x10
#define	LC_STARCOS_KEY_STATUS_INACTIVE_CERT   0x0a
#define	LC_STARCOS_KEY_STATUS_INACTIVE_FREE   0x08
#define	LC_STARCOS_KEY_STATUS_INACTIVE_NEW   0x07
#define	LC_STARCOS_KEY_STATUS_ACTIVE_NEW   0x02
#define	LC_STARCOS_KEY_STATUS_ACTIVE_INCOMPLETE   0x01
#define	LC_STARCOS_KEY_STATUS_ACTIVE_INILETTER   0x00
#define	LC_STARCOS_KEY_STATUS_INTERNAL_UNUSED   0xff
Functions
CHIPCARD_API int	LC_Starcos_ExtendCard (LC_CARD *card)
CHIPCARD_API int	LC_Starcos_UnextendCard (LC_CARD *card)
CHIPCARD_API LC_CLIENT_RESULT	LC_Starcos_Reopen (LC_CARD *card)
CHIPCARD_API GWEN_DB_NODE *	LC_Starcos_GetCardDataAsDb (const LC_CARD *card)
CHIPCARD_API GWEN_BUFFER *	LC_Starcos_GetCardDataAsBuffer (const LC_CARD *card)
Key Management Functions
CHIPCARD_API GWEN_KEYSPEC *	LC_Starcos_GetKeySpec (LC_CARD *card, int kid)
CHIPCARD_API LC_CLIENT_RESULT	LC_Starcos_SetKeySpec (LC_CARD *card, int kid, const GWEN_KEYSPEC *ks)
CHIPCARD_API LC_CLIENT_RESULT	LC_Starcos_GenerateKeyPair (LC_CARD *card, int kid, int bits)
CHIPCARD_API LC_CLIENT_RESULT	LC_Starcos_ActivateKeyPair (LC_CARD *card, int srcKid, int dstKid, const GWEN_KEYSPEC *ks)
CHIPCARD_API LC_CLIENT_RESULT	LC_Starcos_WritePublicKey (LC_CARD *card, int kid, const GWEN_CRYPTKEY *key)
CHIPCARD_API GWEN_CRYPTKEY *	LC_Starcos_ReadPublicKey (LC_CARD *card, int kid)
Bank Information Functions
CHIPCARD_API LC_CLIENT_RESULT	LC_Starcos_ReadInstituteData (LC_CARD *card, int idx, GWEN_DB_NODE *dbData)
CHIPCARD_API LC_CLIENT_RESULT	LC_Starcos_WriteInstituteData (LC_CARD *card, int idx, GWEN_DB_NODE *dbData)
Cryptographic Functions
CHIPCARD_API GWEN_TYPE_UINT32	LC_Starcos_ReadSigCounter (LC_CARD *card, int kid)
CHIPCARD_API LC_CLIENT_RESULT	LC_Starcos_GetChallenge (LC_CARD *card, GWEN_BUFFER *mbuf)

---

Define Documentation

#define LC_STARCOS_KEY_STATUS_ACTIVE   0x10

#define LC_STARCOS_KEY_STATUS_INACTIVE_CERT   0x0a

#define LC_STARCOS_KEY_STATUS_INACTIVE_FREE   0x08

#define LC_STARCOS_KEY_STATUS_INACTIVE_NEW   0x07

#define LC_STARCOS_KEY_STATUS_ACTIVE_NEW   0x02

#define LC_STARCOS_KEY_STATUS_ACTIVE_INCOMPLETE   0x01

#define LC_STARCOS_KEY_STATUS_ACTIVE_INILETTER   0x00

#define LC_STARCOS_KEY_STATUS_INTERNAL_UNUSED   0xff

---

Function Documentation

CHIPCARD_API int LC_Starcos_ExtendCard

(

LC_CARD *

card

)

CHIPCARD_API int LC_Starcos_UnextendCard

(

LC_CARD *

card

)

CHIPCARD_API LC_CLIENT_RESULT LC_Starcos_Reopen

(

LC_CARD *

card

)

CHIPCARD_API GWEN_DB_NODE* LC_Starcos_GetCardDataAsDb

(

const LC_CARD *

card

)

CHIPCARD_API GWEN_BUFFER* LC_Starcos_GetCardDataAsBuffer

(

const LC_CARD *

card

)

CHIPCARD_API GWEN_KEYSPEC* LC_Starcos_GetKeySpec	(	LC_CARD *	card,
		int	kid
	)

Returns a GWEN_KEYSPEC for the given key. The caller becomes the owner of the returned object (if any), so he is responsible for freeing it (using GWEN_KeySpec_free).

CHIPCARD_API LC_CLIENT_RESULT LC_Starcos_SetKeySpec	(	LC_CARD *	card,
		int	kid,
		const GWEN_KEYSPEC *	ks
	)

CHIPCARD_API LC_CLIENT_RESULT LC_Starcos_GenerateKeyPair	(	LC_CARD *	card,
		int	kid,
		int	bits
	)

Generates a temporary key pair. To use the newly created key pair you need to call LC_Starcos_ActivateKeyPair.

Parameters:

kid

use 0x8e for crypt keys and 0x8f for sign keys

CHIPCARD_API LC_CLIENT_RESULT LC_Starcos_ActivateKeyPair	(	LC_CARD *	card,
		int	srcKid,
		int	dstKid,
		const GWEN_KEYSPEC *	ks
	)

CHIPCARD_API LC_CLIENT_RESULT LC_Starcos_WritePublicKey	(	LC_CARD *	card,
		int	kid,
		const GWEN_CRYPTKEY *	key
	)

CHIPCARD_API GWEN_CRYPTKEY* LC_Starcos_ReadPublicKey	(	LC_CARD *	card,
		int	kid
	)

CHIPCARD_API LC_CLIENT_RESULT LC_Starcos_ReadInstituteData	(	LC_CARD *	card,
		int	idx,
		GWEN_DB_NODE *	dbData
	)

This function reads institute data from the card. You need to verify the pin prior to using this function. Please note that this function always returns contexts if there was no error. However, if the context is empty the corresponding context group returned will be empty, too.

Parameters:

	idx	if 0 then all 5 entries are read, if 1 then entry 1 is read etc
	dbData	if idx==0 then every context read will be added as a new group called "context" to this given group. Otherwise the specified context is directly stored within this given group.

CHIPCARD_API LC_CLIENT_RESULT LC_Starcos_WriteInstituteData	(	LC_CARD *	card,
		int	idx,
		GWEN_DB_NODE *	dbData
	)

CHIPCARD_API GWEN_TYPE_UINT32 LC_Starcos_ReadSigCounter	(	LC_CARD *	card,
		int	kid
	)

CHIPCARD_API LC_CLIENT_RESULT LC_Starcos_GetChallenge	(	LC_CARD *	card,
		GWEN_BUFFER *	mbuf
	)

returns 8 random bytes