Lua Requires Chilkat v10.1.0+

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.

Lua

local chilkat = require("chilkat")

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

local bootstrap = chilkat.Secrets.new()

-- 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.
local json = chilkat.JsonObject.new()
json:update_string("appName", "oracle_bs")
json:update_string("service", "Example")
json:update_string("username", "Joe")

-- The bootstrap secret for Oracle Cloud Secrets is the PEM of your private key.
local sbPem = chilkat.StringBuilder.new()
local success = sbPem:load_file("qa_data/pem/oracle_cloud_privkey.pem", "utf-8")
if not success then
    print("Failed to load the private key PEM file.")
    return
end

-- The bootstrap secret for the Oracle Cloud Secrets will contain
-- the private key PEM, like this:
success = bootstrap:update_secret_sb(json, sbPem)
if not success then
    print(bootstrap.last_error_text)
    return
end

print("The Oracle Cloud bootstrap secret has been stored.")