Pascal (Lazarus/Delphi)

Oracle Cloud Secrets - Get a Binary Secret

See more Secrets Examples

Demonstrates how to fetch the content of a binary secret from the Oracle Cloud Secrets.

Note: This example requires Chilkat v10.1.0 or later.

Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.Secrets,
  Chilkat.BinData,
  Chilkat.JsonObject;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  bootstrap: TSecrets;
  bsId: TJsonObject;
  secrets: TSecrets;
  json: TJsonObject;
  bd: TBinData;

begin
  success := False;

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

  //  The bootstrap secret will contain the following information:

  //  Private Key PEM

  //  See following examples for setting up a bootstrap secret in memory, 
  //  or in the local manager (Windows Credentials Manager or Apple Keychain)
  //  Setup Bootstrap Secret in Local Manager
  //  Setup Bootstrap Secret in Memory
  bootstrap := TSecrets.Create;

  //  Set the location of the bootstrap secret.
  //  Can be "local_manager" or "memory", depending on how you setup the bootstrap secret.
  //  ---------------------------------------------------------------------------------------------
  //  If your operating system is NOT Windows or MacOS/iOS, then change "local_manager" to "memory"
  //  You can also, if desired, use "memory" on Windows and MacOS/iOS if your bootstrap secret was previously setup in memory.
  //  ---------------------------------------------------------------------------------------------
  bootstrap.Location := 'local_manager';

  //  Specify the bootstrap secret to be used.
  bsId := TJsonObject.Create;
  bsId.UpdateString('appName','oracle_bs');
  bsId.UpdateString('service','Example');
  bsId.UpdateString('username','Joe');

  //  ----------------------------------------------------
  secrets := TSecrets.Create;

  //  Setup for the Oracle Cloud Secrets
  secrets.Location := 'oracle_cloud';
  success := secrets.SetBootstrapSecret(bsId,bootstrap);
  if (success = False) then
    begin
      WriteLn(secrets.LastErrorText);
      Exit;
    end;

  //  Specify the secret to be fetched.
  json := TJsonObject.Create;
  json.UpdateString('appName','Test2');
  json.UpdateString('service','Custom');
  json.UpdateString('domain','Ocean');
  json.UpdateString('username','Starfish');

  //  Oracle Cloud Secrets requires a lot of additional information for each API call.
  //  You'll need to replace the following with your values.
  //  Note: To learn how to find these values, go to an AI such as ChatGPT and ask (for example) "In Oracle Cloud, where do I find my master key OCID?"
  json.UpdateString('vault_name','ocid1.vault.oc1.us-chicago-1.ijttzlz7aadxo.abxxeljt4gv6tgrar66i5ugffincjmp52oveht3y2zn74rgo6raz6h72qtia');
  json.UpdateString('region','us-chicago-1');
  json.UpdateString('tenancy_ocid','ocid1.tenancy.oc1..aaaaaaaaov6vd3xdybgvwblezx2kmgjmo3dvsuljbwpf2m27mk47kkxsa5aa');
  json.UpdateString('user_ocid','ocid1.user.oc1..aaaaaaaarsn42gwcl5rvahcmt5r6aheek65z54k5nbd6gtclmqn6emkqxajq');
  json.UpdateString('master_key_ocid','ocid1.key.oc1.us-chicago-1.ijttzlz7aadxo.abxyeljtfbqhl5h2velmojmm6ls77lskmc7ardpekjgw264my6fuyxmhm6xa');

  //  Get the binary secret data.
  bd := TBinData.Create;
  success := secrets.GetSecretBd(json,bd);
  if (success = False) then
    begin
      WriteLn(secrets.LastErrorText);
      Exit;
    end;

  //  For our testing, the binary secret was a JPG image..
  bd.WriteFile('c:/temp/qa_output/starfish.jpg');

  WriteLn('Success.');


  bootstrap.Free;
  bsId.Free;
  secrets.Free;
  json.Free;
  bd.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.