React Native

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.

React Native

import { JsonObject, Secrets, StringBuilder } from '@chilkat/react-native'

async function chilkatExample() {
  // This example requires the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  const bootstrap = new Secrets();

  // 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.
  const json = new JsonObject();
  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.
  const sbPem = new StringBuilder();
  try {
    sbPem.loadFile('qa_data/pem/oracle_cloud_privkey.pem', 'utf-8');
  } catch {
    console.log('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:
  try {
    await bootstrap.updateSecretSbAsync(json, sbPem);
  } catch {
    console.log(bootstrap.lastErrorText);
    return;
  }

  console.log('The Oracle Cloud bootstrap secret has been stored.');
}