NAME
SpringCard Calypso API :: SAM command set
COPYRIGHT
(c) 2008 PRO ACTIVE SAS - See LICENCE.txt for licence information
AUTHOR
Johann Dantant / PRO ACTIVE
HISTORY
JDA 21/10/2008 : first public release
NAME
CalypsoSamCipherCardDataEx
DESCRIPTION
Ask the SAM to cipher data to be transmitted to the card
INPUTS
CALYPSO_CTX_ST *ctx : library context BYTE apdu_p1 BYTE apdu_p2 const BYTE plain[] CALYPSO_SZ plainsize BYTE cipher[] CALYPSO_SZ *ciphersize
RETURNS
CALYPSO_RC : 0 or an error code
NAME
CalypsoSamDigestAuthenticate
DESCRIPTION
Verify card's signature after CalypsoCardCloseSecureSession
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE card_sign[4] : signature returned by the card
RETURNS
CALYPSO_RC : 0 or an error code
NAME
CalypsoSamDigestClose
DESCRIPTION
SAM-side counterpart of CalypsoCardCloseSecureSession
INPUTS
CALYPSO_CTX_ST *ctx : library context BYTE sam_sign[4] : signature computed by the SAM (to be forwarded to the card)
RETURNS
CALYPSO_RC : 0 or an error code
NAME
CalypsoSamDigestInit
DESCRIPTION
SAM-side counterpart of CalypsoCardOpenSecureSession1, CalypsoCardOpenSecureSession2 or CalypsoCardOpenSecureSession3
INPUTS
CALYPSO_CTX_ST *ctx : library context BYTE kif : key identifier BYTE kvc : key version and counter const BYTE cardresp[] : card's answer to the open secure session command (including its challenge) CALYPSO_SZ cardrespsize : length of cardresp
RETURNS
CALYPSO_RC : 0 or an error code
NAME
CalypsoSamDigestUpdate
DESCRIPTION
Forward a card's APDU (in/out) to the SAM
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE cardapdu[] : APDU CALYPSO_SZ cardapdusize : length of the APDU
RETURNS
CALYPSO_RC : 0 or an error code
NAME
CalypsoSamGetChallenge
DESCRIPTION
Retrieve the challenge from the SAM, to be used in CalypsoCardOpenSecureSession1, CalypsoCardOpenSecureSession2 or CalypsoCardOpenSecureSession3
INPUTS
CALYPSO_CTX_ST *ctx : library context BYTE sam_chal[4] : the UID of the card
RETURNS
CALYPSO_RC : 0 or an error code
NAME
CalypsoSamGiveRandom
DESCRIPTION
Feed the SAM with a challenge generated by the card
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE challenge[8] : the challenge returned by the card
RETURNS
CALYPSO_RC : 0 or an error code
SEE ALSO
CalypsoCardGetChallenge
NAME
CalypsoSamSelectDiversifier
DESCRIPTION
Feed the SAM with the UID of the card currently being worked on
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE card_uid[8] : the UID of the card
RETURNS
CALYPSO_RC : 0 or an error code