Create Datasets

1.0 Introduction

This document describes how to create and manage datasets in Fortanix Confidential Computing Manager (CCM). A dataset contains the information required to securely retrieve remote data.

This includes the following:

• A location, such as a URL to an external storage service.

• Credentials such as usernames, passwords, authentication tokens, and similar secrets. These credentials are stored securely in a KMS (currently Fortanix Data Security Manager (DSM)).

NOTE

• A credential is a fully user-defined object. For example, a credential can be a JSON string containing the query parameters of an S3 pre-signed URL and the corresponding decryption key.

• Credentials can be rotated through updates to datasets. All approved enclaves can retrieve the latest credentials after credential rotation.

Datasets can be used to securely provide data to enclaves. Fortanix EDP and EnclaveOS applications can retrieve datasets and associated credentials when executed within an approved workflow.

For more information about Fortanix CCM workflows, refer to Create, Update, Clone, and Delete Workflows.

2.0 Create a Dataset

Perform the following steps to create a dataset:

1. In the CCM user interface (UI) left navigation panel, click Dataverse → DATASETS, and then click ADD DATASET to create a dataset.

   

2. In the Add Dataset form:

   1. Connection Name: Enter a name for the dataset. For example, Demo Dataset.

   2. Description (Optional): Enter a short description of the dataset. 

   3. Label Details (Optional): Add one or more key–value labels to the dataset.  

   4. Group: Select the required group name from the drop down menu to associate the dataset with that group.

   5. Location: Enter the URL from which the data can be accessed.

   6. Long description (Optional): Enter the dataset details in GitHub-flavored Markdown format.

      The following example shows a long description in Markdown format:

      - Strikethrough Text
      ~~It is Strikethrough test..~~
      - Blockquote Text
      > Test Blockquote.
      - Bold
      **A sample Description.**
      - Italic
      *It is Italics*
      - Bold and Italic
      ***Bold and Italics text***
      - Link
      This is [Website](https://www.fortanix.com/)?

      Alternatively, click FETCH LONG DESCRIPTION to import Markdown content from an external URL.

      NOTE

      Ensure that Cross-origin resource sharing (CORS) is enabled on the external URL so that Fortanix CCM can access it. For more information, refer to the AWS and Azure documentation for configuring CORS settings.

   7. Credentials: Enter the credentials required to access the data.

3. Click ADD DATASET to create the dataset.

3.0 Update a Dataset

Perform the following steps to edit a dataset:

1. From the dataset table, select the dataset that you want to update.

2. In the dataset details panel, click EDIT to modify the dataset configuration.

3. Update the required fields, such as Name, Description, Location, Labels, and Credentials.

4. Click SAVE after updating the dataset details.

NOTE

You can also update a dataset by clicking the Edit icon for the dataset entry in the table.

4.0 Delete a Dataset

Perform the following steps to delete a dataset:

1. From the dataset table, select the dataset that you want to delete.

2. In the dataset details panel, click DELETE.

3. In the confirmation dialog box, click DELETE to confirm the action.

NOTE

You can also delete a dataset by clicking the Delete icon for the dataset entry in the table.