(Delphi DLL) IBM 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 IBM Cloud Secrets.

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 for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Secrets, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
var
bootstrap: HCkSecrets;
json: HCkJsonObject;
ibm_api_key: PWideChar;
success: Boolean;

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

bootstrap := CkSecrets_Create();

// 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_putLocation(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 := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'appName','ibm_bs');
CkJsonObject_UpdateString(json,'service','Example');
CkJsonObject_UpdateString(json,'username','Joe');

// The bootstrap secret for the IBM Cloud Secrets will contain
// your IBM Cloud API Key, like this..
// (change the following to use your own IBM Cloud API key)
ibm_api_key := 'tI-oaEj_krD2F4Utd1ztRCE+wDWve8HvU15XxOdq7FkW';
success := CkSecrets_UpdateSecretStr(bootstrap,json,ibm_api_key);
if (success = False) then
  begin
    Memo1.Lines.Add(CkSecrets__lastErrorText(bootstrap));
    Exit;
  end;

Memo1.Lines.Add('The IBM Cloud bootstrap secret has been stored in the local manager.');

CkSecrets_Dispose(bootstrap);
CkJsonObject_Dispose(json);

end;