Zig

Oracle Cloud Secrets - Setup Bootstrap Secret in Local Manager

See more Secrets Examples

Accessing a cloud-based secrets manager requires authentication credentials, which cannot be stored in the manager itself. Instead, they must be securely stored locally.

One solution is to store the authentication credentials as a secret in the Windows Credentials Manager or Apple Keychain. These credentials serve as the "bootstrap secret" for authenticating with the cloud-based secrets manager.

This example demonstrates how to setup a bootstrap secret for the Oracle Cloud Secrets.

Note: This example requires Chilkat v10.1.0 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.

    const bootstrap = try chilkat.Secrets.init();
    defer bootstrap.deinit();

    // We're going to store the bootstrap secret in the local manager.
    // On Windows, this is the Windows Credentials Manager
    // On MacOS/iOS, it is the Apple Keychain
    bootstrap.setLocation("local_manager");

    // Specify the name of the bootstrap secret.
    // service and username are required.
    // appName and domain are optional.
    // Note: The values are arbitrary and can be anything you want.
    const json = try chilkat.JsonObject.init();
    defer json.deinit();
    json.updateString("appName", "oracle_bs") catch {};
    json.updateString("service", "Example") catch {};
    json.updateString("username", "Joe") catch {};

    // The bootstrap secret for Oracle Cloud Secrets is the PEM of your private key.
    const sb_pem = try chilkat.StringBuilder.init();
    defer sb_pem.deinit();
    sb_pem.loadFile("qa_data/pem/oracle_cloud_privkey.pem", "utf-8") catch {
        std.debug.print("Failed to load the private key PEM file.\n", .{});
        return;
    };

    // The bootstrap secret for the Oracle Cloud Secrets will contain
    // the private key PEM, like this:
    bootstrap.updateSecretSb(json, sb_pem) catch {
        std.debug.print("{s}\n", .{try bootstrap.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("The Oracle Cloud bootstrap secret has been stored.\n", .{});
}