User's Guide: Create Datasets

February 22, 2021 07:13

Disclaimer: The Fortanix CCM Datasets feature will only be enabled for Customers with an "Enterprise" license.

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 Self-Defending KMS).

NOTE

A Credential is a fully user-provided object, for example: this can be a JSON string that contains the query param of the S3 pre-signed URL and the decryption key.
Credentials can be rotated through updates to datasets, all approved enclaves are allowed to refresh and get the latest credentials.

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.

Click the Datasets icon in the CCM left panel.
Figure 1: Dataset
On the Datasets page, click the CREATE DATASET button to create a dataset.
Figure 2: Create Dataset
In the Create new dataset form, enter the following details:
- Name – the dataset name. For ex: Dataset1.
- Description (optional) – the dataset description.
- Labels (optional)– attach one or more key-value labels to the dataset.
- Location – the URL where data can be accessed.
- Credentials – the credentials needed to access the data.
Figure 3: Create new Dataset
Click the CREATE DATASET to create the dataset.
Figure 4: Dataset created

Update a Dataset

To edit a dataset:

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

NOTE

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

Delete a Dataset

To delete a dataset:

In the dataset table view, click on the dataset to delete.
In the detailed view of the dataset, click DELETE DATASET to delete the dataset.
Figure 8: Delete a Dataset
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 select the DELETE DATASET option from the menu.
Figure 9: Delete a Dataset