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.

C++

#include <CkSecrets.h>
#include <CkJsonObject.h>
#include <CkStringBuilder.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.

    CkSecrets 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("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.
    CkJsonObject json;
    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.
    CkStringBuilder sbPem;
    success = sbPem.LoadFile("qa_data/pem/oracle_cloud_privkey.pem","utf-8");
    if (success == false) {
        std::cout << "Failed to load the private key PEM file." << "\r\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) {
        std::cout << bootstrap.lastErrorText() << "\r\n";
        return;
    }

    std::cout << "The Oracle Cloud bootstrap secret has been stored." << "\r\n";
    }