Xbase++

ScMinidriver - PIN Authentication for Smart Card or USB Token

See more ScMinidriver Examples

Demonstrates how to PIN authenticate with a connected smart card or USB token. Xbase++

LOCAL nSuccess
LOCAL oScmd
LOCAL cReaderName
LOCAL cCardName
LOCAL cPinId
LOCAL cPin
LOCAL nRetval

nSuccess := 0

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

oScmd := CreateObject("Chilkat.ScMinidriver")

//  Reader names (smart card readers or USB tokens) can be discovered
//  via List Readers or Find Smart Cards
cReaderName := "Alcor Micro USB Smart Card Reader 0"
nSuccess := oScmd:AcquireContext(cReaderName)
IF (nSuccess == 0)
    ? oScmd:LastErrorText
    oScmd:destroy()
    RETURN
ENDIF

//  If we are successful, the name of the currently inserted smart card is available:
cCardName := oScmd:CardName
? "Card name: " + cCardName

//  Perform regular PIN authentication with the smartcard.
//  If authentication is successful, then the ScMinidriver session is authenticated and
//  operations such as signing are permissible.

//  The pin ID can be "user", "admin", or a number "3" through "7" (passed as a string).
//  The possible pin ID's for a given smartcard are obtained via the GetCardProperties method.
//  See Get Smart Card Properties for sample code.
//  You should generally use the "user" pin ID.  You would only use the other pin ID's for very specific purposes.
cPinId := "user"

//  Change this to the PIN for your smart card.
cPin := "0000"

nRetval := oScmd:PinAuthenticate(cPinId, cPin)

//  The return value is 0 for success.
//  If the retval is greater than 0, it is the number of attempts remaining before the PIN is blocked.
//  If the retval equals -1, then something else went wrong and you should consult the LastErrorText.
IF (nRetval < 0)
    ? oScmd:LastErrorText
    oScmd:destroy()
    RETURN
ENDIF

IF (nRetval > 0)
    ? "PIN authentcation failed, " + Str(nRetval) + " attempts remaining before the PIN is blocked."
ELSE
    ? "PIN authentication successful. Your session is now authenticated and you may proceed with operations such as signing."
ENDIF

//  ...
//  ...
//  ...

//  You may deauthenticate the session when finished with operations that required authentication.
nSuccess := oScmd:PinDeauthenticate(cPinId)
IF (nSuccess == 0)
    ? oScmd:LastErrorText
ENDIF

//  Delete the context when finished with the card.
nSuccess := oScmd:DeleteContext()
IF (nSuccess == 0)
    ? oScmd:LastErrorText
ENDIF

oScmd:destroy()