Unicode C++

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.

Unicode C++

#include <CkSecretsW.h>
#include <CkJsonObjectW.h>
#include <CkStringBuilderW.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    CkSecretsW bootstrap;

    // 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.put_Location(L"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.
    CkJsonObjectW json;
    json.UpdateString(L"appName",L"oracle_bs");
    json.UpdateString(L"service",L"Example");
    json.UpdateString(L"username",L"Joe");

    // The bootstrap secret for Oracle Cloud Secrets is the PEM of your private key.
    CkStringBuilderW sbPem;
    success = sbPem.LoadFile(L"qa_data/pem/oracle_cloud_privkey.pem",L"utf-8");
    if (success == false) {
        wprintf(L"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:
    success = bootstrap.UpdateSecretSb(json,sbPem);
    if (success == false) {
        wprintf(L"%s\n",bootstrap.lastErrorText());
        return;
    }

    wprintf(L"The Oracle Cloud bootstrap secret has been stored.\n");
    }