Zig

PKCS11 Generate Secret Key (such as AES)

See more PKCS11 Examples

Generates a symmetric secret key such as AES on the HSM.

Note: This example requires Chilkat v9.5.0.96 or later.

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.

    // Note: Chilkat's PKCS11 implementation runs on Windows, Linux, Mac OS X, and other supported operating systems.

    const pkcs11 = try chilkat.Pkcs11.init();
    defer pkcs11.deinit();

    // Use the PKCS11 driver (.dll, .so, .dylib) for your particular HSM.
    // (The format of the path will change with the operating system.  Obviously, "C:/" is not used on non-Windows systems.
    pkcs11.setSharedLibPath("C:/Program Files (x86)/Gemalto/IDGo 800 PKCS#11/IDPrimePKCS1164.dll");

    // Establish a logged-on session.
    const pin = "0000";
    const user_type = 1;
    pkcs11.quickSession(user_type, pin) catch {
        std.debug.print("{s}\n", .{try pkcs11.getLastErrorText(alloc)});
        return;
    };

    // Let's generate a 256-bit AES key on the token, which will exist for the duration of this session.
    // Symmetric keys, such as AES keys, are typically created (or imported) and used during a single session.

    // Other possible values for keyType are "AES XTS", "Blowfish", "Twofish", "ChaCha20", and others.
    // In virtually all cases, you'll want to create an AES key.
    const key_type = "AES";

    // Specify attributes and abilities (how this key can be used) by providing a JSON template.
    const json = try chilkat.JsonObject.init();
    defer json.deinit();

    // The key can be extracted or wrapped.
    json.updateBool("extractable", true) catch {};

    // Allow the key to be used for encryption, decryption, wrapping other keys, and unwrapping other keys.
    json.updateBool("encrypt", true) catch {};
    json.updateBool("decrypt", true) catch {};
    json.updateBool("wrap", true) catch {};
    json.updateBool("unwrap", true) catch {};

    // Indicate a 256-bit AES key is to be generated by setting the value_len attribute equal to the key size in bytes.
    // (32 bytes * 8 bits/byte = 256 bits)
    json.updateInt("value_len", 32) catch {};

    const key_handle = pkcs11.genSecretKey(key_type, json);
    if (key_handle == 0) {
        std.debug.print("{s}\n", .{try pkcs11.getLastErrorText(alloc)});
        std.debug.print("Failed to generate an AES key.\n", .{});
    } else {
        std.debug.print("key handle = {d}\n", .{key_handle});
        std.debug.print("Success.\n", .{});
    }

    pkcs11.logout() catch {};
    pkcs11.closeSession() catch {};
}