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

Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

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

my $bootstrap = Chilkat2::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.
my $json = Chilkat2::JsonObject->new;
$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.
my $sbPem = Chilkat2::StringBuilder->new;
my $success = $sbPem->LoadFile('qa_data/pem/oracle_cloud_privkey.pem', 'utf-8');
if (!$success) {
    print "Failed to load the private key PEM file.\n";
    exit;
}

# The bootstrap secret for the Oracle Cloud Secrets will contain
# the private key PEM, like this:
$success = $bootstrap->UpdateSecretSb($json, $sbPem);
if (!$success) {
    print $bootstrap->LastErrorText, "\n";
    exit;
}

print "The Oracle Cloud bootstrap secret has been stored.\n";