(Node.js) 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.

For more information, see https://cknotes.com/chilkat-secrets-class-added-in-version-10-1-0/

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOSX, and ARM

var os = require('os');
if (os.platform() == 'win32') {  
    if (os.arch() == 'ia32') {
        var chilkat = require('@chilkat/ck-node21-win-ia32');
    } else {
        var chilkat = require('@chilkat/ck-node21-win64'); 
    }
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node21-arm');
    } else if (os.arch() == 'x86') {
        var chilkat = require('@chilkat/ck-node21-linux32');
    } else {
        var chilkat = require('@chilkat/ck-node21-linux64');
    }
} else if (os.platform() == 'darwin') {
    if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node21-mac-m1');
    } else {
        var chilkat = require('@chilkat/ck-node21-macosx');
    }
}

function chilkatExample() {

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

    var bootstrap = new chilkat.Secrets();

    // 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.Location = "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.
    var json = new chilkat.JsonObject();
    json.UpdateString("appName","oracle_bs");
    json.UpdateString("service","Example");
    json.UpdateString("username","Joe");

    // The bootstrap secret for Oracle Cloud Secrets is the PEM of your private key.
    var sbPem = new chilkat.StringBuilder();
    var success = sbPem.LoadFile("qa_data/pem/oracle_cloud_privkey.pem","utf-8");
    if (success == false) {
        console.log("Failed to load the private key PEM file.");
        return;
    }

    // The bootstrap secret for the Oracle Cloud Secrets will contain
    // the private key PEM, like this:
    success = bootstrap.UpdateSecretSb(json,sbPem);
    if (success == false) {
        console.log(bootstrap.LastErrorText);
        return;
    }

    console.log("The Oracle Cloud bootstrap secret has been stored.");

}

chilkatExample();