Zig

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

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

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

    const scmd = try chilkat.ScMinidriver.init();
    defer scmd.deinit();

    // Reader names (smart card readers or USB tokens) can be discovered
    // via List Readers or Find Smart Cards
    const reader_name = "Alcor Micro USB Smart Card Reader 0";
    scmd.acquireContext(reader_name) catch {
        std.debug.print("{s}\n", .{try scmd.getLastErrorText(alloc)});
        return;
    };

    // If we are successful, the name of the currently inserted smart card is available:
    const card_name = try scmd.getCardName(alloc);
    std.debug.print("Card name: {s}\n", .{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.
    const pin_id = "user";

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

    const retval = scmd.pinAuthenticate(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) {
        std.debug.print("{s}\n", .{try scmd.getLastErrorText(alloc)});
        return;
    }

    if (retval > 0) {
        std.debug.print("PIN authentcation failed, {d} attempts remaining before the PIN is blocked.\n", .{retval});
    } else {
        std.debug.print("PIN authentication successful. Your session is now authenticated and you may proceed with operations such as signing.\n", .{});
    }

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

    // You may deauthenticate the session when finished with operations that required authentication.
    scmd.pinDeauthenticate(pin_id) catch {
        std.debug.print("{s}\n", .{try scmd.getLastErrorText(alloc)});
    };

    // Delete the context when finished with the card.
    scmd.deleteContext() catch {
        std.debug.print("{s}\n", .{try scmd.getLastErrorText(alloc)});
    };
}