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

Objective-C

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

BOOL success = NO;

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

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

//  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: @"AWS"];
[json UpdateString: @"service" value: @"Example"];
[json UpdateString: @"username" value: @"Joe"];

//  The bootstrap secret for the AWS Secrets Manager will contain
//  the AWS region, access key, and secret key, like this:
CkoJsonObject *jsonSecret = [[CkoJsonObject alloc] init];
//  Modify if necessary to use your region..
[jsonSecret UpdateString: @"awsRegion" value: @"us-east-1"];
[jsonSecret UpdateString: @"awsAccessKey" value: @"YOUR_ACCESS_KEY"];
[jsonSecret UpdateString: @"awsSecretKey" value: @"YOUR_SECRET_KEY"];

//  Create or update the bootstrap secret.
success = [bootstrap UpdateSecretJson: json secret: jsonSecret];
if (success == NO) {
    NSLog(@"%@",bootstrap.LastErrorText);
    return;
}

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