Visual FoxPro

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. Visual FoxPro

LOCAL lnSuccess
LOCAL loScmd
LOCAL lcReaderName
LOCAL lcCardName
LOCAL lcPinId
LOCAL lcPin
LOCAL lnRetval

lnSuccess = 0

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

loScmd = CreateObject('Chilkat.ScMinidriver')

*  Reader names (smart card readers or USB tokens) can be discovered
*  via List Readers or Find Smart Cards
lcReaderName = "Alcor Micro USB Smart Card Reader 0"
lnSuccess = loScmd.AcquireContext(lcReaderName)
IF (lnSuccess = 0) THEN
    ? loScmd.LastErrorText
    RELEASE loScmd
    CANCEL
ENDIF

*  If we are successful, the name of the currently inserted smart card is available:
lcCardName = loScmd.CardName
? "Card name: " + lcCardName

*  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.
lcPinId = "user"

*  Change this to the PIN for your smart card.
lcPin = "0000"

lnRetval = loScmd.PinAuthenticate(lcPinId,lcPin)

*  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 (lnRetval < 0) THEN
    ? loScmd.LastErrorText
    RELEASE loScmd
    CANCEL
ENDIF

IF (lnRetval > 0) THEN
    ? "PIN authentcation failed, " + STR(lnRetval) + " 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.
lnSuccess = loScmd.PinDeauthenticate(lcPinId)
IF (lnSuccess = 0) THEN
    ? loScmd.LastErrorText
ENDIF

*  Delete the context when finished with the card.
lnSuccess = loScmd.DeleteContext()
IF (lnSuccess = 0) THEN
    ? loScmd.LastErrorText
ENDIF

RELEASE loScmd