C

Oracle Cloud Secrets - Create or Update a Binary Secret

See more Secrets Examples

Demonstrates how to create or update a binary secret stored in the Oracle Cloud Secrets.

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

C

#include <C_CkSecrets.h>
#include <C_CkJsonObject.h>
#include <C_CkHttp.h>
#include <C_CkBinData.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkSecrets bootstrap;
    HCkJsonObject bsId;
    HCkSecrets secrets;
    HCkJsonObject json;
    const char *url;
    HCkHttp http;
    HCkBinData bd;

    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 = CkSecrets_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.
    // ---------------------------------------------------------------------------------------------
    CkSecrets_putLocation(bootstrap,"local_manager");

    // Specify the bootstrap secret to be used.
    bsId = CkJsonObject_Create();
    CkJsonObject_UpdateString(bsId,"appName","oracle_bs");
    CkJsonObject_UpdateString(bsId,"service","Example");
    CkJsonObject_UpdateString(bsId,"username","Joe");

    // ----------------------------------------------------
    secrets = CkSecrets_Create();

    // Setup for the Oracle Cloud Secrets
    CkSecrets_putLocation(secrets,"oracle_cloud");
    success = CkSecrets_SetBootstrapSecret(secrets,bsId,bootstrap);
    if (success == FALSE) {
        printf("%s\n",CkSecrets_lastErrorText(secrets));
        CkSecrets_Dispose(bootstrap);
        CkJsonObject_Dispose(bsId);
        CkSecrets_Dispose(secrets);
        return;
    }

    // Specify the name of the 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","Test2");
    CkJsonObject_UpdateString(json,"service","Custom");
    CkJsonObject_UpdateString(json,"domain","Ocean");
    CkJsonObject_UpdateString(json,"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?"
    CkJsonObject_UpdateString(json,"vault_name","ocid1.vault.oc1.us-chicago-1.ijttzlz7aadxo.abxxeljt4gv6tgrar66i5ugffincjmp52oveht3y2zn74rgo6raz6h72qtia");
    CkJsonObject_UpdateString(json,"region","us-chicago-1");
    CkJsonObject_UpdateString(json,"tenancy_ocid","ocid1.tenancy.oc1..aaaaaaaaov6vd3xdybgvwblezx2kmgjmo3dvsuljbwpf2m27mk47kkxsa5aa");
    CkJsonObject_UpdateString(json,"user_ocid","ocid1.user.oc1..aaaaaaaarsn42gwcl5rvahcmt5r6aheek65z54k5nbd6gtclmqn6emkqxajq");
    CkJsonObject_UpdateString(json,"master_key_ocid","ocid1.key.oc1.us-chicago-1.ijttzlz7aadxo.abxyeljtfbqhl5h2velmojmm6ls77lskmc7ardpekjgw264my6fuyxmhm6xa");

    // The purpose of this example is to show how arbitrary binary data
    // can be stored as a secret.

    // We'll use a small JPG image that is approximately 6KB in size.
    // You can test using this same JPG at this URL:
    url = "https://chilkatdownload.com/sample_data/starfish.jpg";
    http = CkHttp_Create();
    bd = CkBinData_Create();
    success = CkHttp_DownloadBd(http,url,bd);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkSecrets_Dispose(bootstrap);
        CkJsonObject_Dispose(bsId);
        CkSecrets_Dispose(secrets);
        CkJsonObject_Dispose(json);
        CkHttp_Dispose(http);
        CkBinData_Dispose(bd);
        return;
    }

    // Create or update the binary secret.
    success = CkSecrets_UpdateSecretBd(secrets,json,bd);
    if (success == FALSE) {
        printf("%s\n",CkSecrets_lastErrorText(secrets));
        CkSecrets_Dispose(bootstrap);
        CkJsonObject_Dispose(bsId);
        CkSecrets_Dispose(secrets);
        CkJsonObject_Dispose(json);
        CkHttp_Dispose(http);
        CkBinData_Dispose(bd);
        return;
    }

    printf("Success.\n");

    // Here you can see the secret that was created in the Oracle Cloud Secrets:

    // 


    CkSecrets_Dispose(bootstrap);
    CkJsonObject_Dispose(bsId);
    CkSecrets_Dispose(secrets);
    CkJsonObject_Dispose(json);
    CkHttp_Dispose(http);
    CkBinData_Dispose(bd);

    }