Java

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. Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.ScMinidriver;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example requires the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        ScMinidriver scmd = new ScMinidriver();

        // Reader names (smart card readers or USB tokens) can be discovered
        // via List Readers or Find Smart Cards
        String readerName = "Alcor Micro USB Smart Card Reader 0";
        try {
            scmd.acquireContext(readerName);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // If we are successful, the name of the currently inserted smart card is available:
        String cardName = scmd.getCardName();
        System.out.println("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.
        String pinId = "user";

        // Change this to the PIN for your smart card.
        String pin = "0000";

        int retval = scmd.pinAuthenticate(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) {
            System.out.println(scmd.getLastErrorText());
            return;
        }

        if (retval > 0) {
            System.out.println("PIN authentcation failed, " + retval + " attempts remaining before the PIN is blocked.");
        } else {
            System.out.println("PIN authentication successful. Your session is now authenticated and you may proceed with operations such as signing.");
        }

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

        // You may deauthenticate the session when finished with operations that required authentication.
        try {
            scmd.pinDeauthenticate(pinId);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
        }

        // Delete the context when finished with the card.
        try {
            scmd.deleteContext();
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
        }
    }
}