(PowerBuilder) 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

integer li_rc
oleobject loo_Scmd
string ls_ReaderName
integer li_Success
string ls_CardName
string ls_PinId
string ls_Pin
integer li_Retval

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

loo_Scmd = create oleobject
// Use "Chilkat_9_5_0.ScMinidriver" for versions of Chilkat < 10.0.0
li_rc = loo_Scmd.ConnectToNewObject("Chilkat.ScMinidriver")
if li_rc < 0 then
    destroy loo_Scmd
    MessageBox("Error","Connecting to COM object failed")
    return
end if

// Reader names (smart card readers or USB tokens) can be discovered
// via List Readers or Find Smart Cards
ls_ReaderName = "Alcor Micro USB Smart Card Reader 0"
li_Success = loo_Scmd.AcquireContext(ls_ReaderName)
if li_Success = 0 then
    Write-Debug loo_Scmd.LastErrorText
    destroy loo_Scmd
    return
end if

// If we are successful, the name of the currently inserted smart card is available:
ls_CardName = loo_Scmd.CardName
Write-Debug "Card name: " + ls_CardName

// 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.
ls_PinId = "user"

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

li_Retval = loo_Scmd.PinAuthenticate(ls_PinId,ls_Pin)

// 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 li_Retval < 0 then
    Write-Debug loo_Scmd.LastErrorText
    destroy loo_Scmd
    return
end if

if li_Retval > 0 then
    Write-Debug "PIN authentcation failed, " + string(li_Retval) + " attempts remaining before the PIN is blocked."
else
    Write-Debug "PIN authentication successful. Your session is now authenticated and you may proceed with operations such as signing."
end if

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

// You may deauthenticate the session when finished with operations that required authentication.
li_Success = loo_Scmd.PinDeauthenticate(ls_PinId)
if li_Success = 0 then
    Write-Debug loo_Scmd.LastErrorText
end if

// Delete the context when finished with the card.
li_Success = loo_Scmd.DeleteContext()
if li_Success = 0 then
    Write-Debug loo_Scmd.LastErrorText
end if



destroy loo_Scmd