PureBasic

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.

PureBasic

IncludeFile "CkStringBuilder.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkSecrets.pb"

Procedure ChilkatExample()

    success.i = 0

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

    bootstrap.i = CkSecrets::ckCreate()
    If bootstrap.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; 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
    CkSecrets::setCkLocation(bootstrap, "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.
    json.i = CkJsonObject::ckCreate()
    If json.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(json,"appName","oracle_bs")
    CkJsonObject::ckUpdateString(json,"service","Example")
    CkJsonObject::ckUpdateString(json,"username","Joe")

    ; The bootstrap secret for Oracle Cloud Secrets is the PEM of your private key.
    sbPem.i = CkStringBuilder::ckCreate()
    If sbPem.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkStringBuilder::ckLoadFile(sbPem,"qa_data/pem/oracle_cloud_privkey.pem","utf-8")
    If success = 0
        Debug "Failed to load the private key PEM file."
        CkSecrets::ckDispose(bootstrap)
        CkJsonObject::ckDispose(json)
        CkStringBuilder::ckDispose(sbPem)
        ProcedureReturn
    EndIf

    ; The bootstrap secret for the Oracle Cloud Secrets will contain
    ; the private key PEM, like this:
    success = CkSecrets::ckUpdateSecretSb(bootstrap,json,sbPem)
    If success = 0
        Debug CkSecrets::ckLastErrorText(bootstrap)
        CkSecrets::ckDispose(bootstrap)
        CkJsonObject::ckDispose(json)
        CkStringBuilder::ckDispose(sbPem)
        ProcedureReturn
    EndIf

    Debug "The Oracle Cloud bootstrap secret has been stored."


    CkSecrets::ckDispose(bootstrap)
    CkJsonObject::ckDispose(json)
    CkStringBuilder::ckDispose(sbPem)


    ProcedureReturn
EndProcedure