User's Guide: Create Datasets

Introduction

A dataset contains information on how to securely retrieve remote data.

This includes the following:

• A location such as a URL to an external storage service.
• Credentials such as username, password, auth-token, and so on, which are stored securely in a KMS (currently this is Fortanix Data Security Manager).

You can leverage these objects to provide data to enclaves securely.

Fortanix CCM’s EDP and EnclaveOS products can retrieve datasets and their credentials when run in an approved Workflow. For more details about workflows, refer to User's Guide: Workflows.

Create a Dataset

To create a dataset.

1. Click the Datasets icon in the CCM left panel.
   Figure 1: Datasets
2. On the Datasets page, click the CREATE DATASET button to create a dataset.
   Figure 2: Create Dataset
3. In the Create new dataset form, enter the following details:
   • Name – the dataset name. For example: Dataset1.
   • Description (optional) – the dataset description.
   • Labels (optional)– attach one or more key-value labels to the dataset.
   • Location – the URL where the data can be accessed.
   • Long Description (optional)– enter the content in GitHub-flavoured Markdown file format. You can also use the Fetch Long Description button to get the Markdown file content from an external URL.
     
     Figure 3: Fetch Long Description
     The following is the sample 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/)?

   • Credentials – the credentials needed to access the data.
   
   Figure 4: Create New Dataset
4. Click the CREATE DATASET button to create the dataset.
   Figure 5: Dataset Created

Update a Dataset

To edit a dataset:

1. In the dataset table view, select the dataset to edit.
2. In the detailed view of the dataset, click the EDIT DATASET button to edit the dataset details. 
   
   Figure 6: Edit Dataset
3. You can edit the dataset Name, Description, Location, Labels, and Credentials.
4. Click SAVE after you edited the dataset. 
   
   Figure 7: Save Dataset
   NOTE

   You can also edit a dataset by clicking the overflow menu for a dataset table entry and selecting the EDIT DATASET option from the menu.
   Figure 8: Edit Dataset

Delete a Dataset

To delete a dataset:

1. In the dataset table view, click on the dataset to delete.
2. In the detailed view of the dataset, click the DELETE DATASET button to delete the dataset. 
   
   Figure 9: Delete a Dataset
3. In the confirmation window, click DELETE to delete the dataset.
   
   NOTE

   You can also delete a dataset by clicking the overflow menu for a dataset table entry and selecting the DELETE DATASET option from the menu.
   Figure 10: Delete a Dataset