(DataFlex) 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.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoScmd
    String sReaderName
    Boolean iSuccess
    String sCardName
    String sPinId
    String sPin
    Integer iRetval
    String sTemp1

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

    Get Create (RefClass(cComChilkatScMinidriver)) To hoScmd
    If (Not(IsComObjectCreated(hoScmd))) Begin
        Send CreateComObject of hoScmd
    End

    // Reader names (smart card readers or USB tokens) can be discovered
    // via List Readers or Find Smart Cards
    Move "Alcor Micro USB Smart Card Reader 0" To sReaderName
    Get ComAcquireContext Of hoScmd sReaderName To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoScmd To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // If we are successful, the name of the currently inserted smart card is available:
    Get ComCardName Of hoScmd To sCardName
    Showln "Card name: " sCardName

    // 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.
    Move "user" To sPinId

    // Change this to the PIN for your smart card.
    Move "0000" To sPin

    Get ComPinAuthenticate Of hoScmd sPinId sPin To iRetval

    // 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 (iRetval < 0) Begin
        Get ComLastErrorText Of hoScmd To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    If (iRetval > 0) Begin
        Showln "PIN authentcation failed, " iRetval " attempts remaining before the PIN is blocked."
    End
    Else Begin
        Showln "PIN authentication successful. Your session is now authenticated and you may proceed with operations such as signing."
    End

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

    // You may deauthenticate the session when finished with operations that required authentication.
    Get ComPinDeauthenticate Of hoScmd sPinId To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoScmd To sTemp1
        Showln sTemp1
    End

    // Delete the context when finished with the card.
    Get ComDeleteContext Of hoScmd To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoScmd To sTemp1
        Showln sTemp1
    End



End_Procedure