(Delphi DLL) 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 for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, ScMinidriver;

...

procedure TForm1.Button1Click(Sender: TObject);
var
scmd: HCkScMinidriver;
readerName: PWideChar;
success: Boolean;
cardName: PWideChar;
pinId: PWideChar;
pin: PWideChar;
retval: Integer;

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

scmd := CkScMinidriver_Create();

// Reader names (smart card readers or USB tokens) can be discovered
// via List Readers or Find Smart Cards
readerName := 'Alcor Micro USB Smart Card Reader 0';
success := CkScMinidriver_AcquireContext(scmd,readerName);
if (success = False) then
  begin
    Memo1.Lines.Add(CkScMinidriver__lastErrorText(scmd));
    Exit;
  end;

// If we are successful, the name of the currently inserted smart card is available:
cardName := CkScMinidriver__cardName(scmd);
Memo1.Lines.Add('Card name: ' + 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.
pinId := 'user';

// Change this to the PIN for your smart card.
pin := '0000';

retval := CkScMinidriver_PinAuthenticate(scmd,pinId,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 (retval < 0) then
  begin
    Memo1.Lines.Add(CkScMinidriver__lastErrorText(scmd));
    Exit;
  end;

if (retval > 0) then
  begin
    Memo1.Lines.Add('PIN authentcation failed, ' + IntToStr(retval) + ' attempts remaining before the PIN is blocked.');
  end
else
  begin
    Memo1.Lines.Add('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.
success := CkScMinidriver_PinDeauthenticate(scmd,pinId);
if (success = False) then
  begin
    Memo1.Lines.Add(CkScMinidriver__lastErrorText(scmd));
  end;

// Delete the context when finished with the card.
success := CkScMinidriver_DeleteContext(scmd);
if (success = False) then
  begin
    Memo1.Lines.Add(CkScMinidriver__lastErrorText(scmd));
  end;

CkScMinidriver_Dispose(scmd);

end;