(PureBasic) AWS Setup Bootstrap Secret in Memory

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.

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 PureBasic Module Download Chilkat PureBasic Module

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

Procedure ChilkatExample()

    ; 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

    ; This secret will reside in memory.
    CkSecrets::setCkLocation(bootstrap, "memory")

    ; 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","AWS")
    CkJsonObject::ckUpdateString(json,"service","Example")
    CkJsonObject::ckUpdateString(json,"username","Joe")

    ; The bootstrap secret for the AWS Secrets Manager will contain
    ; the AWS region, access key, and secret key, like this:
    jsonSecret.i = CkJsonObject::ckCreate()
    If jsonSecret.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Modify if necessary to use your region..
    CkJsonObject::ckUpdateString(jsonSecret,"awsRegion","us-east-1")
    CkJsonObject::ckUpdateString(jsonSecret,"awsAccessKey","YOUR_ACCESS_KEY")
    CkJsonObject::ckUpdateString(jsonSecret,"awsSecretKey","YOUR_SECRET_KEY")

    ; Create or update the secret (in memory).
    ; The secret is stored encrypted in memory, and is available to be used
    ; regardless of the lifetime of the "bootstrap" object.
    success.i = CkSecrets::ckUpdateSecretJson(bootstrap,json,jsonSecret)
    If success = 0
        Debug CkSecrets::ckLastErrorText(bootstrap)
        CkSecrets::ckDispose(bootstrap)
        CkJsonObject::ckDispose(json)
        CkJsonObject::ckDispose(jsonSecret)
        ProcedureReturn
    EndIf

    Debug "The AWS bootstrap secret has been stored in memory."


    CkSecrets::ckDispose(bootstrap)
    CkJsonObject::ckDispose(json)
    CkJsonObject::ckDispose(jsonSecret)


    ProcedureReturn
EndProcedure