(Objective-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.

For more information, see https://cknotes.com/chilkat-secrets-class-added-in-version-10-1-0/

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoSecrets.h>
#import <CkoJsonObject.h>
#import <CkoStringBuilder.h>

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

CkoSecrets *bootstrap = [[CkoSecrets alloc] init];

// 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.
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"appName" value: @"oracle_bs"];
[json UpdateString: @"service" value: @"Example"];
[json UpdateString: @"username" value: @"Joe"];

// The bootstrap secret for Oracle Cloud Secrets is the PEM of your private key.
CkoStringBuilder *sbPem = [[CkoStringBuilder alloc] init];
BOOL success = [sbPem LoadFile: @"qa_data/pem/oracle_cloud_privkey.pem" charset: @"utf-8"];
if (success == NO) {
    NSLog(@"%@",@"Failed to load the private key PEM file.");
    return;
}

// The bootstrap secret for the Oracle Cloud Secrets will contain
// the private key PEM, like this:
success = [bootstrap UpdateSecretSb: json sb: sbPem];
if (success == NO) {
    NSLog(@"%@",bootstrap.LastErrorText);
    return;
}

NSLog(@"%@",@"The Oracle Cloud bootstrap secret has been stored.");