Rust

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. Rust

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

let scmd = chilkat::ScMinidriver::new();

// Reader names (smart card readers or USB tokens) can be discovered
// via List Readers or Find Smart Cards
let reader_name = "Alcor Micro USB Smart Card Reader 0".to_string();
if scmd.acquire_context(&reader_name).is_err() {
    println!("{}", scmd.last_error_text());
    return;
}

// If we are successful, the name of the currently inserted smart card is available:
let card_name = scmd.card_name();
println!("Card name: {}", card_name);

// 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.
let pin_id = "user".to_string();

// Change this to the PIN for your smart card.
let pin = "0000".to_string();

let retval = scmd.pin_authenticate(&pin_id, &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 {
    println!("{}", scmd.last_error_text());
    return;
}

if retval > 0 {
    println!("PIN authentcation failed, {} attempts remaining before the PIN is blocked.", retval);
} else {
    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.
if scmd.pin_deauthenticate(&pin_id).is_err() {
    println!("{}", scmd.last_error_text());
}

// Delete the context when finished with the card.
if scmd.delete_context().is_err() {
    println!("{}", scmd.last_error_text());
}