Unicode C++

AWS 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 AWS Secrets Manager.

Note: This example requires Chilkat v10.1.0 or later.

Unicode C++

#include <CkSecretsW.h>
#include <CkJsonObjectW.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;

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

    // The bootstrap secret for the AWS Secrets Manager will contain
    // the AWS region, access key, and secret key, like this:
    CkJsonObjectW jsonSecret;
    // Modify if necessary to use your region..
    jsonSecret.UpdateString(L"awsRegion",L"us-east-1");
    jsonSecret.UpdateString(L"awsAccessKey",L"YOUR_ACCESS_KEY");
    jsonSecret.UpdateString(L"awsSecretKey",L"YOUR_SECRET_KEY");

    // Create or update the bootstrap secret.
    success = bootstrap.UpdateSecretJson(json,jsonSecret);
    if (success == false) {
        wprintf(L"%s\n",bootstrap.lastErrorText());
        return;
    }

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