React Native

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. React Native

import { ScMinidriver } from '@chilkat/react-native'

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

  const scmd = new ScMinidriver();

  // Reader names (smart card readers or USB tokens) can be discovered
  // via List Readers or Find Smart Cards
  const readerName = 'Alcor Micro USB Smart Card Reader 0';
  try {
    scmd.acquireContext(readerName);
  } catch {
    console.log(scmd.lastErrorText);
    return;
  }

  // If we are successful, the name of the currently inserted smart card is available:
  const cardName = scmd.cardName;
  console.log(`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.
  const pinId = 'user';

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

  const 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) {
    console.log(scmd.lastErrorText);
    return;
  }

  if (retval > 0) {
    console.log(`PIN authentcation failed, ${retval} attempts remaining before the PIN is blocked.`);
  } else {
    console.log('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 {
    console.log(scmd.lastErrorText);
  }

  // Delete the context when finished with the card.
  try {
    scmd.deleteContext();
  } catch {
    console.log(scmd.lastErrorText);
  }
}