Swift

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.

Swift

func chilkatTest() {
    var success: Bool = false

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

    let bootstrap = CkoSecrets()!

    // 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.
    let json = CkoJsonObject()!
    json.updateString(jsonPath: "appName", value: "oracle_bs")
    json.updateString(jsonPath: "service", value: "Example")
    json.updateString(jsonPath: "username", value: "Joe")

    // The bootstrap secret for Oracle Cloud Secrets is the PEM of your private key.
    let sbPem = CkoStringBuilder()!
    success = sbPem.loadFile(path: "qa_data/pem/oracle_cloud_privkey.pem", charset: "utf-8")
    if success == false {
        print("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(jsonId: json, sb: sbPem)
    if success == false {
        print("\(bootstrap.lastErrorText!)")
        return
    }

    print("The Oracle Cloud bootstrap secret has been stored.")

}